Tanuljunk PHP-ül (Fejlesztés alatt) Fábián Zoltán v0.8

Tanuljunk PHP-ül (Fejlesztés alatt) Fábián Zoltán 2001-2004 v0.8

1

Tartalomjegyzék 1

BEVEZETÉS.............................................................................................................................................................5 MIRE JÓ EZ A JEGYZET?.....................................................................................................................................................5 1. 2 A PHP RÖVID TÖRTÉNETE ..........................................................................................................................................5 MI A PHP? .......................................................................................................................................................................6

2

MILYEN RENDSZEREN HASZNÁLHATÓ? ........................................................................................................8 2.1.1 2.1.2

3

Milyen operációs rendszer? ...........................................................................................................................8 Milyen WEB szervert? ...................................................................................................................................8

A PHP4 TELEPÍTÉSE (WIN32 VÁLTOZAT) ........................................................................................................9 3.1 KÖNYVTÁRAK ....................................................................................................................................................9 3.2 TELEPÍTÉS ........................................................................................................................................................10 3.2.1 Apache WEB szerver 1.3.xx vagy 2.0.xx .......................................................................................................10 3.2.2 Internet Information Server 4 vagy 5............................................................................................................10 3.2.3 Personal Web Server 4 vagy újabb (Win98) .................................................................................................11 3.2.4 Szerver nélküli használat: ............................................................................................................................11

4

ESZKÖZÖK A PHP HASZNÁLATÁHOZ............................................................................................................12

5

EGY HTML ÉS EGY PHP OLDAL SZERKEZETE ............................................................................................13

6

A PHP SZINTAKTIKÁJA......................................................................................................................................14

7

VÁLTOZÓK, ADATTÍPUSOK..............................................................................................................................15 7.1 7.2 7.3 7.4 7.4.1 7.4.2 7.4.3 7.5

8

ALAPVETŐ UTASÍTÁSOK ..................................................................................................................................19 8.1 8.2 8.3

9

STRINGEK KÖZÖTTI MŰVELETEK........................................................................................................................22 ARITMETIKAI MŰVELETEK ................................................................................................................................22 HOZZÁRENDELÉS, ÉRTÉKADÁS ..........................................................................................................................22 NÖVELŐ/CSÖKKENTŐ OPERÁTOROK...................................................................................................................22 LOGIKAI OPERÁTOROK ......................................................................................................................................23 ÖSSZEHASONLÍTÓ OPERÁTOROK ........................................................................................................................23 BITORIENTÁLT OPERÁTOROK.............................................................................................................................23 HIBAKEZELŐ OPERÁTOROK ...............................................................................................................................24 VÉGREHAJTÓ OPERÁTOROK ...............................................................................................................................24 GYAKORLÓ FELADATOK....................................................................................................................................24

VEZÉRLÉSI SZERKEZETEK ..............................................................................................................................25 10.1 10.2 10.3 10.4 10.5 10.6

11

ECHO ...............................................................................................................................................................19 FORMÁZOTT KIÍRÁS ..........................................................................................................................................20 A KIIRATÁS GYAKORLÁSA .................................................................................................................................21

OPERÁTOROK (MŰVELETEK)..........................................................................................................................22 9.1 9.2 9.3 9.4 9.5 9.6 9.7 9.8 9.9 9.10

10

A VÁLTOZÓ NEVE .............................................................................................................................................15 A VÁLTOZÓ ÉRTÉKE ..........................................................................................................................................15 A VÁLTOZÓK ÉS KIFEJEZÉSEK TÍPUSAI ...............................................................................................................15 ELŐRE DEFINIÁLT VÁLTOZÓK ............................................................................................................................17 PHP Core – A PHP rendszer alapvető változóinak a listája..........................................................................17 Environment ................................................................................................................................................17 PHP Variables - A PHP változók listája.......................................................................................................17 KONSTANSOK ...................................................................................................................................................18

ELÁGAZÁSOK ...................................................................................................................................................25 CIKLUSOK ........................................................................................................................................................27 ELÁGAZÁSOK ÉS CIKLUSOK HASZNÁLATA HTML KÓDDAL KEVERVE ..................................................................29 PHP LAPOK BESZÚRÁSA, ”MAKRO”-K HASZNÁLATA. ..........................................................................................30 TÁVOLI FILE-OK HÍVÁSA ...................................................................................................................................31 PÉLDAPROGRAMOK FELTÉTELEKKEL, CIKLUSOKKAL ..........................................................................................31

SAJÁT FÜGGVÉNYEK, VÁLTOZÓK ÉLETTARTAMA ÉS LÁTHATÓSÁGA...............................................32 11.1 11.2 11.3

FÜGGVÉNYEK ...................................................................................................................................................32 PARAMÉTERÁTADÁS .........................................................................................................................................32 FÜGGVÉNYEK VISSZATÉRÉSI ÉRTÉKE .................................................................................................................34

2

11.4 VÁLTOZÓK ÉLETTARTALMA ÉS LÁTHATÓSÁGA ..................................................................................................34 11.5 VÁLTOZÓK ÁTADÁSA LAPOK KÖZÖTT ................................................................................................................36 11.5.1 Header utasítás.......................................................................................................................................36 11.5.2 GET metódus ..........................................................................................................................................36 11.5.3 POST metódus ........................................................................................................................................37 11.5.4 $_SESSION változók ...............................................................................................................................40 Egy session kezelő működése - példa..........................................................................................................................45 11.5.5 COOKIE-k (sütik) ...................................................................................................................................48 12

KONVERZIÓ ADATTÍPUSOK KÖZÖTT............................................................................................................50

13

TÖMBÖK................................................................................................................................................................51

14

SZTRINGEK, SZÖVEGEK MANIPULÁCIÓJA..................................................................................................55

15

FORMOK /ŰRLAPOK – INTERAKTÍV PROGRAMOK ÍRÁSA .......................................................................59 15.1.1

Önmagukat meghívó űrlapok...................................................................................................................59

16

FORMOK ADATAINAK FELDOLGOZÁSA – SZERVER- ÉS KLIENS OLDALON.......................................61

17

LEVÉLKÜLDÉS, PLAIN TEXT, HTML LEVÉL, ATTACHEMENT.................................................................63

18

ADATBÁZISOK .....................................................................................................................................................65 18.1 MYSQL ...........................................................................................................................................................66 18.2 POSTGRES SQL ................................................................................................................................................66 18.3 ADATBÁZIS-KEZELÉS NATÍV MÓDON ..................................................................................................................68 18.4 TIPIKUS FELADATOK ADATBÁZIS-KEZELÉSNÉL ...................................................................................................70 18.5 HIBAKEZELÉS ...................................................................................................................................................73 18.6 ADATBÁZISKEZELÉS MÁSKÉPPEN – ABSZTRAKCIÓS RÉTEGEK, ADODB, ODBC ..................................................73 18.6.1 Az absztrakciós réteg...............................................................................................................................73 18.6.2 ODBC programcsomag...........................................................................................................................73 18.6.3 Az ADODB rétegezés ..............................................................................................................................74 Example 3: Inserting .................................................................................................................................................79 Example 4: Debugging ..............................................................................................................................................79 Example 5: MySQL and Menus..................................................................................................................................80 Example 6: Connecting to 2 Databases At Once.........................................................................................................80 Example 7: Generating Update and Insert SQL .........................................................................................................80 Example 8: Implementing Scrolling with Next and Previous.......................................................................................82 Example 9: Exporting in CSV or Tab-Delimited Format.............................................................................................83 Example 10: Recordset Filters...................................................................................................................................83 Example 11: Smart Transactions ...............................................................................................................................83 18.7 USING CUSTOM ERROR HANDLERS AND PEAR_ERROR...................................................................................85 18.8 DATA SOURCE NAMES ...................................................................................................................................87 18.9 CACHING OF RECORDSETS ............................................................................................................................87 18.10 PIVOT TABLES .............................................................................................................................................87

19

CLASS REFERENCE...........................................................................................................................................91

19.1 GLOBAL VARIABLES......................................................................................................................................91 $ADODB_COUNTRECS...........................................................................................................................................91 $ADODB_CACHE_DIR............................................................................................................................................91 $ADODB_FETCH_MODE........................................................................................................................................91 19.2 ADOCONNECTION ..........................................................................................................................................93 ADOConnection Fields..............................................................................................................................................93 ADOConnection Main Functions...............................................................................................................................94 ADOConnection Utility Functions ...........................................................................................................................105 19.3 ADORECORDSET .........................................................................................................................................107 ADORecordSet Fields .............................................................................................................................................107 ADORecordSet Functions........................................................................................................................................107 function rs2html($adorecordset,[$tableheader_attributes], [$col_titles]).................................................................112 Differences between this ADOdb library and Microsoft ADO...................................................................................113 20 20.1 20.2

DATABASE DRIVER GUIDE...........................................................................................................................114 IDŐ KEZELÉSE PHP – MYSQL ESETÉN .............................................................................................................115 SOKÁIG FUTÓ PROGRAMOK .............................................................................................................................116

3

21

FILE-OK, KÖNYVTÁRAK KEZELÉSE A SZERVEREN ÉS TÁVOLI URL-EKEN ......................................117

LÁTOGATÓK SZÁMA:

GRAFIKA .............................................................................................................................................................122

23

A KÖRNYEZET FELDOLGOZÁSA, AZONOSÍTÁS ........................................................................................131

24

BELÉPTETÉS, JELSZAVAK ALKALMAZÁSA, TITKOSÍTÁS......................................................................132 24.1

TITKOSÍTOTT ÁTVITELE A KLIENS ÉS A SZERVER KÖZÖTT: MD5()......................................................................136

25

BIZTONSÁG, TIPPEK ÉS TRÜKKÖK ..............................................................................................................143

26

A PHP.INI FILE PARAMÉTEREZÉSE..............................................................................................................145

SABLONOK – TEMPLATE-EK, LIB-EK....................................................................................................................148 26.1 26.2 27

TEMPLATE-EK, SMARTY ..................................................................................................................................148 PEAR CSOMAG ..............................................................................................................................................148

PHP CACHE PROGRAMOK ..............................................................................................................................149

4

1 Bevezetés Mire jó ez a jegyzet? A jegyzetnek az a célja, hogy bevezesse az olvasót a ma robbanásszerűen terjedő PHP nyelv világába, megtanítsa az alapvető eljárásokat, fogalmakat és képessé tegye az olvasót saját PHP scriptek írására. Használjuk továbbá a Szily Kálmán Műszaki Középiskola ötödéves számítástechnikai programozó szakán is. Nem teljes PHP dokumentáció! Nem is lehet az, hiszen mialatt a jegyzetet megírtam legalább két új verzió jelent meg a PHP-ből és folyamatosan bővül a PHP-ben használható szolgáltatások köre. Igyekeztem arra koncentrálni, hogy egy kezdő viszonylag gyorsan elsajátíthassa a nyelv alapjait, gyorsan tudjon hatásos programokat írni, és ha valamilyen gyakran előforduló probléma megoldására keres választ, akkor azt viszonylag hamar meg tudja oldani. Teljes dokumentációt az Internetről lehet beszerezni, részben magyar nyelven az alábbi címekről, http://www.php.net dokumentáció angolul vagy a http://hu.php.net/docs.php oldal magyarul. A php 4.2.3 verziójától próbálkozva írom ezt a jegyzetet. A jegyzetben található példaprogramokat, ötleteket, részben az alábbi forrásokból szemezgettem és ezúton köszönetet mondok nekik : http://hu.php.net A PHP site magyar oldalai [email protected] Magyar PHP lista http://php4.x3.hu, Korsós István (KI), [email protected] PHP-s cikksorozata a PC-World-ből, resource-ok PHP és egyéb témákban http://phpbuilder.com/columns/ying20000602.php3?page=1 sessionok, Ying Zhang cikke http://phpmailer.sourceforge.net Emailküldés http://php.weblogs.com/ADODB ADODB – adatbáziskezelés Molnár László A Postgres SQL telepítése Smarty felhasználói kézikönyv http://Smarty.php.net Smarty template rendszer És a diákjaim is.

1. 2 A PHP rövid története A PHP története 1994 őszére nyúlik vissza, amikor a munkát kereső Rasmus Lerdorf egy Perl CGI szkriptet használt a Web odalát felkeresők regisztrálására. A látogatókat naplózó kódot "PHP-tools for Personal Home Page"-nek nevezte el. Az első nyilvános változat úgy 1995 táján látott napvilágot. Ez még csak néhány egyszerűbb feladatra volt használható, többek között számlálót, vendégkönyvet tartalmazott. A PHP fejlesztése a Torontói Egyetemen folytatódott, ahol Rasmus Lerdorf olyan interfészt fejlesztett ki, aminek segítségével a HTML kódba ágyazott speciális utasítások közvetlenül érték el az egyetemi adatbázisokat. A rendszert Rasmus "Form Interpreter"-nek, FI-nek nevezte el. Az FI-ben használt elv már megegyezett a PHP alapelvével, miszerint a HTML kódba beágyazott utasításokat értelmezte és 5

hajtotta végre az FI értelmezője. Később a PHP és az FI összeházasításából született meg az első széles körben használt parancsértelmező a PHP/FI. Ez tartalmazta a PHP és az FI addigi szolgáltatásait, sőt az mSQL adatbázisok elérését is támogatta. Rasmus eleinte eljátszadozott a gondolattal, hogy a PHP-t kereskedelmi termékké teszi, de olyan komoly mennyiségű visszajelzést kapott más programozóktól, különböző kiegészítéseket és hibajavításokat küldve a PHP-hez, hogy letett ebbéli szándékáról. A PHP fejlődéséhez és sokrétűségéhez nagymértékben hozzájárult külső programozók szabad és ingyenes részvétele a rendszer fejlesztésében. A PHP a mai napig is ingyenes termék, és ez valóban nagyon jó dolog. Az első verzió megjelenésétől kezdve a PHP felhasználói tábora töretlenül növekedett. 1996-ban közel 15.000 Web oldalon használták a PHP/FI-t, 1997-ben már több mint 50.000 Web oldalon. Ebben az évben kezdődött el a PHP sokkal jobban szervezett továbbfejlesztése. A PHP/FI-t értelmezőjét szinte az alapoktól kezdve újraírták, átemelve a PHP/FI-ben alkalmazott technikákat és kódot, de számos újat is hozzátéve. Így alakult ki a PHP 3-as változata, ami gyakorlatilag rendelkezett mindazokkal a képességekkel, amik a PHP népszerűségét megalapozták. A PHP fejlődése azonban nem áll meg. Jelenleg a 4.0.6 változatnál tart a fejlesztés, de köszönhetően a "szabad szoftver" filozófiának nem valószínű, hogy itt megreked. A magyar PHP lista az elmúlt évben indult, napi 2-3 levéllel, egy év alatt napi 30-50 levélre duzzadt a forgalma.

Mi a PHP? Egy programozási nyelv. A PHP majdnem általános célú programozási nyelv, amely mára sokféle területen alkalmazható, amit a Weben keresztül meg lehet oldani. Dinamikus oldalak, adatbázis-kezelés, akár ügyviteli alkalmazások, levelezés, portálok, grafikai alkalmazások, file-kezelés, távoli adminisztráció, stb. Mielőtt a PHP működését részleteznénk, meg kell ismerkedni egy kicsit a Web-en lévő alkalmazások lelkivilágával. Amikor a böngészőben beírjuk egy olyan oldal nevét, és letöltjük azt, akkor az Interneten lévő WEB szerver küldi el a böngészőnknek a kívánt oldalt. Ez az oldal egy HTML oldal, egy ASCII szöveg állomány, amely megérkezve a böngészőnkre azt a böngésző értelmezi, és a tartalmát megjeleníti. Az ilyen oldalakat statikus oldalaknak hívjuk, mivel a következő és az utána következő kérésekkor mindig pontosan ugyanazt az oldalt fogjuk újra meg újra megkapni, hiszen a szerveren ez egy file. Abban az esetben, ha azt szeretnénk, hogy az oldal tartalma változzon, azaz dinamikus oldalt szeretnénk, valamilyen módon az oldalt a szerveren létre kell hozni, módosítani kell. Ennek érdekében ki kell egészíteni a WEB-szervert olyan alkalmazásokkal, amelyek az oldal kérésekor futáskor állítják elő az oldalt, majd odaadják a szervernek, amely az eredményt továbbítja a böngésző felé. Ezeket a programokat összefoglaló néven CGI programoknak hívjuk, ami a Common Gateway Interface kifejezés rövidítése. Ezek a programok tehát új funkcionalitással bővítik ki a WEB szervereket. A legfontosabb ebben az, hogy ez által a böngészők interaktív módon tudnak kapcsolatot teremteni a WEB szerverrel, adatokat tudnak bevinni neki, a bevitt információ alapján változik a visszaadott érték. Az ilyen rendszer működése olyan, hogy a böngészőben beírt információt megkapja a WEB szerver, átadja a CGI programnak, ami az információ birtokában feldolgozza és visszaküldi a WEB szervernek, amely továbbítja a böngésző felé HTML kód formájában. A CGI programok vagy a szerver operációs rendszerén futni képes programok, amelyeket valamilyen nyelven, pl. C-ben írtak meg és fordítottak le, vagy úgynevezett scriptek, amelyek egy értelmező program közreműködésével futnak. A PHP programokat egy ilyen értelmező futtatja a szerveren akkor, ha a böngésző PHP, PHP3, PHP4, vagy hasonló kiterjesztésű file-okra hivatkozik. Ekkor a WEB szerver meghívja a PHP értelmező programot (interpretert), amely értelmezi a kérdéses oldalt, majd az eredményt Web oldal formájában visszaadja a WEB szervernek, amely továbbítja a böngészőnek.

6

Tehát a PHP program egy WEB szerveren futó script, amelynek az eredménye egy WEB böngészőn keresztül jelenik meg. Ha valaki már találkozott HTML oldalakon Javascriptekkel, vagy Vbscriptekkel, akkor lehet fogalma arról, hogy miről is van szó, ugyanakkor lényeges különbség van a kétféle megoldás között. Míg a Javascriptek és a Vbscriptek a böngészőn hajtódnak végre, addig a PHP scriptek a szerveren. Ennek több előnye van, például sokkal bonyolultabbak lehetnek, el lehet rejteni a tartalmukat a kíváncsi tekintetek elől, nincsenek a böngésző képességeihez kötve. A PHP script a böngészőn soha nem jelenik meg (ha megjelenik, akkor baj J), csak az a HTML vagy egyéb kód, amelyet előállít. A böngésző kérése nyomán a PHP értelmező megkapja az oldal helyét, nevét és az esetleges bemenő paramétereket valami.php ⇒

Böngésző

valami.php WEB szerver

⇒

PHP értelmező

A kívánt oldalt betölti az értelmező, feldolgozza, és az eredményt visszaküldi HTML kód Böngésző

⇐

HTML kód WEB szerver

⇐

PHP értelmező

⇐

valami.php

A PHP értelmező a fejlődése során egyszerű script futtató programocskából komoly fejlesztőeszköz lett.

7

2 Milyen rendszeren használható? 2.1.1

Milyen operációs rendszer?

Gyakorlatilag létezik az összes elterjedt operációs rendszeren, Win32, Linux, Solaris, BSD, hogy csak a legismertebbeket írják le. Ezeken a rendszereken futó sok-sok WEB szerver segítségével lehet futtatni. Gondolva a tanulásra és az általában meglévő számítástechnikai környezetre a Windows 98, ME, NT, W2000 operációs rendszert ajánljuk. Magyarázat: Miért nem LINUX? Azok részére, akik most tanulják a nyelvet nem célszerű olyan rendszert használni, amelynek nem ismerik eléggé a tulajdonságait. Az oktatásban elsősorban Windowsos rendszereket használnak.

2.1.2

Milyen WEB szervert?

A PHP telepítése előtt mindenképpen szükségünk lesz egy működő WEB szerverre. Nyilván most nem az a feladatunk, hogy egy WEB szerver telepítését bemutassuk, de ha a Windows NT-t használjuk és a Service Pack 5-öt feltelepítettük, akkor lesz IIS4-ünk. A Windows 2000 alatt eleve a rendszer része, Win9x alatt pedig a Personal WEB Servert használhatjuk alapértelmezetten. Ennek ellenére mi az Apache WEB szervert ajánljuk, annak egyszerű telepítése, egyszerű beállítása miatt. Megjegyezzük, hogy az Apache beállítása majdnem ugyanaz LINUX alatt és Win32 alatt is, tehát ennek a rendszernek a használatakor nagyon kis különbségek kellenek a LINUX-os verzióra való átálláshoz. A későbbiek során bemutatunk egy olyan összeállítást is, amellyel egyszerűbb PHP programokat tudunk futtatni WEB szerver nélkül is, Win9x, ME, NT, W2000, XP rendszeren! Én Windows 2000 és Apache 1.3.xx valamint Windows XP és Apache 2.0.xx rendszerrel is használom. Hol találok szolgáltatót, aki futtat PHP scripteket, esetleg adatbázist? Az utóbbi időben többen is vállalkoznak erre a szolgáltatásra. Jelenleg tudomásom szerint a következő szolgáltatók hajlandók futtatni ingyen php-t: http://www.f2s.com ingyen PHP, MySQL, PostGres SQL http://www.swi.hu

pénzes szolgáltató

8

3 A PHP4 telepítése (Win32 változat) A PHP telepítése operációs rendszerenként és WEB szerverenként más és más. A telepítésről további információ a http://hu.php.net és a http://www.php4win.de oldalakon található. A PHP csomagot letöltve kapunk egy tömörített állományt, amelyet kibontva az alábbi könyvtárstruktúrát kapjuk.

3.1

Könyvtárak

browscap: A browscap.ini file-t tartalmazza. Ez a file az egyes böngészőtípusok adatait, tulajdonságait tartalmazza. dlls: Itt olyan dll-ek vannak, amelyekre a php-nek és néhány kiterjesztésnek van szüksége. Ezeket másold be a windows/system (Win9.x) vagy a winnt/system32 (Windows NT, Win2000) könyvtárba. Ha ezek léteznek már az adott helyen, csak akkor írd felül a régieket, ha a rendszer nem működik. extensions: A php kiterjesztéseit tartalmazó könyvtár. keys: Az mcrypt-hez kulcsok. Az mcrypt még nem működik. licenses: Több licence-et tartalmaz. mibs: Az SNMP használata esetén szükséges. pdf-related:Az itt lévő fontok a PDF kiterjesztés használatához kellenek. Olvasd el az ezzel kapcsolatos licence-t. pear:

The pear archive captured at the build date.

readme:

Readme file-ok különböző témákban

sapi:

Natív server api-kat tartalmaz. Az ajánlott a CGI verzió. Ezen kívül választhatod még ezeket: - php4-module a win32 Apache szerver sapi-ja, - ISAPI - az IIS4/5 sapi-ja, - NAPI - a netscape enterprise server és a php4 servlet verziója

tests:

A PHP működésének teszteléséhez használható program van itt.

A PHP értelmező általában a C:\PHP\PHP.EXE program, amelynek manapság Windows NT/W2000/XP környezetben a \WINNT\SYSTEM32\PHP\PHP.EXE helyet ajánlják, de én nem ide teszem. Szerintem az utólagos frissítések miatt célszerű valamelyik meghajtó gyökeréből nyíló könyvtárba tenni, például C:\PHP. A PHP konfigurálásához szükség van egy PHP.INI nevű file-ra, amelynek a Windows könyvtárba kell kerülnie. Ennek a file-nak a mintája php.ini-dist néven a PHP könyvtárban található telepítéskor. A megfelelő sorokat átírva van egy működő konfigurációnk. A későbbiek során megnézzük, hogy milyen változtatások szükségesek a PHP.INI-ben, a gyorsabb működés érdekében.

9

3.2

Telepítés

Mindenekelőtt csomagold ki a PHP-t a C:\PHP könyvtárba, majd másold a php4ts.dll-t a C:\WINDOWS\SYSTEM vagy a C:\WINNT\SYSTEM32 könyvtárba! Másold a php.ini-dist file-t a rendszer gyökérkönyvtárba, ahol a Windows van, majd nevezd át PHP.INIre. Szerkeszd át a PHP.INI-t, szükség szerint (a későbbiekben bemutatjuk, hogy mit érdemes átszerkeszteni).

3.2.1

Apache WEB szerver 1.3.xx vagy 2.0.xx

1. Telepítsd az Apache szervert. Ez a telepítőt tartalmazó MSI file vagy az .EXE kiterjesztésű file esetén az önkicsomagoló file futtatását jelenti. 2. Állítsd le az Apache Webszervert. 3. Az Apache szerver konfigurációs állománya például az C:\Apache\conf\httpd.conf file. Szerkeszd meg ezt a file-t, az alábbi módon: Apache modul esetén: # Apache modul esetén LoadModule php4_module c:/php/sapi/php4apache.dll AddType application/x-httpd-php .php4

Másold be a \Winnt\system32 vagy a \windows\system könyvtárba a php4ts.dll file-t CGI modul esetén: #for the cgi bináris esetben ScriptAlias /php4/ "C:/php/" Action application/x-httpd-php4 "/php4/php.exe" AddType application/x-httpd-php4 .php

Sajnos jelenleg az Apache modul nem fut a 2.0.xx-es verzióban. 4. Keresd meg a DirectoryIndex parancsot a konfigurációs állományban és egészítsd ki az alábbi módon DirectoryIndex index.html index.php index.php3 index.php4

5. Indítsd újra az Apache szervert, 6. Írd meg a kedvenc ASCII editorod segítségével az alábbi tartalmú scriptet, mentsd el a szervered gyökérkönyvtárába, majd hívd meg a böngészőben az alábbi módon:

7. Próbáld ki az alábbi programocskát a Böngésződdel a szervered root könyvtárából: http://localhost/proba.php

Ennek hatására lefut a script és kiírja a böngésződbe az éppen használt php rendszer rengeteg paraméterét.

3.2.2

Internet Information Server 4 vagy 5

Indítsd el a Microsoft Management Console-t vagy az Internet Services Manager-t, a Control Panelről. Kattints a Webszerverre és válaszd a properties-t. Ha nem akarsz HTTP Authentication-t használni a PHP-vel, akkor átlépheted ezt a lépést. Az ISAPI Filters (ISAPI szűrők) alatt add hozzá az új ISAPI szűrőt. Használd a PHP nevet a szűrő nevének, majd keresd meg az php4isapi.dll-t, a C:\PHP\sapi\php4isapi.dll útvonalon. 10

A Home Directory alatt, kattints a Configuration (Konfiguráció) gombra. Új bejegyzést kell felvenni, az Application Mapping-be (Alkalmazások Hozzárendelése). Használd a C:\php\sapi\php4isapi.dll-t és állítsd Executable-re (Futtatható), .php legyen a kiterjesztés, Method exclusions-nál állítsd be az engine checkbox-ot. Állítsd le az IIS-t. Indítsd újra. az IIS-t Írd meg a kedvenc ASCII editorod segítségével az alábbi tartalmú scriptet, mentsd el a szervered gyökérkönyvtárába, majd hívd meg a böngészőben az alábbi módon:

localhost/és próbáld ki az alábbi programocskát a Böngésződdel a szervered root könyvtárából: http://localhost/proba.php

Ennek hatására lefut a script és kiírja a böngésződbe az éppen használt php rendszer rengeteg paraméterét.

3.2.3

Personal Web Server 4 vagy újabb (Win98)

Szerkeszd meg a csomagban lévő PWS-php4isapi.reg (ISAPI interface) file-t vagy a PWSphp4cgi.reg (CGI interface) file-t, hogy arra könyvtárra mutasson, ahol a php4isapi.dll / php.exe található. Pl. [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\w3svc\parameters\ScriptMap]".php"="C:\\PHP\ \php4isapi.dll"

A PWS Manager-ben jobb egérrel kattintva, a megfelelő könyvtárhoz add hozzá a PHP support-ot (támogatás), válaszd a Properties-t (Tulajdonságok). Állítsd be az 'Execute' ’végrehajtható’ tulajdonságot.

3.2.4

Szerver nélküli használat:

Bontsd ki a C:\PHP könyvtárba a csomagot. Az alábbi batch file-t készítsd el, a megfelelő útvonalakkal C:\php\php.exe %1 >%Temp%\phptemp.htm C:\Progra~1\Intern~1\iexplore %Temp%\phptemp.htm

A batch file-t paramétere a php file legyen. A második sorba az általad használt böngésző elérését kell beírni Írd meg a kedvenc ASCII editorod segítségével az alábbi tartalmú scriptet, mentsd el a szervered gyökérkönyvtárába, majd hívd meg a böngészőben az alábbi módon:

Hívd meg a megírt batch file-t az alábbi módon: Test.bat proba.php

Ennek hatására lefut a script és kiírja a böngésződbe az éppen használt php rendszer rengeteg paraméterét. A CGI verzió stabilabb a Windows rendszerekben, az ISAPI verziók alkalmanként összedönthetik a rendszert. 11

4 Eszközök a PHP használatához Felmerül a kérdés, hogy mi kellhet a PHP használatához a fentieken kívül. A várakozással ellentétben nem sok, de azért itt összefoglalom a lehetőségeket: Kell egy ASCII szövegszerkesztő, kezdetben jó a NOTEPAD.EXE a Windowsból is. Ha ennél komolyabbra vágysz, akkor válaszd mondjuk az EditPlus nevű editort, amely a http://www.editplus.com címről tölthető le. Számozza az oldalakat, és még a szintaktikát is színezi. Ezen kívül sok más hasonló editor van forgalomban. A nagyok közül tudnám ajánlani a Macromedia Dreamweaver Ultradev 4 vagy a Dreamweaver MX csomagot is. Nem árt, ha van egy jó HTML editorod, mert a php oldalak jelentős részben azért HTML kódból is állnak. A freeware vagy shareware programok között jelentős választék van, pl. CoffeCup. Kell egy böngésző, ami adott az újabb Windows-okban Internet Explorer 4/5/6. Használhatod a Netscape Navigator-t (www.netscape.com), illetve az Opera legújabb változatát is. Talán ez utolsó a legkisebb és leggyorsabb. Az opera letölthető a www.opera.com -ról. Szükséged lesz egy jó Help-re. Én a http://hu.php.net/docs.php oldaláról a CHM (Windows-os Help file) változatot javaslom, de használhatod a HTML verziókat is, és ha gyors Internet kapcsolatod van, akkor a Internetről is lehet online módon használni őket. Nem árt, ha a HTTP-ről is van egy jó Help-ed. A http://www.htmlhelp.com/ -ról letölthető többféle formában, köztük Windows-os Help formájában a HTML nyelv szintaktikája. Nem ide tartozik, de gyakori, hogy a php scripteket vegyítjük Javascriptekkel is. Erre a célra több forrás létezik, de sajnos magyar nyelven és Windows-os Help formájában nem tudok róla: Talán célszerű a következőt Web oldalt használni http://weblabor.hu/leiras/javascr/ vagy megnézni az alábbi oldalt: http://www.szily.sulinet.hu/jegyzetek Letölthető állapotú változat az ftp://ftp.szily.sulinet.hu/jegyzetek/Javascript/ könyvtárban található. Szükség lehet egy jó HTML/ Javascript könyvre, például Bócz Péter – Szász Péter: A világháló lehetőségei

12

5 Egy HTML és egy PHP oldal szerkezete Mielőtt továbbmennénk nézzük, mit akarunk programozni? Hogyan is néz ki egy HTML oldal: <TITLE>Proba web oldal
Hello World!!!

Na ez nagy durranás volt. A bekezdéses írásmódot az áttekinthetőségért használok, de mint látjuk később, ez rendkívül fontos! A böngészők a sor vége jelet, a szóközöket és a tabulátor jeleket kihagyják, ezért akár az egészet egy sorba is írhatnánk. A fenti HTML oldalt az alábbi php scripttel tudjuk előállíttatni: <TITLE>Proba web oldal

Tisztán látszik, hogy a program szerkezete nagy vonalakban ugyanaz, de azért vannak különbségek. A PHP értelmező a kód első sorait változatlanul továbbítja a Web szervernek, de amikor a tag jelzi az értelmezőnek a PHP script végét. Egy oldalon többször is megnyithatjuk a scriptet és bezárhatjuk, azaz keverhetjük a php és a HTML kódot, sőt ha van merszünk, akkor beiktathatunk javascriptes részeket is. Az alábbi lehetőségeink vannak arra, hogy php scriptet helyezzünk el egy oldalon: <script language=”PHP”> ..... php kód ...

Ha beírjuk a PHP.INI-ben, a short_open_tag= on sort, akkor ez a megoldás is lehetséges:

Ha beírjuk a PHP.INI-be az asp_tags = on sort, akkor használható az alábbi szintaktika is: <% ..... php kód ........%>

Speciális lehetőség. Ha egy változó értékét szeretnénk csak kiiratni és a short_open_tag = on sor be van írva, akkor egy változó értékét így adhatjuk át a web oldalnak legegyszerűbben:

13

6 A PHP szintaktikája A PHP nyelv szintaktikája nagyon hasonlít a C nyelvére, ezért sokak számára nem lesz túlságosan idegen. A php scriptben lévő utasítások mindegyike után kötelezően ki kell tenni a ; elválasztójelet. Megjegyzés: Bár a dokumentáció azt mondja, hogy egy záró tag előtt nem kell kitenni, azért azt tanácsolom, hogy megszokás céljából mindenhol alkalmazzuk A Megjegyzéseinket szintén C jellegű szintaktikával kétféleképpen tehetjük ki: //

Az egysoros kommentek, a sor végéig tarthatnak, mint a C-ben

#

jellel, mint a Unixos shell programoknál

/*...................................*/

A több soros kommentek

Amint látjuk a fentiek alapján a kiírandó szöveget ”…” jelek közé tehetjük, de a jelpáros lehet ’...’ is. A továbbiakban nézzük meg, hogy milyen típusú értékekkel dolgozhatunk.

14

7 Változók, adattípusok A PHP-ben használhatunk változókat is. A változó neve előtt mindig $ jel található.

7.1

A változó neve

A változó neve betűvel vagy aláhúzás jellel kezdődik és bármilyen alfanumerikus karakterrel, illetve 127...255 ASCII kódú karakterrel folytatódhat. A kis és nagybetűk különböznek!

7.2

A változó értéke

Amikor először adunk értéket egy változónak, akkor jön létre a változó. $a = 5; $todo = ”szöveg”;

Ha egy változó értékét azelőtt vizsgáljuk meg, mielőtt értéket adunk neki, az értéke NULL lesz. Egy változó típusát többféleképpen lehet meghatározni. -

Értéket adunk neki, az érték alapján létrejött változónak a típusa is egyértelművé válik.

Beállítjuk a típusát a settype (“változónév”, “típus”) paranccsal, ahol a típus az alábbiak közül választható: "integer", "double", "string", "array", "object" -

Típuskonverziót alkalmazunk. Az alkalmazható típusok ugyanazok, mint a fenti példában, hozzávéve, hogy az ”integer” lehet ”int” is, a ”double” lehet ”float” és ”real” is. $a = (int) $b $c = (string) $d

A változók értékadásakor használhatunk hasonló trükköket, mint a C-ben: $a = $b = 5

A fenti kifejezést úgy kell értelmezni, mintha az alábbiakat írtuk volna le: $b = 5; $a = b;

A későbbiekben foglalkozunk részletesen az operátorokkal, amelyek egy változó értékét meghatározzák. A változónak bármilyen módon értéket adtunk, akkor a típusát is meghatároztuk.

7.3

A változók és kifejezések típusai

A különböző programozási nyelveken megszokott típusok a PHP-ban is megtalálhatók: Numerikus típusok: int, integer - egész típus – értéke –32768-32767-ig tart Float, double, real – Lebegőpontos String A C-ben használt string fogalomhoz hasonló, ”...” vagy ’....’ jelek közé írt ASCII karaktersorozat. Array Tömb típus. A tömb elemi tetszőlegesen vegyesek lehetnek Egy tömb lehet egy, két és több dimenziós tömb is. A tömb indexelése történhet hagyományosan 0-tól kezdődő indexeléssel, vagy lehet úgynevezett asszociatív tömböt is létrehozni, amikor a tömbindex valamiféle string, vagy egyéb érték. Ebben a példában egy dimenziós tömböt hozunk létre. $array = array (1, "hello", 1, "world", "hello");

15

Az alábbi példában kétdimenziós asszociatív hozunk létre. $fruits = array ( "fruits" => array ("a"=>"orange", "b"=>"banana", "c"=>"apple"), "numbers" => array (1, 2, 3, 4, 5, 6), "holes" => array ("first", 5 => "second", "third") );

Object - Objektum. A típus hasonlít a C++ objektumaira, de vannak lényeges különbségek is. Egy objektum típusú változó létrehozásához először definiálni kell magát az osztályt a class kulcsszóval, hasonlóképpen, mint C++ -ban, majd a definíció után a new() operátorral létre lehet hozni a megfelelő változót. A class részét képezik változók és a classhoz tartozó függvények is. A későbbiekben részletesen is szólunk az objektumokról. Az alábbiakban egy példát látunk.
// A kosárban levő dolgok

function berak ($sorsz, $db) { // berak a kosárba $db darabot az $sorsz indexű dologból $this->dolgok[$sorsz] += $db; } function kivesz ($sorsz, $db) { // kivesz a kosárból $db darabot az $sorsz indexű dologból if ($this->items[$sorsz] > $db) { $this->items[$sorsz] -= $db; return true; } else { return false; } } } $a = new Kosar; ?>

boolean – Logikai értékek. Két érték előre definiált, a TRUE és a FALSE null - Olyan változók, amelyeknek nincsen beállított értékük Resource – Erőforrások, mint például file vagy adatbáziskezelő mutatója. Valójában ezek a memória egyes helyére mutató pointerek! Unknown type - Ismeretlen típusok Változók és kifejezések visszatérési értékének típusát le lehet kérdezni az alábbi függvényekkel: int empty ($a)

Megadja, hogy a változó üres volt-e vagy nem.

string gettype ($a)

Visszaadja a változó típusát. A lehetséges típusok az alábbiak: "integer", "double", "string", "array", "object", "unknown type"

void settype($var,$type)

Beállítja egy változó típusát. A lehetséges típusok ($type) lehet: "integer", "double", "string", "array", "object"

int intval($a,[$alap])

Visszaadja a változó értékét egésszé konvertálva a megadott alapú számrendszerben. Az alap default értéke 10.

int is_array($a)

Megadja, hogy a változó tömb vagy sem

int is_bool($a)

Megadja, hogy a változó logikai típusú vagy sem

int is_float ($a) int is_double ($a)

Megadja, hogy a változó lebegőpontos-e, vagy sem.

16

int is_real ($a) int is_long ($a) int is_integer ($a) int is_int ($a)

Megadja, hogy a változó egész vagy sem.

int is_numeric ($a)

Megadja, hogy a változó numerikus, numerikus szöveg vagy sem.

int is_object ($a)

Megadja, hogy a változó objektum vagy sem

int is_resource ($a)

Megadja, hogy a változó erőforrás azonosító vagy sem (pl. file handler)

int is_string ($a)

Megadja, hogy a változó string vagy sem.

int isset (változó)

Megadja, hogy be van-e állítva a változó. A visszatérési értéke hamis, ha nem és Igaz, ha van értéke a változónak

void print_r(kifejezés)

Ember számára olvasható információt ad egy változóról.

7.4

Előre definiált változók

A változók között vannak olyanok, amelyek a rendszerben előre definiáltak. Ezeknek a változóknak a nevét és pillanatnyi értékét a phpinfo() függvény segítségével lehet kiíratni. A változókra hivatkozva természetesen az értékeket fel tudjuk használni, és azt tudjuk manipulálni. Ezen változóknak az értékét a PHP.INI file-ban lehet beállítani, néhány érték a használt WEB szervertől függ, további értékek pedig a futtató operációs rendszertől függnek. A változók másik nagy csoportjai a rendszerben alkalmazott modulok értékei. Néhány fontosabb változó csoport

7.4.1

PHP Core – A PHP rendszer alapvető változóinak a listája

A rendszer beállításait, és alapértelmezett paramétereit tartalmazó változólista.

7.4.2

Environment

Az operációs rendszerről, a környezeti beállításokról, a WEB szerverről, a böngészőről, az aktuálisan meghívott lapról és a kliensről minden lényeges adatot felsorol, beleértve az IP címeket is.

7.4.3

PHP Variables - A PHP változók listája

További gyakran használt változók tömbjei a szerver által szolgáltatott tömb és a $_SERVER[”PATH”]

A környezeti változók $HTTP_ENV_VARS vagy $_ENV[”valtnev”]

Formok kezelésénél használható változók listája a GET metódussal elküldött változók listája és értékei $_GET[”valtnev”]

Post metódussal elküldött változók listája és értékei $_POST[”valtnev”]

17

Sessionokben használt változók listája és értékei $_SESSION[”valtnev”] $GLOBALS[”valtnev ”]

a szuperglobális változók. Bárhol elérhetők az értékei $_COOKIE[”valtnev”]

A PHP 4.1.0-tól ez a szuperglobális tömb is létezik A HTTP protokollban definiált további változók. Ezek közül a változók közül néhány megtalálható a környezeti változók között is. A szerver IP címe Echo $REMOTE_ADDR

a szerver neve $REMOTE_HOST

a lekért oldal azonosítója $HTTP_REFERER

a szerverhez kapcsolódó böngésző fajtája, az operációs rendszer fajtája $HTTP_USER_AGENT

a WEB oldalnak átadott paramétersztring (a.php?A=proba) $QUERY_STRING

Az aktuálisan futtatott PHP oldal azonosítója: $_SERVER["PATH_TRANSLATED"]

A szerveren lévő WEB szerver gyökérkönyvtára $_SERVER["DOCUMENT_ROOT"]

Az alábbiakban egy példát mutatok be a fenti változók használatából: A pár sort beszúrva egy script elejére előűllítja konstans formában az aktuálisan futó script elérési útvonalát, továbbá a WEB szerver dokumentumainak elérési útvonalát. $path=dirname($_SERVER["PATH_TRANSLATED"]); DEFINE("PATH",$path); DEFINE("DOCROOT", $_SERVER["DOCUMENT_ROOT"]);

7.5

Konstansok

A PHP-ben vannak előre definiált konstansok, továbbá mi is definiálhatunk a define(nev, érték) parancs segítségével.

Az előre definiált konstansok közül néhány: _FILE_

az éppen futtatott file neve

_LINE_

az éppen futó programsor

PHP_VERSION

a futtatott rendszer verziószáma

PHP_OS

a futtató operációs rendszer

TRUE, FALSE

logikai értékek

18

8 Alapvető utasítások Aki a Pascal nyelven nevelkedett megszokta, hogy a definiciós és a végrehajtható utasításoknak kötött sorrendje van. A C nyelv és többek között a PHP tartalmaz előírásokat az utasítások sorrendjére, de azok nem annyira kötöttek, ezért aztán nagyon könnyű áttekinthetetlen és rosszul működő programot írni bennük. Ahhoz, hogy gyorsan tudjunk egy programot írni, ismertetünk néhány utasítást.

8.1

Echo

A PHP egyik leggyakrabban használt utasítása az echo. Segítségével a böngészőbe ki lehet írni a program futásának eredményét. A kiíratás során gondolnunk kell arra, hogy az eredmény egy HTML kód mindig, amit majd a böngésző tovább értelmez. Az egymás után ír echo parancsok az eredményt egymás után írják ki a kimenetre, pozicionálás, visszalépés a szövegben nem lehetséges. Ha a kiírás után új sorban szeretnénk kezdeni a kiírást, akkor a HTML szerint egy
tag-et (soremelés) vagy kell kiírni. Az alábbiakban több soros kiírást alkalmazunk: ”; echo ”Mit sütsz kis szücs?
”; ?>

A numerikus eredmények kiírására is használhatjuk ezt az utasítást, azonban formátumozni nem tudjuk a kimenetet így.

5; 6; $a + $b; ”Mit sütsz kis szücs?
”;

További probléma, hogy mi van akkor, ha numerikus információt és string-et akarunk egy szövegben kiírni. A feladat megoldáshoz ugyanazt kell használnunk, mint amikor két string-et akarunk összefűzve kiírni. ”; ?>

A fenti példában az echo parancs az összeadás műveletét string-gé konvertálta és így íratta ki. A konverzió teljesen automatikus. További érdekes lehetőség, amikor egy string-ben szeretnénk kiíratni egy változó értékét: ”; ?>

Amint látjuk, a korábbi megfontolások alapján a soremelést a HTML szerint kell használnunk. Az alábbiakban néhány gyakran használt tag-et írunk le. A használható tag-ek tárát egy HTML kódolással foglalkozó könyvből, jegyzetből vagy Internet helyről meg lehet tudni. A képernyőn való soremelésre a
tag szolgál. Vízszintes vonal írására
Paragrafus eleje, vége:
....
Vastag betű .... 19

Dőlt betű .... Táblázat létrehozásáraLaz alábbi példa egy soros, két oszlopos táblázatot hoz létre)

első oszlop

masodik oszlop

Stb.... Mivel a fenti TAG-ek sztringek, ezért célszerűen az echo paranccsal kell kiiratnunk őket. Az echo egy nyelvi elem és nem függvény, azaz valami olyasmi, mintha C-ben egy függvénymakrót hoznánk létre. Éppen ezért bonyolultabb kifejezések kiiratásához alkalmatlan! Ha az adatokat formázottan szeretnénk kiírni, akkor a printf parancsot kell használni

8.2 print()

Formázott kiírás – Ugyanaz, mint az Echo, csak a szintaktika kissé más.

printf()

– kiiratás formázottan

sprintf()

– formázott sztringet ad vissza az alábbi szintaktika szerint:

string sprintf (string formátum [, mixed paraméterek...]) A fromátum szerint megadott karaktersorozattal tér vissza. A formátumkarakterek lényegében a C-ben megszokott formátumkarakterek. A formátumstring több direktívát tartalmazhat. A % string vezeti be a direktívákat, majd utána következnek a formázó karakterek. Ezeken kívül minden karakter megjelenik a kimeneten. A kimenet konverziós parancsait a printf() és az sprintf() parancsban ugyanúgy lehet használni. A konverziós parancssorozat az alábbi parancsokat tartalmazza: Opcionális kitöltő karakter. Ezzel lehet a stringet megfelelő méretre kitölteni. Default értéke a szóköz. Ezen kívül lehet a 0, vagy egyéb karakter. Igazítás karakter. Az eredmény balra vagy jobbra igazított lesz. A default a jobbraigazítás; a – karakter igazítja balra. Szélesség meghatározó. Megmondja, hogy minimum hány karakter legyen az eredményben. A tizedes jegyek száma. Csak a double formátum esetén hatásos. (A számformátumokat number_format() függvénnyel tudjuk még jól kezelni.) A típusmeghatározó megmondja, hogy milyen típusú adatokat kell kezelnie. Lehetőségek: % - a % jel. b – az argmentum integer, és bináris számként jelenítjük meg c – az argumentum integer, ASCII kódként jelenítjük meg. d – az argumentum integer, decimális számként jelenítjük meg. f - the argumentum double és lebegőpontos számként jelenítjük meg. o - az argumentum integer, és oktális számként jelenítjük meg. s – az argumentum string és így is jelenítjük meg.

20

x - az argumentum integer és hexadecimális számként jelenítjük meg (kisbetűvel) X - az argumentum integer és hexadecimális számként jelenítjük meg (nagybetűvel)

$isodate = sprintf ("%04d-%02d-%02d", $ev, $ho, $nap); $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; // Az echo $money kimenete "123.1" lesz $formatted = sprintf ("%01.2f", $money); // Az echo $formatted kimenete "123.10" echo $money; echo $formatted;

8.3

A kiiratás gyakorlása

1. Írasd ki PHP programmal egy általad ismert tetszőleges vers első négy sorát, soronként! 2. Írasd ki egy tetszőleges dalszöveget egy táblázatba, versszakonként egy- egy oszlopba! 3. Írasd ki egymás után a 1-től 20-ig a négyzetszámokat jobbra igazítval!

21

9 Operátorok (műveletek) A következőkben megismerjük, hogy milyen műveleteket végezhetünk a különböző adattípusokkal.

9.1

Stringek közötti műveletek

Stringek összefűzése: . $a = ”alma”.”körte” ; echo $a; //eredménye ”almakörte” lesz

Stringek hozzáadása meglévő sztringhez: .= $a = ”meleg”; $a .= ”víz”; $echo $a; // eredmény: melegvíz

9.2

Aritmetikai műveletek

A numerikus értékek összeadására ugyanolyan operátorokat használunk, mint más nyelvekben. echo echo echo echo echo

9.3

$a $a $a $a $a

+ * / %

$b; $b; $b; $b; $b;

//$a és $b összege //$a és $b különbsége //$a és $b szorzata //$a és $b hányadosa (egész, ha $a és $b egészek és a hányados egész) //Modulus $a / $b maradéka

Hozzárendelés, értékadás

Az operátor az "=". Ez ugyanazt jelenti, mint Pascalban a := vagy C-ben az =. A bal oldal értéke legyen az, ami a jobb oldalé. A hozzárendelő kifejezésnek az értéke a bal oldalhoz rendelt érték. $a = ($b = 4) + 5; // $a most 9, és $b 4

9.4

Növelő/csökkentő operátorok

A PHP támogatja a C-ben megismert inkrementáló és dekrementáló operátorokat. Az alábbiakban megismerjük azokat, majd példát látunk rájuk: Amikor az operátor a változó előtt van, akkor a kiértékelés során először növekszik a változó értéke, majd értékeli ki a rendszer, míg a változó mögötti operátor esetén először kiértékeli a változót a rendszer, majd növeli vagy csökkenti az értékét!

// // // //

Növeli $a-t eggyel, majd visszaadja $a értékét Visszaadja $a értékét, majd növeli $a-t eggyel Csökkenti $a-t eggyel, majd visszaadja $a értékét Visszaadja $a értékét, majd csökkenti $a-t eggyel

Itt egy másik példaprogram: Postinkrementálás"; $a = 5; echo "5-nek kell lennie: " . $a++ . "
\n"; echo "6-nak kell lennie: " . $a . "
\n"; echo $a = echo echo

"
Preinkrementálás
"; 5; "6-nak kell lennie: " . ++$a . "
\n"; "6-nak kell lennie: " . $a . "
\n";

echo $a = echo echo

"
Postdekrementálás
"; 5; "5-nek kell lennie: " . $a-- . "
\n"; "4-nek kell lennie: " . $a . "
\n";

22

echo $a = echo echo ?>

9.5

"
Predekrementálás
"; 5; "4-nek kell lennie: " . --$a . "
\n"; "4-nek kell lennie: " . $a . "
\n";

Logikai operátorok

A logikai műveletek minden programozási nyelvben hasonlóan néznek ki. Az alábbi lehetőségek vannak. A PHP-ben az igaz értéket mindig az 1 és a hamis értéket a 0 hordozza. Ennek a tudásnak a birtokában ugyanakkor nem célszerű a 0 és 1 értékeket numerikusan használni.

9.6

//És //Vagy //Kizáró vagy //Tagadás //És //Vagy

Csak akkor igaz, ha mind $a mind $b igazak Akkor igaz, ha $a és $b között van igaz Akkor igaz, ha $a és $b közül pontosan egy igaz Igaz, ha $a nem igaz Csak akkor igaz, ha mind $a mind $b igazak Akkor igaz, ha $a és $b között van igaz

Összehasonlító operátorok

Az összehasonlító operátorok, mint nevük is sugallja, két érték összehasonlítására szolgálnak. Az eredmény igaz, vagy hamis lehet! Echo $a == $b; //Egyenlő Igaz, ha $a és $b értéke egyenlő $b; //Nagyobb mint Igaz, ha $a szigorúan nagyobb, mint $b echo $a <= $b; //Kisebb, vagy egyenlő Igaz, ha $a kisebb, vagy egyenlő, mint $b echo $a >= $b; //Nagyobb, vagy egyenlő Igaz, ha $a nagyobb, vagy egyenlő, mint $b ?>

Van egy feltételes operátor is, a "?:" (ternális) operátor, ami úgy muködik, mint a C-ben és sok más nyelvben. (kif1) ? (kif2) : (kif3);

A kifejezés kif2-t értékeli ki, ha kif1 igaznak bizonyul, és kif3-at, ha kif1 hamis.

9.7

Bitorientált operátorok

A bitorientált operátorok teszik lehetővé, hogy egy egész érték bizonyos bitjeit beállítsuk, vagy kimaszkoljuk. > $b

//És Azon helyeken, ahol mind $a-ban, mind $b-ben '1' volt, az eredményben '1' lesz, egyébként '0'. //Vagy Ott lesz '1' az eredmény, ahol vagy $a-ban, vagy $b-ben '1' állt. //Kizáró vagy Ott lesz '1', ahol vagy $a-ban, vagy $b-ben '1' áll, de csak az egyikben. //Nem $a összes bitjét invertálja //Eltolás balra $a bitjeit $b-vel balra tolja (minden tolás 2-vel való szorzást jelent [amíg el nem fogynak a bitek. A legfelső helyiérték az előjelbit.) //Eltolás jobbra $a bitjeit $b-vel jobbra tolja (minden tolás 2-vel való

23

// //

[egész!]osztást jelent. Mivel a legfelső bit az előjelbit, negatív szám jobbra tolása fura eredményre vezet!)

?>

9.8

Hibakezelő operátorok

A PHP egy hibakezelő operátort támogat, az at (kukac) jelet (@). Ha egy PHP kifejezés elé írod, a kifejezés által esetlegesen generált hibaüzenete(ke)t figyelmen kívül hagyja a rendszer. Ha a track_errors szolgáltatás be van kapcsolva, bármilyen a kifejezés által generált hibaüzenet a $php_errormsg globális változóba kerül tárolásra. Ez a változó minden hiba esetén felülíródik, ezért ellenőrizd minél hamarabb a kifejezést követően ha használható információt szeretnél kapni.

Lásd még: error_reporting().

9.9

Végrehajtó operátorok

A PHP-segítségével utasításokat hajthatok végre az operációs rendszeren. A jel a visszaidézőjel ``. Ha közéjük írok egy parancsot az operációs rendszer részére, akkor az megpróbálja végrehajtani és egy változónak átadni az eredményt. [Az alábbi kis példa az aktuális könyvtár tartalmát (hosszú lista, rejtett fájlok is) formázva írja ki (illetve fix szélességű betűket használva, entereket tiszteletben tartva)] $output"; ?>

Ebben a témában az alábbi függvényeket érdemes még megtekinteni a doksiból: system(), passthru(), exec(), popen(), és escapeshellcmd().

9.10 Gyakorló feladatok 1. Irasd ki két változónak az összegét különbségét, szorzatát és hányadosukat, továbbá a maradékot úgy, hogy minden sorba egy érték kerül, továbbá kiiratjuk az operandusokat is! 2. Irasd ki áttekinthető formában egy ember különböző címen megkapott jövedelmeit, a befizetendő adóját és összesaítését! 3. Írd ki az alábbi logikai kifejezés igazságtáblázatát: (A and B ) or not C! 4. Mutasd meg, hogy mi történik akkor, ha negatív számnak a két, három, négy bittel eltolod az értékeit jobbra és balra is! 5. Hívd meg a futtató operációs rendszeren a könyvtár listázó parancsot és irasd ki az eredményét!

24

10 Vezérlési szerkezetek A PHP-ben ugyanúgy, mint más programozási nyelvekben az utasítások végrehajtásának sorrendje alapvetően fentről lefelé. Ily módon csak szekvenciális programokat lehet írni, azonban rövid tanukás után szükségessé válik elágazásokat és ciklusokat tartalmazó programok írása is. A vezérlési szerkezetek, mint mindig itt is a C-hez hasonlóak. A program a különböző irányokba való továbbhaladását általában egy kifejezés határozza meg. Ennek a kifejezésnek az értéke logikai alapvetően, azonban a PHP hasonlóképpen, mint a C nem különböztet meg külön logikai értékeket, hanem a 0 és a nem 0 értékek jelentik azt. Ily módon, ha egy numerikus kifejezés 0, akkor hamis, és ha nem 0, akkor igaznak tekinthető. Ha egy string kifejezés üres, akkor hamis, ha van értéke, akkor igaz. Az olyan változók, amelyeket még azelőtt értékelünk ki, hogy értéket kaptak volna (ez nem helyes), a NULL értékkel bírnak.

10.1 Elágazások Az első fontos lehetőség a feltételhez kötött végrehajtás. Ha bármelyik ágon több utasítást akarunk végrehajtatni, akkor szintén a C szintaktika szerint { ...} jelpárost kell használnunk If( utasítás) ... if(kifejezés) utasítás;

if(kifejezés) { utasítás1; utasitas2; ..... }

If .... else.... Ha a kifejezés igaz, akkor az utasítás1 különben az utsítás2 hajtódik végre. if( kifejezés ) else

utasítás1; utasítás2;

Ha a kifejezés igaz, akkor az utasítás1 ág hajtódik végre, különben a másik if( kifejezés ) { utasítás1; utasitas2; ..... }else{ utasítás3; utasitas4; ..... }

If ... elseif ... else ... Ha kettőnél több elégazást szeretnénk, akkor az alábbi szintaktikával tudjuk a kérdést megoldani: if( kifejezés1 ) elseif(kifejezés2) else

utasítás1; utasítás2; utasítás3;

vagy if( kifejezés1 ) { utasítás1; utasitas2; .....

25

}elseif( kifejezés2 ){ utasítás3; utasitas4; ..... }else { utasítás5; utasítás6; ...... }

Switch(kifejezés) A fenti esetben az if és az elseif utasításnál lévő kifejezések tetszőlegesek lehetnek, és az így felírt vezérlési szerkezettel meglehetősen bonyolult elágazásokat lehet létrehozni. Ezzel szemben általánosabb eset, amikor egy változ értékétől függően akarunk több féle műveletet is végrehajtani. Erre a célra alkalmas a C-ből jól ismert switch() függvény, amely több irányú elágazást hajt végre. Az ágak meghatározásakor csak konstansokat használhatunk, és az ágra akkor adódik át a vezérlés, ha a switch függvényben lévő változó értéke pontosan a konstans értékével egyezik meg. Amennyiben egy ágra ráadtuk vezérlést, majd végrehajtottuk az ott definiált utasításokat, a switch szerkezet végére kell ugranunk a break utasítás segítségével, mivel különben rácsorognánk a következő case feltételvizsgálatokra. Nézzük a szintaktikáját: switch ($i) { case 0: print "i break; case 1: print "i break; case 2: print "i break; default: print "i

most 0";

most 1";

most 2";

se nem 0, se nem 1, se nem 2";

}

A fenti példában az $i változó értékétől függően léptünk valamelyik irányba. Ha a változó értéke nem vette fel sem a 0, 1 vagy 2 értékeket, akkor a default utáni parancs hajtódik végre. Gyakori eset, hogy amikor több különböző eseményt egyetlen változó különböző értékei alapján akarsz végrehajtatni, akkor használod a switch utasítást. Előfordulhat, hogy ugyanazt az eseményt több érték is jelölheti, illetve több különböző esemény van. Az alábbi példában a $jelző változó 0, 1, 2 értéke esetén az fv1() függvény fut le, a 3-as értékre az fv2() függvény, egyéb esetekben az fv3(). switch ($i) { case 0: case 1: case 2: fv1($jelzo); break; case 3: fv2($jelzo); break; default: fv3($jelzo); }

A fenti példában az fv1, fv2, fv3 függvények lehetnek akármik!

26

10.2 Ciklusok Mint a C-ben, itt is hasonló ciklusszerkezetek léteznek. While (kifejezés) Itt a kifejezés a ciklus előtt értékelődik ki, azaz a ciklus magja nem biztos, hogy végrehajtódik. While (kifejezés) utasítás;

While (kifejezés) { Utasítás1; Utasítás2; ... }

Példa:

// a kiírt érték $i, a kiírás után nő $i értéke // Az előző ciklus másképpen, de ugyanazzal az eremdénnyel // a kiírt érték $i, a kiírás után nő $i értéke

Do ..... While(kifejezés) A kifejezés a ciklus végén értékelődik ki, azaz a ciklus magja egyszer mindenképpen lefut. Do

Do{

utasítás while(kifejezés);

Utasítás1; Utasítás2; ... }while(kifejezés);

Példa: 0); ?>

For(inicializáló kifejezés; Benntmaradás kifejezése; iteráló kifejezés) A ciklus elején egyszer fut le az inicializáló kifejezés. Általában ez egy változónak ad egy kezdőértéket. Az ilyen változót ciklusváltozónak hívjuk. A Benntmaradás kifejezése mindannyiszor a ciklus magjának lefutása előtt értékeli ki a rendszer. Ha a kifejezés igaz értéket ad vissza, akkor lefut a ciklus magja, ha hamis értéket, akkor a ciklus utáni első utasításon folytatódik a futás. Ha a kifejezés helyére üres értéket írunk, akkor végtelen ciklusba kerülhetünk, hacsak a ciklus belsejéből nem ugrunk ki a break utasítással. Az Iteráló kifejezés felelős azért, hogy a ciklus valamikor befejeződjön. Általában a ciklusváltozó értékét növeljük vagy csökkentjük eggyel. For (init;bentmaradás;iterácio) utasítás;

For (init;bentmaradás;iterácio){ Utasítás1; Utasítás2 ...... }

Példa:

27

0; $i--) { print $i; } //Írassuk ki egy két dimenziós tömb elemit soronként $a= array( array(3,5,4,6),array(12,234,12,12),array(3,6,5,77)); for ($i =1; $i<= 0; $i--) { for (j=1;j<=4;j++){ print $a[$i][$j].” ”; } print ”
”; } ?>

Foreach ( tömb_kifejezés as $érték) vagy Foreach ( tömb_kifejezés as $kulcs => $érték) Ez a fajta ciklus a Perl nyelvből került át a PHP-be. Ezt a ciklust arra használhatjuk, hogy egy ciklussal végigmenjünk egy tömb minden egyes elemén. Rendkívül jól használható adatbázis lekérdezések vagy egyéb tömbben visszaadott adatok feldolgozása során. Kétféle Foreach ($tömbváltozó as $ertek) utasítás;

Foreach ($tömbváltozó as $ertek){ Utasítás1; Utasítás2 ... }

Példa: $tomb = array (1, 2, 3, 17); foreach ($tomb as $ertek) { print "Az aktuális értéke \$tomb-nek: $ertek.\n"; }

A második formában a $kulcs változó megkapja a tömb éppen aktuális indexét, ezáltal egyes esetekben könnyebb a feldolgozása Foreach($tömbváltozó as $kulcs => $ertek) utasítás;

Foreach ($tömbváltozó as $kulcs => $ertek){ Utasítás1; Utasítás2 ... }

Példa: * harmadik foreach példa: kulcs és érték */ $tomb = array ( "egy" => 1, "kettő" => 2, "három" => 3, "tizenhét" => 17 ); foreach ($tomb as $kulcs => $ertek) { print "\$tomb[$kulcs] => $ertek.\n"; }

break vagy break n A break utasítás arra szolgál, hogy segítségével egy struktúrából az adott helyen ki tudjunk ugrani. Ha utána írunk egy számot, akkor annak alapján több egymásba ágyazott struktúrából is ki tud ugrani: Példának okáért korábban a switch utasításnál mutattunk egy példát a break használatára, az opcionális módra pedig itt van egy példa: $i = 0; while ($i++) { switch ($i) { case 5: echo "5 esetén
\n";

28

break 1; /* csak a switch-ből lép ki */ case 10: echo "10 esetén kilépés
\n"; break 2; /* a switch és a while befejezése */ default: break; } }

continue vagy continue n Bár programozási módszertanok kerülik a ciklusokból való kiugrálást és a ciklusmagon belüli iterációt, azért minden általános nyelvben benne van a lehetőség, beleértve a Pascalt és a C-t is. Ez az utasítás akkor használható, ha a ciklus belsejében már eldőlnek a további iterációra vonatkozó feltételek és nem akarjuk, hogy a ciklus magjának többi részét feleslegesen futtassuk. Ha a continue n formát használjuk, akkor több egymásba ágyazott struktúrát tudunk folytatni. Az alábbi példában 100 db véletlenszámot hozunk létre a 0..4 egész tartományból és az eloszlásukat vizsgáljuk. A continue utasítások hatására ha megvan az érték, további feltételeket nem értékel ki a program, hanem rögtön iterálja a for ciklust.

10.3 Elágazások és ciklusok használata HTML kóddal keverve Gyakori, hogy a HTML oldalon két különböző kódot szeretnénk megjeleníteni, attól függően, hogy éppen melyik feltétel igaz, ugyanakkor a kiírandó HTML részt túl bonyolultan állíthatjuk csak elő PHPben. Ebben az esetben alkalmazni lehet az alábbi példához hasonlót: .......

Szevasz tavasz, a kifejezés igaz

valamit visz a víz

Ez a rész itt egyszerűbb lett!

Az igaz kifejezés esetén az igaz ágban létrejövő egy soros táblának két oszlopa lesz, míg a hamis érték esetén csak a második szakaszban lévő kiírás jelenik meg, mivel a PHP amikor megszakad a PHP kód – itt többször is megszakad -, akkor a szervernek változatlanul adja vissza a HTML kódot. Sajnos az így megírt program kissé áttekinthetetlen.

29

10.4 PHP lapok beszúrása, ”makro”-k használata. Gyakran megfogalmazott feladat, hogy egy több lapból álló PHP programban minden PHP oldal elején fussanak le ugyanazok a beállítások, ugyanazok az inicializáló paraméterek, illetve ugyanazokat a függvényeket és lehetőségeket használjuk minden PHP scriptben. Valami olyasmire gondolok itt, mint Pascal-ban a unit fogalma vagy C-ben a header file-ok fogalma. Erre a célra két parancs áll rendelkezésre, amelyeknek a működése nem pontosan ugyanaz, de nagyon hasonló. Mind a két esetben arról van szó, hogy a PHP script egy adott pontján behívunk egy file-t, amelynek a kódja futásidőben bekerül a PHP scriptbe, a szerver kiértékeli, és annak megfelelően jár el. A file tartalma tehát a futás idejére úgy válik a PHP script részévé, mintha eleve abba beírtuk volna. Mivel a Webszerver kezdi a kérdéses include file-t feldolgozni, ezért ilyenkor HTML módba kerül a szerver, így a PHP kód feldolgozásához az include file elején PHP nyitó tag-et kell elhelyezni és a végén zárótag-et. () Include () Az include használata esetén a megadott file mindannyiszor kiértékelődik, ahányszor a vezérlés az include-ra kerül. Ennek eredményeként, ha egy ciklus belsejében megfelelően helyezzük el a file-t, akkor a ciklus értékétől függően mindig más és más file-t szerkesztünk be, mint az alábbi példában láthatjuk: $fileok = array ('elso.php', 'masodik.php', 'harmadik.php'); for ($i = 0; $i < count($fileok); $i++) { include $files[$i]; }

require() A require parancs akkor is beolvassa a célfile-t, ha soha nem hajtódik végre a kérdéses sor a fő file-ban, és ha ciklusban helyezzük el a kérdéses sort, akkor is csak egyszer kerül be. A fentiek miatt require parancsot csak konstans file-nevekkel szabad használni.

include_once() Az utasítás hasonlít az include() utasításra, azzal a különbséggel, hogy csak egyszer kerül bele a futáskor a kérdéses file. Ez azért fontos, mert ha az include() utasítással többször is meghívjuk futás közben ugyanazt a file-t, akkor a benne lévő globális változók és függvények többször kerülnek a kódba, ami miatt a futás hibaüzenettel leáll, hiszen ugyanaz az azonosító más és mást jelöl. Az include_once() segítségével ezt a hibaforrást kiküszöbölhetjük. require_once() Az utasítás hasonlóan az include_once() utasításhoz csak egyszer hívja be a kérdéses file-t futás közben, így a függvények és globálisváltozók újradefiniálása körüli problémák kiküszöbölhetők. Egyébként a require() utasítással megegyező a szerepe és működése.

30

10.5 Távoli file-ok hívása A fenti két utasítás – include és require – alkalmas arra, hogy a PHP megfelelő konfigurálása esetén távoli file-okat is elérjünk, akár másik Web szerveren is. Ehhez az "URL fopen wrapper"-eket kell bekapcsolni, a PHP4.0.3-tól kezdődően az allow_url_fopen php.ini beállításával. Ez a lehetőség Windows rendszereken nem működik. Ennek a tulajdonságnak persze vannak veszélyei is. Ha egy ilyen távoli hívás során olyan lapot hívunk meg, aminek a tartalmára nincsen hatásunk, akkor az include-olt file tartalma lehet olyan, hogy a mi rendszerünkre veszélyeket hordoz. A távoli helyen megfelelően elkészített lap email-ben elküldheti az azonosítókat és egyéb olyan adatokat, amelyeket nem szeretnénk nyilvánosságra hozni, ezért ezzel a lehetőséggel óvatosan kell bánni.

10.6 Példaprogramok feltételekkel, ciklusokkal 1. Írj programot, amely kiírja az öttel és a héttel osztható számokat és ezen számok összegét! 2. Írj egy programot, amely az eraszthotenészi szita vagy más módszer segítségével kiírja a prímszámokat 1-től n-ig! 3. Készíts programot, amely összefésüli $a, $b rendezett tömbök tartalmát, majd az tetszetős formában kiírja a képernyőre! 4. Írj programokat, az include és require parancsok segítségével, amely teszteli egy rendezési algoritmus sebességét, mivel ugyanazokat az include-olt tömböket rendezi sorba. Az alábbi feladatok a Programozási tételek és Adatszerkezetek című jegyzetemből származnak Feladatok:

Egy repülő indul az egyik kontinensről a másikra, és repülés közben rendszeresen méri az alatta lévő felszín tengerszint feletti magasságát. A mért érték nulla – ekkor tenger felett repül – vagy pozitív – ekkor szárazföld felett repül. Készítsünk olyan programot, amelyik a következőkre képes: Szimulálja a méréseket véletlenszerűen, figyelve arra, hogy az első és az utolsó mérés szárazföld felett történt. Az eredményeket fájlba menti. Kiírja a képernyőre az alábbi kérdésekre a válaszokat: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.

Milyen távol van egymástól a két kontinens? Hol vannak a szigetek partjai (előtte tenger, utána szárazföld vagy fordítva)? Hány sziget van a két kontinens között? Hány hegycsúcsot talált (A hegycsúcs az a hely, ami előtt és mögött kisebb a tengerszint feletti magasság)? Át tud-e menni a két kontinens között egy kajakos, ha egyszerre csak egy adott távolságot tud evezni, mert ha többet evez, akkor elpusztul? Mekkora a szigetek átlagos távolsága? Van-e leszállópálya valamelyik szigeten (olyan rész, amely vízszintes legalább két mérés távolságig) Hány darab apró sziget van (maximum 3 méréshosszúságú)? Szeretünk alföldön élni. Van-e olyan rész, amely sík vidék, elég nagy és alföld? Keressük meg ezt a helyet! Hol található a leghosszabb sziget kezdőpontja? - A fenti kérdésekre választ ad úgyis, hogy véletlen-szél gátolja, vagy segíti a repülőgép útját - Töltsünk fel adatokkal egy két-dimenziós tömböt! Írjunk programot, amely kiírja a legnagyobb elemet tartalmazó sor számát!

31

11 Saját függvények, változók élettartama és láthatósága Eddig sok szó esett a változókról és esetenként a függvényekről is, azonban az eddigiek alapján azt gondolná az ember, hogy csak ilyen egyszerű programok írhatók PHP-ben. Az igazság az, hogy PHPben csak a futási idő és a futtató rendszer memóriája szab határt az alkalmazott program bonyolultságának.

11.1 Függvények A PHP-ban is használhatunk programstruktúrákat, programszegmenseket. Már Pascal-ból vagy C-ből is jól ismerhetjük az alapvető két eljárástípust, amit Pascalban Procedure illetve Function névvel illetünk, C-ben pedig típus nélküli illetve típusos function-nak mondunk. Mind a két nyelven a különbség az, hogy ad-e vissza a kérdéses eljárástípus értéket, vagy nem. A PHP-ben csakúgy, mint a C-ben kétféle eljárástípust használhatunk. A szintaktika a következő: Ez az eljárástípus nem ad vissza értéket. function függvény_név(paraméterlista) { A függvény törzse; }

Ez az eljárástípus a definiáltnak megfelelő típusú értéket ad vissza: function függvény_név(paraméterlista) { A függvény törzse; return érték; }

Látható, hogy a visszatérési érték léte vagy nem léte a programozótól függ, ezért egyes esetekben célszerű a visszatérési érték típusát megállapítani ahhoz, hogy van-e egyáltalán visszatérési érték. PHP3-ban a definiált függvénynek mindig a függvény hívása előtti ponton kell lennie, vagyis azokat a függvényeket, amelyeket használni akarunk a PHP program elejére kell tennünk. A PHP4–ben ez a megszorítás megszűnt, ugyanakkor célszerű magadat ehhez a szokáshoz tartani. A PHP nem támogatja a függvények polimorfizmusát, a függvényeket nem tudod undefiniálni vagy újradefiniálni a már definiált függvényeket. Az objektum orientáltság ennek megfelelően nem teljes a PHP-ben. A függvény meghívása esetén paramétereket adhatunk át a hívott függvénynek. Ennek részleteit a következő szakaszban fogjuk tárgyalni. Rekurzió lehetséges a függvényhívásoknál, de természetesen arra kell vigyázni, hogy a rekurzió véget érjen. Az alábbi kis példa az N faktoriális kiszámítását végzi rekurzív módon. 1) $nf = $n*nfakt($n-1); else $nf = 1; echo $n." => ".$nf."
"; return $nf; } nfakt(200); ?>

11.2 Paraméterátadás Egy függvény definiálásakor meg kell határozni, hogy milyen paramétereket vegyen át. Ezt a paraméterlistával tudjuk megtenni, amelyben az átvevő változók neveit vesszővel elválasztva fel kell sorolni.

32

A híváskor nem kell minden paramétert átadni. Ebben az esetben a kérdéses paramétereknek a függvényen belül nem lesz értéke. Az empty() függvénnyel lehet megvizsgálni, hogy egy paraméter kapott-e értéket vagy sem. A PHP-ben kétféle paraméterátadás, létezik Érték szerinti A hívó kifejezés értéke behelyettesítődik a meghívott függvény paraméterlistájában szereplő változóba és a függvényen belül a paraméter használható. Ez az alapértelmezés. Cím szerinti Ez azt jelenti, hogy a változó memóriacímét adjuk át a függvénynek, amely a cím ismeretében tudja azt módosítani és a függvényből való visszatéréskor a változások megmaradnak. Ez utóbbi esetben, ha cím szerint akarunk átvenni értéket egy függvénnyel, akkor használnunk kell a & operátort. ”; fgv($n); echo ”$n
”; ?>

Még akkor is átadhatjuk cím szerint a változót, ha a fogadó függvényt nem készítettük fel a cím szerinti paraméterátvételre, az átadásnál használjuk a & operátort. Ez utóbbi nem túlságosan szép mód, mivel egy függvényt valószínűleg nem azért használunk érték szerinti paraméter átvételre, hogy majd máshol módosítsunk a dolgon. ”; fgv(&$n); echo ”$n
”; ?>

A függvények paramétereinek átvétele még egy módon megtörténhet. A PHP támogatja a paraméterek kezdőértékadását. Ennek akkor van értelme, ha a függvény hívásakor nem adtunk át értéket a függvénynek. Ilyenkor alapértelmezett értéket kap az a paraméter, amelyet a hívó nem adott át. Természetesen az át nem adott paramétereknek a helye az átadottak után helyezkedjen el!

Ha azt szeretnénk, hogy egy függvény változó számú paramétert vegyen át és a függvényben meg akarjuk állapítani, hogy éppen most hány paraméter van, akkor a következő függvényeket használni: func_get_args() Egy tömbben visszaadja az átadott paraméterek listáját. Func_num_arg() Megadja a kapott függvények számát 33

func_get_arg(sorszám) Visszaadja a sorszám paraméterrel megadott paramétert. Ha a sorszám nagyobb, mint a paraméterlista utolsó elemének indexe, akkor hibaüzenet jön (warning). A paraméterlista indexe 0-val kezdődik. Az alábbi példa ezeket példázza. \n"; if ($numargs >= 2) { echo "A második paraméter: " . func_get_arg (1) . "
\n"; } $arg_list = func_get_args(); for ($i = 0; $i < $numargs; $i++) { echo "$i-ik paraméter: " . $arg_list[$i] . "
\n"; } } foo (1, 2, 3); ?>

11.3 Függvények visszatérési értéke Egy függvény tetszőleges típust, még tömböt, vagy változóreferenciát is vissza tud adni. Több érték visszaadására a tömböt használhatjuk. Ha nem használjuk a return utasítást, akkor az utolsó végrehajtott kifejezés lesz a visszatérési érték.

11.4 Változók élettartalma és láthatósága A PHP-ban nagyon egyszerű szabályok vannak a változók láthatóságára és élettartamára vonatkozólag. Élettartam A változó akkor jön létre, amikor létrehozzuk, értéket adunk neki. Egy változó megsemmisül, ha az unset(változónév) paranccsal felszabadítjuk a változó nevét (memóriaterületét is), vagy véget ér az adott PHP script oldal. Ez alól kivétel, ha a változókat átadjuk egy másik PHP oldalnak a POST, GET metódussal, a cookie-k vagy sessionok használatával. Egy PHP oldal elején használhatók a HTTP_ és az Environment változók, amikről korábban esett szó. Használhatók azok a változók, amelyeket egy másik php oldal, vagy más HTML oldal küldött, POST vagy GET metódussal. Használhatók a Cookie-k és a Sessionok segítségével átvitt változók is. Létezik az úgynevezett a $GLOBALS tömb, amelynek tartalma a PHP oldal minden helyéről látható.

34

Létezik-e a változó Azt, hogy egy változó létezik-e az isset() függvénnyel kérdezhetjük le. Igazat ad vissza, ha a változó létezik, az empty() függvény pedig igazat ad vissza, ha a változó értéke 0, üres, vagy nem létezik!

die(”Jelentkezz be!”);

Láthatóság A PHP oldalon létrejött és a különböző módokon átvett változók globálisak, azaz attól a helytől kezdve láthatók mindenhonnan, azonban ha meghívunk egy függvényt, akkor abban a függvényben csak azok a változók láthatók, amelyeket a függvényben hoztunk létre, vagy paraméterként adtunk át. Ha a függvényből kilépünk, akkor ezek a változók megsemmisülnek kivéve, ha nem cím szerinti paraméterátadás során jöttek létre. Azaz ezek a változók lokálisak lesznek a függvényre nézve. Ha egy függvényből új függvényt hívunk, akkor abban nem lehet látni a hívó függvény változóit. A fentiek alól az egyetlen kivétel, ha a függvényben használjuk a global parancsot, aminek segítségével importálhatjuk a script globális változóit a függvénybe.

A másik lehetőség az, hogy használjuk a $GLOBALS[] asszociatív tömb értékeit, amelyben minden bejegyzett globális változó megtalálható.

Létrehozhatunk statikus változókat is, amelyek a Clipperben és más hasonló nyelveken léteznek. Statikus változó egy függvényben jöhet létre. Amikor kilépünk a függvényből már nem használhatjuk ennek a változónak az értékét, de ha újra meghívjuk a függvényt, nini még megvan az előző értéke. J ott folytathatjuk, ahol abbahagytuk. Ennek néha van értelme. Mindenesetre a használatához a függvényben a static kulcsszót kell használni. Az alábbi kis szösszenet egy ciklusból meghívja újra meg újra a Test() függvényt és ennek során az $a változó tartalma folyamatosan nő, noha mindig kilépünk a függvényből. Na ja, statikusnak deklaráltuk! A statikus változónak kezdőértéket adva, az csak egyszer fut le, amikor először meghívjuk a függvényt. Function Test () { static $a = 0; echo $a; $a++; } for ($i =0; $i< 10;$i++) {

35

Test(); Echo ”blablabla” }

11.5 Változók átadása lapok között Gyakori kérdés a PHP-ben programozók között, hogyan tudnak értékeket átadni a PHP lapok között, hiszen ha egy lap lefut, akkor eddig úgy tudtuk, hogy a lapon keletkezet változók is megszűnnek. Amikor először szembekerültem a problémával, akkor azt hittem, hogy a globális változók oldják meg a problémát. Sajnos a dolog nem ennyire egyszerű, de nem is túlságosan bonyolult. Átadhatunk egyedi változókat és egy dimenziós tömböket is. Négy lehetőségünk van erre.

11.5.1 Header utasítás A Header utasítást csak akkor használhatjuk, ha az adott oldalon még semmiféle képernyőre írás nem volt, azaz a keletkező HTML oldalnak még nem kezdtük írni a BODY részét. A header segítségével bármilyen header TAG-et kiírathatunk a HTML oldalra. Az alábbi példában egy teljes header sorozatot írunk ki a HTML oldalra header header header header

("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Date in the past ("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT"); // always modified ("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1 ("Pragma: no-cache"); // HTTP/1.0

header ("HTTP/1.0 404 Not Found");

Itt egy hibakezelést írunk ki, az URL nem található. Akkor lehet ilyet tenni, ha például az Apache szerverünk hibaüzeneteit átirányítjuk a saját oldalainkra. header ("HTTP/1.0 404 Not Found");

Böngésző átirányítása. Itt adhatjuk meg az új oldalt. Ez a parancs nem csak a böngészőt vágja át az új oldalra, hanem a szervernek is visszaküld egy átirányítás státusz üzenetet is. header ("Location: http://www.php.net"); /* Átirányítja a böngészőt a PHP web oldalra */ exit; /* Ha nem megy az átirányítás, akkor az exit parancs biztosan kilép */

11.5.2 GET metódus A GET metódust úgy használhatjuk, hogy meghívunk egy lapot az oldalunkról egy másik lapot és az URL végére paraméterként átadjuk a változókat, valahogy így, ahogy a következő példákban látjuk: Az első példában igazából nem is PHP a megoldás, egyszerűen a TAG-ben megadjuk, hogy melyik oldalt és menyi idő múlva hívja meg az oldal. Ennek a megoldásnak hibája, hogy tulajdonképpen itt egy Javascriptet használunk. A példában 3 másodpercig vár a betöltődés után a böngésző, majd a szerver átdobja az új oldallal és meghívja a lapot a user, pwd és a level változókkal.

A következő példában hasonlót teszünk, de itt a HTML oldal fejlécében dolgozunk. Felhasználjuk a HTML meta tag-ját. Itt is 3 másodperc múlve hívja be a következő oldalt és az előző oldalról átadjuk az előző példában látott 3 változó pillanatnyi értékét. <meta http-equiv="refresh" content="3; URL=">

A harmadik példában a PHP header utasítását használjuk. A példában egy POST metódussal egy űrlapon bevitt adatokat vizsgálunk meg, és amennyiben hiányzik az adat, akkor egy hibakezelő

36

függvénybe irányítom át, ahol a header segítségével átirányítom egy másik oldalra, átadva neki a megfelelő változókat.

function sorry($msg,$from=1,$glob="") { header("Location: sorryuser.php?from=$from&msg=$msg&glob=$glob"); } if(empty($name)) sorry("Hiányzik a név adat! Kötelező kitölteni",1); if(empty($loginname)) sorry("Hiányzó login név! Kötelező kitölteni",1); if(empty($email)) sorry("Hiányó E-mail cím! Kötelező kitölteni. Itt kapod meg a jelszót!",1);

A fenti három lehetőség közös hibája az, hogy az átirányított lapok URL-je megjelenik a böngészőben, azaz titkos információt nem tudunk átadni, továbbá azok a böngészők, amelyek nem tűrik az átirányítást, nem fognak továbbmenni.

11.5.3 POST metódus A POST adatátviteli metódust az űrlapokkal kapcsolatban használhatjuk legtermészetesebben. Itt egyelőre csak annyit mondunk, hogy az ürlapok olyan HTML kódok, amelyen keresztül a böngésző előtt ülő felhasználó beírhat adatokat a HTML oldalon, az űrlap SUBMIT gombjának megnyomására pedig az űrlapon definiált mezők tartalmát, mint változóneveket és változó tartalmakat elküldi a cél oldalnak a böngésző. Az űrlap fejlécében meg kell adni a cél oldalt (kinek küldjük) és a megfdelelő oldal, ha az olyan oldal, amit a szerver meg tud jeleníteni betöltődik a böngészőbe. A PHP esetén a módszer az, hogy az űrlap kitöltése után a submit gomb megnyomásával elküldjük az eredményeket egy PHP oldalnak, amely betöltődéskor megkapja az elküldött változókat, esetleg elvégzi azokat a ferladatokat, amelyekre rendeltetett, majd megjelenít valami választ. Ennél a módszernél, az elküldött értékek nem látható módon kerülnek el a meghívott oldalhoz, tehát ezzel a módszerrel viszonylag könnyű változóértékeket átadni. Vigyázni kell azonban arra, hogy az adatbevitel alapvetően string és ha nem úgy használjuk fel azokat a bevitt stringeket, hogy előtte kiszűrjük a ../../etc/ ... stb jellegű adatrokatés nem figyelünk arra, hogy az eredményeket a lehető legtöbb szempont szerint ellenőrizzük, akkor a web site-unk feltörhető lehet. Az alábbi példában egy olyan HTML oldalt mutatok be, amely egy űrlapot tartalmaz, a submit gomb megnyomásának hatására az oldal önmagának (!) küldi el a változókat, majd a submit változó értéke alapján egy elágazásra kerül a végrehajtás és az eredményt elküldi e-mailben egy megadott címre. A lapon van egy kis Javascript betét is, amely az aktuális időpont beszúrására szolgál. Az űrlapon található olyan mező is, amelynek a tartalma hidden, azaz az űrlapon nem jelenik meg. <meta http-equiv="Content-Language" content="hu"> <meta http-equiv="Content-Type" content="text/html; charset=windows-1250"> Munkalap <script language="JavaScript"> function Kitolt() { var x=0; for (x=0;x<document.munkalap.lista.length;x++) if (document.munkalap.lista.options[x].selected) document.munkalap.ceg.value = document.munkalap.lista.options[x].value; Alert (document.munkalap.lista.options[x].value); } <script language="php"> $datum = date('Y.M.d H:i');

//aktuális dátum

37

$mikor= date ('Y.M.d'); if (!empty($pswd)) $jls = "_".$pswd."_"; else $jls = "__";

// // egyszerű (primitiv) password ellenőrzés // Lehetne biztonsáégosabban is, de itt most ez nem szempont

// A munkalap elküldéséhez ki kell tölteni a partnercég nevét is. if(!empty($ceg)) { $jel= (strpos($jls, "xxxx") == 0) | empty($munkavegzo); if(!$jel) { // Itt állítjuk össze az Email-t az átküldött változók értékéből. $uze =""; $uze= $uze ."Cég $ceg\n"; $uze= $uze ."Bejelentő $bejelento\n"; $uze= $uze ."Bejelentés időpontja $mikor\n"; $uze= $uze ."Hibajelenség $hibajelenség\n"; $uze= $uze ."A hiba oka $hibaok\n"; $uze= $uze ."Az elvégzett munka $elvegzett_munka\n"; $uze= $uze ."A munkavégzés alapja\n"; $uze= $uze ."- Garanciális $granciális\n"; $uze= $uze ."- Rendszergazdai $rendszergazda\n"; $uze= $uze ."- Fizetős $fizetos\n"; $uze= $uze ."- Kiszállás $kiszallas\n"; $uze= $uze ."- Műhelyben $muhely\n"; $uze= $uze ."- Rendszergazdai $rendszergazda\n\n"; $uze= $uze ."A szükséges munkaidő $munkaido\n"; if (!empty($munkadij)) { $uze= $uze ."Számlázott munkadíj $munkadij Ft + 25% ÁFA\n\n"; } if (!empty($alkatreszek)) { $uze= $uze ."Beépített alkatrészek $alkatreszek\n"; $uze= $uze ."Alkatrészek ára $alkatreszar Ft + 25% ÁFA\n\n"; } $uze= $uze ."\n"; $uze= $uze ."Munkavégző $munkavegzo\n"; $uze= $uze ."Dátum $datum\n"; $uze= $uze ."Igazolás $igazolas\n\n"; $uze= $uze ."A munkalapot küldő gép adatai\n"; $uze= $uze ."A gép IP címe ".$HTTP_ENV_VARS['HTTP_HOST']."\n"; $uze= $uze ."A gép neve ".$HTTP_ENV_VARS['REMOTE_HOST']."\n"; $uze= $uze ."A gépen futó böngésző ".$HTTP_USER_AGENT."\n"; mail("[email protected]","munkalap",$uze); if( Die("Az munkalapot elküldtük!")); } if ($jel) <script language="javascript"> Alert ("Hiányosan töltötte ki a munkalapot"); <script language="php"> }

Józsi Cégének munkalapja

A partnercég: <select name="lista" onclick="Kitolt()">

38

A bejelentő neve:

A bejelentés időpontja:

A hibajelenség:

A megállapított hiba

Az elvégzett munka leírása

Garanciális?

Rendszergazdai?

Fizetős?

Kiszállás

Műhely

39

Beépített alkatrészek

Alkatrészek ára (nettó) +25% ÁFA

A munkát végző(k): Munkaórák
Munkadíj (netto) +25% ÁFA

Dátum:
Digitális aláírás:

Igazolás:

Utolsó módosítás: 2011. március 12.

11.5.4 $_SESSION változók A session változók olyan változók, amelyek megtartják értékeiket miközben a felhasználó egyik oldalról átlép a másikra anélkül, hogy a korábban ismertetett módszerek valamelyikével direkt át kellene adnunk az értékeket a lapok között. Ez a lehetőség igazi globális változókat enged meg és sokkal összetettebb WEB-es programok készítését teszi lehetővé. Több lapból álló site fejlesztése gyakorlatilag session változók nélkül nem megy. Amikor egy felhasználó belép egy WEB oldalra, akkor egy egyedi azonosító keletkezik, az úgynevezett session id (SID), amelyet vagy a böngészőben tárolunk úgynevezett cookie (süti) formájában, vagy a szerver oldalon tartunk nyilván. A sessionok támogatják korlátlan mennyiségű változó regisztrálását és a tartalmuk megtartását. Amikor a felhasználó eléri a web oldalt, akkor a PHP automatikusan leellenőrzi, hogy a megfelelő session id vajon már létezik-e a szerveren. Ha létezik a session id, akkor a session-höz tartozó elmentett értékeket hozzárendeli a lekért oldalhoz. A session id-t két módon lehet aktivizálni. 1. Vagy a PHP.INI-ben beállítjuk a session.auto_start =1 értéket

40

2. Minden oldal elején használjuk a session_start() függvényt, vagy implicit módon a session_register() függvényt. Amikor a látogató elindít egy PHP-s lekérést, a PHP motor megnézi, hogy a fenti esetekben van-e a kéréshez hozzárendelve egy session id. Ha van, akkor a korábban elmentett környezetet hozzárendeli ehhez a kéréshez, azaz visszaállítja a megfelelő változókat. Minden regisztrált változót elment a rendszer a kérés befejeződésekor. Azok a regisztrált változók, amelyek nem kaptak értéket, azaz nem definiáltuk őket, a nem definiáltak közé kerülnek. Ezek a változók csak akkor kerülnek a definiáltak közé később is, ha a user értéket ad neki. A track_vars és a register_globals konfigurációs paraméterek (PHP.INI-ben) befolyásolják a session változók tárolásának és visszaállításának módját. Ha a track_vars engedélyezve van és a register_globals tiltva, akkor csak a $HTTP_SESSION_VARS globális asszociatív tömböt lehet session változóknak beállítani. A visszaállított változók is csak ebben a tömbben lesznek elérhetők. (Ebben az esetben egy visszaálított változó értékét az alábbi módon tudjuk elérni:

Ha a register_globals engedélyezett, akkor minden globális változót session változónak tudunk elmenteni, és a session változók a következő kérés során automatikusan globális változókká válnak.

Ha a track_vars és a register_globals is engedélyezettek a PHP.INI-ben, akkor mind a két fenti módszert használhatjuk, azaz a $HTTP_SESSION_VARS elemei és a globális változók ugyanazokat az értékeket tartalmazzák majd. Hogyan kezelhetjük a session id-ket? Cookie - sütikkel URL parameterekkel A session modul mind a két változatot támogatja. A cooki-k az optimálisak, viszont vannak olyan kliensek, akik nem támogatják a cooki-k elhelyezését a gépükön biztonsági okokból, ráadásul ilyenkor a böngésző és a szerver között vándorolnak adatok is. Ez biztonsági problémákat vet fel. A második módszer esetén a session id az URL része. A PHP képes hajlékonyan kezelni a kérdést, ha megfelelően fordítottuk (--enable-trans-sid kapcsolóval) Ebben az esetben a relatív URI-k megváltoznak automatikusan és tartalmazni fogják a session ID-t (=SID). Más esetben használhatjuk a SID konstanst, amely a session_name=session_ID vagy egy üres stringet tartalmaz (pl. PHPSESSID=8e1f5ff69434aea7ecab51da33314b53&PHPSESSID=8e1f5ff69434aea7ecab51da33314b53 )

Az alábbi példában bemutatjuk, hogyan lehet regisztrálni egy változót és egy URI-hoz hozzárendelni a session ID-t, felhasználva a SID-et. Példa 3. Egy user bejelentkezéseit számolja le ez a példa Hello visitor, you have seen this page times.

41

# the is necessary to preserve the session id # in the case that the user has disabled cookies ?> To continue, ">click here

Ha a fenti kódot lefuttatjuk és megnézzük a PHP.INI-ben megadott könyvtárban lévő file-okat, akkor látni fogjuk, hogy a session indulása után létrejön egy file (pl. C:\temp-ben) valami hasonló névvel, sess_8e1f5ff69434aea7ecab51da33314b53. Ez tartalmazza a session változók nevét és értékét. Ez felveti azt a problémát, hogy az ilyen típusú file-ok a szerveren lévő temp könyvtárban csak gyűlnek és korrekt lekezelésük idővel nagyon nehézzé válik. Azt is figyelembe kell venni, hogy egyes sessionok elévülnek, másokat nem lehet még törölni, mert éppen futó alkalmazás használja. A PHP.INI session részében vannak azok a beállítások, amelyek a session file-ok elévülését, a szemétszedést és egyebeket szabályoznak. A szerver automatikusan gondoskodik egy idő múlva a session file-ok törléséről. Másfelől a fejlesztőket gondoltak arra is, hogy a programozók a saját kezükbe akarják venni a session kezelésének lehetőségét. Erre a célra a fejlesztők megadták a session_set_save_handler() függvényt, aminek paramétereivel megadhatjuk a teljes session kezelő függvénycsomagunkat. A paraméterek tehát azoknak a függvényeknek a nevei, amelyek az egyes műveleteket végzik. session_set_save_handler ("ss_open", "ss_close", "ss_read", "ss_write", "ss_destroy", "ss_gc"); Az egyes függvények feladatai a következők: ss_open ($save_path, $session_name) a két megadott paraméter tartalmazza a PHP.INI-ben megadott helyet session.save_path, és változónevet, session.session_name, ami a keletkezett file-t is megjelöli sess_session_name alakban (lásd fenti példa) ss_close() Ezzel bezárjuk a session kezelőt, nem lelőjük, mintha a sess_destroy()-t alkalmaznánk! ss_read($id) Ez a függvény olvassa be a megfelelő változókba a kulcs által meghatározott sessionokhoz tartozó értékeket. ss_write($id, $változonév_érték) Ez írja bele a megfelelő kulccal azonosított sessionba a változónév érték párokat. ss_destroy($id) Ezt hívjuk meg, amikor törölni akarjuk egy session adatait és be akarjuk zárni a boltot. ss_gc($maxlifetime) Garbage collection algoritmus. Ha egy session lejárt, akkor az időnként elindított függvénnyel letöröljük a feleslegessé vált sessionok adatait. Ez például azért is szükséges, mert az egyes userek nem biztos, hogy megvárják egy php oldal lefutását, hanem időnként csak egyszerűen kilépnek, megszakad a kapcsolat, vagy egyéb okok is lehetnek. Ha túllépi egy session a neki szánt időt, illetve sokáig nem nyúltak hozzá a session adataihoz, akkor azt könyörtelenül ki kell takarítani. Az alábbiakban két változatot mutatunk be. Egyet a manualból, amely a temp könyvtárban lévő sessionokat kezeli file-okként. Példa a session_set_save_handler() használatáról
42

// Ez nem csinál semmit function ss_close() { return(true); } //Beolvassa a session file adatait egy változóba, amit fel lehet dolgozni, function ss_read ($id) { global $sess_save_path, $sess_session_name; $sess_file = "$sess_save_path/sess_$id"; if ($fp = @fopen($sess_file, "r")) { $sess_data = fread($fp, filesize($sess_file)); return($sess_data); } else { return(""); } } // Kiírja a session adatokat egy file-ba. function ss_write ($id, $sess_data) { global $sess_save_path, $sess_session_name; $sess_file = "$sess_save_path/sess_$id"; if ($fp = @fopen($sess_file, "w")) { return(fwrite($fp, $sess_data)); } else { return(false); } } // A session file-t töröljük a sessionok tárolására szolgáló könyvtárból function ss_destroy ($id) { global $sess_save_path, $sess_session_name; $sess_file = "$sess_save_path/sess_$id"; return(@unlink($sess_file)); } /******************************************************** * Figyelem! Garbage collection rutint kell ide írni! * ********************************************************/ // Itt azt vizsgáljuk meg, hogy az utolsó hozzáférés mikor zajlott le a file-on. function expirity($filename, $now, $maxlifetime) { $last = fileatime ($filename); return ($now - $last >= $maxlifetime); } function ss_gc ($maxlifetime) { global $sess_save_path, $sess_session_name; $aktdir = dirname($PATH_TRANSLATED); $now = time(); chdir($sess_save_path); $d=opendir($sess_save_path); while($filename=readdir($d)){ if ((substr($filename,0,4) == ”sess_”) && (expirity($filename,$now,$maxlifetime) )) unlink($filename); } closedir($d); chdir($aktdir); return true; } session_set_save_handler ("ss_open", "ss_close", "ss_read", "ss_write", "ss_destroy", "ss_gc"); session_start(); ?>

A korábbiak alapján érthető lehet a példa. Talán az ss_gc() függvény kicsit bonyolult. Az aktuális könyvtárt elmentjük, majd belépünk a session adatait tároló helyre, ott megnyitva a könyvtárat 43

végignézzük a file-ok neveit. A ”sess_” kezdetű filenevek session file-okat takarnak, azoknak megnézzük és a jelenlegi időt és az utolsó hozzáférésének idejét kivonva egymásból megnézzük, hogy lejárt-e az élete.

44

Egy session kezelő működése - példa A továbbiakban megnézzük egy MySQL-es sessionkezelő működését. A működéséhez szükség van az alábbi adatbázis szerkezetre: CREATE TABLE sessions ( sesskey char(32) not null, exp int(11) unsigned not null, value text not null, PRIMARY KEY (sesskey) );

= = = =

"localhost"; "sessions"; "phpsession"; "phpsession";

/* /* /* /*

adatbázis adatbázis adatbázis adatbázis

szerver hostneve */ neve */ user */ jelszó */

$SESS_DBH = ""; $SESS_LIFE = get_cfg_var("session.gc_maxlifetime"); function sess_open($save_path, $session_name) { global $SESS_DBHOST, $SESS_DBNAME, $SESS_DBUSER, $SESS_DBPASS, $SESS_DBH; if (! $SESS_DBH = mysql_pconnect($SESS_DBHOST, $SESS_DBUSER, $SESS_DBPASS)) { echo "
Nem tudok kapcsolódnia stzerverhez: $SESS_DBHOST, mint $SESS_DBUSER user"; echo "
MySQL hiba: ", mysql_error(); die; } if (! mysql_select_db($SESS_DBNAME, $SESS_DBH)) { echo "
Nem tudom kiválasztani az adatbázist: $SESS_DBNAME"; die; } return true; } function sess_close() { return true; } function global $qry = $qid =

sess_read($key) { $SESS_DBH, $SESS_LIFE; "SELECT value FROM sessions WHERE sesskey = '$key' AND exp > " . time(); mysql_query($qry, $SESS_DBH);

if (list($value) = mysql_fetch_row($qid)) { return $value; } return false; } function sess_write($key, $val) { global $SESS_DBH, $SESS_LIFE; $exp = time() + $SESS_LIFE; $value = addslashes($val); $qry = "INSERT INTO sessions VALUES ('$key', $exp, '$value')"; $qid = mysql_query($qry, $SESS_DBH); if (! $qid) { $qry = "UPDATE sessions SET exp=$exp, value='$value' WHERE sesskey='$key' AND exp> " .time(); $qid = mysql_query($qry, $SESS_DBH); } return $qid; } function sess_destroy($key) { global $SESS_DBH;

45

$qry = "DELETE FROM sessions WHERE sesskey = '$key'"; $qid = mysql_query($qry, $SESS_DBH); return $qid; } function sess_gc($maxlifetime) { global $SESS_DBH; $qry = "DELETE FROM sessions WHERE exp < " . time(); $qid = mysql_query($qry, $SESS_DBH); return mysql_affected_rows($SESS_DBH); } session_set_save_handler( "ss_open", "ss_close", "ss_read","ss_write","ss_destroy","ss_gc"); ?>

A fenti két esetben mindannyiszor hasonló paraméterekkel kell meghívni a függvényeket: Ss_open(”C:\TEMP”,”PHPSESSID”) ezeket adja át a változóknak The is not necessary, if --enable-trans-sid was used to compile PHP. A sessionkezelési rendszer több olyan beállítást figyelembe vesz, amelyek a PHP.INI-jében találhatók. session.save_handler a session kezelőjét űllítja be. Default files. session.save_path meghatározza a session file-ok tárolásának helyét. Ha a default filekezelőt használod, akkor a /tmp. Könyvtár lesz az. Windowsos rendszeren célszerű a TEMP környezeti változót

megadni, példul c:\TEMP. session.name a session által használt cookie nevet határozza meg. Default PHPSESSID. session.auto_start meghatározza, hogy a session automatikusan induljon-e el, ha a PHP kérés lefutott. Default 0 (nem indul el). session.cookie_lifetime meghatározza, hogy a cookie hány másodpercig éljen a böngésző indulása után. A 0 azt jelenti, hogy, amíg a böngésző fut. Default 0. session.serialize_handler defines the name of the handler which is used to serialize/deserialize data. Currently, a PHP internal format (name php) and WDDX is supported (name wddx). WDDX is only available, if PHP is compiled with WDDX support. Defaults to php. session.gc_probability meghatározza, hogy a gc (garbage collection) szemétgyűjtő rutin milyen

százalékkal induljon el. Az elmúlt sessionok file-jai a temp könyvtárban ott maradnak és ha egy új PHP kérést kap a rendszer, akkor ennek a változónak az értékétől függően statisztikai valószínűséggel elindul a régi session file-ok kitörlése. Ha az érték kicsi, akkor sok session fle is felgyűlhet, hiszen ritkán fut le a szemétszedés, ha nagy, akkor gyakran fut az algoritmus, tehát lassab lesz a kiszolgálás. Default érték 1, tesz környezetben 5 – 10. session.gc_maxlifetime specifies the number of seconds after which data will be seen as 'garbage'

and cleaned up. session.referer_check determines whether session ids referred to by external sites will be

eliminated. If session ids are propagated using the URL method, users not knowing about the impact might publish session ids. This can lead to security problems which this check tries to defeat. Defaults to 0. session.entropy_file gives a path to an external resource (file) which will be used as an additional entropy source in the session id creation process. Examples are /dev/random or /dev/urandom which

are available on many Unix systems.

46

session.entropy_length specifies the number of bytes which will be read from the file specified above. Defaults to 0 (disabled). session.use_cookies specifies whether the module will use cookies to store the session id on the client side. Defaults to 1 (enabled). session.cookie_path specifies path to set in session_cookie. Defaults to /. session.cookie_domain specifies domain to set in session_cookie. Default is none at all.

specifies cache (nocache/private/public). Defaults to nocache. session.cache_limiter

control

method

to

use

for

session

pages

session.cache_expire specifies time-to-live for cached session pages in minutes, this has no effect for nocache limiter. Defaults to 180.

A PHP4 sessionkezelője session_start — Session adatok inicializálása session_destroy — Session adatok megszüntetése session_name — Session név lekérdezése, beállítása session_module_name — Session kezelő modul nevének lekérdezése/beállítása session_save_path — Session mentési könyvtár lekérdezése beállítása session_id — Sessin ID (SID) lekérdezése/beállítása session_register — Register one or more variables with the current session session_unregister — Unregister a variable from the current session session_unset — Session változók felszabadítása session_is_registered — Megmondja, hogy egy változó regisztrálva van-e a sessionben session_get_cookie_params — Beolvassa a session cookie parametereket session_set_cookie_params — Beállítja a session cookie parametereket session_decode — Dekódolja a session adatokat egy stringből session_encode — Stringbe tárolja le a session adatokat

47

11.5.5 COOKIE-k (sütik) A cookiek használata a PHP környezetben lehetséges, de nem igazán ajánlott. A PHP alkalmazások a szerveren futnak és általában valamiféle user azonosításhoz kötöttek. A cookike-k használata esetén a cookie-ban tárolt adatok átkerülnek a böngészőt futtastó számítógépre és ott egy textfile-ban tárolódnak, aminek a visszafejtése csak idő kérdése, éppen ezért fontos vagy titkolni való adatot a cookie-kba sohas ne tároljunk, inkább használjunk sessionöket. bool setcookie ( string nev, string ertek, int lejarat, string utvonal, sting domain, int titkos) A fenti függvény minden paramétere az elsőt kivéve elhagyható. A függvényt a html oldal headerében kell elküldeni, mielőtt az oldalra bármit kiírnánk! Az alábbi példában elküldünk egy egyszerű értéket: Param

Leírás

Példa

Nev

A süti neve

'teszt’ nevű változót hozzuk létre $_COOKIE['teszt']

Ertek

Ez az érték tárolódik a kliens Ezt az értéket tároljuk a 'teszt' nevű változóban. $ertek oldalon =$_COOKIE['teszt']

Lejarat

A süti lejárati ideje másodtime()+60*60*24*2 két napot állítunk be lejáratnak. Ha percekben megadva. Beállítása nincs beállítva, akkor aböngésző bezárásáig érvényes a süti. time() + lejárati idő.

Utvonal Hol tároljuk a sütiket.

Minden böngédsző rendelkezik egy alapértelmezett süti tárhellyel. Beállíthatjuk, hogy ehhez képest hol tárolja a sütiket. Például a /fz/ az fz alkönyvtárba teszi a sütiket.

Domain

Az a domain, amire érvényes a Itt adhatjuk meg, hogy melyik aldomainre legyen érvényes a süti süti. A www.fz.ini.hu esetén csak erre a domainre érvényes.

Titkos

Ha az érték 1, akkor csak 0 vagy 1 , alapérterlmezés 0 HTTPS esetén küldi sütit.

Tömböket is tárolhatunk sütikben. $value) {

echo "$name : $value
\n"; } } /* Ez three two : one : */ ?>

lesz az eredmény : cookiethree cookietwo cookieone

A PHP 3 esetén fordított sorrendben kellett elküldeni a sütiket, mint ahogy tárolni szeretnénk, a PHP4 esetén már a sorrend a tárolási sorrendnek megfelelő. 48

A következő oldalt betöltve a böngészőbe a sütik automatikusan megjelennek a $_COOKIE tömbben, és azokat az értékeket lehet használni. Ha a register_globals paramétert bekapcsoljuk a php.ini-ben, akkor automatikusan létrejönnek a megfelelő változók, de korábban említettük, hogy ennek a paraméternek a bekapcsolása nem javallott. Ha a $_COOKIE tömb értékeit debuggolás céljából ki akarjuk iratni, akkor használjuk a következő utasítást:

49

12 Konverzió Adattípusok között A PHP automatikusan, és meglehetősen szabadon kezeli a típusokat. Néha szükség lehet egy bizonyos adattípus alkalmazására. Ekkor használhatjuk az alábbi módszereket: Előírjuk a típust, mint a C-ben: $a = (float) $b; $c = (int) $c;

Használhatjuk a bool settype ( $valtozo, ”tipus”) függvényt. Ekkor a tetszőleges típusú $változó-t átkonvertáljuk az adott típusra. A konverzió sikerességéről bool eredményt ad vissza a függvény. Lehetséges tipus értékek: • • • • • • •

"boolean" (vagy a PHP 4.2.0 óta "bool") "integer" (vagy a PHP 4.2.0 óta "int") "float" (csak a PHP 4.2.0 óta, korábban "double") "string" "array" "object" "null" (a PHP 4.0.8 óta)

TRUE értéket ad siker esetén, FALSE értéket egyébként. $ize = "5valami"; // string $valami = true; // boolean settype($ize, "integer"); // $ize most 5 (integer) settype($valami, "string"); // $valami most "1" (string)

50

13 Tömbök A tömbök, azok különböző lehetőségei, és az azok köré felsorakoztatott függvények a PHP programozás egyik legerőteljesebb eszközrendszerét alkotják, ugyanakkor rendkívül egyszerűen és könnyedén használhatók. A tömb változók halmaza, melyeket a tömbön belül sorban tárolhatunk és a teljes adathalmazt egyszerre is kezelhetjük, ugyanakkor a tömb elemeihez külön-külön is hozzáférhetünk. Fontos tulajdonsága a tömböknek, hogy egy tömbön belül az elemek típusa különböző lehet. Egy tömb elemeit legegyszerűbben explicit módon, elemenként tölthetjük fel: $tomb[1] $tomb[2] $tomb[4] $tomb[5]

= = = =

"dBase"; "FoxPro"; "Clipper"; 42;

Látható, hogy a tömb elemeinek megadásakor nem szükséges a sorrendiséget szigorúan betartani. Egy tömb elemeihez a fentieknél egyszerűbben is, a tömbindex használata nélkül is lehet elemeket adni: $tomb[] = "Basic"; $tomb[] = "FoxPro";

Ily módon a tömb végéhez kapcsolódnak az új elemek, az index értéke pedig az legutolsó indexelemnél eggyel magasabb lesz. Hasonlóan működik az array_push() függvény, azzal a különbséggel, hogy egy utasításon belül több értéket is hozzáfűzhetünk a tömbhöz: array_push($tomb, "Cobol", "Fortran");

Szép lassan dagadó tömbünk a fenti utasításokat követően már így néz ki: Array ( [1] [2] [4] [5] [6] [7] [8] [9] )

=> => => => => => => =>

dBase FoxPro Clipper 42 Basic FoxPro Cobol Fortran

Természetesen a tömbök értékeinek megadásához hasonlóan férhetünk hozzá a tömbelemekhez, azonban a fent említett array_push() függvény párja, az array_pop() függvény is rendelkezésünkre áll, mely azonban nemcsak egyszerűen a tömb utolsó elemét adja vissza értékül, hanem a tömb elemeinek számát is csökkenti az utolsó elemmel: $nyelv1 = $tomb[1]; // $nyelv1 értéke "dBase" $nyelv2 = $tomb[4]; // $nyelv2 értéke "FoxPro" $nyelv9 = array_pop($tomb);// $nyelv9 értéke "Fortran" és a tömb nyolc elemű lesz…

Bonyolítsuk egy kicsit a dolgokat. Ezidáig a tömbünk egy dimenziós volt, azonban a PHP nyelvben a tömbök kettő vagy akár több dimenziósak is lehetnek. Az értékadás legegyszerűbb módja ilyen esetben is az explicit értékadás: $auto[1][1] $auto[1][2] $auto[2][1] $auto[2][2] $auto[3][1] $auto[3][2]

= = = = = =

"Maserati"; "olasz"; "Renault"; "francia"; "Mercedes"; "német";

a tömb valahogyan így fog kinézni: Array ( [1] => Array ( [1] => Maserati [2] => olasz

51

) [2] => Array ( [1] => [2] => ) [3] => Array ( [1] => [2] => )

Renault francia

Mercedes német

)

Ilyen és ehhez hasonló tömbök létrehozására, azonban sokkal tömörebb és olvashatóbb módszer az array() függvény használata. Ez a függvény a paraméterként megadott értékeket tömb formában adja vissza. Így a fenti értékadással pontosan megegyező eredményt ad a következő: $auto[1] = array( "Maserati" , "olasz" ); $auto[2] = array( "Renault" , "francia" ); $auto[3] = array( "Mercedes" , "német" );

Ahogyan azonban a tömbelemek típusaira vonatkozóan nincsenek túl szigorú megkötései a PHP nyelvnek, ugyanúgy nem kezeli szigorúan a többdimenziós tömbök elemszámait sem a PHP. Az alábbi értékadás teljesen helyes eredményt ad: $auto[1] = array( "Maserati" , "olasz" ); $auto[2] = array( "Renault" , "francia" , "406", "206" ); $auto[3] = array( "Mercedes" , "német" , "E320", "Vito" , "Sprinter kisteherautó" );

Természetesen az array_pop() és az array_push() függvények az array() függvénnyel ötvözve több dimenziós tömbök esetén is használhatók. array_push( $auto, array("Citroen" , "francia" , "ZX" , "Xsara");

A fenti esetekben a tömb elemei azok sorszámaival voltak azonosítva. A PHP ismeri az asszociatív tömbök fogalmát is. Az asszociatív tömbök rendkívül hasznos és sokoldalú elemei a PHP nyelvnek. A PERL nyelvben használt hash típusú tömbökhöz hasonlóan működnek. A tömbelemekre való hivatkozás ilyen esetben nem sorszámmal, hanem egy indexelem (kulcs) segítségével történik, egyszerűen úgy, hogy a sorszám helyére, az indexelemet helyezzük. $tomb["első"] = "Kis Gedeon"; $tomb["második"] = "Nagy Elemér";

Függetlenül attól, hogy a tömb elemeinek milyen sorrendben adtunk értéket, az elemeket az indexkulcs segítségével érhetjük el, és ez nem függ attól, ha a tömbhöz hozzáfűzünk, vagy attól elveszünk egy elemet. Új elem bármikor hozzáfűzhető a tömbhöz: $tomb["harmadik"] = "Kukonya Berkó";

Az asszociatív tömbök lehetnek egydimenziósak, mint a fenti példában, de lehetnek több dimenziósak is. A fenti példát kibővíthetjük több dimenzióssá: $tomb["első"]["neve"] = "Kis Gedeon"; $tomb["első"]["kora"] = 27; $tomb["második"]["neve"] = "Nagy Elemér"; $tomb["második"]["kora"] = 22;

Ha a "Nagy Elemér" értékű elemet a $tomb["második"]["neve"] hivatkozással tudjuk elérni, de ha $sorszam értéke "második" akkor akár $tomb[$sorszam]["neve"] hivatkozással is elérhetjük a keresett elemet. 52

A normál és az asszociatív tömbök létrehozására egyaránt használható az array() függvény, amit leginkább tömbök kezdő értékfeltöltése során használhatunk, egy értékadással kiküszöbölve többet. A fenti példákkal megegyezőek az alábbi értékadások: $tomb = array ( "első" => "Kis Gedeon", "második" => "Nagy Elemér"); $tomb = array ("első"

=> array ("neve" "kora" "második" => array ("neve" "kora"

=> => => =>

"Kis Gedeon", 27), "Nagy Elemér", 22) );

Mint az alábbi példa is mutatja, az értékadás esetén az index értékét nemcsak konkrétan, hanem változóval is megadhatjuk, így már meglehetősen rugalmasan töthetjük fel tömbjeinket adatainkkal. A következő példa megmutatja a print_r() függvény használatát is, amit tetszőleges változó értékének kiíratásához használhatunk, de mivel tömbváltozó esetében a komplett tömbstruktúrát is megjeleníti leginkább tesztelési célokra használható nagyon jól. array("nev" => "Tabi Imre", "email" => "[email protected]"), $nick2 => array("nev" => "Nagy Krisztián", "email" => "[email protected]") ); echo("
"); print_r($tomb); echo("
"); print_r($tomb["Tabbi"]["nev"]); echo("
"); ?> A program kimenete a következő lesz: Array ( [Tabbi] => Array ( [nev] => Tabi Imre [email] => [email protected] ) [Chris] => Array ( [nev] => Nagy Krisztián [email] => [email protected] ) )

Asszociatív tömbök esetében azonban figyelemmel kell lenni arra, hogy ilyen tömb elemeit kizárólag a meghatározott indexértékkel érhetjük el, a tömb sorszámával nem. Ennek rendkívül egyszerű az oka. Az egyszerű sorszámozott tömb is asszociatív tömb, ahol a tömbindex maga a sorszám. Sőt egy tömbön belül keverhetjük is a sorszámozott és az indexelt elemeket, de azért ezt kerüljük, csak gondot okozunk magunknak. A normál és az asszociatív típusú tömbök a PHP programozás során rendkívül változatosan és hatékonyan használhatók, főleg akkor, ha tudjuk azt, hogy a PHP a tömbök elemeire, az elemszámokra és a tömbelemek típusaira vonatkozóan rendkívül szabad kezet ad nekünk: -

többdimenziós tömbön belül az egyik index lehet asszociatív, a másik normál

-

többdimenziós tömb esetében a tömbelem tömböknek nem kell feltétlenül azonos elemszámúaknak lenni, vagyis $tomb[1] lehet öt elemű, míg $tomb[2] lehet akár 8 elemű is.

-

egydimenziós tömbök esetében a tömbelemek lehetnek különbözű típusú adatok, de még többdimenziós tömbök esetében sem kell a tömbelem tömbök adatszerkezetének megegyeznie. 53

Vagyis elég nagy szabadsággal használhatjuk a tömbváltozókat, mégis érdemes szem előtt tartani, hogy ha lehet, járjunk el következetesen a változók értékadásával és azok használatával. A PHP nyelvben a tömbváltozókhoz is egy egész sor függvény és utasítás kapcsolódik. Ezek a http://weblabor.hu/php/ref.array.php címen találhatók meg. Ezek a függvények egy egész sor feladatot láthatnak el kezdve a tömbök definíciójától az értékfeltöltésen és a tömbben való mozgáson keresztül a tömbelemek legváltozatosabb módú sorbarendezéséig. Mivel a tömbök a PHP programozás során igen kiterjedten használatosak, és a tömbökhöz kapcsolódó függvények fontossága kiemelkedő, így ezen függvényekből a fontosabbakat a következő részekben részletesebben is tárgyaljuk majd.

54

14 Sztringek, szövegek manipulációja A továbbiakban néhány gyakran előforduló szövegmanipulációs feladat megoldását tekintjük meg PHPban. Természetesen sok olyan feladat van, amit máshol, máshogy már vagy még érintünk, illetve sok egyéb, itt nem megemlített függvény található a stringkezelésnél. A példák a php manualból valók! Gyakori, hogy egy string hosszát meg szeretnénk tudni: strlen() Ha egy string valahány karakterét ki akarjuk venni a szövegből, akkor a használandó függvény: substr() A 2. és harmadik paraméter lehet negatív is. Ekkor a jelentésük a szöveg végéről értendő.
$rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", $string = 'abcdef'; echo $string{0}; echo $string{3}; $rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", $rest = substr("abcdef", ?>

1); 1, 3); 0, 4); 0, 8);

// // // //

returns returns returns returns

"bcdef" "bcd" "abcd" "abcdef”

// returns a

// returns d -1); // returns "f" -2); // returns "ef" -3, 1); // returns "d" 0, -1); // returns "abcde" 2, -1); // returns "cde" 4, -4); // returns "" -3, -1); // returns "de"

Ha ki akarom cserélni a szöveg egy részét más részre, akkor: substr_replace() . \n"; // Beszúrjuk a 'bob' szót a $var elejére echo substr_replace($var, 'bob', 0, 0) . "
\n"; // Ha a második paraméter negatív, akkor a szöveg végéről indul a csere. echo substr_replace($var, 'bob', 10, -1) . "
\n"; echo substr_replace($var, 'bob', -7, -1) . "
\n"; // Töröljük a szöveg elejéről echo substr_replace($var, '', 10, -1) . "
\n"; ?>

A szövegben egyes karakterek, stringek előfordulásait kicseréljük másik stringekre. Str_replace() $bodytag = str_replace("%body%", "black", ""); // Eredmény: Hll Wrld f PHP $vowels = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U"); $onlyconstants = str_replace($vowels, "", "Hello World of PHP"); // Provides: You should eat pizza, beer, and ice cream every day $phrase = "You should eat fruits, vegetables, and fiber every day."; $healthy = array("fruits", "vegetables", "fiber"); $yummy = array("pizza", "beer", "ice cream"); $newphrase = str_replace($healthy, $yummy, $phrase); ?>

Ha egy string helyét akarom megtudni egy másik stringben, akkor: strpos(); Ugyanez a végéről: strrpos() 55

Ugyanezek kis/nagybetű érzéketlen módon: stripos(), strripos()

Egy string kiegészítése karakterekkel: str_pad()

10); 10, "-=", STR_PAD_LEFT); 10, "_", STR_PAD_BOTH); 6 , "___");

// // // //

produces produces produces produces

"Alien " "-=-=-Alien" "__Alien___" "Alien_"

Ha egy szöveg elejéről és végéről le akarom vágni a bevezető és a záró szóközt, tab-ot, soremelés karaktert, akkor a trim() függvényt használhatom. Ha csak a szveg elejéről akarom levágni a fent említett karaktereket, akkor ltrim(), ha a végéről, akkor rtrim(). Az alapesetben levágandó karakterekhez további kiegészítéseket is rendelhetek.

Érdekes lehetőség bizonyos speciális karakterek, tag-ek kihagyása a stringekből, illetve bizonyos speciális karakterek beszúúrása: Strip_tags(), htmlentities(), htmlspecialchars(),stripslashes(), '); $str = "A 'quote' is bold"; // Kimenet: A 'quote' is bold echo htmlentities($str);

56

//Kivettük

$new = htmlspecialchars("Test", ENT_QUOTES); echo $new; // Test ?>

Gyakori feladat, hogy sté kell vágni egy stringet valailyen karakter mentén darabokra, például szavakra, ahol a szavakat határoló karakter többféle is lehet. Az eredmény egy stringekből álló tömb lesz: Explode()

Az alábbi példa egy PHP oldalról keresztreferenciát készít és kiírja a beinclude-olt file-okat. ","=",";",")","(",")","\"","\'","!","+","","\t","*","/","?","&",":",".","#","@","{","}","[","]","|","%",","); $ar=str_replace("\\","/",$argv); //Az összes \\ jelet /-re cserélem $text=file($ar[1]); //Megnyitom a file-t function includes($f) { $terminal = array(" ",";","!","+","-","*","/","=","\n"); //A szöveghatároló jelek listája $fileterm = array("\"","'"); $inc =array(); //includes calling $lines = array(); $out = ""; $v = ""; $token = array("include","include_once","require"," require_once"); $text=file($f); while (list ($key, $val) = each ($text)) { $lin = str_replace($terminal," ",$val); if( (strpos($lin,$token[0])>0) or (strpos($lin,$token[1])>0) or (strpos($lin,$token[2])>0) or (strpos($lin,$token[3])>0) ) { $lines[]=str_replace($terminal," ",$val); } } $i=0; /*while ($i<$sizeof($lines)){ if( ) { $out .= includes($f); }

57

$i++; } */ print_r($lines); Return $out; } // Variables crossreference function variables($text) { global $terminal,$lines,$vars; //change Terminator characters while (list ($key, $val) = each ($text)) { $lines[]=str_replace($terminal," ",$val); } $splitted =array(); $line=0; while(list($key,$row)= each($lines)) { $splitted = explode(" ",$row); //Szétvágom szavakra a sort. Az eredmény egy tömb for($i=0; $i<sizeof($splitted); $i++) { $st = $splitted[$i]; if(substr($st,0,1)== "$"){ if(!isset($vars[$st])) $vars[$st] = "->".sprintf("%4d",$line).", "; else $vars[$st].= sprintf("%6d",$line).", "; } } $line++; } ksort($vars); $out = "--------- Variables ---------\n"; while (list ($key, $val) = each ($vars)) { $out .=str_pad($key,10).$val."\n"; } Return $out; } printf(variables($text)); printf(includes($ar[1])); ?>

58

15 Formok /űrlapok – Interaktív programok írása A PHP és általában a WEB-es programozás egyik sarokköve volt az interaktivitás megjelenése. Ehhez arra volt szükség, hogy a böngészőnkön beírt adatokat vissza tudjuk küldeni a szervernek, amely azt feldolgozza. A HTML-ben lehet űrlapokat létrehozni az alábbi szintaktikával:

A fenti xxxx= vagy GET vagy POST metódus lehet. Az űrlapok belsejében minden html elemet használhatunk, és itt használhatunk olyan beviteli mezőket, amelyek változóknak adnak értéket. A POST és a GET metódus segítségével a változók neve és értéke eljut az action-nal megjelölt laphoz, amely azt fel tudja dolgozni. Az űrlapon belül az alábbi adatbeviteli lheetőségek vannak:

Egy soros szöveg bevitelére szolgál

- Egy soros password, beviteléhez kell.

15.1.1 Önmagukat meghívó űrlapok Gyakori feladat, hogy egy Űrlapot meghívunk, leellenőrizzük és a következő oldalon csak akkor küldjük tovább a böngészőt, ha az oldal hibátlanul ki van töltve. Ehhez az alábbi dolgoknak kell teljesülnie: Az űrlapot saját magának küldi el a PHP oldal Amikor beérkezik a kérés a szerver oldalon ellenőrizzük a megfelelő értékek meglétét. Ha az értékek megvannak, akkor feldolgozzuk őket Ha nincsenek meg az értékek, akkor újra meghívjuk a feldolgozandó adatot: Az alábbi példában két rértéket küldünk el egy feldolgozandó oldalnak. Ha nincs kitöltve mind a két érték, akkor újrahívjuk a feldolgozandó oldalt. A feldolgozás részen a feldolgozott értékek valamiféle lekérdezésbe torkollnak vagy akármilyen egyéb műveletet végezhetünk vele. Javasolt egyéb műveletek: Az átadott adatok típus szerinti ellenőrzése. Erre használhatók az alábbi függvények: is_bool() – logikai-? is_int(), is_integer() – egész-e? is_float(), is_real(),– lebegőpontos-e? is_object() – Objektum-e? is_array(). – Tömb-e? Is_string() – string-e? Az átadott adatokból célszerű kivenni a HTML kódokat, mivel biztonsági problémák merülhetnek fel

Az átadott értékekből célszerű kiszedni a [{()}] jeleket.

59

Ha az így bevitt értékek közvetlenül SQL lekérdezések összeállítására használatosak, akkor célszerű még egyéb speciális jelek kivétele is, például = <> OR, AND ! stb... $a =array(”[”,”{”,”(”,”)”,”}”,”]”,”or”,”and”,”!”); $str = str_ireplace($a, " ", $str);

$uz =’Töltsd ki a név beviteli mezőt”; $uz .=’Töltsd ki a jelszó beviteli mezőt”;

} if (!empty($uz)){ //Form kiiratása print(”
”.$uz.”
”); print(’
’); print(””); print(””); print(””); print(”
Név: print(””); print(”
Jelszó: ”); print(”
”); print(””); print(”
”); print(’
’); }else{ /* Feldolgozás*/ } ?>

60

16 Formok adatainak feldolgozása – szerver- és kliens oldalon A PHP-ben a HTML űrlapok (FORM-ok) felhasználásával történik meg az interakció a felhasználó és programja között. Az űrlapok használatának gyakori formája, hogy az űrlap a saját magát tartalmazó oldalt hívja meg és az űrlap kitöltöttségét olyan kóddal ellenőrizzük, amely ugyanazon az oldalon van. Ez célszerűen azért lehet így, mert a beviteli formátum és az ellenőrzés is egy helyen található. A példában egy egyész típusú, 1000-nél nagyobb adatot és egy folyószámla nevet vár a beviteli oldalon a program. Urlap.php 1000)){ $ok = $ok && False; //Ezernél nagyobb értéket ellenőrzök éppen $mess_adat = ’Túl kicsi érték!
’; } }else{ $mess_adat = ’Hibás adattípus!
’; } }else{ $mess_adat = ’Hiányzó adat!
’; } //Ellenőrizzük, hogy a folyószámla neve megfelel-e? $fszamla = -1; if (isset($_POST[”fszamla”])){ $fszamla= $_POST[”fszamla”]; if (is_string($fszamla)){ $fszamla = $urldecode($fszamla); //Esetleges URL kódolás dekódolja $fszamla = strip_tags ( $fszamla); //kiveszi a HTML és PHP tageket $fszamla = stripcslashes ( $fszamla); // kiveszi a \ jeleket //SQL injekció kiszűrése!!! $keres = array (”WHERE”,”LIKE”,”(”,”)”); $csere = array (” ”,” ”,” ”,” ”); $fszamla = str_replace($keres,$csere,$fszamla); if (van_e_szamla($fszamla)){ $ok = $ok && False; //Ezernél nagyobb értéket ellenőrzök éppen $mess_fszamla = ’Nincs ilyenfolyószámla!
’; } }else{ $mess_fszamla = ’Hibás adattípus!
’; } }else{ $mess_fszamla = ’Hiányzó adat!
’; } .... itt ellenőrizzük a többi szükséges mező értékét és létezését ... } if(!$ok){ print(’
’); print($mess_adat); print(<’INPUT type=”text” name=”adat” value=<% = $adat %> > ’); print($mess_fszamla); print(<’INPUT type=”text” name=”fszamla” value=<% = $fszamla %> > ’); ...

további beviteli mezők ...

print(’’); print(’
’); }else{

61

.... adatok feldolgozása ... header("Location: http://www.example.com/"); exit;

//A böngészőt átdobom a következő oldalra // a kód többi része ne fusson le

}

A párbeszédek alkalmazásánál fontos, hogy ellenőrizzük a bevitt adatokat, mivel véletlenül, akarva vagy akaratlanul olyan adatok kerülhetnek a meghívott oldalra, aminek típusa, formátuma nem felel meg az elvárásoknak ennek érdekében az alábbi ellenőrzéseket célszerű megtenni: •

Egy oldalon minden mező ki van-e töltve

•

A megfelelő típusú, formátumú adat került-e bele

•

Nincs-e benne HTML vagy PHP, vagy SQL utasítás kód (ezek sanda szándékok esetén szoktak bekerülni)

Az ellenőrzést két lépcsőben célszerű megtenni. A kliens oldalon megfelelő Javascript kód segítségével és a szerveroldalon a PHP kód segítségével, mint fent is látszik. Bár a Javascript ennek a jegyzetnek nem témája, azért az ellenőrzésre adunk példát itt. A megoldás alapja, hogy minden beviteli mező vagy a Formon lévő ”Elküld” gomb megnyomására lefut egy ellenőrző script a böngészőn, ami ellenőrzi, hogy ki vannak-e töltve a megfelelő mezők. A Javascript ellenőrzés ugyanakkor nem helyettesíti a PHP oldali ellenőrzést, mert a böngésző oldalon megfelelő technikákkal el lehet kerülni az ellenőrzést.

62

17 Levélküldés, plain text, html levél, attachement A PHP-ban van lehetőség arra, hogy leveleket küldjünk el megadott címre, megadott tartalomal. Az üzenetküldéshez először a PHP.INI-ben be kell lenni állítani az alábbi szakasz értékeit. Az alábbi sorok a Win32-es rendszeren beállítandókat tartalmazza. Be kell állítani annak az SMTP szervernek a címét kell írni, amelyik elküldi a levelünket és annak a usernek a nevét, akivel defaultban küldünk levelet. [mail function] SMTP = mail.szily.sulinet.hu ;for win32 only sendmail_from = [email protected] ;for win32 only

A levél elküldése a mail paranccsal történik, de mielőtt elküldenénk, létre kell hozni azokat a stringeket, amelyek segítségével a levél különböző szakaszai létrejönnek. $cimzett = [email protected]; $tema = ”drágám”; $uzenet = ”A kölykök összementek. Mind a kettőt hiába keresem. Géza” $fejlecek .= "From: Tőlem \n"; $fejlecek .= "X-Sender: \n"; $fejlecek .= "X-Mailer: PHP\n"; // Levelezőprogram $fejlecek .= "X-Priority: 1\n"; // Sürgős üzenet! $fejlecek .= "Return-Path: \n"; //Hiba esetén ide jön levél mail($cimzett, $tema, $uzenet, $fejlecek);

A levél szövegét és a fejlécet tovább cifrázhatjuk. A fenti mezőkön kívül használhatjuk például a cc: bc: Reply-To: és a hasonló fejléc mezőket is. Hogy milyen mezőket lehet használni, bámelyik leveled fejlécéből kinézheted. Sajnos az attachmentek kezelése nem tartozik ele a php által támogatott dolgok körébe, ezért külső alkalmazás nélkül nem tudunk attachmentet küldeni php-ben. Egy lehetőség adódik komolyabb levelezési funkciók használatára. Meg kell hívni egy külső, parancssori levelezőszoftvert, amelynek a megfelelő paraméterezésével tetszőleges levelezési funkcókat el lehet érni. Ilyen szoftver például a POSTIE.EXE Windows alatt. Ez a program és más hasonló programok az Internetről letölthetők. A levelezés kérdéskörében fontos, hogy formázott leveleket is tudjunk küldeni. Erre alkalmasak a HTML levelek. A HTML levelek küldéséhez elég sokmindent el kell végezni, alapesetben a PHP nem támogatja a HTML levelek küldését, de a NET-en találhatók egyszerű objektumcsomagok, amelyek ebben az esetben segítenek (http://phpmailer.sourceforge.net) Ennek a csomagnak a használatára álljon itt egy példa: IsSMTP(); $mail->Host = "smtp.mydomain.com"; $mail->SMTPAuth = true $mail->Username = "fz" $mail->Password = "titok"

// // // // //

set mailer to use SMTP specify main and backup server turn on SMTP authentication SMTP username SMTP password

$mail->From = "[email protected]”; $mail->FromName = "Levelező"; $mail->AddAddress("[email protected]", "X Y"); $mail->AddReplyTo("[email protected]", "Information"); $mail->WordWrap = 50; $mail->AddAttachment("C:\temp\text.zip"); $mail->IsHTML(true);

// set word wrap to 50 characters // add attachments // set email format to HTML

63

$mail->Subject = "Ez itt a targy"; $mail->Body = "Ez a HTML szöveg rész vastagon!"; $mail->AltBody = "Ez a rész a nem HTMl szöveg"; if(!$mail->Send()) { echo "A szöveg nem ment el.
"; echo "Levelező hiba " . $mail->ErrorInfo; exit; } echo "A levél elment"; ?>

A fenti csomag telepítésekor gondoskodni kell arról, hogy a PHP.INI-ben be legyen állítva az include_path a class.phpmailer.php file-ra, amit az alábbi módon tehetünk meg futás közben: $incl_path = ini_get("include_path"); $incl_path .= ”;./phpmailer”; ini_set("include_path", $incl_path);

64

18 Adatbázisok A PHP programozási nyelv úgy kezeli az adatbázisokat, hogy a nyelvbe beépítették az elterjedt és támogatott adatbázis-kezelők támogatását. Az adatbáziskezelők általában SQL rendszerek, és kliensszerver minta szerint működnek együtt a PHP-val. Egy PHP-val meghajtott adatbázis-kezelő rendszernek az alábbiakban éehet felrajzolni a működési sémáját: Szerver számítógép /szerver oldal HDD/ adatbázis

ó

Adatbáziskezelő program

ó

Adatbáziskezelő driver

ó

Kliens számítógép PHP

ó

WEB szerver

ó Internet felhő ó

WEB böngésző

Egyes adatbázis-kezelőket a PHP alapból beépítve támogatja, míg másokhoz be kell tölteni a PHP.INIben a megfelelő sorok segítségével a támogatást. A használhatóság módja három féle lehet: Alapból támogatja a PHP az aktuális rendszert Be kell tölteni a megfelelő modult A Windows verzió esetén a PHP.INI file Windows Extensions részében az alábbi bejegyzés kell: Extensions = postgresql.dll

Linux verzió esetén az alábbi sor kell: Extensions = postgresql.so

Fordításkor be kell fordítani a támogató modult, LIB-ből A mi esetünkben az első és második módszer az, ami érdekes lehet. Természetesen minden esetben kell telepíteni egy adatbázis-szerver szoftvert, amely nem mindig ingyenes! Magyarországon elterjedt legfontosabb adatbáziskezelők az alábbiak Adatbáziskezelő

Támogatás módja

Az adatbázis-kezelő web címe

Tulajdonságai

MySQL

Beépítve

www.mysql.com

Free, gyors, Win és LINUX verzió létezik

DBASE

Beépítve

www.dbase.com

A dBase 3+ verzió standard, az adatcsere állományok gyakori formátuma. Nem ajánlott a használata éles alkalmazásban

mSQL

be kell fordítani

www.hughes.com.au

Kicsi, könnyen telepíthető, 14 napig free

Ingres

be kell fordítani

www.ingres.com

Nem free, a Computer Associates fejleszti

Interbase

php_interbase.dll

www.interbase.com

Teljes körű, jó adatbázis-kezelő, ajánlható, az InterBase 6.01 free!

Microsoft SQL7.0/ 2000

php_mssql70.dll php_mssql.dll

www.microsoft.com

Régebbi verzió, létezik un. Personal és Evaulation Edition. Minden MS fejlesztőtermék része a Personal Edition változat.

Oracle8

php_oci8.dll

www.oracle.com

Nem free, teljes körű, nagy tudású SQL szerver

Oracle7

php_oracle.dll

www.oracle.com

Nem free, teljes körű, nagy tudású SQL szerver régebbi verziói

PostGres SQL

php_pgsql.dll

www.postgresql.org.

LINUX és Windows verzió is van, free, teljes SQL rendszer

ODBC

Beépítve

Az ODBC = Open DataBaseConnectivity – A Microsoft által létrehozott, elvileg platform és adatbázis-kezelő független felület, minden elterjedt adatforrásnak van ODBC drivere. Win és Linux alatt is léteznek ODBC driverek

65

18.1 MySQL A fenti adatbázis-kezelőkről annyit, hogy jelenleg a legelterjedtebb ilyen alkalmazás a Linuxon, Netware-en és Windows rendszereken is futó MySQL. Ez a rendszer talán a leggyorsabb az összes elterjedt adatbázis-kezelő között, de jelenleg a (MySQL 4.0.*) MySQL nem valósítja meg az SQL összes lehetőségét, és nem támogatja a tárolt eljárásokat, továbbá a táblák közötti állandó (perzisztens) kapcsolatokat, csak egy speciális fajta adatbázis esetén (InnoDB). Ez a WEB-es alkalmazások esetén nem túlságosan nagy baj, mert azok tipikusan nem adatmódosítással foglalkoznak, hanem inkább lekérdezéssel, ebben pedig a MySQL nagyon gyors. A hírek szerint a MySQL 5.0 a fenti hiányosságokat kiküszöböli. A MySQL nagyon előnyös tulajdonsága, hogy GNU liszensszel lehet használni, azaz akkor is free, ha eladási céllal használjuk, de magát a MySQL adatbázis-kezelő programot nem adjuk el ( J). Miért is tennénk, ha egyszer az Internetről letölthető. A MySQL letölthető az alábbi címről: http://www.mysql.com/downloads/mysql-4.0.html Telepítése egyszerű Windowson el kell indítani a ZIP-ből való kicsomagolás után a SETUP.EXE programot, a többit elkészíti ő. Ha firewall van a gépünkön, akkor a TCP/IP 3306-os portját kell szabaddá tennünk. Ha a szerver ugyanazon a gépen fut, mint amelyiken a WEB szervert és a PHP-t futtatjuk, akkor a Firewallon nem szabad (!) engedélyezni más gépről ehhez a porhoz való hozzáférést. Ha fejlesztés közben az adatbázisunkat módosítani akarjuk, különböző dolgokat akarunk elvégezni, akkor ajánlhatjuk a free phpMyAdmin nevű csomagot, illetve a professzonális, de pénzes EMS MySQL Manager programcsomagot. Magában a MySQL csomagban is van egy WinMySQLAdmin nevű eléggé bugyuta alkalmazás. Ha feltesszük a MySQL ODBC driverét, akkor viszont tetszőleges ODBC kompatibilis alkalmazásból el tudjuk végezni az adatok módosítását, feltöltését stb... Akár ez lehet egy Microsoft Access is. A MySQL használatához dokumentációt innen lehet letölteni: http://www.mysql.com/get/Downloads/Manual/manual.chm-2002-10-07.zip/from/pick

18.2 PostGres SQL A PostGres SQL egy kicsit komolyabb alkalmazás, mint a fent említett adatbázis-kezelő. A telepítése sajnos nem egyszerű, mivel alapvetően Linux-ra íródott program. A telepítés menetét Molnár László PHP listán közölt leírása alapján közlöm. 1. Letoltod: http://www.cygwin.com/setup.exe 2. Ha megvan elinditod a setup.exe -t Lassuk a telepitest: - Indulas utan kerdezi, hogy mit tegyen: * Install from internet * Download form internet <- EZT VALASZD * Install form local directory -

Megkerdezi, hogy hova telepitsen (oda teszed ahova akarod) Kivalasztod a kapcsolatot Ha keri kivalasztasz egy szimpatikus mirrort ekkor letolti a setup.bz2-t Most jon a lenyeg elso fele SELECT PACKAGES A + jelekre kattintva kijeolheted, hogy mit toltson le ha kibomlik a lista, a 'Skip' szóra kattintva kijeloli - itt celszeru minden kijeolni hiszem most csak letoltod a csomagokat. - ha Tovabb lepsz szepen elkezd tolteni. (A teljes csomag lehet, akár 180 MB is!) Ha már letöltöttél minden csomagot, johet a telepites: Ujra futtasd a korabban letoltott setup.exe -t. - Most valaszd az Install from local directoy -t - Add meg a root konyvtarat. (default: c:\cygwin) - Add meg a csomagok helyet. (pl: f:\ftproot\ftp%3a%2f%2fftp.univie.ac.at%2fpackages%2fcygwin) - Jelöld ki azokat a csomagokat, amire szükséged lehet, illetve van, amit nem szabad kihagyni:

66

Archive - zip / unzip Database - postgresql !!!!!!!!! EZT NE HAGYD KI. EZERT JOTTEL :-)) Editors - valassz egyett. vagy mind :-)) Utils - bzip2 - ha nem teszed fel kesobb bajba lehetsz! - Ha kivalasztottad a szukseges csomagokat mehet az telepites (csak kattints a Tovabb gombra :-)))) Telepites kesz johet a postgreSQL. - most mart indulhat: futtasd: C:\cygwin\cygwin.bat - es lass csodat ott a cygwin prompt. (Bshell prompt) Johet a inicializalas: $ ipc-daemon2 & $ initdb -D /var/pgsql/data Ez is kesz! Akkor lassuk a medvet: FIGYELEM! az 'ipc-daemon &' mindig ki kell adni ha nem fut :-)) Ezt eleg 1x megtenni amikor einditod a cygwin -t. Az server inditasahoz itt egy indito script, a neve és elérési helye: c:\cygwin\bin\pg_start #!/bin/bash ipc-daemon2 & postmaster -i -D /var/pgsql/data >/var/log/pgsql.log & Telepiteskor 1 usert felvesz a szerver, azt aki telepítette, tehát pl. magyar WinXP-n Rendszergazda. Ha elinditod pl. pgAdmin3-t, amit szintén le lehet tölteni a NET-ről, például innen: ftp://ftp2.cz.postgresql.org/pub/postgresql/pgadmin3/release/win32/pgadmin3-1_0_1.zip Server: localhost Port: 5432 User: Rendszergazda Kész.

A PostgresSQL használatához dokumentációt az alábbi helyen lehet elérni: http://www.postgres.org/docs/ Itt HTML és PDF formátumban vannak meg a megfelelő dokumentumok.

67

18.3 Adatbázis-kezelés natív módon Az adatbázis-kezelők használatához a PHP.INI-ben meg kell adni a megfelelő beállítást (vagy, mint például a MySQL-nél, eleve a támogatás a rendszer része), és programunkban használhatjuk az adatbázisra vonatkozó utasításokat. A PHP az adatbáziskezelésre általában az alábbi utasításfajtákat tartalmazza. -

Az adatbázis-kezelő szerverrel kapcsolatot teremtő, a kapcsolatot lezáró parancsok

-

Az adatbázisokra vonatkozó lekérdező és adminisztrációs parancsok

-

Egy megnyitott adatbázisra vonatkozó adminisztrációs és lekérdező parancsok

-

Az SQL lekérdezéseket átküldő parancs

-

A lekérdezés eredményét feldolgozó parancsok.

A továbbiakban a MySQL utasításai alapján mutatom be az adatbáziskezeléssel kapcsolatos utasításokat. Más adatbáziskezelő esetén a változás általában csak annyi, hogy a névben az előtag más. Például: Mysql_connect() //MySQL adatbázis-kezelő esetén pg_connect() //PostgresSQL

Kapcsolódás egy adatbáziskezelőhöz, amely vagy lokális gépen helyezkedik el, vagy egy távoli, IP címmel meghatározott gépen. A kapcsolat létrehozása meg kell adni a kapcsolódási helyet (localhost, vagy IP cím), a kapcsolódó user-t, és a user jelszavát. $link = mysql_connect(”localhost”,$username,$password);

vagy $link = mysql_pconnect(”localhost”,$username,$password);

A fentiekhez egy kis magyarázat. A connect és pconnect között az a különbség, hogy a connect-tel megnyitott kapcsolat lezárul a kérdéses php oldal lefutása után, míg a pconnect kapcsolat nyitva marad (Persistent connection), és újbóli kapcsolódás során csak akkor kell egy viszonylag sokáig tartó kapcsolódási procedúrán átmennie a rendszernek, ha a kapcsolat nincsen nyitva. Egyébként a pconnect használata ugyanaz, mint a connect-é. A visszaadott érték a kapcsolat sorszáma. Ennek alapján lehet a továbbiakban azonosítani több megnyitott kapcsolat esetén, hogy éppen melyik kapcsolatot használjuk. A kapcsolat bezárása: mysql_close($kapcsolat)

Példa

Az adatbáziskezelőn lévő adatbázisokra vonatkozó parancsok int mysql_list_dbs ([int link_identifier]) int mysql_create_db (string database name [, int link_identifier]) int mysql_drop_db (string database_name [, int link_identifier])
68

} else { printf ("Error creating database: %s\n", mysql_error ()); } ?>

int mysql_select_db (string database_name [, int link_identifier])

Egy konkrét adatbázis tábláinak kilistázása Egy adatbázis (lekérdezés) oszlopneveinek listázása. Ugyanez az utasítás a lekérdezés eredményének tetszőleges adatait is kilistázza ... object mysql_fetch_field (int result [, int result_type])

Mezőnevek kiírása, és tárolása a mezonev tömbben name; //Oszlop/Mező adatainak kilistázása. echo "
blob: $meta->blob max_length: $meta->max_length multiple_key: $meta->multiple_key name: $meta->name not_null: $meta->not_null numeric: $meta->numeric primary_key: $meta->primary_key table: $meta->table type: $meta->type unique_key: $meta->unique_key unsigned: $meta->unsigned zerofill: $meta->zerofill
"; } mysql_close(); ?>

Egy SQL parancs elküldése resource mysql_query ( string query [, resource link_identifier])

Az Adatbáziskezelőnek adott SQL, vagy egyéb utasítás eredményének átvétele a pufferből. Az eredmény általában két dimenziós tömbbe érkezik, amelyet vagy a tömbkezelő függvények segítségével lehet feldolgozni, vagy indexel és ciklussal végig kell szaladni rajta. A visszaadott paraméterről mindig meg tudjuk mondani, hogy hány sorból áll. Az alábbi függvény megadja az eredmény sorainak számát. Ha nincs eredmény sor, akkor az értéke 0. int mysql_num_rows()

Ha Delete, Update utasítások eredményére vagyunk kiváncsiak, akkor az alábbi függvényt kell használnunk. int mysql_affected_rows ( [resource link_identifier])

Egy sort ad vissza egy tömbbe az alábbi függvény. A tömb öt sorszámokkal lehet indexelni, a sorszámozás 0-val kezdődik. Akkor használhatjuk, ha egy lekérdezésről nem tudjuk előre, hogy hány sort ad majd vissza. array mysql_fetch_row([resource link_identifier])

69

Ennél a függvénynél szükségünk lehet a visszaadott oszlopok számára is. Ezt az alábbi függvénnyel tudjuk meg: int mysql_num_fields ( [resource result])

Ez a függvény a sort szintén egy tömbben adja vissza, de a tömbelemek sorszámozva és a mezőnévvel is, mint asszociatív tömbindexxel elérhetők. array mysql_fetch_array([resource link_identifier)

Az alábbi példa elküld egy lekérdezést, az eredmény oszlopneveit lekérdezi, majd megjeleníti táblázatos formában. int mysql_fetch_object([resource link_identifier])

Az alábbi példa elküld egy lekérdezést, az eredmény oszlopneveit lekérdezi, majd megjeleníti táblázatos formában. ”; for($i=0;$i<$n;$i++) { $mezok=mysql_fetch_field($result); echo "".$mezok->name.""; $meznev[]=$mezok->name; } echo""; // mezok kiirasanak vege // // mezokben levo adatok kiirasa // for($i=0;$i<$m;$i++) { echo""; $adat=mysql_fetch_array($result); for($j=0;$j<$n;$j++) echo "".$adat[$meznev[$j]].""; echo""; } echo ””; ?>

18.4 Tipikus feladatok adatbázis-kezelésnél Egy adatbázis-kezelő használata során az alábbi tipikusnak mondható feladatokat kell megoldani PHPban, (de hasonlóképpen más programozási nyelveken is). -

Kapcsolódunk a szerveren lévő adatbázishoz.(láttunk mintát hozzá)

-

Elküldünk egy SQL lekérdezést az adatbázis-kezelő programnak (Láttunk mintát)

-

Az elküldött lekérdezésre kapott válasz általában egy táblázattal, vagy két-dimenziós tömbbel reprezentálható. Ezt szokás rekordszet-nek hívni. Egy ilyen rekordszetet megjelenítünk, célszerűen táblázatos formában. Ha a rekordszet túl sok sorból áll, akkor vagy a lekérdezéskor adunk olyan feltételeket, amely kevesebb sort ada eredményül, vagy megalkotjuk annak a lehetőségét, hogy a táblázat eredményét görgetni, vagy lapozni lehessen. (később általános mintát láttunk, az előző fejezetben bizonyos speciális eseteket néztünk)

-

A rekordszet egyes sorait „űrlap” formájában meg akarjuk jeleníteni (később látunk mintát a fejezetben)

-

Az űrlap vagy a rekordset eredményét ki akarjuk nyomtatni

-

Az adatbázisba új adatot akarunk bevinni. 70

o Egy rekordszethez illeszkedő új sorral o Egy rekordszethez illszkedő új sor-űrlap formájában bevitt adatokkal. o Minden adatbevitelnél valamilyen tipizálható ellenőrzési feladatot illik elvégezni, vagy a bevitt adatokat szintaktikailag és/vagy szemantikailag ellenőrizni illik. o Adatok bevitelekor vagy módosításkakor, amikor csak lehet az adatokat egy felkínált listából kelljen kiválasztani – a tévedések elkerülése miatt. -

Adatok módosítása lehetőség szerint az új adat bevitelével azonos formátumban és módon történjen.

-

Egyes adatok, adatsorok, rekordok törlése, ellenőrzött módon.

-

Az adatok bevitele vagy módosítása során, hibás adatfelvitel miatti ismétléskor a korábban bevitt vagy meglévő adat jelenjen meg a beviteli űrlapon.

A fenti feladatokhoz az alábbi nem igazán PHP-ben megvalósított fogalmakat társíthatunk: Az adatok táblázatos megjelenéséhez az alábbi séma szerint érdemes eljárni abban az esetben, ha két dimenziós táblázatban kapom meg az adatokat. Print( ””); For($i=0;i<$maxsor;$i++){ Print(””); For($j=0;$j<$maxoszlop; $j++);{ Print(”); } Print(””); } print(”
); Print(adat[$i][$j]); Print(”
”);

Természetesen a táblázat formázását, a szegélyeket, stb… mindenki a saját ízlése szerint alkothatja meg. Ha az adatokat soronként vezsem át az adatbáézis-kezelőtől, akkor a fenti algoritmus kicsit megváltozik. Azt is megmutatom a következő példában, ha nem az oszlopok száma adott a lekérdezett rekordszetben, bár ezt is mindig meg lehet tudni egy adott esetben, hanem a mezőnevekkel, asszociatív módon tudok hivatkozni egy sorra. Erre az előző fejezetben láttunk példát. ”); for($i=0;$i<$n;$i++) { print(””); //Oszlopnév/mezőnév bemásolása tömbbe későbbi felhasználásra $mezok=mysql_fetch_field($result); $meznev[]=$mezok->name; //Oszlop/Mező adatainak kilistázása. print(””); print($meznev[$i]); print(””) print(””); print($sor[$meznev]); print(””) print(””);

//A mező neve

//A mező értéke

} print(””); mysql_close(); ?>

A fenti megjelenítés még elemi módomn sem alkalmas új adatok bevitelére, hiszen új adatokat WEB böngésző esetén csakis FORM-okon keresztül vihetünk fel. Mindezek mellett meg kell oldanunk a 71

mezők ellenőrzését is. Ennek megfelelően módosítanunk kell a fenti megoldást kissé. A példáról annyit, hogy egy űrlap jelenik meg, amely a megjeleníti a mezőket egy INPUT HTML tag segítségével, amivel a z értéket rögtön módosítani is lehet. A bevitt adatokat minden mező esetén a böngésző javascript kódja rögtön ellenőrzi is (Hogy egyáltalán ki van-e töltve). Ha nincsen kitöltve, akkor hibaüzenet érkezik. <SCRIPT LANGUAGE="JavaScript1.2" type="text/JavaScript1.2"> function elenoriz() { var k=document.form1.text.value; if (k.length<1){ alert("Nincs kitöltve az adat!!"); return false; } else{ return true; } } print(””); for($i=0;$i<$n;$i++) { print(””); //Oszlopnév/mezőnév bemásolása tömbbe későbbi felhasználásra $mezok=mysql_fetch_field($result); $meznev[]=$mezok->name; //Oszlop/Mező adatainak kilistázása. print(””); print(””) print(””);

//A mező értéke

} print(””); print(””) print(””); print(””); print(”
”); print($meznev[$i]); //A mező neve print(” ”); print(””); print($sor[$meznev]); print(”

”); print(””); print(””); print(” ”); print(”
”); mysql_close(); ?>

72

18.5 Hibakezelés A MySQL szerver a lekérdezések során hibakódot és szöveges üzenetet is küld vissza a kliensnek. A hiábk kezelésére az alábbi függvényewk használhatók: string mysql_error ([int link_identifier])

A MySQL szerver által visszaadott hiba szövegesen int mysql_errno ([int link_identifier])

A MySQL szerver által visszaadott hiba kódja. "; mysql_select_db("nincsadatbazis"); echo mysql_errno().": ".mysql_error()."
"; $conn = mysql_query("SELECT * FROM nincsadattabla"); echo mysql_errno().": ".mysql_error()."
"; ?>

A fenti lehetőségek csak a MySQL-re vonatkoznak, de hasonlóan lehet használni őket más adatbázisok esetén is.

18.6 Adatbáziskezelés másképpen – absztrakciós rétegek, ADODB, ODBC Fontos kérdés, hogy mit tegyünk akkor, ha előre nem tudjuk, hogy milyen adatbáziskezelőt fogunk használni az oldalunkon, vagy ha hozzászoktunk olyan adatbáziskezelőkhöz, mint például az ADODB rendszerhez Microsoft Windows környezetben. Alapvető dolog, hogy az egyes adatbáziskezelők általában az SQL szintakszis szerint működnek, tehát ha készítünk egy olyan programcsomagot, amely eltakarja előlünk az adatbáziskezelők közti különbségeket, akkor tudunk erre alapozva olyan alkalmazást írni, amelynek mindegy, hogy melyik adatbáziskezelőt használja. Ez az absztrakciós réteg alkalmazásának módszere

18.6.1 Az absztrakciós réteg A konkrét adatbáziskezelőtől független olyan utilitycsomag, amely eltakarja az adatbázis-kezelők közötti különbségeket, kiegészíti azokat plusz funkciókkal kényelmesebbé teszi az adatbáziskezeléssel kapcsolatos programozást. Persze felmerül a kérdés, hogy vajon nem, lassítja-e le nagyon a programjaink futását egy ilyen réteg alkalmazása. Megnyugtathatjuk a kedves olvasót, hogy bármiféle absztrakciós réteg lassítja a rendszert, de csak olyan csekély mértékben, hogy a lassulás észrevehetetlen, csak extrém nagy szerver terhelés, mellett észrevehető, ugyanakkor az alkalmazásfejlesztés nagyságrendekkel meggyorsul. Ilyen egyszerű absztrakciós réteget többet is lehet találni az interneten:

18.6.2 ODBC programcsomag A Microsoft már korábban megvalósított egy adatbáziskezelés esetén jól használható absztrakciós eljárást, ez pedig az ODBC driverek csoportja Az ODBC driverek olyan meghajtók, amelyek a windows rendszerre telepített (szinte) tetszőleges adatbáziskezelőt egységes módon érnek el. Ennek megfelelően az ilyen drivert használü alkalmazások a Windows rendszeren az SQL szerver módosításával is működnek, ODBC-n keresztül érik el őket. Használatuk: 1. Létre kell hozni az adatbázist valamilyen adatbáziskezelővel: Egy windows rendszeren lehet, Access, MSSQL, MySQL, PostgresSQL, InterBase SQL, vagy bármi más, amelynek létezik ODBC drivere. 73

2. Létre kell hozni egy ODBC kapcsolatot. Ezt az ODBC kezelővel tehetjük meg. A különböző Windows verziók esetén ez máshol van, de alapvetően a Vezérlőpult környékén kell keresni „ODBC adatforrások” vagy hasonló néven. Az alábbiakban a Windows XP magyar verziójából vesszük a példát:

A fenti beállításokkal most egy MySQL adatforrást adtunk meg. Ezek után az ODBC adatbáziskezelőt kell használni a PHP-ban. Az ODBC csomag részletes leírását lásd az alábbi helyen: http://www.php.net/manual/hu/ref.odbc.php

18.6.3 Az ADODB rétegezés (Az alábbi leírást az eredeti ADODB manual fordításával és rövidítésével készítettem el.) Az ADODB a Microsoft által kifejlesztett adatbáziskezelési programcsomag, amely egyesíti az SQL adatkezelés és a kliens oldali adatelérés előnyeit. A lényege, hogy az adatbáziskezelőtől lekérdezésekkel kapott eredményeket – rekordszeteket – nem csak szekvenciálisan dolgozhatunk fel, hanem véletlen eléréssel bármelyik részét elérhetjük. Segítségével könnyen tudunk gördíthető menüket, listboxokat és ehhez hasonló objektumokat készíteni grafikus rndszerben. Az phpADODB könyvtárszerkezete ehhez hasonló funkciókat valósít meg. Az ADOdb for PHP-hez legalább PHP 4.0.2 kell. Használatának előnyei: 74

-

Könnyen használható a windowson programozóknak, mivel szintaktikája hasonlít a Microsoft féle ADODB-hez.

-

A PHP natív adatbázis-kezelése felé egy réteget von, ami nem lassítja le lényegesen az adatbázis elérését, viszont tetszőleges adatbázison azonossá teszi az adatbáziskok kezelését.

-

Nem csak lekérdezésekre, hanem Update és Insert utasításokra is jól használható.

-

Támogatja a PHP4 sessionját.

-

Alapvető adattípusokkal dolgozik – ez is a különböző rendszerek kompatibilitását segíti elő.

Telepítése: Az ADODB library-t letöltés után be kell tenni az adodb alkönyvtárba, vagy a PHP include library-jai közé. Ez utóbbi esetben a PHP.ini file-t meg kell szerkeszteni egy kicsit: ; Windows: "\path1;\path2" include_path = ".;i:\phplibs;i:\phplibs\adodb;"

Ekkor az alábbi formát lehet használnunk, mivel a PHP eléri mindig az ADODB-t. debug = true; $db->Connect($server, $user, $password, $database); $rs = $db->Execute('select * from some_small_table'); print_r($rs->GetRows()); ?>

Ha nem tudjuk library-be tenni, akkor egy alkönyvtárba tesszük az ADODB programcsomagot. debug = true; $db->Connect($server, $user, $password, $database); $rs = $db->Execute('select * from some_small_table'); print_r($rs->GetRows()); ?>

A scriptben az include(’adodb/adodb.inc.php’);

utasítással mondjuk meg a scriptnek, hogy ADODB adatbázist fog kezelni a program. Az adatbázis típusát az $conn = ADONewConnection('mysql') vagy a $conn = &ADONewConnection(' mysql');

formát használhatjuk a kapcsolat létrehozására. Ennek hatására létrejön a $conn nevű objektum, amely minden olyan paramétert és metódust tartalmaz, ami a későbbi kezeléshez szükséges. Amennyiben egy másik oldalon újra szükségünk van ennek az objektumnak az adataira, az objektumot célszerű lementeni sessionba, majd a következő oldal elején újra betölteni. Feltéve azt, hogy az objektum definició már lefusson, amikor a session elindul, tehát, ha van egy általános session kezelő rutincsomagunk, akkor a helyes includolási sorrend az alábbi: include(’adodb.inc.php’); include(’session.php’);

75

Az alábbi táblázat a leggyakrabban előforduló adatbázisokat sorolja fel. Név

Áll. Adatbázis-kezelő

Rekord sorsz

Hivatkozás, kliens

Op.rend.

access

B

Microsoft Access/Jet. You need to create an ODBC DSN.

Y/N

ODBC

W

ado

B

Általános Microsoft ADO, nem specializálva semmilyen Adatbázistól ADO, OLEDB W adatbázisra. Lehet DSN-nélküli Lehetőség szerint OLEDB függ adatforrás adatbázis. Kapcsolódás előtt állítsd be a $db->codePage értéket.

ado_access B

Microsoft Access/Jet ADO, DSN-nélküli kapcsolat. Használj Y/N OLEDB adatbázist.

ADO,OLEDB W adatforrás

ado_mssql

B

Microsoft SQL Server ADO-t használva, DSN-nélkül

Y/N

ADO,OLEDB W adatforrás

vfp

A

Microsoft Visual FoxPro. ODBC DSN-nel

Y/N

ODBC

W

mssql

A

Microsoft SQL Server 7 / 2000. A dátumok kezelése problémás

Y/N

Mssql client

U, W

mysql

A

MySQL tranzakció nélkül!

Y/N

MySQL client U, W

mysqlt, maxsql

A

MySQL tranzakcióval.

Y/N

MySQL client U,W

oci8

A

Oracle 8/9. Jobb, mint a többi oracle driver. Használnod kell az Y/N alábbi parancsot: putenv('ORACLE_HOME=...') Connect/Pconnect előtt. Kétféle kapcsolódás létezik: IP és szerviz névvel: PConnect('serverip:1521','scott','tiger','service') vagy TNSNAMES.ORA és ONAMES vagy PConnect(false, 'scott', 'tiger', $oraname).

U, W

HOSTNAMES:

Általános ODBC parancs kapcsolódás: Connect('DSN','user','pwd').

? depends on ODBC database

W,U

odbc_mssql C

ODBC, MSSQL kapcsolattal

Y/N

ODBC

U,W

odbc_oracle C

ODBC Oracle kapcsolattal

Y/N

ODBC

U, W

odbc

A

Oracle client

oracle

C

Oracle 7. Jobb az oci8 driver.

Y/N

Oracle client

U, W

postgres64

A

PostgreSQL 6.4 és kjorábbi esetben LIMIT internally.

Y

PostgreSQL client

U,W

postgres7

A

PostgreSQL7 illetve későbbi.

Y

PostgreSQL client

U,W

A = Jól bevált, használatos B =Tesztelt, de bizonyos részei még nincsenek készen C = Még kisérleti állapotban van W= windows U = Unix/Linux Ha a fenti adatbázisok egyikát használjuk ADODB-vel, az alábbi lehetőségeink vannak A továbbiakban nézzünk egy programot, amely a Microsoft Acces-hez adott NorthWind adatbázisból egy lekérdezést hajt végre, végigmegy a rekordokon és ha dátum vagy idő típusú mezőt talál, akkor azt megfelelő formátumban írja ki.

76

PConnect('northwind'); # MS ACCESS-hez kapcsolódunk, northwind dsn-nel $recordSet = &$conn->Execute('select CustomerID,OrderDate from Orders'); if (!$recordSet) print $conn->ErrorMsg(); # Hibaüzenet, ha nincsen eredménye a lekérdezésnek else while (!$recordSet->EOF) { $fld = $recordSet->FetchField(1); # Az első mező beolvasása $type = $recordSet->MetaType($fld->type); if ( $type == 'D' || $type == 'T') print $recordSet->fields[0].' '. $recordSet->UserDate($recordSet->fields[1],'m/d/Y').'
'; else print $recordSet->fields[0].' '.$recordSet->fields[1].'
'; $recordSet->MoveNext(); } $recordSet->Close(); # optional $conn->Close(); # optional ?>

A $conn ADO objektumhoz a $conn->Pconnect(‘northwind’)

metódus kapcsolja hozzá a Northwind adatbázist, ami természetesen elérhető a windowsos rendszerben. Az adatok lekérdezését az $recordSet = $conn->execute(’select * from Orders’) ;

metódus hajtja végre. Ez a $recordSet változóba visszatér egy ADO rekordszet objektummal. Ha valamilyen ok miatt nem jön létre a rekordszet, akkor azt le lehet kérdezni, és hibakezelést lehet végrehajtani. A rekordszetnek van kurzora. Ez a kurzor jelöli meg az aktuális rekordot. A kurzort $recordSet->MoveNext()

metódussal tudom tovább mozgatni. A sorok közötti mozgást további parancsok is könnyítik: $recordSet->Move($n)

- az aktuális sorhoz képest n sorral ugrik tovább a kurzor

$recordSet->MoveNext()

– következő sorra lép a kurzor

$recordSet->MoveFirst() $recordSet->MoveLast()

– első sorra ugrik a kurzor

– utolsó sorra ugrik a kurzor

$recordSet->AbsolutePosition (n)

– Egy abszolút módon megadott sorra ugrik

$sorszám = $recordSet->CurrentRow ()

– Az aktuális sor számát adja vissza

A FetchField függvény teszteli le a mezők típusát. 3 elemű objektumot ad vissza. -

name: oszlop neve

-

type: az eredeti mezőtípus

-

max_length: a mező max. hossza. Néha nem ad vissza semmit (pl. MySQL)

A MetaType() lefordítja az eredeti típust általános ADODB típusra. Az alábbi generic típusok léteznek: • • • • •

C: szöveg, a taggal jeleníthető meg X: TeXt, nagy szöveg, a taggal jeleníthető meg B: Blobs, Binary Large Objects. Általában képek. D: Dátum T: Időbélyeg 77 • • • • L: Logikai (boolean vagy bit mező) I: Egész N: Numerikus, illetve autoinkrementális. R: Sorozat típus. Lehet sorozat vagy, autoinkrement egész. Dátum vagy Időbélyeg esetén a UserDate() függvény konvertálja és kiírja a megfelelő formátumú időt. 18.6.3.1 Lapozás ADODB-ben Akkor használhatjuk a z ADODB lapozó funkcióját, ha beincludoljuk az adodb-pager.inc.php függvényt. A rekordszet lapokra bontható, minden lap megadott számú sorból áll. A lapok között is lehet mozogni. Bool AtFirstPage() – True, ha az első lapon vagyunk Bool AtLastPage() - True, ha az utolsó lapon vagyunk $page= AbsolutePage(n) – Megadott lapra ugrik. Ezt Az alábbi viszonylag egyszerű példa ezt mutatja be: <?php include_once('adodb.inc.php'); include_once('adodb-pager.inc.php'); session_start(); $db = NewADOConnection('mysql'); $db->Connect('localhost','root','','xphplens'); $sql = "select * from adoxyz "; $pager = new ADODB_Pager($db,$sql); $pager->Render($rows_per_page=5); // A $pager objektum létrejön // Megadjuk, hogy hány sor legyen rajta. ?> A példában az adodb-pager.inc.php include engedélyezi a lapozást. A sessionben tároljuk az oldal állapotát. A ADODB_Pager() létrehozza az adott oldalon a megfelelő lapozó objektumot. A Render metódus létrehozza a HTML oldalon a megfelelő vezérlőkkel ellátott táblázatot. A PHP adatbázis-motor generálta a $recordSet->fields[] tömböt. Némelyik adatbázis megengedi, hogy sorszámmal és mezőnévvel is indexelhessük a kapott eredménysor tömbjét. Ha mindenképpen névvel akarunk indexelni, akkor a SetFetchMode függvényt kell használnunk. Minden rekorszet letárolja, hogy milyen üzemmódban használtuk, mikor az Execute() vagy a SelectLimit() parancsot használtuk. Az Execute parancs az SQL parancs által visszaadott teljes rekordszetet visszadja a hivó eljárásnak, míg a SelectLimit() csak a megadott számú sorral tér vissza. $db->SetFetchMode(ADODB_FETCH_NUM); $rs1 = $db->Execute('select * from table'); $db->SetFetchMode(ADODB_FETCH_ASSOC); $rs2 = $db->Execute('select * from table'); print_r($rs1->fields); # shows array([0]=>'v0',[1] =>'v1') print_r($rs2->fields); # shows array(['col1']=>'v0',['col2'] =>'v1') A lekérdezett sorok számát a $recordSet->RecordCount() utasítás adja vissza. -1 az eredmény, ha nem meghatározható a visszaadott sorok száma. $rs->GetArray([$number_of_rows]) Az alábbi függvény egy két dimenziós tömböt hoz létre a recordset adataiból és azt adja vissza. Ha nem adjuk meg a sorok számát, akkor az összes adatot visszadja EOf-ig. $rs = $db->Execute($sql); if ($rs) 78 while ($arr = $rs->FetchRow()) { # process $arr } } Example 3: Inserting Insert a row to the Orders table containing dates and strings that need to be quoted before they can be accepted by the database, eg: the single-quote in the word John's. <? include('adodb.inc.php'); # load code common to ADOdb $conn = &ADONewConnection('access'); # create a connection $conn->PConnect('northwind'); # connect to MS-Access, northwind dsn $shipto = $conn->qstr("John's Old Shoppe"); $sql = "insert into orders (customerID,EmployeeID,OrderDate,ShipName) "; $sql .= "values ('ANATR',2,".$conn->DBDate(time()).",$shipto)"; if ($conn->Execute($sql) === false) { print 'error inserting: '.$conn->ErrorMsg().' '; } ?> In this example, we see the advanced date and quote handling facilities of ADOdb. The unix timestamp (which is a long integer) is appropriately formated for Access with DBDate(), and the right escape character is used for quoting the John's Old Shoppe, which is John''s Old Shoppe and not PHP's default John's Old Shoppe with qstr(). Observe the error-handling of the Execute statement. False is returned by Execute() if an error occured. The error message for the last error that occurred is displayed in ErrorMsg(). Note: php_track_errors might have to be enabled for error messages to be saved. Example 4: Debugging <? include('adodb.inc.php'); # load code common to ADOdb $conn = &ADONewConnection('access'); # create a connection $conn->PConnect('northwind'); # connect to MS-Access, northwind dsn $shipto = $conn->qstr("John's Old Shoppe"); $sql = "insert into orders (customerID,EmployeeID,OrderDate,ShipName) "; $sql .= "values ('ANATR',2,".$conn->FormatDate(time()).",$shipto)"; $conn->debug = true; if ($conn->Execute($sql) === false) print 'error inserting'; ?> In the above example, we have turned on debugging by setting debug = true. This will display the SQL statement before execution, and also show any error messages. There is no need to call ErrorMsg() in this case. For displaying the recordset, see the rs2html() example. Also see the section on Custom Error Handlers. 79 Example 5: MySQL and Menus Connect to MySQL database agora, and generate a <select> menu from an SQL statement where the <option> captions are in the 1st column, and the value to send back to the server is in the 2nd column. <? include('adodb.inc.php'); # load code common to ADOdb $conn = &ADONewConnection('mysql'); # create a connection $conn->PConnect('localhost','userid','','agora');# connect to MySQL, agora db $sql = 'select CustomerName, CustomerID from customers'; $rs = $conn->Execute($sql); print $rs->GetMenu('GetCust','Mary Rosli'); ?> Here we define a menu named GetCust, with the menu option 'Mary Rosli' selected. See GetMenu(). We also have functions that return the recordset as an array: GetArray(), and as an associative array with the key being the first column: GetAssoc(). Example 6: Connecting to 2 Databases At Once <? include('adodb.inc.php'); # load code common to ADOdb $conn1 = &ADONewConnection('mysql'); # create a mysql connection $conn2 = &ADONewConnection('oracle'); # create a oracle connection $conn1->PConnect($server, $userid, $password, $database); $conn2->PConnect(false, $ora_userid, $ora_pwd, $oraname); $conn1->Execute('insert ...'); $conn2->Execute('update ...'); ?> Example 7: Generating Update and Insert SQL ADOdb 1.31 and later supports two new recordset functions: GetUpdateSQL( ) and GetInsertSQL( ). This allow you to perform a "SELECT * FROM table query WHERE...", make a copy of the $rs->fields, modify the fields, and then generate the SQL to update or insert into the table automatically. We show how the functions can be used when accessing a table with the following fields: (ID, FirstName, LastName, Created). Before these functions can be called, you need to initialize the recordset by performing a select on the table. Idea and code by Jonathan Younger jyounger#unilab.com. <? #============================================== # SAMPLE GetUpdateSQL() and GetInsertSQL() code #============================================== include('adodb.inc.php'); include('tohtml.inc.php'); #========================== # This code tests an insert $sql = "SELECT * FROM ADOXYZ WHERE id = -1"; # Select an empty record from the database $conn = &ADONewConnection("mysql"); # create a connection $conn->debug=1; $conn->PConnect("localhost", "admin", "", "test"); # connect to MySQL, testdb $rs = $conn->Execute($sql); # Execute the query and get the empty recordset $record = array(); # Initialize an array to hold the record data to insert # Set the values for the fields in the record # Note that field names are case-insensitive $record["firstname"] = "Bob"; $record["lastNamE"] = "Smith"; $record["creaTed"] = time(); 80 # Pass the empty recordset and the array containing the data to insert # into the GetInsertSQL function. The function will process the data and return # a fully formatted insert sql statement. $insertSQL = $conn->GetInsertSQL($rs, $record); $conn->Execute($insertSQL); # Insert the record into the database #========================== # This code tests an update $sql = "SELECT * FROM ADOXYZ WHERE id = 1"; # Select a record to update $rs = $conn->Execute($sql); # Execute the query and get the existing record to update $record = array(); # Initialize an array to hold the record data to update # Set the values for the fields in the record # Note that field names are case-insensitive $record["firstname"] = "Caroline"; $record["LasTnAme"] = "Smith"; # Update Caroline's lastname from Miranda to Smith # Pass the single record recordset and the array containing the data to update # into the GetUpdateSQL function. The function will process the data and return # a fully formatted update sql statement with the correct WHERE clause. # If the data has not changed, no recordset is returned $updateSQL = $conn->GetUpdateSQL($rs, $record); $conn->Execute($updateSQL); # Update the record in the database $conn->Close(); ?> 81 Example 8: Implementing Scrolling with Next and Previous The following code creates a very simple recordset pager, where you can scroll from page to page of a recordset. include_once('../adodb.inc.php'); include_once('../adodb-pager.inc.php'); session_start(); $db = NewADOConnection('mysql'); $db->Connect('localhost','root','','xphplens'); $sql = "select * from adoxyz "; $pager = new ADODB_Pager($db,$sql); $pager->Render($rows_per_page=5); This will create a basic record pager that looks like this: |< ID 36 37 38 39 40 << >> >| First Name Last Name Date Created Alan Turing Sat 06, Oct 2001 Serena Williams Sat 06, Oct 2001 Yat Sun Sun Sat 06, Oct 2001 Wai Hun See Sat 06, Oct 2001 Steven Oey Sat 06, Oct 2001 Page 8/10 The number of rows to display at one time is controled by the Render($rows) method. If you do not pass any value to Render(), ADODB_Pager will default to 10 records per page. You can control the column titles by modifying your SQL (supported by most databases): $sql = 'select id as "ID", firstname as "First Name", lastname as "Last Name", created as "Date Created" from adoxyz'; The above code can be found in the adodb/tests/testpaging.php example included with this release, and the class ADODB_Pager in adodb/adodb-pager.inc.php. The ADODB_Pager code can be adapted by a programmer so that the text links can be replaced by images, and the dull white background be replaced with more interesting colors. You can also allow display of html by setting $pager->htmlSpecialChars = false. Some of the code used here was contributed by Iván Oliva and Cornel G. 82 Example 9: Exporting in CSV or Tab-Delimited Format We provide some helper functions to export in comma-separated-value (CSV) and tab-delimited formats: include_once('/path/to/adodb/toexport.inc.php'); include_once('/path/to/adodb/adodb.inc.php'); $db = &NewADOConnection('mysql'); $db->Connect($server, $userid, $password, $database); $rs = $db->Execute('select fname as "First Name", surname as "Surname" from table'); print "<pre>"; print rs2csv($rs); # return a string, CSV format print '<hr>'; $rs->MoveFirst(); # note, some databases do not support MoveFirst print rs2tab($rs,false); # return a string, tab-delimited # false == suppress field names in first line print '<hr>'; $rs->MoveFirst(); rs2tabout($rs); # send to stdout directly (there is also an rs2csvout function) print "</pre>"; $rs->MoveFirst(); $fp = fopen($path, "w"); if ($fp) { rs2csvfile($rs, $fp); # write to file (there is also an rs2tabfile function) fclose($fp); } Carriage-returns or newlines are converted to spaces. Field names are returned in the first line of text. Strings containing the delimiter character are quoted with double-quotes. Double-quotes are doublequoted again. This conforms to Excel import and export guide-lines. All the above functions take as an optional last parameter, $addtitles which defaults to true. When set to false field names in the first line are suppressed. Example 10: Recordset Filters Sometimes we want to pre-process all rows in a recordset before we use it. For example, we want to ucwords all text in recordset. include_once('adodb/rsfilter.inc.php'); include_once('adodb/adodb.inc.php'); // ucwords() every element in the recordset function do_ucwords(&$arr,$rs) { foreach($arr as $k => $v) { $arr[$k] = ucwords($v); } } $db = NewADOConnection('mysql'); $db->PConnect('server','user','pwd','db'); $rs = $db->Execute('select ... from table'); $rs = RSFilter($rs,'do_ucwords'); The RSFilter function takes 2 parameters, the recordset, and the name of the filter function. It returns the processed recordset scrolled to the first record. The filter function takes two parameters, the current row as an array, and the recordset object. For future compatibility, you should not use the original recordset object. Example 11: Smart Transactions The old way of doing transactions required you to use 83 $conn->BeginTrans(); $ok = $conn->Execute($sql); if ($ok) $ok = $conn->Execute($sql2); if (!$ok) $conn->RollbackTrans(); else $conn->CommitTrans(); This is very complicated for large projects because you have to track the error status. Smart Transactions is much simpler. You start a smart transaction by calling StartTrans(): $conn->StartTrans(); $conn->Execute($sql); $conn->Execute($Sql2); $conn->CompleteTrans(); CompleteTrans() detects when an SQL error occurs, and will Rollback/Commit as appropriate. To specificly force a rollback even if no error occured, use FailTrans(). Note that the rollback is done in CompleteTrans(), and not in FailTrans(). $conn->StartTrans(); $conn->Execute($sql); if (!CheckRecords()) $conn->FailTrans(); $conn->Execute($Sql2); $conn->CompleteTrans(); Lastly, StartTrans/CompleteTrans is nestable, and only the outermost block is executed. In contrast, BeginTrans/CommitTrans/RollbackTrans is NOT nestable. $conn->StartTrans(); $conn->Execute($sql); $conn->StartTrans(); # ignored if (!CheckRecords()) $conn->FailTrans(); $conn->CompleteTrans(); # ignored $conn->Execute($Sql2); $conn->CompleteTrans(); Note: Savepoints are currently not supported. 84 18.7 Using Custom Error Handlers and PEAR_Error Apart from the old $con->debug = true; way of debugging, ADOdb 1.50 onwards provides another way of handling errors using ADOdb's custom error handlers. ADOdb provides two custom handlers which you can modify for your needs. The first one is in the adodb-errorhandler.inc.php file. This makes use of the standard PHP functions error_reporting to control what error messages types to display, and trigger_error which invokes the default PHP error handler. Including the above file will cause trigger_error($errorstring,E_USER_ERROR) to be called when (a) Connect() or PConnect() fails, or (b) a function that executes SQL statements such as Execute() or SelectLimit() has an error. (c) GenID() appears to go into an infinite loop. The $errorstring is generated by ADOdb and will contain useful debugging information similar to the error.log data generated below. This file adodb-errorhandler.inc.php should be included before you create any ADOConnection objects. If you define error_reporting(0), no errors will be shown. If you set error_reporting(E_ALL), all errors will be displayed on the screen. <?php error_reporting(E_ALL); # show any error messages triggered include('adodb-errorhandler.inc.php'); include('adodb.inc.php'); include('tohtml.inc.php'); $c = NewADOConnection('mysql'); $c->PConnect('localhost','root','','northwind'); $rs=$c->Execute('select * from productsz'); #invalid table productsz'); if ($rs) $rs2html($rs); ?> If you want to log the error message, you can do so by defining the following optional constants ADODB_ERROR_LOG_TYPE and ADODB_ERROR_LOG_DEST. ADODB_ERROR_LOG_TYPE is the error log message type (see error_log in the PHP manual). In this case we set it to 3, which means log to the file defined by the constant ADODB_ERROR_LOG_DEST. <?php error_reporting(0); # do not echo any errors define('ADODB_ERROR_LOG_TYPE',3); define('ADODB_ERROR_LOG_DEST','C:/errors.log'); include('adodb-errorhandler.inc.php'); include('adodb.inc.php'); include('tohtml.inc.php'); $c = NewADOConnection('mysql'); $c->PConnect('localhost','root','','northwind'); $rs=$c->Execute('select * from productsz'); ## invalid table productsz if ($rs) $rs2html($rs); ?> 85 The following message will be logged in the error.log file: (2001-10-28 14:20:38) mysql error: [1146: Table 'northwind.productsz' doesn't exist] in EXECUTE("select * from productsz") The second error handler is adodb-errorpear.inc.php. This will create a PEAR_Error derived object whenever an error occurs. The last PEAR_Error object created can be retrieved using ADODB_Pear_Error(). <?php include('adodb-errorpear.inc.php'); include('adodb.inc.php'); include('tohtml.inc.php'); $c = NewADOConnection('mysql'); $c->PConnect('localhost','root','','northwind'); $rs=$c->Execute('select * from productsz'); #invalid table productsz'); if ($rs) $rs2html($rs); else { $e = ADODB_Pear_Error(); echo '',$e->message,''; } ?> You can use a PEAR_Error derived class by defining the constant ADODB_PEAR_ERROR_CLASS before the adodb-errorpear.inc.php file is included. For easy debugging, you can set the default error handler in the beginning of the PHP script to PEAR_ERROR_DIE, which will cause an error message to be printed, then halt script execution: include('PEAR.php'); PEAR::setErrorHandling('PEAR_ERROR_DIE'); Note that we do not explicitly return a PEAR_Error object to you when an error occurs. We return false instead. You have to call ADODB_Pear_Error() to get the last error or use the PEAR_ERROR_DIE technique. 18.7.1.1 Error Messages Error messages are outputted using the static method ADOConnnection::outp($msg,$newline=true). By default, it sends the messages to the client. You can override this to perform error-logging. 86 18.8 Data Source Names We now support connecting using PEAR style DSN's. A DSN is a connection string of the form: $dsn = "http://php.weblogs.com/$driver://$username:$password@$hostname/$databasename";; You pass the DSN to the static class function DB::Connect. An example: include_once('../adodb/adodb-pear.inc.php'); $username = 'root'; $password = ''; $hostname = 'localhost'; $databasename = 'xphplens'; $driver = 'mysql'; $dsn ="http://php.weblogs.com/$driver://$username:$password@$hostname/$databasename"; $db = DB::Connect($dsn); $rs = $db->Execute('select firstname,lastname from adoxyz'); $cnt = 0; while ($arr = $rs->FetchRow()) { print_r($arr); print " "; } This requires PEAR to be installed and in the default include path in php.ini. 18.9 Caching of Recordsets ADOdb now supports caching of recordsets using the CacheExecute( ), CachePageExecute( ) and CacheSelectLimit( ) functions. There are similar to the non-cache functions, except that they take a new first parameter, $secs2cache. An example: include('adodb.inc.php'); # load code common to ADOdb $ADODB_CACHE_DIR = '/usr/ADODB_cache'; $conn = &ADONewConnection('mysql'); # create a connection $conn->PConnect('localhost','userid','','agora');# connect to MySQL, agora db $sql = 'select CustomerName, CustomerID from customers'; $rs = $conn->CacheExecute(15,$sql); The first parameter is the number of seconds to cache the query. Subsequent calls to that query will used the cached version stored in $ADODB_CACHE_DIR. To force a query to execute and flush the cache, call CacheExecute() with the first parameter set to zero. Alternatively, use the CacheFlush($sql) call. For the sake of security, we recommend you set register_globals=off in php.ini if you are using $ADODB_CACHE_DIR. In ADOdb 1.80 onwards, the secs2cache parameter is optional in CacheSelectLimit() and CacheExecute(). If you leave it out, it will use the $connection->cacheSecs parameter, which defaults to 60 minutes. $conn->Connect(...); $conn->cacheSecs = 3600*24; # cache 24 hours $rs = $conn->CacheExecute('select * from table'); Please note that magic_quotes_runtime should be turned off. More info. 18.10 Pivot Tables Since ADOdb 2.30, we support the generation of SQL to create pivot tables, also known as crosstabulations. For further explanation read this DevShed Cross-Tabulation tutorial. We assume that your database supports the SQL case-when expression. In this example, we will use the Northwind database from Microsoft. In the database, we have a products table, and we want to analyze this table by suppliers versus product categories. We will place the suppliers on each row, and pivot on categories. So from the table on the left, we generate the pivottable on the right: 87 Supplier Category supplier1 category1 supplier2 category1 supplier2 category2 category1 category2 --> supplier1 1 0 1 supplier2 1 1 2 total The following code will generate the SQL for a cross-tabulation: # # # # # # Query the main "product" table Set the rows to CompanyName and the columns to the values of Categories and define the joins to link to lookup tables "categories" and "suppliers" include "adodb/pivottable.php"; $sql = PivotTableSQL( $gDB, # adodb connection 'products p ,categories c ,suppliers s', # tables 'CompanyName', # rows (multiple fields allowed) 'CategoryName', # column to pivot on 'p.CategoryID = c.CategoryID and s.SupplierID= p.SupplierID' # joins/where ); This will generate the following SQL: SELECT CompanyName, SUM(CASE WHEN CategoryName='Beverages' THEN 1 ELSE 0 END) AS "Beverages", SUM(CASE WHEN CategoryName='Condiments' THEN 1 ELSE 0 END) AS "Condiments", SUM(CASE WHEN CategoryName='Confections' THEN 1 ELSE 0 END) AS "Confections", SUM(CASE WHEN CategoryName='Dairy Products' THEN 1 ELSE 0 END) AS "Dairy Products", SUM(CASE WHEN CategoryName='Grains/Cereals' THEN 1 ELSE 0 END) AS "Grains/Cereals", SUM(CASE WHEN CategoryName='Meat/Poultry' THEN 1 ELSE 0 END) AS "Meat/Poultry", SUM(CASE WHEN CategoryName='Produce' THEN 1 ELSE 0 END) AS "Produce", SUM(CASE WHEN CategoryName='Seafood' THEN 1 ELSE 0 END) AS "Seafood", SUM(1) as Total FROM products p ,categories c ,suppliers s WHERE p.CategoryID = c.CategoryID and s.SupplierID= p.SupplierID GROUP BY CompanyName You can also pivot on numerical columns and generate totals by using ranges. This code was revised in ADODB 2.41 and is not backward compatible. The second example shows this: $sql = PivotTableSQL( $gDB, # adodb connection 'products p ,categories c ,suppliers s', # tables 'CompanyName', # rows (multiple fields allowed) array( # column ranges ' 0 ' => 'UnitsInStock <= 0', "1 to 5" => '0 < UnitsInStock and UnitsInStock <= 5', "6 to 10" => '5 < UnitsInStock and UnitsInStock <= 10', "11 to 15" => '10 < UnitsInStock and UnitsInStock <= 15', "16+" => '15 < UnitsInStock' ), ' p.CategoryID = c.CategoryID and s.SupplierID= p.SupplierID', # joins/where 'UnitsInStock', # sum this field 'Sum ' # sum label prefix ); Which generates: 88 SELECT CompanyName, SUM(CASE WHEN UnitsInStock <= 0 THEN UnitsInStock ELSE 0 END) AS "Sum 0 ", SUM(CASE WHEN 0 < UnitsInStock and UnitsInStock <= 5 THEN UnitsInStock ELSE 0 END) AS "Sum 1 to 5", SUM(CASE WHEN 5 < UnitsInStock and UnitsInStock <= 10 THEN UnitsInStock ELSE 0 END) AS "Sum 6 to 10", SUM(CASE WHEN 10 < UnitsInStock and UnitsInStock <= 15 THEN UnitsInStock ELSE 0 END) AS "Sum 11 to 15", SUM(CASE WHEN 15 < UnitsInStock THEN UnitsInStock ELSE 0 END) AS "Sum 16+", SUM(UnitsInStock) AS "Sum UnitsInStock", SUM(1) as Total, FROM products p ,categories c ,suppliers s WHERE p.CategoryID = c.CategoryID and s.SupplierID= p.SupplierID GROUP BY CompanyName 89 90 19 Class Reference Function parameters with [ ] around them are optional. 19.1 Global Variables $ADODB_COUNTRECS If the database driver API does not support counting the number of records returned in a SELECT statement, the function RecordCount() is emulated when the global variable $ADODB_COUNTRECS is set to true, which is the default. We emulate this by buffering the records, which can take up large amounts of memory for big recordsets. Set this variable to false for the best performance. This variable is checked every time a query is executed, so you can selectively choose which recordsets to count. $ADODB_CACHE_DIR If you are using recordset caching, this is the directory to save your recordsets in. Define this before you call any caching functions such as CacheExecute( ). We recommend setting register_globals=off in php.ini if you use this feature for security reasons. If you are using Unix and apache, you might need to set your cache directory permissions to something similar to the following: chown -R chgrp -R apache /path/to/adodb/cache apache /path/to/adodb/cache $ADODB_FETCH_MODE This is a global variable that determines how arrays are retrieved by recordsets. The recordset saves this value on creation (eg. in Execute( ) or SelectLimit( )), and any subsequent changes to $ADODB_FETCH_MODE have no affect on existing recordsets, only on recordsets created in the future. The following constants are defined: define('ADODB_FETCH_DEFAULT',0); define('ADODB_FETCH_NUM',1); define('ADODB_FETCH_ASSOC',2); define('ADODB_FETCH_BOTH',3); An example: $ADODB_FETCH_MODE = ADODB_FETCH_NUM; $rs1 = $db->Execute('select * from table'); $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC; $rs2 = $db->Execute('select * from table'); print_r($rs1->fields); # shows array([0]=>'v0',[1] =>'v1') print_r($rs2->fields); # shows array(['col1']=>'v0',['col2'] =>'v1') As you can see in the above example, both recordsets store and use different fetch modes based on the $ADODB_FETCH_MODE setting when the recordset was created by Execute(). If no fetch mode is predefined, the fetch mode defaults to ADODB_FETCH_DEFAULT. The behaviour of this default mode varies from driver to driver, so do not rely on ADODB_FETCH_DEFAULT. For portability, we recommend sticking to ADODB_FETCH_NUM or ADODB_FETCH_ASSOC. Many drivers do not support ADODB_FETCH_BOTH. SetFetchMode Function Some programmers prefer to use a more object-oriented solution, where the fetch mode is set by a object function, SetFetchMode. Once this function is called for a connection object, that connection object will ignore the global variable $ADODB_FETCH_MODE and will use the internal fetchMode property exclusively. 91 $db->SetFetchMode(ADODB_FETCH_NUM); $rs1 = $db->Execute('select * from table'); $db->SetFetchMode(ADODB_FETCH_ASSOC); $rs2 = $db->Execute('select * from table'); print_r($rs1->fields); # shows array([0]=>'v0',[1] =>'v1') print_r($rs2->fields); # shows array(['col1']=>'v0',['col2'] =>'v1') To retrieve the previous fetch mode, you can use check the $db->fetchMode property, or use the return value of SetFetchMode( ). ADODB_ASSOC_CASE You can control the associative fetch case for certain drivers which behave differently. For the sybase, oci8po, mssql, odbc and ibase drivers and all drivers derived from them, ADODB_ASSOC_CASE will by default generate recordsets where the field name keys are lower-cased. Use the constant ADODB_ASSOC_CASE to change the case of the keys. There are 3 possible values: 0 = assoc lowercase field names. $rs->fields['orderid'] 1 = assoc uppercase field names. $rs->fields['ORDERID'] 2 = use native-case field names. $rs->fields['OrderID'] -- this is the default since ADOdb 2.90 To use it, declare it before you incldue adodb.inc.php. define('ADODB_ASSOC_CASE', include('adodb.inc.php'); 2); # use 92 native-case for ADODB_FETCH_ASSOC 19.2 ADOConnection Object that performs the connection to the database, executes SQL statements and has a set of utility functions for standardising the format of SQL statements for issues such as concatenation and date formats. ADOConnection Fields databaseType: Name of the database system we are connecting to. Eg. odbc or mssql or mysql. dataProvider: The underlying mechanism used to connect to the database. Normally set to native, unless using odbc or ado. host: Name of server or data source name (DSN) to connect to. database: Name of the database or to connect to. If ado is used, it will hold the ado data provider. user: Login id to connect to database. Password is not saved for security reasons. raiseErrorFn: Allows you to define an error handling function. See adodb-errorhandler.inc.php for an example. debug: Set to true to make debug statements to appear. concat_operator: Set to '+' or '||' normally. The operator used to concatenate strings in SQL. Used by the Concat function. fmtDate: The format used by the DBDate function to send dates to the database. is '#Y-m-d#' for Microsoft Access, and ''Y-m-d'' for MySQL. fmtTimeStamp: The format used by the DBTimeStamp function to send timestamps to the database. true: The value used to represent true.Eg. '.T.'. for Foxpro, '1' for Microsoft SQL. false: The value used to represent false. Eg. '.F.'. for Foxpro, '0' for Microsoft SQL. replaceQuote: The string used to escape quotes. Eg. double single-quotes for Microsoft SQL, and backslash-quote for MySQL. Used by qstr. autoCommit: indicates whether automatic commit is enabled. Default is true. charSet: set the default charset to use. Currently only interbase supports this. dialect: set the default sql dialect to use. Currently only interbase supports this. metaTablesSQL: SQL statement to return a list of available tables. Eg. SHOW TABLES in MySQL. genID: The latest id generated by GenID() if supported by the database. cacheSecs: The number of seconds to cache recordsets if CacheExecute() or CacheSelectLimit() omit the $secs2cache parameter. Defaults to 60 minutes. sysDate: String that holds the name of the database function to call to get the current date. Useful for inserts and updates. sysTimeStamp: String that holds the name of the database function to call to get the current timestamp/datetime value. leftOuter: String that holds operator for left outer join, if known. Otherwise set to false. rightOuter: String that holds operator for left outer join, if known. Otherwise set to false. ansiOuter: Boolean that if true indicates that ANSI style outer joins are permitted. Eg. select * from table1 left join table2 on p1=p2. 93 connectSID: Boolean that indicates whether to treat the $database parameter in connects as the SID for the oci8 driver. Defaults to false. Useful for Oracle 8.0.5 and earlier. autoRollback: Persistent connections are auto-rollbacked in PConnect( ) if this is set to true. Default is false. ADOConnection Main Functions ADOConnection( ) Constructor function. Do not call this directly. Use ADONewConnection( ) instead. Connect($host,[$user],[$password],[$database]) Non-persistent connect to data source or server $host, using userid $user and password $password. If the server supports multiple databases, connect to database $database. Returns true/false depending on connection. ADO Note: If you are using a Microsoft ADO and not OLEDB, you can set the $database parameter to the OLEDB data provider you are using. PostgreSQL: An alternative way of connecting to the database is to pass the standard PostgreSQL connection string in the first parameter $host, and the other parameters will be ignored. For Oracle and Oci8, there are two ways to connect. First is to use the TNS name defined in your local tnsnames.ora (or ONAMES or HOSTNAMES). Place the name in the $database field, and set the $host field to false. Alternatively, set $host to the server, and $database to the database SID, this bypassed tnsnames.ora. Examples: # $oraname in tnsnames.ora/ONAMES/HOSTNAMES $conn->Connect(false, 'scott', 'tiger', $oraname); $conn->Connect('server:1521', 'scott', 'tiger', 'ServiceName'); # bypass tnsnames.ora There are many examples of connecting to a database at php.weblogs.com/ADOdb, and in the testdatabases.inc.php file included in the release. PConnect($host,[$user],[$password],[$database]) Persistent connect to data source or server $host, using userid $user and password $password. If the server supports multiple databases, connect to database $database. We now perform a rollback on persistent connection for selected databases since 2.21, as advised in the PHP manual. See change log or source code for which databases are affected. Returns true/false depending on connection. See Connect( ) above for more info. Since ADOdb 2.21, we also support autoRollback. If you set: $conn = &NewADOConnection('mysql'); $conn->autoRollback = true; # default is false $conn->PConnect(...); # rollback here Then when doing a persistent connection with PConnect( ), ADOdb will perform a rollback first. This is because it is documented that PHP is not guaranteed to rollback existing failed transactions when persistent connections are used. This is implemented in Oracle, MySQL, PgSQL, MSSQL, ODBC currently. Since ADOdb 3.11, you can force non-persistent connections even if PConnect is called by defining the constant ADODB_NEVER_PERSIST before you call PConnect. NConnect($host,[$user],[$password],[$database]) 94 Always force new connection. In contrast, PHP sometimes reuses connections when you use Connect() or PConnect(). Currently works only on mysql (PHP 4.3.0 or later) and oci8-derived drivers. For other drivers, NConnect() works like Connect(). Execute($sql,$inputarr=false) Execute SQL statement $sql and return derived class of ADORecordSet if successful. Note that a record set is always returned on success, even if we are executing an insert or update statement. Returns derived class of ADORecordSet. Eg. if connecting via mysql, then ADORecordSet_mysql would be returned. False is returned if there was an error in executing the sql. The $inputarr parameter can be used for binding variables to parameters. Below is an Oracle example: $conn->Execute("SELECT * FROM TABLE WHERE COND=:val", array('val'=> $val)); Another example, using ODBC,which uses the ? convention: $conn->Execute("SELECT * FROM TABLE WHERE COND=?", array($val)); Binding variables Variable binding speeds the compilation and caching of SQL statements, leading to higher performance. Currently Oracle and ODBC support variable binding. ODBC style ? binding is emulated in databases that do not support binding. Variable binding in the odbc and oci8po drivers. $rs = $db->Execute('select * from table where val=?', array('10')); Variable binding in the oci8 driver. $rs = $db->Execute('select name from table where val=:key', array('key' => 10)); CacheExecute([$secs2cache,]$sql,$inputarr=false) Similar to Execute, except that the recordset is cached for $secs2cache seconds in the $ADODB_CACHE_DIR directory. If CacheExecute() is called again with the same parameters, same database, same userid, same password, and the cached recordset has not expired, the cached recordset is returned. include('adodb.inc.php'); include('tohtml.inc.php'); $ADODB_CACHE_DIR = '/usr/local/ADOdbcache'; $conn = &ADONewConnection('mysql'); $conn->PConnect('localhost','userid','password','database'); $rs = $conn->CacheExecute(15, 'select * from table'); # cache 15 secs rs2html($rs); /* recordset to html table */ Alternatively, since ADOdb 1.80, the $secs2cache parameter is optional: $conn->Connect(...); $conn->cacheSecs = 3600*24; // cache 24 hours $rs = $conn->CacheExecute('select * from table'); Note that the $secs2cache parameter is optional. If omitted, we use the value in $connection->cacheSecs (default is 3600 seconds, or 1 hour). Use CacheExecute() only with SELECT statements. Performance note: I have done some benchmarks and found that they vary so greatly that it's better to talk about when caching is of benefit. When your database server is much slower than your Web server or the database is very overloaded then ADOdb's caching is good because it reduces the load on your database server. If your database server is lightly loaded or much faster than your Web server, then caching could actually reduce performance. 95 ExecuteCursor($sql,$cursorName='rs',$parameters=false) Execute an Oracle stored procedure, and returns an Oracle REF cursor variable as a regular ADOdb recordset. Does not work with any other database except oci8. Thanks to Robert Tuttle for the design. $db = ADONewConnection("oci8"); $db->Connect("foo.com:1521", "uid", "pwd", "FOO"); $rs = $db->ExecuteCursor("begin :cursorvar := getdata(:param1); end;", 'cursorvar', array('param1'=>10)); # $rs is now just like any other ADOdb recordset object rs2html($rs); ExecuteCursor() is a helper function that does the following internally: $stmt = $db->Prepare("BEGIN :RS := SP_FOO(); END;"); $db->Parameter($stmt, $cur, 'RS', false, -1, OCI_B_CURSOR); $rs = $db->Execute($stmt); SelectLimit($sql,$numrows=-1,$offset=-1,$inputarr=false) Returns a recordset if successful. Returns false otherwise. Performs a select statement, simulating PostgreSQL's SELECT statement, LIMIT $numrows OFFSET $offset clause. In PostgreSQL, SELECT * FROM TABLE LIMIT 3 will return the first 3 records only. The equivalent is $connection->SelectLimit('SELECT * FROM TABLE',3). This functionality is simulated for databases that do not possess this feature. And SELECT * FROM TABLE LIMIT 3 OFFSET 2 will return records 3, 4 and 5 (eg. after record 2, return 3 rows). The equivalent in ADOdb is $connection->SelectLimit('SELECT * FROM TABLE',3,2). Note that this is the opposite of MySQL's LIMIT clause. You can also set $connection>SelectLimit('SELECT * FROM TABLE',-1,10) to get rows 11 to the last row. The last parameter $inputarr is for databases that support variable binding such as Oracle oci8. This substantially reduces SQL compilation overhead. Below is an Oracle example: $conn->SelectLimit("SELECT * FROM TABLE WHERE COND=:val", 100,-1,array('val'=> $val)); The oci8po driver (oracle portable driver) uses the more standard bind variable of ?: $conn->SelectLimit("SELECT * FROM TABLE WHERE COND=?", 100,-1,array('val'=> $val)); Ron Wilson reports that SelectLimit does not work with UNIONs. CacheSelectLimit([$secs2cache,] $sql, $numrows=-1,$offset=-1,$inputarr=false) Similar to SelectLimit, except that the recordset returned is cached for $secs2cache seconds in the $ADODB_CACHE_DIR directory. Since 1.80, $secs2cache has been optional, and you can define the caching time in $connection>cacheSecs. $conn->Connect(...); $conn->cacheSecs = 3600*24; // cache 24 hours $rs = $conn->CacheSelectLimit('select * from table',10); CacheFlush($sql=false,$inputarr=false) Flush (delete) any cached recordsets for the SQL statement $sql in $ADODB_CACHE_DIR. If no parameter is passed in, then all adodb_*.cache files are deleted. If you want to flush all cached recordsets manually, execute the following PHP code (works only under Unix): system("rm -f `find ".$ADODB_CACHE_DIR." -name adodb_*.cache`"); 96 For general cleanup of all expired files, you should use crontab on Unix, or at.exe on Windows, and a shell script similar to the following: #-----------------------------------------------------# This particular example deletes files in the TMPPATH # directory with the string ".cache" in their name that # are more than 7 days old. #-----------------------------------------------------AGED=7 find ${TMPPATH} -mtime +$AGED | grep ".cache" | xargs rm -f MetaError($errno=false) Returns a virtualized error number, based on PEAR DB's error number system. You might need to include adodb-error.inc.php before you call this function. The parameter $errno is the native error number you want to convert. If you do not pass any parameter, MetaError will call ErrorNo() for you and convert it. If the error number cannot be virtualized, MetaError will return -1 (DB_ERROR). MetaErrorMsg($errno) Pass the error number returned by MetaError() for the equivalent textual error message. ErrorMsg() Returns the last status or error message. This can return a string even if no error occurs. In general you do not need to call this function unless an ADOdb function returns false on an error. Note: If debug is enabled, the SQL error message is always displayed when the Execute function is called. ErrorNo() Returns the last error number. Note that old versions of PHP (pre 4.0.6) do not support error number for ODBC. In general you do not need to call this function unless an ADOdb function returns false on an error. SetFetchMode($mode) Sets the current fetch mode for the connection and stores it in $db->fetchMode. Legal modes are ADODB_FETCH_ASSOC and ADODB_FETCH_NUM. For more info, see $ADODB_FETCH_MODE. Returns the previous fetch mode, which could be false if SetFetchMode( ) has not been called before. CreateSequence($seqName = 'adodbseq',$startID=1) Create a sequence. The next time GenID( ) is called, the value returned will be $startID. Added in 2.60. DropSequenceD($seqName = 'adodbseq') Delete a sequence. Added in 2.60. GenID($seqName = 'adodbseq',$startID=1) Generate a sequence number (an integer except for mssql). Works for interbase, mysql, postgresql, oci8, oci8po, mssql, ODBC based (access,vfp,db2,etc) drivers currently. Uses $seqName as the name of the sequence. GenID() will automatically create the sequence for you if it does not exist (provided the userid has permission to do so). Otherwise you will have to create the sequence yourself. If your database driver emulates sequences, the name of the table is the sequence name. The table has one column, "id" which should be of type integer, or if you need something larger - numeric(16). For ODBC and databases that do not support sequences natively (eg mssql, mysql), we create a table for each sequence. If the sequence has not been defined earlier, it is created with the starting value set in $startID. 97 Note that the mssql driver's GenID() used to generate 16 byte GUID's. We now return integers since 1.90. UpdateBlob($table,$column,$val,$where) Allows you to store a blob (in $val) into $table into $column in a row at $where. Usage: # for oracle $conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, empty_blob())'); $conn->UpdateBlob('blobtable','blobcol',$blobvalue,'id=1'); # non oracle databases $conn->Execute('INSERT INTO blobtable (id, blobcol) VALUES (1, null)'); $conn->UpdateBlob('blobtable','blobcol',$blobvalue,'id=1'); Returns true if succesful, false otherwise. Supported by MySQL, PostgreSQL, Oci8, Oci8po and Interbase drivers. Other drivers might work, depending on the state of development. Note that when an Interbase blob is retrieved using SELECT, it still needs to be decoded using $connection->DecodeBlob($blob); to derive the original value in versions of PHP before 4.1.0. For PostgreSQL, you can store your blob using blob oid's or as a bytea field. You can use bytea fields but not blob oid's currently with UpdateBlob( ). Conversely UpdateBlobFile( ) supports oid's, but not bytea data. If you do not pass in an oid, then UpdateBlob() assumes that you are storing in bytea fields. UpdateClob($table,$column,$val,$where) Allows you to store a clob (in $val) into $table into $column in a row at $where. Similar to UpdateBlob (see above), but for Character Large OBjects. Usage: # for oracle $conn->Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, empty_clob())'); $conn->UpdateBlob('clobtable','clobcol',$clobvalue,'id=1'); # non oracle databases $conn->Execute('INSERT INTO clobtable (id, clobcol) VALUES (1, null)'); $conn->UpdateBlob('clobtable','clobcol',$clobvalue,'id=1'); UpdateBlobFile($table,$column,$path,$where,$blobtype='BLOB') Similar to UpdateBlob, except that we pass in a file path to where the blob resides. For PostgreSQL, if you are using blob oid's, use this interface. This interface does not support bytea fields. Returns true if successful, false otherwise. BlobEncode($blob) Some databases require blob's to be encoded manually before upload. Note if you use UpdateBlob( ) or UpdateBlobFile( ) the conversion is done automatically for you and you do not have to call this function. For PostgreSQL, currently, BlobEncode() can only be used for bytea fields. Returns the encoded blob value. Note that there is a connection property called blobEncodeType which has 3 legal values: false no need to perform encoding or decoding. 'I' - blob encoding required, and returned encoded blob is a numeric value (no need to quote). 'C' - blob encoding required, and returned encoded blob is a character value (requires quoting). 98 This is purely for documentation purposes, so that programs that accept multiple database drivers know what is the right thing to do when processing blobs. BlobDecode($blob) Some databases require blob's to be decoded manually after doing a select statement. If the database does not require decoding, then this function will return the blob unchanged. Currently BlobDecode is only required for one database, PostgreSQL, and only if you are using blob oid's (if you are using bytea fields, we auto-decode for you). $rs = $db->Execute("select bloboid from postgres_table where id=$key"); $blob = $db->BlobDecode( reset($rs->fields) ); Replace($table, $arrFields, $keyCols,$autoQuote=false) Try to update a record, and if the record is not found, an insert statement is generated and executed. Returns 0 on failure, 1 if update statement worked, 2 if no record was found and the insert was executed successfully. This differs from MySQL's replace which deletes the record and inserts a new record. This also means you cannot update the primary key. The only exception to this is Interbase and its derivitives, which uses delete and insert because of some Interbase API limitations. The parameters are $table which is the table name, the $keyCols which is an associative array where the keys are the field names, and keyCols is the name of the primary key, or an array of field names if it is a compound key. If $autoQuote is set to true, then Replace() will quote all values that are non-numeric; auto-quoting will not quote nulls. Note that auto-quoting will not work if you use SQL functions or operators. Examples: # single field primary key $ret = $db->Replace('atable', array('id'=>1000,'firstname'=>'Harun','lastname'=>'Al-Rashid'), 'id', 'firstname',$autoquote = true); # generates UPDATE atable SET firstname='Harun',lastname='Al-Rashid' WHERE id=1000 # or INSERT INTO atable (id,firstname,lastname) VALUES (1000,'Harun','Al-Rashid') # compound key $ret = $db->Replace('atable2', array('firstname'=>'Harun','lastname'=>'Al-Rashid', 'age' => 33, 'birthday' => 'null'), array('lastname','firstname'), 'firstname',$autoquote = true); # no auto-quoting $ret = $db->Replace('atable2', array('firstname'=>"'Harun'",'lastname'=>"'Al-Rashid'", 'age' => 'null'), array('lastname','firstname'), 'firstname'); 99 GetUpdateSQL(&$rs, $arrFields, $forceUpdate=false,$magicq=false) Generate SQL to update a table given a recordset $rs, and the modified fields of the array $arrFields (which must be an associative array holding the column names and the new values) are compared with the current recordset. If $forceUpdate is true, then we also generate the SQL even if $arrFields is identical to $rs->fields. Requires the recordset to be associative. $magicq is used to indicate whether magic quotes are enabled (see qstr()). The field names in the array are case-insensitive. GetInsertSQL(&$rs, $arrFields,$magicq=false) Generate SQL to insert into a table given a recordset $rs. Requires the query to be associative. $magicq is used to indicate whether magic quotes are enabled (for qstr()). The field names in the array are caseinsensitive. PageExecute($sql, $nrows, $page, $inputarr=false) Used for pagination of recordset. $page is 1-based. See Example 8. CachePageExecute($secs2cache, $sql, $nrows, $page, $inputarr=false) Used for pagination of recordset. $page is 1-based. See Example 8. Caching version of PageExecute. Close( ) Close the database connection. PHP4 proudly states that we no longer have to clean up at the end of the connection because the reference counting mechanism of PHP4 will automatically clean up for us. StartTrans( ) Start a monitored transaction. As SQL statements are executed, ADOdb will monitor for SQL errors, and if any are detected, when CompleteTrans() is called, we auto-rollback. To understand why StartTrans() is superior to BeginTrans(), let us examine a few ways of using BeginTrans(). The following is the wrong way to use transactions: $DB->BeginTrans(); $DB->Execute("update table1 set val=$val1 where id=$id"); $DB->Execute("update table2 set val=$val2 where id=$id"); $DB->CommitTrans(); because you perform no error checking. It is possible to update table1 and for the update on table2 to fail. Here is a better way: $DB->BeginTrans(); $ok = $DB->Execute("update table1 set val=$val1 where id=$id"); if ($ok) $ok = $DB->Execute("update table2 set val=$val2 where id=$id"); if ($ok) $DB->CommitTrans(); else $DB->RollbackTrans(); Another way is (since ADOdb 2.0): $DB->BeginTrans(); $ok = $DB->Execute("update table1 set val=$val1 where id=$id"); if ($ok) $ok = $DB->Execute("update table2 set val=$val2 where id=$id"); $DB->CommitTrans($ok); Now it is a headache monitoring $ok all over the place. StartTrans() is an improvement because it monitors all SQL errors for you. This is particularly useful if you are calling black-box functions in which SQL queries might be executed. Also all BeginTrans, CommitTrans and RollbackTrans calls inside a StartTrans block will be disabled, so even if the black box function does a commit, it will be ignored. $DB->StartTrans(); CallBlackBox(); $DB->Execute("update table1 set val=$val1 where id=$id"); $DB->Execute("update table2 set val=$val2 where id=$id"); $DB->CompleteTrans($ok); 100 Note that a StartTrans blocks are nestable, the inner blocks are ignored. CompleteTrans($autoComplete=true) Complete a transaction called with StartTrans(). This function monitors for SQL errors, and will commit if no errors have occured, otherwise it will rollback. Returns true on commit, false on rollback. If the parameter $autoComplete is true monitor sql errors and commit and rollback as appropriate. Set $autoComplete to false to force rollback even if no SQL error detected. BeginTrans( ) Begin a transaction. Turns off autoCommit. Returns true if successful. Some databases will always return false if transaction support is not available. Interbase, Oracle and MSSQL support transactions. Any open transactions will be rolled back when the connection is closed. Note that StartTrans() and CompleteTrans() is a superior method of handling transactions, available since ADOdb 3.40. For a explanation, see the StartTrans() documentation. You can also use the ADOdb error handler to die and rollback your transactions for you transparently. Some buggy database extensions are known to commit all outstanding tranasactions, so you might want to explicitly do a $DB->RollbackTrans() in your error handler for safety. 19.2.1.1 Detecting Transactions Since ADOdb 2.50, you are able to detect when you are inside a transaction. Check that $connection>transCnt > 0. This variable is incremented whenever BeginTrans() is called, and decremented whenever RollbackTrans() or CommitTrans() is called. CommitTrans($ok=true) End a transaction successfully. Returns true if successful. If the database does not support transactions, will return true also as data is always committed. If you pass the parameter $ok=false, the data is rolled back. See example in BeginTrans(). RollbackTrans( ) End a transaction, rollback all changes. Returns true if successful. If the database does not support transactions, will return false as data is never rollbacked. GetOne($sql,$inputarr=false) Executes the SQL and returns the first field of the first row. The recordset and remaining rows are discarded for you automatically. If an error occur, false is returned. GetRow($sql,$inputarr=false) Executes the SQL and returns the first row as an array. The recordset and remaining rows are discarded for you automatically. If an error occurs, false is returned. GetAll($sql) Executes the SQL and returns the all the rows as a 2-dimensional array. The recordset is discarded for you automatically. If an error occurs, false is returned. GetCol($sql,$inputarr=false,$trim=false) Executes the SQL and returns all elements of the first column as a 1-dimensional array. The recordset is discarded for you automatically. If an error occurs, false is returned. CacheGetOne([$secs2cache,] $sql,$inputarr=false), CacheGetRow([$secs2cache,] $sql,$inputarr=false), CacheGetAll([$secs2cache,] $sql,$inputarr=false), CacheGetCol([$secs2cache,] $sql,$inputarr=false,$trim=false) 101 Similar to above Get* functions, except that the recordset is serialized and cached in the $ADODB_CACHE_DIR directory for $secs2cache seconds. Good for speeding up queries on rarely changing data. Note that the $secs2cache parameter is optional. If omitted, we use the value in $connection->cacheSecs (default is 3600 seconds, or 1 hour). Prepare($sql ) Prepares an SQL query for repeated execution. Only supported internally by interbase, oci8 and selected ODBC-based drivers, otherwise it is emulated. There is no performance advantage to using Prepare() with emulation. Returns an array containing the original sql statement in the first array element; the remaining elements of the array are driver dependent. If there is an error, or we are emulating Prepare( ), we return the original $sql string. This is because all error-handling has been centralized in Execute( ). Example: $stmt = $DB->Prepare('insert into table (col1,col2) values (?,?)'); for ($i=0; $i < $max; $i++) $DB->Execute($stmt,array((string) rand(), $i)); Important: Due to limitations or bugs in PHP, if you are getting errors when you using prepared queries, try setting $ADODB_COUNTRECS = false before preparing. This behaviour has been observed with ODBC. PrepareSP($sql) In the mssql driver, preparing stored procedures requires a special function call, mssql_init( ), which is called by this function. PrepareSP( ) is available in all other drivers, and is emulated by calling Prepare( ). For examples of usage, see Parameter( ) below. Returns the same array or $sql string as Prepare( ) above. Parameter($stmt, $var, $name, $isOutput=false, $maxLen = 4000, $type = false ) Adds a bind parameter in a fashion that is compatible with Microsoft SQL Server and Oracle oci8. The parameters are: $stmt Statement returned by Prepare() or PrepareSP(). $var PHP variable to bind to. Make sure you pre-initialize it! $name Name of stored procedure variable name to bind to. [$isOutput] Indicates direction of parameter 0/false=IN 1=OUT 2= IN/OUT. This is ignored in oci8 as this driver auto-detects the direction. [$maxLen] Maximum length of the parameter variable. [$type] Consult mssql_bind and ocibindbyname docs at php.net for more info on legal values for type. In mssql, $opt can hold the following elements: array('type' => integer, maxLen =>integer). Example: # @RETVAL = SP_RUNSOMETHING @myid,@group $stmt = $db->PrepareSP('SP_RUNSOMETHING'); # note that the parameter name does not have @ in front! $db->Parameter($stmt,$id,'myid'); $db->Parameter($stmt,$group,'group',false,64); # return value in mssql - RETVAL is hard-coded name $db->Parameter($stmt,$ret,'RETVAL',true); $db->Execute($stmt); An oci8 example: # For oracle, Prepare and PrepareSP are identical $stmt = $db->PrepareSP( "declare RETVAL integer; begin :RETVAL := SP_RUNSOMETHING(:myid,:group); 102 end;"); $db->Parameter($stmt,$id,'myid'); $db->Parameter($stmt,$group,'group',false,64); $db->Parameter($stmt,$ret,'RETVAL',true); $db->Execute($stmt); Note that the only difference between the oci8 and mssql implementations is the syntax of $sql. If $type parameter is set to false, in mssql, $type will be dynamicly determined based on the type of the PHP variable passed (string => SQLCHAR, boolean =>SQLINT1, integer =>SQLINT4 or float/double=>SQLFLT8). In oci8, $type can be set to OCI_B_FILE (Binary-File), OCI_B_CFILE (Character-File), OCI_B_CLOB (Character-LOB), OCI_B_BLOB (Binary-LOB) and OCI_B_ROWID (ROWID). To pass in a null, use $db->Parameter($stmt, $null=null, 'param'). Lastly, in oci8, bind parameters can be reused without calling PrepareSP( ) or Parameters again. This is not possible with mssql. An oci8 example: $id = 0; $i = 0; $stmt = $db->PrepareSP( "update table set val=:i where id=:id"); $db->Parameter($stmt,$id,'id'); $db->Parameter($stmt,$i, 'i'); for ($cnt=0; $cnt < 1000; $cnt++) { $id = $cnt; $i = $cnt * $cnt; # works with oci8! $db->Execute($stmt); } Bind($stmt, $var, $size=4001, $type=false, $name=false) This is a low-level function supported only by the oci8 driver. Avoid using unless you only want to support Oracle. The Parameter( ) function is the recommended way to go with bind variables. Bind( ) allows you to use bind variables in your sql statement. This binds a PHP variable to a name defined in an Oracle sql statement that was previously prepared using Prepare(). Oracle named variables begin with a colon, and ADOdb requires the named variables be called :0, :1, :2, :3, etc. The first invocation of Bind() will match :0, the second invocation will match :1, etc. Binding can provide 100% speedups for insert, select and update statements. The other variables, $size sets the buffer size for data storage, $type is the optional descriptor type OCI_B_FILE (Binary-File), OCI_B_CFILE (Character-File), OCI_B_CLOB (Character-LOB), OCI_B_BLOB (Binary-LOB) and OCI_B_ROWID (ROWID). Lastly, instead of using the default :0, :1, etc names, you can define your own bind-name using $name. The following example shows 3 bind variables being used: p1, p2 and p3. These variables are bound to :0, :1 and :2. $stmt = $DB->Prepare("insert into table (col0, col1, col2) values (:0, :1, :2)"); $DB->Bind($stmt, $p1); $DB->Bind($stmt, $p2); $DB->Bind($stmt, $p3); for ($i = 0; $i < $max; $i++) { $p1 = ?; $p2 = ?; $p3 = ?; $DB->Execute($stmt); } You can also use named variables: $stmt = $DB->Prepare("insert into table (col0, col1, col2) values (:name0, :name1, :name2)"); $DB->Bind($stmt, $p1, "name0"); $DB->Bind($stmt, $p2, "name1"); $DB->Bind($stmt, $p3, "name2"); for ($i = 0; $i < $max; $i++) { $p1 = ?; $p2 = ?; $p3 = ?; $DB->Execute($stmt); } 103 fnExecute and fnCacheExecute properties These two properties allow you to define bottleneck functions for all sql statements processed by ADOdb. This allows you to perform statistical analysis and query-rewriting of your sql. For example, to count all cached queries and non-cached queries, you can do this: # $db is the connection object function CountExecs($db, $sql, $inputarray) { global $EXECS; $EXECS++; } # $db is the connection object function CountCachedExecs($db, $secs2cache, $sql, $inputarray) { global $CACHED; $CACHED++; } $db = NewADOConnection('mysql'); $db->Connect(...); $db->fnExecute = 'CountExecs'; $db->fnCacheExecute = 'CountCachedExecs'; : : # After many sql statements:` printf("Total queries=%d; total cached=%d",$EXECS+$CACHED, $CACHED); The fnExecute function is called before the sql is parsed and executed, so you can perform a query rewrite. If you are passing in a prepared statement, then $sql is an array (see Prepare). The fnCacheExecute function is only called if the recordset returned was cached. The function parameters match the Execute and CacheExecute functions respectively, except that $this (the connection object) is passed as the first parameter. 104 ADOConnection Utility Functions BlankRecordSet([$queryid]) No longer available - removed since 1.99. Concat($s1,$s2,....) Generates the sql string used to concatenate $s1, $s2, etc together. Uses the string in the concat_operator field to generate the concatenation. Override this function if a concatenation operator is not used, eg. MySQL. Returns the concatenated string. DBDate($date) Format the $date in the format the database accepts; this can be a Unix integer timestamp or an ISO format Y-m-d. Uses the fmtDate field, which holds the format to use. If null or false or '' is passed in, it will be converted to an SQL null. Returns the date as a quoted string. DBTimeStamp($ts) Format the timestamp $ts in the format the database accepts; this can be a Unix integer timestamp or an ISO format Y-m-d H:i:s. Uses the fmtTimeStamp field, which holds the format to use. If null or false or '' is passed in, it will be converted to an SQL null. Returns the timestamp as a quoted string. qstr($s,[$magic_quotes_enabled=false]) Quotes a string to be sent to the database. The $magic_quotes_enabled parameter may look funny, but the idea is if you are quoting a string extracted from a POST/GET variable, then pass get_magic_quotes_gpc() as the second parameter. This will ensure that the variable is not quoted twice, once by qstr and once by the magic_quotes_gpc. Eg. $s = $db->qstr(HTTP_GET_VARS['name'],get_magic_quotes_gpc()); Returns the quoted string. Quote($s) Quotes the string, automatically checking get_magic_quotes_gpc() first. If get_magic_quotes_gpc() is set, then we do not quote the string. Affected_Rows( ) Returns the number of rows affected by a update or delete statement. Returns false if function not supported. Not supported by interbase/firebird currently. Insert_ID( ) Returns the last autonumbering ID inserted. Returns false if function not supported. Only supported by databases that support auto-increment or object id's, such as PostgreSQL, MySQL and MSSQL currently. PostgreSQL returns the OID, which can change on a database reload. MetaDatabases() Returns a list of databases available on the server as an array. You have to connect to the server first. Only available for ODBC, MySQL and ADO. MetaTables() 105 Returns an array of tables and views for the current database as an array. The array should exclude system catalog tables if possible. MetaColumns($table) Returns an array of ADOFieldObject's, one field object for every column of $table. Currently Sybase does not recognise date types, and ADO cannot identify the correct data type (so we default to varchar).. MetaColumnNames($table) Returns an array of column names for $table. MetaPrimaryKeys($table) Returns an array containing column names that are the primary keys of $table. Only supported by mysql, postgres, oci8 currently. ServerInfo($table) Returns an array of containing two elements 'description' and 'version'. The 'description' element contains the string description of the database. The 'version' naturally holds the version number (which is also a string). 106 19.3 ADORecordSet When an SQL statement successfully is executed by ADOConnection->Execute($sql),an ADORecordSet object is returned. This object contains a virtual cursor so we can move from row to row, functions to obtain information about the columns and column types, and helper functions to deal with formating the results to show to the user. ADORecordSet Fields fields: Array containing the current row. This is not associative, but is an indexed array from 0 to columns-1. See also the function Fields, which behaves like an associative array. dataProvider: The underlying mechanism used to connect to the database. Normally set to native, unless using odbc or ado. blobSize: Maximum size of a char, string or varchar object before it is treated as a Blob (Blob's should be shown with textarea's). See the MetaType function. sql: Holds the sql statement used to generate this record set. canSeek: Set to true if Move( ) function works. EOF: True if we have scrolled the cursor past the last record. ADORecordSet Functions ADORecordSet( ) Constructer. Normally you never call this function yourself. GetAssoc([$force_array]) Generates an associative array from the recordset if the number of columns is greater than 2. The array is generated from the current cursor position till EOF. The first column of the recordset becomes the key to the rest of the array. If the columns is equal to two, then the key directly maps to the value unless $force_array is set to true, when an array is created for each key. Inspired by PEAR's getAssoc. Example: We have the following data in a recordset: row1: Apple, Fruit, Edible row2: Cactus, Plant, Inedible row3: Rose, Flower, Edible GetAssoc will generate the following associative array: Apple => [Fruit, Edible] Cactus => [Plant, Inedible] Rose => [Flower,Edible] Returns: The associative array, or false if an error occurs. GetArray([$number_of_rows]) Generate a 2-dimensional array of records from the current cursor position, indexed from 0 to $number_of_rows - 1. If $number_of_rows is undefined, till EOF. GetRows([$number_of_rows]) Generate a 2-dimensional array of records from the current cursor position. Synonym for GetArray() for compatibility with Microsoft ADO. GetMenu($name, [$moreAttr='']) [$default_str=''], [$blank1stItem=true], 107 [$multiple_select=false], [$size=0], Generate a HTML menu (<select><option><option></select>). The first column of the recordset (fields[0]) will hold the string to display in the option tags. If the recordset has more than 1 column, the second column (fields[1]) is the value to send back to the web server.. The menu will be given the name $name. If $default_str is defined, then if $default_str == fields[0], that field is selected. If $blank1stItem is true, the first option is empty. You can also set the first option strings by setting $blank1stItem = "$value:$text". $Default_str can be array for a multiple select listbox. To get a listbox, set the $size to a non-zero value (or pass $default_str as an array). If $multiple_select is true then a listbox will be generated with $size items (or if $size==0, then 5 items) visible, and we will return an array to a server. Lastly use $moreAttr to add additional attributes such as javascript or styles. Menu Example 1: GetMenu('menu1','A',true) will generate a menu: (C,3). Also see example 5. A for the data (A,1), (B,2), Menu Example 2: For the same data, GetMenu('menu1',array('A','B'),false) will generate a menu with both A and B selected: A B C GetMenu2($name, [$moreAttr='']) [$default_str=''], [$blank1stItem=true], [$multiple_select=false], [$size=0], This is nearly identical to GetMenu, except that the $default_str is matched to fields[1] (the option values). Menu Example 3: Given the data in menu example 2, GetMenu2('menu1',array('1','2'),false) will generate a menu with both A and B selected in menu example 2, but this time the selection is based on the 2nd column, which holds the values to return to the Web server. UserDate($str, [$fmt]) Converts the date string $str to another format.UserDate calls UnixDate to parse $str, and $fmt defaults to Y-m-d if not defined. UserTimeStamp($str, [$fmt]) Converts the timestamp string $str to another format. The timestamp format is Y-m-d H:i:s, as in '200202-28 23:00:12'. UserTimeStamp calls UnixTimeStamp to parse $str, and $fmt defaults to Y-m-d H:i:s if not defined. UnixDate($str) Parses the date string $str and returns it in unix mktime format (eg. a number indicating the seconds after January 1st, 1970). Expects the date to be in Y-m-d H:i:s format, except for Sybase and Microsoft SQL Server, where M d Y is also accepted (the 3 letter month strings are controlled by a global array, which might need localisation). This function is available in both ADORecordSet and ADOConnection since 1.91. UnixTimeStamp($str) Parses the timestamp string $str and returns it in unix mktime format (eg. a number indicating the seconds after January 1st, 1970). Expects the date to be in Y-m-d H:i:s format, except for Sybase and Microsoft SQL Server, where M d Y h:i:sA is also accepted (the 3 letter month strings are controlled by a global array, which might need localisation). This function is available in both ADORecordSet and ADOConnection since 1.91. 108 OffsetDate($dayFraction, $basedate=false) Allows you to calculate future and past dates based on $basedate in a portable fashion. If $basedate is not defined, then the current date (at 12 midnight) is used. Returns the SQL string that performs the calculation when passed to Execute(). For example, in Oracle, to find the date and time that is 2.5 days from today, you can use: # get date one week from now $fld = $conn->OffsetDate(7); // returns "(trunc(sysdate)+7") # get date and time that is 60 hours from current date and time $fld = $conn->OffsetDate(2.5, $conn->sysTimeStamp); // returns "(sysdate+2.5)" $conn->Execute("UPDATE TABLE SET dodate=$fld WHERE ID=$id"); This function is available for mysql, mssql, oracle, oci8 and postgresql drivers since 2.13. It might work with other drivers provided they allow performing numeric day arithmetic on dates. SQLDate($dateFormat, $basedate=false) Use the native SQL functions to format a date or date column $basedate, using a case-insensitive $dateFormat, which supports: Y: Q: M: D: 4-digit Year Quarter (1-4) Month (01-12) Day (01-31) All other characters are treated as strings. You can also use to escape characters. Available on selected databases, including mysql, postgresql, mssql, oci8 and DB2. This is useful in writing portable sql statements that GROUP BY on dates. For example to display total cost of goods sold broken by quarter (dates are stored in a field called postdate): $sqlfn = $db->SQLDate('Y-QQ','postdate'); # get sql that formats postdate to output 2002-Q1 $sql = "SELECT $sqlfn,SUM(cogs) FROM table GROUP BY $sqlfn ORDER BY 1 desc"; MoveNext( ) Move the internal cursor to the next row. The $this->fields array is automatically updated. Return false if unable to do so (normally because EOF has been reached), otherwise true. If EOF is reached, then the $this->fields array is set to false (this was only implemented consistently in ADOdb 3.30). Note that if false is returned, then the previous array in $this->fields is preserved. Example: $rs = $db->Execute($sql); if ($rs) while (!$rs->EOF) { ProcessArray($rs->fields); $rs->MoveNext(); } Move($to) Moves the internal cursor to a specific row $to. Rows are zero-based eg. 0 is the first row. The fields array is automatically updated. For databases that do not support scrolling internally, ADOdb will simulate forward scrolling. Some databases do not support backward scrolling. If the $to position is after the EOF, $to will move to the end of the RecordSet for most databases. Some obscure databases using odbc might not behave this way. Note: This function uses absolute positioning, unlike Microsoft's ADO. Returns true or false. If false, the internal cursor is not moved in most implementations, so AbsolutePosition( ) will return the last cursor position before the Move( ). MoveFirst() 109 Internally calls Move(0). Note that some databases do not support this function. MoveLast() Internally calls Move(RecordCount()-1). Note that some databases do not support this function. GetRowAssoc($toUpper=true) The above function is no longer the prefered way of getting associative arrays. Use the $ADODB_FETCH_MODE variable instead. Returns an associative array containing the current row. The keys to the array are the column names. The column names are upper-cased for easy access. To get the next row, you will still need to call MoveNext(). For example: Array ( [ID] =>1 [FIRSTNAME] =>Caroline [LASTNAME] =>Miranda [CREATED] =>2001-07-05 ) Note: do not use GetRowAssoc() with $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC. Because they have the same functionality, they will interfere with each other. AbsolutePage($page=-1) Returns the current page. Requires PageExecute()/CachePageExecute() to be called. See Example 8. AtFirstPage($status='') Returns true if at first page (1-based). Requires PageExecute()/CachePageExecute() to be called. See Example 8. AtLastPage($status='') Returns true if at last page (1-based). Requires PageExecute()/CachePageExecute() to be called. See Example 8. Fields($colname) This function is deprecated. Use $ADODB_FETCH_MODE instead. Some database extensions (eg. MySQL) return arrays that are both associative and indexed if you use the native extensions. GetRowAssoc() does not return arrays that combine associative and indexed elements. Returns the value of the associated column $colname for the current row. The column name is case-insensitive. FetchRow() Returns array containing current row, or false if EOF. FetchRow( ) internally moves to the next record after returning the current row. Warning: Do not mix using FetchRow() with MoveNext(). Usage: $rs = $db->Execute($sql); if ($rs) while ($arr = $rs->FetchRow()) { # process $arr } FetchInto(&$array) Sets $array to the current row. Returns PEAR_Error object if EOF, 1 if ok (DB_OK constant). If PEAR is undefined, false is returned when EOF. FetchInto( ) internally moves to the next record after returning the current row. FetchRow() is easier to use. See above. FetchField($column_number) 110 Returns an object containing the name, type and max_length of the associated field. If the max_length cannot be determined reliably, it will be set to -1. The column numbers are zero-based. See example 2. FieldCount( ) Returns the number of fields (columns) in the record set. RecordCount( ) Returns the number of rows in the record set. If the number of records returned cannot be determined from the database driver API, we will buffer all rows and return a count of the rows after all the records have been retrieved. This buffering can be disabled (for performance reasons) by setting the global variable $ADODB_COUNTRECS = false. When disabled, RecordCount( ) will return -1 for certain databases. See the supported databases list above for more details. RowCount is a synonym for RecordCount. PO_RecordCount($table, $where) Returns the number of rows in the record set. If the database does not support this, it will perform a SELECT COUNT(*) on the table $table, with the given $where condition to return an estimate of the recordset size. $numrows = $rs->PO_RecordCount("articles_table", "group=$group"); NextRecordSet() For databases that allow multiple recordsets to be returned in one query, this function allows you to switch to the next recordset. Currently only supported by mssql driver. $rs = $db->Execute('execute return_multiple_rs'); $arr1 = $rs->GetArray(); $rs->NextRecordSet(); $arr2 = $rs->GetArray(); FetchObject($toupper=true) Returns the current row as an object. If you set $toupper to true, then the object fields are set to uppercase. Note: The newer FetchNextObject() is the recommended way of accessing rows as objects. See below. FetchNextObject($toupper=true) Gets the current row as an object and moves to the next row automatically. Returns false if at end-offile. If you set $toupper to true, then the object fields are set to upper-case. $rs = $db->Execute('select firstname,lastname from table'); if ($rs) { while ($o = $rs->FetchNextObject()) { print "$o->FIRSTNAME, $o->LASTNAME "; } } There is some trade-off in speed in using FetchNextObject(). If performance is important, you should access rows with the fields[] array. FetchObj() Returns the current record as an object. Fields are not upper-cased, unlike FetchObject. FetchNextObj() Returns the current record as an object and moves to the next record. If EOF, false is returned. Fields are not upper-cased, unlike FetctNextObject. CurrentRow( ) Returns the current row of the record set. 0 is the first row. 111 AbsolutePosition( ) Synonym for CurrentRow for compatibility with ADO. Returns the current row of the record set. 0 is the first row. MetaType($nativeDBType[,$field_max_length],[$fieldobj]) Determine what generic meta type a database field type is given its native type $nativeDBType as a string and the length of the field $field_max_length. Note that field_max_length can be -1 if it is not known. The field object returned by the database driver can be passed in $fieldobj. This is useful for databases such as mysql which has additional properties in the field object such as primary_key. Uses the field blobSize and compares it with $field_max_length to determine whether the character field is actually a blob. For example, $db->MetaType('char') will return 'C'. Returns: • • • • • • • • • C: Character fields that should be shown in a <input type="text"> tag. X: Clob (character large objects), or large text fields that should be shown in a <textarea> D: Date field T: Timestamp field L: Logical field (boolean or bit-field) N: Numeric field. Includes decimal, numeric, floating point, and real. I: Integer field. R: Counter or Autoincrement field. Must be numeric. B: Blob, or binary large objects. Since ADOdb 3.0, MetaType accepts $fieldobj as the first parameter, instead of $nativeDBType. Close( ) Close the recordset. function rs2html($adorecordset,[$tableheader_attributes], [$col_titles]) This is a standalone function (rs2html = recordset to html) that is similar to PHP's odbc_result_all function, it prints a ADORecordSet, $adorecordset as a HTML table. $tableheader_attributes allow you to control the table cellpadding, cellspacing and border attributes. Lastly you can replace the database column names with your own column titles with the array $col_titles. This is designed more as a quick debugging mechanism, not a production table recordset viewer. You will need to include the file tohtml.inc.php. Example of rs2html: <? include('tohtml.inc.php'); # load code common to ADOdb include('adodb.inc.php'); # load code common to ADOdb $conn = &ADONewConnection('mysql'); # create a connection $conn->PConnect('localhost','userid','','agora');# connect to MySQL, agora db $sql = 'select CustomerName, CustomerID from customers'; $rs = $conn->Execute($sql); rs2html($rs,'border=2 cellpadding=3',array('Customer Name','Customer ID')); ?> 112 Differences between this ADOdb library and Microsoft ADO 1. ADOdb only supports recordsets created by a connection object. Recordsets cannot be created independently. 2. ADO properties are implemented as functions in ADOdb. This makes it easier to implement any enhanced ADO functionality in the future. 3. ADOdb's ADORecordSet->Move() uses absolute positioning, not relative. Bookmarks are not supported. 4. ADORecordSet->AbsolutePosition() cannot be used to move the record cursor. 5. ADO Parameter objects are not supported. Instead we have the ADOConnection::Parameter( ) function, which provides a simpler interface for calling preparing parameters and calling stored procedures. 6. Recordset properties for paging records are available, but implemented as in Example 8. 113 20 Database Driver Guide This describes how to create a class to connect to a new database. To ensure there is no duplication of work, kindly email me at jlim#natsoft.com.my if you decide to create such a class. First decide on a name in lower case to call the database type. Let's say we call it xbase. Then we need to create two classes ADODB_xbase and ADORecordSet_xbase in the file adodbxbase.inc.php. The simplest form of database driver is an adaptation of an existing ODBC driver. Then we just need to create the class ADODB_xbase extends ADODB_odbc to support the new date and timestamp formats, the concatenation operator used, true and false. For the ADORecordSet_xbase extends ADORecordSet_odbc we need to change the MetaType function. See adodb-vfp.inc.php as an example. More complicated is a totally new database driver that connects to a new PHP extension. Then you will need to implement several functions. Fortunately, you do not have to modify most of the complex code. You only need to override a few stub functions. See adodb-mysql.inc.php for example. The default date format of ADOdb internally is YYYY-MM-DD (Ansi-92). All dates should be converted to that format when passing to an ADOdb date function. See Oracle for an example how we use ALTER SESSION to change the default date format in _pconnect _connect. ADOConnection Functions to Override Defining a constructor for your ADOConnection derived function is optional. There is no need to call the base class constructor. _connect: Low level implementation of Connect. Returns true or false. Should set the _connectionID. _pconnect: Low level implemention of PConnect. Returns true or false. Should set the _connectionID. _query: Execute a query. Returns the queryID, or false. _close: Close the connection -- PHP should clean up all recordsets. ErrorMsg: Stores the error message in the private variable _errorMsg. ADOConnection Fields to Set _bindInputArray: Set to true if binding of parameters for SQL inserts and updates is allowed using ?, eg. as with ODBC. fmtDate fmtTimeStamp true false concat_operator replaceQuote hasLimit support SELECT * FROM TABLE LIMIT 10 of MySQL. hasTop support Microsoft style SELECT TOP 10 * FROM TABLE. ADORecordSet Functions to Override You will need to define a constructor for your ADORecordSet derived class that calls the parent class constructor. FetchField: as documented above in ADORecordSet 114 _initrs: low level initialization of the recordset: setup the _numOfRows and _numOfFields fields -called by the constructor. _seek: seek to a particular row. Do not load the data into the fields array. This is done by _fetch. Returns true or false. Note that some implementations such as Interbase do not support seek. Set canSeek to false. _fetch: fetch a row using the database extension function and then move to the next row. Sets the fields array. If the parameter $ignore_fields is true then there is no need to populate the fields array, just move to the next row. then Returns true or false. _close: close the recordset Fields: If the array row returned by the PHP extension is not an associative one, you will have to override this. See adodb-odbc.inc.php for an example. For databases such as MySQL and MSSQL where an associative array is returned, there is no need to override this function. ADOConnection Fields to Set canSeek: Set to true if the _seek function works. 20.1 Idő kezelése PHP – MySQL esetén Az időpontok kezelése a Unix hagyományokra épül. A Unix „időszámítás” kezdete 1970. január.01, 0 óra 0 perc. Az időt a Unix rendszerek innen számított másodpercekben mérik és tárolják. Ennek megfelelően a PHP és a MySQL is innen indul ki. A UNIX idő elnevezése TIMESTAMP. Az így kapott időpont azonban egy nagy egész szám, amit az adatok bevitelénél és kiiratásánál nemigen lehet használni, ezért léteznek konverziós függvények ilyen célokra. A PHP esetén az aktuális időpontot a string Date(formátumstring [,timestamp]) függvény állítja elő A fromátumstringben az alábbi megjegyzések lehetnek: Év – y két karakter (01), Y 4 karakter hosszú (2001) Hónap - m – két karakter, sorszám 01, 02,…, M – a hónap angol neve (January, February, …) Nap – d –két karakter, a hónapban a nap sorszáma, D – elnevezése angolul (Monday, Thuesday, …) Óra – h – 12 órás ciklus 00-12, H – 24 órás ciklus két karakter 00 - 23 Perc – i – kt karakter 00-59 Az eredmény tehát string! Az időpont átalakítása TIMESTAMP formátumra az alábbi függvénnyel lehetséges: int mktime (int óra, int perc, int másodperc, int hónap, int nap, int év [, int is_dst]) Amennyiben nem akarunk kitölteni bizonyos értékeket, akkor 0-val kell feltölteni őket. Az utolsó paraméter a nappal értékét tartalmazza, általában elhagyható, sőt gyakorlatilag elhagyandó. A MySQL esetén az időpont tárolása és formátuma hasonlóan kettős. Lehet tárolni időpontot TIMESTAMP formátumban. Ekkor a UNIX timestamp lesz a belső tárolási formátum, de a megjelenítésnél már karaktersorozatot kapunk vissza. Ahhoz, hogy a PHP-nek megfelelő Timestamp legyen egy lekérdezés eredménye, a MySQL TIMESTAMP()függvényét kell használni. Az alábbiakban egy ilyen megoldásra látunk példát. Function koncertlista($datum) { // A lekérdezés összeállítása 115 $qry ="SELECT UNIX_TIMESTAMP(Mikor) AS Ido,Mi,Hol FROM esemeny WHERE Mikor > '".$datum."'"; $result = @mysql_query($qry, $fc); $str ="<UL>"; while ($a = mysql_fetch_object($result)) { $str .= "<LI>".date("Y.M.d, D H:i",$a->Ido).", ".$a->Mi." "; $str .= $a->Hol." Belépő:".$a->Belepo." Ft</LI>"; } $str .="</UL>"; echo $str; return; } // Itt hívom meg az aktuális dátummal a függvényt. A formátum azért fontos, mert csak így // hasonlítható össze a MySQL Timestamp-jével. koncertlista(date("YmdHis")); Az eredmény az alábbi lesz: 2002.Jan.12, Sat 09:12, Koncert Uj várklub Belépõ:500 Ft Az alkalmazott adattípus az SQL táblában a TIMESTAMP(14) 20.2 Sokáig futó programok A PHP scriptek futásának a maximális ideje korlátozva van a PHP-ben, mert ha egy végtelen ciklust ír az ember, akkor lefagyaszthatja a szervert. A korlát default értéke 30 sec. Ha egy scriptünk mégis tovább futna, mert valamilyen oknál fogva a feldolgozás lassú, vagy esetleg egy adatbázisszervertől vár adatokat, akkor célszerű használnunk az alábbi függvényt a PHP oldalunk elején, mivel ez a kívánt ideig engedi futni a scriptet Set_time_limit( másodperc) Célszerűen csak akkora értéket írjunk be, hogy a script biztonságosan lefusson, ugyanakkor idejében ki is lépjen, ha kell. Ha időnek 0-t írunk, akkor soha nem jár le a script, és ha végtelen ciklust teszünk bele, akkor örökhajtós lesz a scriptünk. 116 21 File-ok, könyvtárak kezelése a szerveren és távoli URL-eken Az alábbi fejezetben megnézzük, hogy melyek a leggyakrabban használt függvények és módszerek a PHP programokban. Amennyiben valaki úgy vélné, hogy más függvények gyakrabban használatosak az ő programjaiban, nagyon sajnálom, a help alapján kell megnézni a működésüket – sokszor én is ott nézem meg. Az alábbi esetek fordulnak elő a filekezelésnél leggyakrabban a PHP programok esetén: - Távoli szerverről szeretnénk olvasni, vagy távoli szerverre írni - Helyi könyvtárszerkezetből szeretnénk olvasni, vagy ide szeretnénk írni. Az írásnál előfordulhat, hogy a kimenetet a helyi standard outputra szeretnénk tenni. - A fenti eseményeket bináris vagy text file esetén is meg akarjuk valósítani. - Helyi és távoli gépen is szeretnénk könyvtárakat létrehozni, vagy könyvtárakat törölni. - Alkalmanként kell vizsgálnunk, hogy a kérdéses file a helyi filestruktúrában vagy távoli szerveren létezik-e? - Egy megadott elérési útvonal file-ra, könyvtárra vagy link-re mutat-e? - A fileok kezeléséhez jó, ha tudjuk az alábbiakat: o Az éppen aktuálisan futó alkalmazás lokális szerveren lévő elérési útvonalát a § $_SERVER[”PATH_TRANSLATED”] stringváltozó tartalmazza o A WEB szerver gyökérkönyvtárát a § $_SERVER[”SERVER_ROOT”] változó tartalmazza o Az operációs rendszer temporary könyvtárát § a $_ENV[”TEMP”] vagy hasonló nevű szuperglobális változó tartalmazza. A file kezelésnél tundnunk kell, hogy az otthoni környezetben futtatott program eléri-e az éles szerveren is ugyanazt a könyvtárat. Ha egy web struktúrában lévő file-t kell elérnünk, akkor célszerű kiindulnunk az éppen futó alkalmazás könyvtárából. A fentiek alapján, ha az index.php alkalmazásunk az alábbi helyen fut: C:\wwwroot\valami És egy geza nevű alkönyvtárban lévő szoveg.txt file-ra szeretnénk hivatkozni, akkor az alábbi elérést kell alkalmazni: $el = $_SERVER[”PATH_TRANSLATED”].”/geza/szoveg.txt”; Az elérési útvonalak kezelése során gyakori, hogy szét kell választanom az elérési utat könyvtár, filenév illetve kiterjesztés részre. Az alábbi függvények a fenti elérési utat választják szét: $path = ”C:/wwwroot/valami/geza/szoveg.txt”; $file = basename ($path); // $file értéke "szoveg.txt" $file = basename ($path,".txt"); // $file értéke "szoveg", mivel a második paraméter hatására // a végéről levágja a megadott stringet. $dir = dirname ($path); // $d értéke ”C:\wwwroot\valami\geza" lesz. Alternatív megoldás a fenti feladatra lehet a pathinfo függvény: <?php $path_parts = pathinfo("/www/htdocs/index.html"); echo $path_parts["dirname"] . "\n"; echo $path_parts["basename"] . "\n"; echo $path_parts["extension"] . "\n"; ?> 117 Ha el akarjuk dönteni, hogy a filerendszer egy bejegyzése könyvtár, file, vagy egy link, akkor az alábbi függvényeket használhatjuk: boolean is_dir($path); boolean is_file($path); boolean is_link($path); Egy file további tulajdonságait – attributumait az alábbi függvényekkel kaphatjuk meg: int is_executable($path )- Megmondja, hogy a bejegyzés futtatható-e int is_readable($filename) – Megmondja, hogy a file olvasható-e int is_writeable($filename) – Megmondja, hogy a file írható-e int fileatime ($filename)- A file utolsó elérési ideje. A visszaadott idő UNIX időbélyeg formájában int filemtime($filename) – A file utolsó módosításának ideje Unix időbélyeg formájában int Fileowner($filename) – A file tulajdonosának ID-je. Csak lokális filerendszerben használható. int fileperms($filename) – A filera vonatkozó jogokat adja vissza. Csak lokális filerendszerben használható. int filesize($filename) - a file mérete $filename = ”C:/wwwroot/valami/geza/szoveg.txt”; echo filesize($filename); A filekezelés meglehetősen hasonlít a C-ben megszokottakra: Egy file olvasása előtt meg kell nyitnunk azt. Erre a célra az $fp = fopen($filenev, mód) függvényt használhatjuk, ahol a $filenév egy lokális filerendszer egy file-ja vagy egy URL-lel megadott file lehet. Ha windows rendszert használunk, akkor a filenévben az elérési útban szereplő könyvtárneveket a \\ jellel kell elválasztani. $fp=fopen (”C:\\wwwroot\\index.htm”,”w”); Ha a $filenév a http:// vagy az ftp:// jelekkel kezdődik, akkor egy távoli szerveren lévő file-ról van szó. $fp = fopen(”http://www.szily.sulinet.hu/index.html”,”r”); A file megnyitásának módja az alábbi lehet: mód leírás Példa ’r’ Olvasásra nyitom meg a file-t. File pointer a file elején áll $fp=fopen(”C:\\autoexec.bat”,”r”) ’w’ Írásra nyitom meg a file-t. A file pointer a file elejére áll és ha volt ilyen file, akkor megsemmisül, zéró hosszúságúvá válik $fp=fopen(”C:\\inetpub\\default.htm”,”w”) 'r+' Írásra és olvasásra nyitom meg a file-t. A pointer a file elejére áll. $fp=fopen(”C:\\inetpub\\adat.ini”,”r+”) ’w+ Írásra és olvasásra nyitom meg a file-t. A pointer $fp=fopen(”C:\\inetpub\\adat.ini”,”w+”) 118 ’ a file elejére áll. A file megnyitáskor 0 hosszúságúra csonkolódik 'a' Írásra nyitom meg a file-t. A pointer a file végére áll. $fp=fopen(”C:\\inetpub\\adat.ini”,”a”) ’a+’ Írásra és olvasásra nyitom meg a file-t. A pointer a file végére áll. $fp=fopen(”C:\\inetpub\\adat.ini”,”a+”) ’b’ Ha biztosan bináris file-t akarok olvasni vagy írni, akkor a megnyitáskor a mód stringbe be kell írni ezt is. $fp=fopen(”C:\\autoexec.bat”,”rb”) A fenti utasítás hibaüzenetet ad, ha nem létezik az olvasásra megnyitni akart file. Ezért a hibakezeléshez az alábbiakat kell tenni: if (file_exists($File)) // Létezik a file? { $fp = fopen($File,"r"); // Megnyitjuk olvasásra ..... Mielőtt olvasni szeretnénk egy file-t, meg kell nézni, hogy létezik-e. A létezés ellenőrzésére a Boolean file_exists($filename) függvényt használhatjuk. A visszatérési értéke igaz, ha a file létezik, hamis egyébként. Ha az fopen-nel megnyitottunk egy filet írásra és egy karaktert vagy byte információt akarunk beolvasni, akkor az alábbi függvényt használhatjuk $c =fgetch($fp); Ha az fopen-nel megnyitottunk egy filet írásra, és egy text file egy sorát akarjuk beolvasni, akkor az alábbi függvényt használjuk: $sor = fgets($fp[,sorhossz]); A sorhossz paraméter nem kötelező, ha nem tesszük ki, akkor alapértéke 1024 karaktert olvas a függvény. Ha az fopen-nel megnyitottunk egy filet írásra és, ki akarom szedni a beolvasott fileból az esetlegesen benne lévő html tag-okat, akkor ezt kell használni. $sor=fgetss($fp[,sorhossz]); Ha nem adjuk meg a sorhosszat, akkor max 1024 hosszú stringet olvas be. Ha egy text file összes sorát be akarjuk olvasni egy tömbbe, akkor az alábbi függvényt kell használni: $aline =file($Filename[,int include_path]) A függvény beolvassa a megadottt $Filename elérési útvonalú text file sorait egy $aline nevű tömbbe. A függvénnyel nemcsak a lokális filerendszerből, hanem URL-lel megadott file-ból is lehet olvasni! Ha a file nem létezik, akkor hibaüzenet keletkezik, és a tömb elemszáma 0 marad. A kezelésére nézzük az alábbi példát a Help alapján: <?php // A beolvasandó file egy URL-lel van megadva. $filename =”http://www.szily.hu/szily/szily.css”; $asor = @file($filename); if(count($asor==0)){ die(”Nem létező file”); } 119 // A beolvasott file feldolgozása és a sorok kiiratása. // A html sorokat kiírja, mint html szöveg, sor és sorszámot is kiír. foreach ($asor as $line_num => $sor) { echo "#{$line_num} sor : " . htmlspecialchars($sor) . " \n"; } // Ez a példa egy file-t beolvas, majd a sorokat egy stringgé összevonja. $html = implode ('', file ('http://www.szily.hu/szily/')); ?> Ha egy teljes file-t akarunk beolvasni, akkor az alábbi függvényt kell használnunk: $t=fread($fp,$filesize( $filenev)); A filesize($filenev) függvény megadja az adott file méretét byte-okban és a paraméter hatására a fileméretnek megfelelő puffert foglal le a memóriában a PHP. A visszatérési érték változója tartalmazza majd a file összes byte-ját, mint string. Ez a függvény bináris olvasáskor használható igazán, mert a beolvasott tartalommal semmiféle konverzió nem történik. Egy írásra vagy írásra/olvasásra megnyitott fileokba való írásnál alapvető függvény az int fwrite($fp,$c); Ha a kiirandó érték egy karakter, akkor karakterenként írunk, ha egy textfile egy sora, akkor a sorvége jelet hozzá kell tennünk a kiirandó tartalomhoz az alábbi módon: $c=$sor,”\r\n”; Ha egy file tartalmát akarjuk kiiratni, akkor a változó tartalmazza a teljes tartalmat. Álljon itt filekezelésre egy komplexebb példa. Egy file-ból olvasnom kell, de ehhez először meg kell nyitnom. <!Ez a program megvalósít egy egyszerű karakter alapú számlálót. A számláló pillanatnyi értéke a counter.txt állományban van, amit a szkript beolvas értékét minden egyes beolvasás során megnöveli, a megnövelt értéket ugyanabba a fileb visszaírja, majd a számláló állását megjeleníti. Ahhoz, hogy program megfelelően müködjön a counter.txt állományt létre kell hoznunk, melynek tartalma csak '1' legyen, ezt a filet fel kell töltenünk ugyanabba a könyvtárba, ahol a program van, és írási jogosultságot kell adnunk rá. --> <hr> Látogatók száma: <?php $File = 'counter.txt'; // A számláló file neve if (file_exists($File)) // Létezik a file? { $fp = fopen($File,"r"); // Megnyitjuk olvasásra $num = fread($fp, filesize($File)); // Beolvassuk a tartalmát a $num változóba. fclose($fp); // Zárjuk a filet. $num=$num+1; // A változó értékét megnöveljük $fp = fopen($File,"w"); // Megnyitjuk ugyanazt a filet, de most írásra fwrite($fp, $num, 10); // Kiírjuk a változó értékét. fclose($fp); 120 // Zárjuk a filet echo(''.chop($num).''); // Kiírjuk a HTML-kódba a változó értékét. } ?> <hr> Az alábbiakban elmondjuk a filekezeléshez szükséges tudnivalókat. 121 22 Grafika A PHP-ban a grafikai modult nem a képek egyszerű kitételére használhatjuk, hanem a szerver oldalon képekkel végzett manipulációkra. A PHP grafikához szükséges, hogy a szerver oldalon be legyen töltve a GD.DLL vagy a GD_2.DLL (Windows szerver esetén). A GD_2.DLL támogatja a BMP, JPEG, GIF, és PNG képekkel végzett manipulációkat. Az alábbi mintában egy fotoalbum készítő és hazsnáló programot mutatunk be. A program az első meghívásakor az aktuális könyvtárban lévő képekről kisképeket készít, majd táblázatos formában megjeleníti azokat. A programot objektum-orientált formában írtam meg. <?php /* Simple PhotoAlbum 2.2.1.2004.06.02 (c) by Zoltán Fábián, 1999-2004 Use the program free. email: fz@szily.hu This script works on this site: http://fz.szily.hu, http://www.alarmsystem.hu/fotoalbum Használata include("../photoalbum.php"); */ if(stristr($_SERVER["PHP_SELF"], __FILE__)) die("Nem hívhatod meg a file-t közvetlenül!..."); if(!defined("THUMBNAIL_WIDTH")) define("THUMBNAIL_WIDTH",150); define("SERVERTARGET",str_replace(".","_",$_SERVER["SERVER_NAME"])); define("DOCUMENT_ROOT",$_SERVER["DOCUMENT_ROOT"].(( substr($_SERVER["DOCUMENT_ROOT"],-1)!="/") ? "/" :"")); define("PHOTOSCRIPT",relpath(__FILE__)); //The path of this script define("PHOTOALBUM","__photoalbum.txt"); define("DELIMITER","#"); define("CSV_OK",True); if(!isset($col)) $col = 4; define("COLUMNS", $col); if(!isset($slide)) $slide = 5; define("SLIDE", $slide); // Number of columns // timeout of the sliding //Needed gd extension DEFINE("GD",True); if(!extension_loaded ("gd")) { if(ini_get("enable_dl")) { DEFINE("GD",dl("gd.dll")); }else{ DEFINE("GD",False); } } 122 //The DO // ---------- Image class image { var $Name; // var $Thumb; // var $dx; // var $dy; var $Text; // osztály ----------Picture picture Thumbnail name size of picture text under the picture function image($Entry="",$Txt="") { global $aktdir,$newThumbnails; if(strlen($Entry)>0) { $this->Name = $Entry; //get size of picture if(GD) { $size = GetImageSize($aktdir.$this->Name); }else{ $size=array(800,600); } $this->dx = $size[0]; $this->dy = $size[1]; //Text under the pictures if (strlen($Txt)>0){ $this->Text = $Txt; }else{ $pos = explode(".",$Entry); $this->Text = str_replace("_"," ",$pos[0]); } //Is there thumbnail of image? $thn = $aktdir."tn_".$this->Name; $origDate = filemtime ( $aktdir.$this->Name); $isthn = is_file($thn); $thDate = $isthn ? filemtime ( $thn): 0; //print($origDate ." ".$thDate." "); if((!$isthn || ($origDate > $thDate ))&& GD ) { $this->NewThumbnail(); $newThumbnails++; }else{ $this->ReadThumbnail(); } }else{ $this->Name = ""; $this->dx = 0; $this->dy = 0; $this->Text = ""; } } 123 //Make new thumbnails from GIF, PNG or JPG | JPEG |bmp! function NewThumbnail () { global $gd, $aktdir; //size of original big picture $size = GetImageSize($aktdir.$this->Name); $dx = $size[0]; $dy = $size[1]; $a = eregi("\.gif",$aktdir.$this->Name); if((!eregi("\.gif",$aktdir.$this->Name)) && (($dx> THUMBNAIL_WIDTH) |($dy>THUMBNAIL_WIDTH))) { if (eregi("\.jpg|\.jpeg",$aktdir.$this->Name)) { $im = ImageCreateFromJPEG ($aktdir.$this->Name); //Empty destination image $dst_im = @ImageCreateTrueColor( THUMBNAIL_WIDTH, THUMBNAIL_WIDTH*$dy /$dx); } if (eregi("\.png",$aktdir.$this->Name)){ $im = @ImageCreateFromPNG ($pics->ImagePath.$this->Name); $dst_im = @ImageCreateTrueColor(THUMBNAIL_WIDTH, THUMBNAIL_WIDTH*$dy /$dx); } if (eregi("\.wbmp",$aktdir.$this->Name)){ $im = @ImageCreateFromwbmp ($pics->ImagePath.$this->Name); $dst_im = @ImageCreateTrueColor(THUMBNAIL_WIDTH, THUMBNAIL_WIDTH*$dy /$dx); } if (eregi("\.bmp",$aktdir.$this->Name)){ $im = @ImageCreateFromwbmp ($aktdir.$this->Name); $dst_im = @ImageCreateTrueColor(THUMBNAIL_WIDTH, THUMBNAIL_WIDTH*$dy /$dx); } // Image resize and copy from source to destination $a = imagecopyresized ($dst_im, $im, 0, 0, 0, 0, THUMBNAIL_WIDTH, THUMBNAIL_WIDTH*$dy/$dx, $dx, $dy); $this->Thumb = $aktdir."tn_".$this->Name; //New image on disk Imagejpeg ($dst_im, $this->Thumb); }else{ $this->Thumb = $aktdir."tn_".$this->Name; copy($aktdir.$this->Name,$aktdir."tn_".$this->Name); } } //Thumbnail reading function ReadThumbnail(){ if(GD) { $this->Thumb = "tn_".$this->Name; }else{ $this->Thumb = $this->Name; } } 124 //Write out a thumbnail into the table function ShowThumbnail() { $str=$this->GetString(); print($str); } //get the string of a thumbnail function GetString() { global $css_td,$css_link,$pics; $str = "<TD ".$css_td." ALIGN=\"CENTER\" VALIGN=\"top\">"; $str .= "<a href='javascript:picturepopup(\"". PHOTOSCRIPT."?getimg=".$this- rel="nofollow">Name."&picpath=". $pics->ImageWebPath."\",\"".SERVERTARGET."\")' ". $css_link.">\n"; $str .= "<IMG SRC=\"".$this->Thumb."\" ALT=\"".$this->Name. "\" border=\"0\" width=\"".THUMBNAIL_WIDTH."\" > ". $this->Text."</a>\n"; $str .= "</TD>"; return $str; } } //-------- Image list class ----------class ImageList { var $aPictures = array(); //Array of images var $ImageNumber; var $RowNumber; //number of rows var $ImagePath; //The directory of list var $ImageWebPath; //The Path in the website var $CSV_OK; var var var var var var var $css_file; $css_link; $css_body; $css_table; $css_tr; $css_td; $css_tag; //styles //It makes a list from the actual directory function ImageList($path) { $this->newThumbnails = 0; $this->ImageNumber = 0; $this->ImagePath = $path; $this->ImageWebPath = substr(relpath($path),0,-1); if(CSV_OK){ $aCSV = array(); if (file_exists(PHOTOALBUM)){ $row = 1; $handle = fopen (PHOTOALBUM,"r"); while ($row = fgetcsv ($handle, 1000, DELIMITER)) { $aCSV[$row[0]] = $row[1]; } fclose ($handle); }else{ $handle=fopen(PHOTOALBUM,"w"); fclose($handle); } } //Make an Image object $d=opendir($path); while($entry=readdir($d)){ if ($this->is_image($entry)) { 125 $text=$entry; //Handling CSS text if(CSV_OK){ if(isset($aCSV)){ if(isset($aCSV[$entry])){ $text=$aCSV[$entry]; }else{ $handle = fopen(PHOTOALBUM,"a"); fwrite($handle,$entry.DELIMITER.$entry."\n"); fclose($handle); } }else{ $handle = fopen(PHOTOALBUM,"a"); fwrite($handle,$entry.DELIMITER.$entry."\n"); fclose($handle); } } $this->aPictures[] = new Image($entry,$text); $this->ImageNumber++; } } closedir($d); sort($this->aPictures); $this->RowNumber = (int) ($this->ImageNumber / COLUMNS ); } //Is Image this filename function is_image($str){ //This is the right soluton. $str="_".strtolower($str); //exclude thumbnails $pos = strpos ($str, "tn_"); if ($pos ==1){ return FALSE; }else{ return eregi("\.gif|\.jpg|\.jpeg|\.bmp|\.png",$str); } } function css(){ global $css_file,$css_link,$css_body,$css_table,$css_tr,$css_td,$css_tr; $this->css_file = ( isset($_GET["css_file"]) )? $_GET["css_file"] : (isset($css_file) ? $css_link : False); $this->css_link = ( isset($_GET["css_link"]) )? $_GET["css_link"] : (isset($css_link) ? $css_link : "style=\"font-family: Verdana,Arial, Helvetica, sans-serif; font-size: x-small; color: #000000\""); $this->css_body = ( isset($_GET["css_body"]) )? $_GET["css_body"] : (isset($css_body) ? $css_body : "style=\"background-color: #666666;\""); $this->css_table = ( isset($_GET["css_table"]))? $_GET["css_table"]: (isset($css_table)? $css_table: "style=\"border:0;\""); $this->css_tr = ( isset($_GET["css_tr"] ))? $_GET["css_tr"] : (isset($css_tr) ? $css_tr : "style=\"vertical-align:top;\""); $this->css_td = ( isset($_GET["css_td"] ))? $_GET["css_td"] : (isset($css_td) ? $css_td : "align=\"center\""); $this->css_tag = ( isset($_GET["css_tag"] ))? $_GET["css_tag"] : (isset($css_tag) ? $css_tag : "class=\"kapcsolat\""); } //It makes a table from the pictures function ShowList() { $str=$this->GetString(); print($str); } function GetString() { global $css_table,$css_tr,$css_td,$newThumbnails; 126 $str = picturepopup(); $str .= "<TABLE ".$css_table.">";// Border=\"0\">\n\r"; $str .= "<TR ".$css_tr.">\n\r"; $j=0; while (list ($key, $ertek) = each ($this->aPictures)) { $str .=$this->aPictures[$key]->GetString(); $j++; if ($j == COLUMNS){ $str .="</TR>\n\r<TR>"; $j =0; } } while(0<$j && $j<COLUMNS){ $str .= "<TD ".$css_td."> </TD>"; $j++; } $str .="</TR>\n\r"; $str .="</TABLE>\n\r"; if ($newThumbnails>0){ $str .=" Found ". $newThumbnails." new pictures and made thumbnails!"; $newThumbnails=0; } Return $str; } //Searches an image in array function Search($image) { $i =0; while( ($i<sizeof($this->aPictures) ) && ($this->aPictures[$i]->Name != $image) ) { $i++; } return $i; } function PreviousImage($idx){ if($idx==0) $idx = sizeof($this->aPictures); $idx--; Return $idx; } function NextImage($idx) { if($idx==sizeof($this->aPictures)-1) $idx=-1; $idx++; Return $idx; } } class popup { var $Image; var $PrevImage; var $NextImage; var $dx; //width of popup var $dy; //height of popup var $dxx; //width of picture var $dyy; //height of picture function popup($getimg){ global $pics; $idx= $pics->Search($getimg); $this->Image = new Image(); 127 $this->PrevImage $this->NextImage $this->Image $this->PrevImage $this->NextImage $this->dxx = = = = = = new Image(); new Image(); $pics->aPictures[$idx]; $pics->aPictures[$pics->PreviousImage($idx)]; $pics->aPictures[$pics->NextImage($idx)]; ($this->Image->dx<600) ? (600) :($this->Image->dx); if ($this->dxx>1024) $this->dxx = 1024; $this->dyy = ($this->Image->dy) *$this->dxx/$this->Image->dx; $this->dx = $this->dxx + 28; $this->dy = $this->dyy + 40; } function GetString(){ global $pics,$isslide; //Javascript for show the picture $str ="<HTML>\n"; $str .="<HEAD>\n"; $str .="<TITLE>Kep:".$this->Image->Name."</TITLE>\n"; if($isslide) { $str .="<META HTTP-EQUIV=REFRESH CONTENT=\"".SLIDE.";URL=".basename($_SERVER["PATH_TRANSLATED"])."?getimg=".urlenco de($this->NextImage->Name)."&isslide=1\">"; } $str .="</HEAD>\n"; $str .= picturepopup(); $str .="<BODY style=\"background-color: #666666;\" style=\"margin:0\">\n"; $str .="<DIV ALIGN=CENTER>\n"; $str .="<A HREF='javascript:picturepopup(\"".PHOTOSCRIPT."?getimg=".$this rel="nofollow">PrevImage->Name."&picpath=".$pics->ImageWebPath."\",\"".SERVERTARGET."\")' style=\"font-family: Verdana,Arial, Helvetica, sans-serif; font-size: x-small; color: #000000\" ".$pics->css_tag.">[::Prev::</A>\n"; $str .="<A HREF='javascript:picturepopup(\"".PHOTOSCRIPT."?getimg=".$this rel="nofollow">NextImage->Name."&picpath=".$pics->ImageWebPath."\",\"".SERVERTARGET."\")' style=\"font-family: Verdana,Arial, Helvetica, sans-serif; font-size: x-small; color: #000000\" ".$pics->css_tag.">::Next::</A>\n"; $str .="<A HREF='javascript:picturepopup(\"".PHOTOSCRIPT."?getimg=".$this rel="nofollow">NextImage->Name."&picpath=".$pics>ImageWebPath."&isslide=1\",\"".SERVERTARGET."\")' style=\"font-family: Verdana,Arial, Helvetica, sans-serif; font-size: x-small; color: #000000\" ".$pics->css_tag.">::Slide::</A>\n"; $str .="<A HREF='javascript:picturepopup(\"".PHOTOSCRIPT."?getimg=".$this rel="nofollow">Image->Name."&picpath=".$pics->ImageWebPath."\",\"".SERVERTARGET."\")', style=\"font-family: Verdana,Arial, Helvetica, sans-serif; font-size: x-small; color: #000000\" ".$pics->css_tag.">::Stop::</A>\n"; $str .="<A HREF=\"Javascript:void()\" onClick=\"self.close()\" ".$pics rel="nofollow">css_tag.">::Close::]</A>\n"; $str .=" \n"; $str .="<IMG SRC=\"".$pics->ImageWebPath."/".$this->Image->Name."\" width=\"".$this->dxx."\">\n"; $str .="</DIV>\n"; $str $str $str $str $str $str $str $str $str $str $str .="<SCRIPT language=\"JAVASCRIPT1.4\">\n"; .=" dx = ".$this->dx.";\n"; .=" dy = ".$this->dy.";\n"; .=" if(self.OuterWidth < dx) {\n"; .=" dy = (int)(dy * self.OuterWidth /dx);\n"; .=" dx = self.innerWidth;\n"; .=" }\n"; .=" if(self.OuterHeight < dy) {\n"; .=" dx = (int)(dx * self.OuterHeight /dy);\n"; .=" dy = self.OuterHeight;\n"; .=" }\n"; 128 $str .=" self.resizeTo(dx, dy)\n"; $str .="</SCRIPT>\n"; $str .="</BODY>\n"; $str .="</HTML>\n"; return $str; } function Show() { print($this->GetString()); } } // ************ Some functions ************ function picturepopup(){ $str = "<SCRIPT LANGUAGE=\"JAVASCRIPT1.2\">\n"; $str .= " function picturepopup(url,target){\n"; $str .= " winpops=window.open(url,target,\"status=0,resizable=1,location=0,menubar=0,scr ollbars=0,toolbar=0\");\n"; $str .= " }\n"; $str .= "</SCRIPT>\n"; return $str; } function CSS_File_search() { $lines = file ($_SERVER["PATH_TRANSLATED"]); $keresendo = "text/css"; $csere = array("<",">","\""); $lnk = " "; $ok = False; while ((list ($kulcs, $ertek) = each ($lines)) && !$ok){ $e = strtolower($ertek); $p = strpos($e,$keresendo); if($p>0) { $ok = True; $p1 = strpos($e,"href"); $e1 = substr($e,$p1+6); $e2 = explode(" ",$e1); $lnk= substr($e2[0],0,-1); } } Return $lnk; } //Searching for the css style after the body tag function CSS_Body_search() { $fname =$_SERVER["PATH_TRANSLATED"]; $handle = fopen ($fname, "r"); $contents = fread ($handle, filesize ($fname)); fclose ($handle); $text = strtolower($contents); $text = str_replace(" ", "", $text); $atags = array(); $atags = explode("<body",$text); if (sizeof($atags) >1 ){ $lnk =""; $p = explode("\"",$atags[1]); $lnk = $p[0]; }else { $lnk ="style=\"background-color: #666666\""; } Return $lnk; } 129 function relpath($dir){ $dir=str_replace("\\","/",$dir); $len = strlen(DOCUMENT_ROOT); return substr($dir,$len-1); } function pathcomp($p){ return (( substr($p,-1)!= "/") ? ($p."/") : ($p) ); } /************* end of functions ***********/ /****************** * The main program ****************/ $newThumbnail =0; //*********************** Calling parameters ************** $isslide = ( isset($_GET["isslide"] ) )? $_GET["isslide"] : (isset($isslide) ? $isslide :False); $getimg = ( isset($_GET["getimg"] ) )? $_GET["getimg"] : (isset($getimg) ? $getimg : ""); //The name of viewing picture //The path of actual pictures if (!isset($aktdir)){ //from calling script first if (isset($_GET["picpath"])){ //From somewhere $aktdir =substr(DOCUMENT_ROOT,0,-1).$_GET["picpath"]; } else { //Slide $aktdir = dirname($_SERVER["PATH_TRANSLATED"])."/"; } } $aktdir=pathcomp($aktdir); $pics = new ImageList($aktdir); //******************* searching for css style settings ***************** if(!isset($pics->css_file)) $pics->css_file = CSS_File_search(); if(!isset($pics->css_link)) $pics->css_body = CSS_Body_Search(); //****************** main things ***************** if( !$getimg){ $pics->Showlist(); }else{ $p = new popup($getimg); $p->show(); } ?> // ************* show one Image ****************** 130 23 A környezet feldolgozása, azonosítás 131 24 Beléptetés, jelszavak alkalmazása, titkosítás Az alábbi forrást használtam fel a következő oldalak leírásához: http://hotwired.lycos.com/webmonkey/00/05/index2a_page2.html?tw=programming Amikor egy könyvtárat vagy html oldalt le akarunk védeni azonosító névvel és jelszóval, akkor először is meg kell szerveznünk a WEB szerver oldali védelmet. Ez a különböző WEB szerverek esetén mindig egy kicsit másképpen megy. Az Apache WEB szerver esetén is több lehetőség kínálkozik, de talán a következő a legegyszerűbb: Tegyük fel, hogy a /wwwroot/ceg nevű könyvtárat szeretnénk levédeni: A védett könyvtárban létre kell hozni a .htaccess nevű file-t. Ennek a tartalma: AuthType Basic AuthName "Vedett terület" AuthUserFile /wwwroot/ceg/.htpasswd AuthGroupFile /dev/null <Limit GET POST PUT> require valid-user </Limit> A szerveren be kell állítani a megfelelő könyvtárra az alábbi sorokat: httpd.conf <Directory "/wwwroot"> ... AllowOverride AuthConfig ... </Directory> //itt a www gyökérkönyvtáráról van szó // a későbbiek során be kell töltve lenniük az alábbi soroknak LoadModule LoadModule LoadModule LoadModule LoadModule LoadModule LoadModule LoadModule LoadModule anon_auth_module modules/mod_auth_anon.so dbm_auth_module modules/mod_auth_dbm.so digest_auth_module modules/mod_auth_digest.so digest_module modules/mod_digest.so expires_module modules/mod_expires.so headers_module modules/mod_headers.so info_module modules/mod_info.so status_module modules/mod_status.so php4_module x:/php/sapi/php4apache.dll #Ez itt a PHP4 miatt kell Az alábbi könyvtárban /apache/bin le kell futtatni az alábbi parancsot: htpasswd /wwwroot/ceg/.htpasswd usernév Ennek hatására létrejön egy text file, amiben a usernév és a hozzá tartozó jelszó található. Ha több usert akarunk azonosíttatni, akkor létre kell hozni egy user groupot és abban a usereket definiálni. Például létrehozzuk a .htgroup nevű file-t, amiben definiáljuk a csoportot: userek: bela geza user1 user2 Lefuttatjuk a jelszógenerálást többször htpasswd htpasswd htpasswd htpasswd /wwwroot/ceg/.htpasswd /wwwroot/ceg/.htpasswd /wwwroot/ceg/.htpasswd /wwwroot/ceg/.htpasswd bela geza user1 user2 Módosítjuk a htaccess file tartalmát: 132 AuthUserFile /wwwroot/ceg/.htpasswd AuthGroupFile /wwwroot/ceg/.htgroup AuthName userek AuthType Basic <Limit GET> require group dorks </Limit> Az adott könyvtár oldalának lekérésekor a szerver elküldi a böngészőnek a 401-es hibakódot, amely utasítja a böngészőt, hogy jelenítse meg az adatok bevitelére alkalmas oldalt párbeszédablakot. Itt beviszi a felhasználó az adatokat, amit a szerver ellenőriz. A fenti módszer használatához nincsen szükség PHP közreműködésére, ugyanakkor nagy számú felhasználó esetén nem túl gyors a módszer, csak a szerveren lehet módosítani a userlistát és a jelszavakat. A beléptetésre több megfelelő módszer kínálkozik a PHP esetén. Ha modulként futtatjuk a PHP-t, akkor viszonylag egyszerűen biztosíthatjuk, hogy egy HTTP bekérést szimulálhassunk, csak az alábbi sorokat kell elküldeni a böngészőnek: header('WWW-Authenticate: Basic realm="Magánterület!"'); header('HTTP/1.0 401 Unauthorized'); echo 'Authorization Required.'; exit; Ennek hatására a $PHP_AUTH_USER és $PHP_AUTH_PWD változók fogják tartalmazni a bevitelnél adott választ. Ekkor sessionok segítségével minden oldalon felhasználhatjuk a változók értékeit. Ha CGI módszerrel futtatjuk a PHP-t, akkor sajnos nem egyszerű a fenti változók használata, ekkor gondoskodni kell arról, hogy minden oldal hívásakor a változó tartalma átadódjon. A továbbiakban bemutatjuk két példán, hogy mi történik akkor, ha egy párbeszédablakban bekértük a két változó értékét. Egy lehetőség, hogy létrehozzunk egy beviteli ablakot egy HTML form segítségével, majd POST metódussal elküldjük az eredményt a következő oldalnak. <Form method=”POST” ACTION=”login.php”> Kérem a usernevet: <INPUT Type=”text” NAME=”PHP_AUTH_USER” SIZE=60> Kérem a jelszót: <INPUT TYPE =”PASSWORD” NAME=”PHP_AUTH_PWD”> <INPUT TYPE=”SUBMIT” NAME=”OK”> <INPUT TYPE=”RESET” NAME=”RESET”> </Form> A login.php oldal leellenőrzi, hogy a megfelelő usernév jelszó páros szerepel-e benne. Az ellenőrzés történhet adatbázisból vagy sima text file-ból is. 133 <?php // Megvizsgáljuk, hogy az előző form-ból kapott adatok között létezik-e //a $PHP_AUTH_USER változó és tartalmaz-e adatokat. if (!isset($PHP_AUTH_USER)) { // Ha nem létezik, a változó, akkor elküldünk egy fejlécet a böngészőnek. header('WWW-Authenticate: Basic realm="Magánterület!"'); header('HTTP/1.0 401 Unauthorized'); exit; } else if (isset($PHP_AUTH_USER)) { // Ha nem üres a változó, akkor megnézzük, hogy az adatbázisban megvan-e // a megfelelő usernév jeszó páros // MySQL kapcsolatot hozunk létre. Az itteni usernév nem azonos a beléptető userrel! mysql_connect("hostname", "username", "password") or die ("Unable to connect to database."); // Megnyitjuk a jelszóadatbázist mysql_select_db("Userlista") or die ("Unable to select database."); // Elküldjük a lekérdezést a users táblára $sql = "SELECT * FROM users WHERE username='$PHP_AUTH_USER' and password='$PHP_AUTH_PW'"; // Végrehajtjuk, majd az eredmény a $result változóba kerül $result = mysql_query($sql); // Ha az eredménynek 0 sora van, akkor nincs ilyen user és jelszó páros, // ha 1, akkor van $num = mysql_numrows($result); if ($num != "0") { echo "Isten hozott!"; exit; } else { header('WWW-Authenticate: Basic realm="Magánterület!"'); header('HTTP/1.0 401 Unauthorized'); echo 'Authorization Required.'; exit; } } ?> Hasonló megoldás, amikor egy text file-t használunk az authentikációhoz: <?php // Megvizsgáljuk, hogy az előző form-ból kapott adatok között létezik-e //a $PHP_AUTH_USER változó és tartalmaz-e adatokat. if (!isset($PHP_AUTH_USER)) { // Ha nem létezik, a változó, akkor elküldünk egy fejlécet a böngészőnek. header('WWW-Authenticate: Basic realm="Magánterület!"'); header('HTTP/1.0 401 Unauthorized'); exit; } else if (isset($PHP_AUTH_USER)) { // Ha nem üres a változó, akkor megnézzük, hogy egy text file-ban megvan-e // a megfelelő usernév jeszó páros. Beolvassuk a file-t a $file_tartalom nevű // változóba $filename = "/wwwroot/ceg/file.txt"; $fp = fopen($filename, "r"); $file_tartalom = fread($fp, filesize($filename)); fclose($fp); 134 // A text file sorait egy $sor nevű tömbbe visszük be. //A sorok végét a \n karakter jelzi. $sor = explode("\n", $file_tartalom); // // // // Végignézzük a $sor tombot, hogy a megfelelő értéket megtaláljuk-e benne A sor minden elemét két részre bontjuk, usernév és jelszó párra. Az elválasztó jel a : A következőben a keresés programozási tételt alkalmazzuk. $i = 0; $adatok = explode(":", $sor[$i]); while($i<=sizeof($sor))&& !(($adatok[0]=="$PHP_AUTH_USER") &&($adatok[1]== "$PHP_AUTH_PW")) { $data_pair = explode(":", $sor[$i]); i++; } if ($i<=sizeof($sor)) $auth = 1; else $auth = 0; if ($auth == "1") { echo "Isten hozott!"; exit; } else { header('WWW-Authenticate: Basic realm="Magánterület!"'); header('HTTP/1.0 401 Unauthorized'); echo 'Authorization Required.'; exit; } ?> A fenti rutinokat kissé módosítva beírhatjuk őket egy include file-ba. Ha minden php oldalon beszúrjuk a file-t, akkor automatikusan az oldal bekérésekor lefut és ellenőrzi a jogosultságot. Mindenesetre ekkor biztosítani kell, hogy átlépve a következő oldalra a $PHP_AUTH_USER és $PHP_AUTH_PWD változók tartalma megmaradjon és elérhető legyen. 135 Egy harmadik és talán elég jól használható megoldás. Alapja, hogy egy scriptet minden védett oldal elejére beszúrunk, ami az oldal hívásakor lefut és SESSION változóban tároljuk a beléptetés eredményét, illetve a beléptetett user-t. $name =""; $pwd =""; Session_start(); if(!isset($_SESSION["logged_in"])) $_SESSION["logged_in"] = False; If (!$_SESSION["logged_in"]){ if( isset($_POST["name"]) && isset($_POST["pwd"])){ //Ha később login formot használunk POST-tal $name = $_POST["name"]; $pwd = $_POST["pwd"]; //Ha a Böngésző authhentikációs ablakát használjuk // if (isset($PHP_AUTH_USER) && isset ($PHP_AUTH_PW)){ // $name = $PHP_AUTH_USER; // $pwd = $PHP_AUTH_PW; // //A jelszó és usernév ellenőrzése adatbázisból mysql_connect("hostname", "username", "password") or die ("Unable to connect to database."); // Megnyitjuk a jelszóadatbázist mysql_select_db("Userlista") or die ("Unable to select database."); // Elküldjük a lekérdezést a users táblára $sql = "SELECT * FROM users WHERE username='$name' and password='$pwd'"; // Végrehajtjuk, majd az eredmény a $result változóba kerül $result = mysql_query($sql); // Ha az eredménynek 0 sora van, akkor nincs ilyen user és jelszó páros, // ha 1, akkor van $num = mysql_numrows($result); if($num>0){ //Ide kell betenni a jelszóellenőrzést $_SESSION["logged_in"] = True; //vagy sima text vagy mysql lekérdezés stb... } } } If (!($_SESSION["logged_in"])){ //Vagy egy login formot használunk, ekkor POST-tal küldjük el a megfelelő értékeket include ("login.html"); // vagy szimuláljuk a WEBböngésző beléptető oldalát. //header('WWW-Authenticate: Basic realm="Beléptetés!"'); //header('HTTP/1.0 401 Unauthorized'); exit; } 24.1 Titkosított átvitele a kliens és a szerver között: MD5() A PHP-ban van egy jól használható függvény, amellyel adatok módosítatlanását tudjuk vizsgálnialapvető titkosítását tudjuk elvégezni, illetve a titkosított adatokat tudjuk visszakódolni plain text-é. Az adatoknak karakter formátumúaknak kell lenni. A függvény az String md5( string) /* * md5.jvs 1.0b 27/06/96 * * Javascript implementation of the RSA Data Security, Inc. MD5 136 * Message-Digest Algorithm. * * Copyright (c) 1996 Henri Torgemane. All Rights Reserved. * * Permission to use, copy, modify, and distribute this software * and its documentation for any purposes and without * fee is hereby granted provided that this copyright notice * appears in all copies. * * Of course, this soft is provided "as is" without express or implied * warranty of any kind. * * $Id: md5.js,v 1.2 1998/11/22 14:27:42 sas Exp $ * */ function array(n) { for(i=0;i<n;i++) this[i]=0; this.length=n; } /* Some basic logical functions had to be rewritten because of a bug in * Javascript.. Just try to compute 0xffffffff >> 4 with it.. * Of course, these functions are slower than the original would be, but * at least, they work! */ function integer(n) { return n%(0xffffffff+1); } function shr(a,b) { a=integer(a); b=integer(b); if (a-0x80000000>=0) { a=a%0x80000000; a>>=b; a+=0x40000000>>(b-1); } else a>>=b; return a; } function shl1(a) { a=a%0x80000000; if (a&0x40000000==0x40000000) { a-=0x40000000; a*=2; a+=0x80000000; } else a*=2; return a; } function shl(a,b) { a=integer(a); b=integer(b); for (var i=0;i<b;i++) a=shl1(a); return a; } function and(a,b) { a=integer(a); b=integer(b); var t1=(a-0x80000000); var t2=(b-0x80000000); if (t1>=0) if (t2>=0) return ((t1&t2)+0x80000000); else return (t1&b); else if (t2>=0) return (a&t2); else 137 return (a&b); } function or(a,b) { a=integer(a); b=integer(b); var t1=(a-0x80000000); var t2=(b-0x80000000); if (t1>=0) if (t2>=0) return ((t1|t2)+0x80000000); else return ((t1|b)+0x80000000); else if (t2>=0) return ((a|t2)+0x80000000); else return (a|b); } function xor(a,b) { a=integer(a); b=integer(b); var t1=(a-0x80000000); var t2=(b-0x80000000); if (t1>=0) if (t2>=0) return (t1^t2); else return ((t1^b)+0x80000000); else if (t2>=0) return ((a^t2)+0x80000000); else return (a^b); } function not(a) { a=integer(a); return (0xffffffff-a); } /* Here begin the real algorithm */ var state = new array(4); var count = new array(2); count[0] = 0; count[1] = 0; var buffer = new array(64); var transformBuffer = new array(16); var digestBits = new array(16); var var var var var var var var var var var var var var var var S11 S12 S13 S14 S21 S22 S23 S24 S31 S32 S33 S34 S41 S42 S43 S44 = = = = = = = = = = = = = = = = 7; 12; 17; 22; 5; 9; 14; 20; 4; 11; 16; 23; 6; 10; 15; 21; function F(x,y,z) { return or(and(x,y),and(not(x),z)); } function G(x,y,z) { return or(and(x,z),and(y,not(z))); 138 } function H(x,y,z) { return xor(xor(x,y),z); } function I(x,y,z) { return xor(y ,or(x , not(z))); } function rotateLeft(a,n) { return or(shl(a, n),(shr(a,(32 - n)))); } function FF(a,b,c,d,x,s,ac) { a = a+F(b, c, d) + x + ac; a = rotateLeft(a, s); a = a+b; return a; } function GG(a,b,c,d,x,s,ac) { a = a+G(b, c, d) +x + ac; a = rotateLeft(a, s); a = a+b; return a; } function HH(a,b,c,d,x,s,ac) { a = a+H(b, c, d) + x + ac; a = rotateLeft(a, s); a = a+b; return a; } function II(a,b,c,d,x,s,ac) { a = a+I(b, c, d) + x + ac; a = rotateLeft(a, s); a = a+b; return a; } function transform(buf,offset) { var a=0, b=0, c=0, d=0; var x = transformBuffer; a b c d = = = = state[0]; state[1]; state[2]; state[3]; for (i = 0; i < 16; i++) { x[i] = and(buf[i*4+offset],0xff); for (j = 1; j < 4; j++) { x[i]+=shl(and(buf[i*4+j+offset] ,0xff), j * 8); } } /* Round a = FF ( d = FF ( c = FF ( b = FF ( a = FF ( d = FF ( c = FF ( b = FF ( a = FF ( d = FF ( c = FF ( b = FF ( a = FF ( d = FF ( c = FF ( b = FF ( 1 */ a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, d, d, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, x[ 0], x[ 1], x[ 2], x[ 3], x[ 4], x[ 5], x[ 6], x[ 7], x[ 8], x[ 9], x[10], x[11], x[12], x[13], x[14], x[15], S11, S12, S13, S14, S11, S12, S13, S14, S11, S12, S13, S14, S11, S12, S13, S14, 0xd76aa478); 0xe8c7b756); 0x242070db); 0xc1bdceee); 0xf57c0faf); 0x4787c62a); 0xa8304613); 0xfd469501); 0x698098d8); 0x8b44f7af); 0xffff5bb1); 0x895cd7be); 0x6b901122); 0xfd987193); 0xa679438e); 0x49b40821); 139 /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* 1 */ 2 */ 3 */ 4 */ 5 */ 6 */ 7 */ 8 */ 9 */ 10 */ 11 */ 12 */ 13 */ 14 */ 15 */ 16 */ /* Round a = GG ( d = GG ( c = GG ( b = GG ( a = GG ( d = GG ( c = GG ( b = GG ( a = GG ( d = GG ( c = GG ( b = GG ( a = GG ( d = GG ( c = GG ( b = GG ( 2 */ a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, d, d, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, x[ 1], x[ 6], x[11], x[ 0], x[ 5], x[10], x[15], x[ 4], x[ 9], x[14], x[ 3], x[ 8], x[13], x[ 2], x[ 7], x[12], S21, S22, S23, S24, S21, S22, S23, S24, S21, S22, S23, S24, S21, S22, S23, S24, 0xf61e2562); 0xc040b340); 0x265e5a51); 0xe9b6c7aa); 0xd62f105d); 0x2441453); 0xd8a1e681); 0xe7d3fbc8); 0x21e1cde6); 0xc33707d6); 0xf4d50d87); 0x455a14ed); 0xa9e3e905); 0xfcefa3f8); 0x676f02d9); 0x8d2a4c8a); /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ /* Round a = HH ( d = HH ( c = HH ( b = HH ( a = HH ( d = HH ( c = HH ( b = HH ( a = HH ( d = HH ( c = HH ( b = HH ( a = HH ( d = HH ( c = HH ( b = HH ( 3 */ a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, d, d, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, x[ 5], x[ 8], x[11], x[14], x[ 1], x[ 4], x[ 7], x[10], x[13], x[ 0], x[ 3], x[ 6], x[ 9], x[12], x[15], x[ 2], S31, S32, S33, S34, S31, S32, S33, S34, S31, S32, S33, S34, S31, S32, S33, S34, 0xfffa3942); 0x8771f681); 0x6d9d6122); 0xfde5380c); 0xa4beea44); 0x4bdecfa9); 0xf6bb4b60); 0xbebfbc70); 0x289b7ec6); 0xeaa127fa); 0xd4ef3085); 0x4881d05); 0xd9d4d039); 0xe6db99e5); 0x1fa27cf8); 0xc4ac5665); /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ /* Round a = II ( d = II ( c = II ( b = II ( a = II ( d = II ( c = II ( b = II ( a = II ( d = II ( c = II ( b = II ( a = II ( d = II ( c = II ( b = II ( 4 */ a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, a, b, d, a, c, d, b, c, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, d, d, c, b, a, d, c, b, a, d, c, b, a, d, c, b, a, x[ 0], x[ 7], x[14], x[ 5], x[12], x[ 3], x[10], x[ 1], x[ 8], x[15], x[ 6], x[13], x[ 4], x[11], x[ 2], x[ 9], S41, S42, S43, S44, S41, S42, S43, S44, S41, S42, S43, S44, S41, S42, S43, S44, 0xf4292244); 0x432aff97); 0xab9423a7); 0xfc93a039); 0x655b59c3); 0x8f0ccc92); 0xffeff47d); 0x85845dd1); 0x6fa87e4f); 0xfe2ce6e0); 0xa3014314); 0x4e0811a1); 0xf7537e82); 0xbd3af235); 0x2ad7d2bb); 0xeb86d391); /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* /* 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ */ state[0] state[1] state[2] state[3] +=a; +=b; +=c; +=d; } function init() { count[0]=count[1] = 0; state[0] = 0x67452301; state[1] = 0xefcdab89; state[2] = 0x98badcfe; state[3] = 0x10325476; for (i = 0; i < digestBits.length; i++) digestBits[i] = 0; } function update(b) { var index,i; 140 index = and(shr(count[0],3) , 0x3f); if (count[0]<0xffffffff-7) count[0] += 8; else { count[1]++; count[0]-=0xffffffff+1; count[0]+=8; } buffer[index] = and(b,0xff); if (index >= 63) { transform(buffer, 0); } } function finish() { var bits = new array(8); var padding; var i=0, index=0, padLen=0; for (i = 0; i < 4; i++) { bits[i] = and(shr(count[0],(i * 8)), 0xff); } for (i = 0; i < 4; i++) { bits[i+4]=and(shr(count[1],(i * 8)), 0xff); } index = and(shr(count[0], 3) ,0x3f); padLen = (index < 56) ? (56 - index) : (120 - index); padding = new array(64); padding[0] = 0x80; for (i=0;i<padLen;i++) update(padding[i]); for (i=0;i<8;i++) update(bits[i]); for (i = 0; i < 4; i++) { for (j = 0; j < 4; j++) { digestBits[i*4+j] = and(shr(state[i], (j * 8)) , 0xff); } } } /* End of the MD5 algorithm */ function hexa(n) { var hexa_h = "0123456789abcdef"; var hexa_c=""; var hexa_m=n; for (hexa_i=0;hexa_i<8;hexa_i++) { hexa_c=hexa_h.charAt(Math.abs(hexa_m)%16)+hexa_c; hexa_m=Math.floor(hexa_m/16); } return hexa_c; } var ascii="01234567890123456789012345678901" + " !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ"+ "[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~"; function MD5(entree) { var l,s,k,ka,kb,kc,kd; init(); for (k=0;k<entree.length;k++) { l=entree.charAt(k); update(ascii.lastIndexOf(l)); } finish(); ka=kb=kc=kd=0; for (i=0;i<4;i++) ka+=shl(digestBits[15-i], (i*8)); for (i=4;i<8;i++) kb+=shl(digestBits[15-i], ((i-4)*8)); for (i=8;i<12;i++) kc+=shl(digestBits[15-i], ((i-8)*8)); for (i=12;i<16;i++) kd+=shl(digestBits[15-i], ((i-12)*8)); s=hexa(kd)+hexa(kc)+hexa(kb)+hexa(ka); 141 return s; } 142 25 Biztonság, tippek és trükkök Egy nyilvános szerveren futó PHP program futtatásának a biztonságossá tétele rendkívül fontos dolog, és két tényezőn, a szerver beállításain és a programozó gondosságán is múlik. Bemenő adatok ellenőrzése és szűrése A bemenő adatokat két oldalon lehet vagy kell ellenőrizni. - A user oldalon a formok adatbevitelének felprogramozásával - A szerver oldalon a már elküldött adatok érvényességének vizsgálatával Az első változat arra való csakis és kizárólag, hogy a felhasználó user hibáit kiküszöböljk illetve minimalizáljuk. Az adatbevitel általában egy ormon keresztül zajlik, tehát a formon való adatbevitelt célszeű ellenőrizni. Erre a célra általában Javascript kódot használhatunk, amely például akkor fut le, - ha a Form submit gombját megnyomjuk – ekkor a Form onSubmit eseményére indulhat el a Javascript kód, - vagy minden egyes mező értékének változásakor lefuttatunk egy ellenőrző rutint – ekkor a mező onChange eseményére indulhat a javascript kód. Mely mezőket kell ellenőrizni? Gondos programozással csak néhányat. A HTML Formoknál az alábbi beviteli mezők vannak: - Input mező Text – ellenőrizni kell TEXTarea – ellenőrizni kell Checkbox – ellenőrizni lehet RadioButton – célszerű ellenőrizni Select menü – a kiválasztottságot célszerű ellenőrizni File mező – Igazából a file létezését ellene ellenőrizni, de nem illik. Csak annyit leet, hogy a file mezőben van-e valamiféle bejegyzés. A fentiek alapján llátszik, hogy egyszerű esetben csak a text és a textarea ellenőrzése igazán fontos. Ott ellenőrizhetjük a string hosszát, azt hogy bizonyos karakterek benne vannak-e vagy nincsenek. Mevizsgálhatjuk, hogy a bevitt adat numerikus-e, és ha igen, akkor milyen tartományba esik. A szerver oldalon már ellenőrzött adatot kapunk, miért kell a szerver oldalon ismételten ellenőrizni? A a kliens oldali ellenőrzés sokkal gyorsabb, továbbá a userek sanda szándékait a szerver oldalon lehet csak elkapni. Itt is minden fenti dolgot ellenrizhetünk, azaz: - Egy változó értékét - Egy változó formáját (milyen hosszú, milyen karakterek vannak bene vagy hiányoznak). Itt kell kiszűrni az esetlegesen bevitt HTML tag-eket, a ” és a ’ jeleket, az esetlegesen bevitt SQL utasításneveket (SQL injection). - Az adat numerikus-e, és ha igen, akkor megfelelő-e az értéke. - Ez azt jelenti, hogy itt már a változók létét, a formátumát, és értékét kell csak ellenőrizni. Itt kell felkészülni esetleges sanda szándékú userek datbevitelére is. File-k elérésének a kezelése 143 A PHP.INI megfelelő (biztonságos) beállítása Biztonságos kapcsolatok, kapcsolati módok használata 144 26 A PHP.INI file paraméterezése A PHP.INI file általában a PHP beállítáasait tartalmazó file. Itt nem sorolhajuk fel az összes lehetséges paraméterét, de néhány általunk fontosabbnak tartott paramétert igen. Megjegyzendő, hogy a paramétereket a set_ini(változónév, érték) függvénnyel állíthatjuk be futás közben programból, és a pillanatnyi értékeket a get_ini(változónév) függvénnyel lehet lekérni. Az ini_restore(változónév) a korábbi értékeket állítja vissza, az ini_alter(változónév, érték) pedig a változó korábbi értékével tér vissza, ha a módosítás sikeres volt, ha nem , akkor False értéket ad vissza. Változónév Default érték Hol módosítható define_syslog_variables "0" PHP_INI_ALL highlight.bg HL_BG_COLOR PHP_INI_ALL highlight.comment HL_COMMENT_COLOR PHP_INI_ALL highlight.default HL_DEFAULT_COLOR PHP_INI_ALL highlight.html HL_HTML_COLOR PHP_INI_ALL highlight.keyword HL_KEYWORD_COLOR PHP_INI_ALL highlight.string HL_STRING_COLOR PHP_INI_ALL allow_call_time_pass_reference "1" PHP_INI_SYSTEM|PHP_INI_PERDIR asp_tags "0" PHP_INI_SYSTEM|PHP_INI_PERDIR display_errors "1" PHP_INI_ALL display_startup_errors "0" PHP_INI_ALL enable_dl "1" PHP_INI_SYSTEM error_append_string NULL PHP_INI_ALL error_prepend_string NULL PHP_INI_ALL expose_php "1" PHP_INI_SYSTEM html_errors "1" PHP_INI_SYSTEM ignore_user_abort "0" PHP_INI_ALL implicit_flush "0" PHP_INI_PERDIR|PHP_INI_SYSTEM log_errors "0" PHP_INI_ALL magic_quotes_gpc "1" PHP_INI_ALL magic_quotes_runtime "0" PHP_INI_ALL magic_quotes_sybase "0" PHP_INI_ALL output_buffering "0" PHP_INI_PERDIR|PHP_INI_SYSTEM 145 Változónév Default érték Hol módosítható output_handler NULL PHP_INI_PERDIR|PHP_INI_SYSTEM register_argc_argv "1" PHP_INI_ALL register_globals "1" PHP_INI_PERDIR|PHP_INI_SYSTEM safe_mode "0" PHP_INI_SYSTEM short_open_tag "1" PHP_INI_SYSTEM|PHP_INI_PERDIR sql.safe_mode "0" PHP_INI_SYSTEM track_errors "0" PHP_INI_ALL y2k_compliance "0" PHP_INI_ALL arg_separator "&" PHP_INI_ALL auto_append_file NULL PHP_INI_ALL auto_prepend_file NULL PHP_INI_ALL doc_root NULL PHP_INI_SYSTEM default_charset SAPI_DEFAULT_CHARSET PHP_INI_ALL default_mimetype SAPI_DEFAULT_MIMETYPE PHP_INI_ALL error_log NULL PHP_INI_ALL extension_dir PHP_EXTENSION_DIR PHP_INI_SYSTEM gpc_order "GPC" PHP_INI_ALL include_path PHP_INCLUDE_PATH PHP_INI_ALL max_execution_time "30" PHP_INI_ALL open_basedir NULL PHP_INI_SYSTEM safe_mode_exec_dir "1" PHP_INI_SYSTEM upload_max_filesize "2M" PHP_INI_ALL file_uploads "1" PHP_INI_ALL post_max_size "8M" PHP_INI_SYSTEM upload_tmp_dir NULL PHP_INI_SYSTEM user_dir NULL PHP_INI_SYSTEM variables_order NULL PHP_INI_ALL SMTP "localhost" PHP_INI_ALL browscap NULL PHP_INI_SYSTEM 146 Változónév Default érték Hol módosítható error_reporting NULL PHP_INI_ALL memory_limit "8M" PHP_INI_ALL precision "14" PHP_INI_ALL sendmail_from NULL PHP_INI_ALL sendmail_path DEFAULT_SENDMAIL_PATH PHP_INI_SYSTEM disable_functions "" PHP_INI_SYSTEM allow_url_fopen "1" PHP_INI_ALL 147 Sablonok – Template-ek, LIB-ek Template vagy más előregyártott library-t akkor használunk, ha 1. Gyorsítani akarjuk a PHP alkalmazás futtatását 2. Gyorsítani akarjuk a programfejlesztést 3. El akarjuk választani a fejlesztés design és a logikai részét 4. Nem akarjuk feltalálni a spanyolviaszt, azaz a más által jól megírt kódot használni akarjuk. 26.1 Template-ek, Smarty A template rendszerek olyan PHP-ban vagy egyéb módon kifejlesztett alkalmazások, amelyek segítségével el tudjuk választani egymástól az üzleti logika és a design elemeket. Ezek a gyakorlatban azt jelentik, hogy a design elemek egy HTML-hez hasonló kódolási rendszerben jönnek létre, z adatbázis, és egyéb prorgramozási részek a kifejleszett PHP kód alapján, és a futás közben amTemplate rendszer összeszerkeszti a design template-eket és a PHPkódot, majd az így létrejött kódot futtatja. Felvetődik a kérdés, hogy mennyire lassítja le az alkalmazást az így kifejlesztett kód? A tapasztalatok azt mutatják, hogy egyes template rendszerek használata esetén a kód futási sebessége nő, mivel nem a PHP-nak kell előállítania a teljes HTML tartalmat, hanem azt HTML kódban tartjuk. A PHP programozónak és a Designernek könnyű elválasztania a munkáját, hiszen a programozó és a designer egy jól definiált felhasználói interface-en keresztül kapcsolódik egymáshoz. A programnak az a feladata, hogy az általa előállított PHP kód eredményét helyezze el egy tipikusan string típusú változóba, amit aztán a sablon feldolgozó modulja beszerkeszt a Sablon tartalmába és elküldi a WEB szerveren keresztül a kliensnek. Tekintettel arra, hogy a Web oldalak jelentős része még akkor is statikusnak tekinthető, ha PHP-val állítkjuk elő, egyes sablon rendszerek arra is képeske, hogy az összeszerkesztett oldalakat cache-eljék, azaz az összeszerkesztett oldallal szolgáljanak ki bizonyos kéréseket. Az alábbiakban a Smarty nevű népszerű alkalmazáscsomaggal ismerkedünk meg egy kicsit. A telepítése során a smarty.inc.php oldalt kell beszerkesztenünk az oldalaink elejére, ami egyúttal inicializálja a rendszert. A példában egy program leőállítja a kódot, a kimenete egy stringbe kerül, majd a smarty rendszer a tartalmat egy változóban helyezi el. Azután a template változó tartalmával együtt a smarty megjeleníti az eredényt. 26.2 PEAR Csomag 148 27 PHP Cache programok Zend Cache Turck- MMCache 149 </div> </div> </div> </div> </div> </div> </div> </div> <div class="modal fade" id="report" tabindex="-1" role="dialog" aria-hidden="true"> <div class="modal-dialog"> <div class="modal-content"> <form role="form" method="post" action="https://adoc.pub/report/tanuljunk-php-l-fejlesztes-alatt-fabian-zoltan-v08" style="border: none;"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title">Report "Tanuljunk PHP-ül (Fejlesztés alatt) Fábián Zoltán v0.8"</h4> </div> <div class="modal-body"> <div class="form-group"> <label>Your name</label> <input type="text" name="name" required="required" class="form-control" /> </div> <div class="form-group"> <label>Email</label> <input type="email" name="email" required="required" class="form-control" /> </div> <div class="form-group"> <label>Reason</label> <select name="reason" required="required" class="form-control"> <option value="">-Select Reason-</option> <option value="pornographic" selected="selected">Pornographic</option> <option value="defamatory">Defamatory</option> <option value="illegal">Illegal/Unlawful</option> <option value="spam">Spam</option> <option value="others">Other Terms Of Service Violation</option> <option value="copyright">File a copyright complaint</option> </select> </div> <div class="form-group"> <label>Description</label> <textarea name="description" required="required" rows="3" class="form-control" style="border: 1px solid #cccccc;">

Név:	print(””); print(”
Jelszó:	”); print(”
	”); print(””); print(”

”); print($meznev[$i]); //A mező neve print(”	”); print(””); print($sor[$meznev]); print(”
”); print(””); print(””); print(”	”); print(”

Tanuljunk PHP-ül (Fejlesztés alatt) Fábián Zoltán v0.8

Recommend Documents

Preinkrementálás

Postdekrementálás

Predekrementálás