Index: phpdoc/hu/functions/mysql.xml diff -u phpdoc/hu/functions/mysql.xml:1.6 phpdoc/hu/functions/mysql.xml:1.7 --- phpdoc/hu/functions/mysql.xml:1.6 Wed Dec 12 15:51:15 2001 +++ phpdoc/hu/functions/mysql.xml Tue Jan 15 06:19:46 2002 @@ -1,5 +1,5 @@ - + MySQL függvények @@ -7,13 +7,13 @@ E függvények segítségével érheted el a MySQL adatbázisokat. Ahhoz, hogy - ezeket a függvényeket használhasd, a php-t a + ezeket a függvényeket használhasd, a php-t a opcióval kell lefordítanod. Ha nem adod meg az opció után a mysql elérési útvonalát, akkor a php a beépített mysql kliens könyvtárat fogja használni. Ha a felhasználók más alkalmazásokat is használnak, amelyek mysql-t használnak (például a php 3-as és 4-es verzióját, vagy az auth-mysql-t), akkor mindig meg kell adni - a mysql elérési útvonalát a + a mysql elérési útvonalát a formában. Ez ki fogja kényszeríteni, hogy a meglévő mysql kliens könyvtárat használja a php, elkerülve az ebből adódó ütközéseket. @@ -26,12 +26,49 @@ A MySQL dokumentációját pedig a &url.mysql.docs;. + + Az alábbi kis példa bemutatja, hogyan lehet MySQL adatbázisokhoz + csatlakozni, kérést végrehajtani, kiíratni az eredményt és megszüntetni a + kapcsolatot. + + MySQL modul áttekintő példa + +\n"; +while ($line = mysql_fetch_array($eredmeny, MYSQL_ASSOC)) { + print "\t\n"; + foreach ($sor as $egy_oszlop) { + print "\t\t$egy_oszlop\n"; + } + print "\t\n"; +} +print "\n"; +// Kapcsolat lezárása +mysql_close($kapcsolat); +?> +]]> + + + - mysql_affected_rows + mysql_affected_rows Az előző MySQL műveletben érintett sorok számát adja meg @@ -40,23 +77,24 @@ int mysql_affected_rows - int + resource link_identifier - + A mysql_affected_rows függvény az előző - link_identifier-rel azonosított kapcsolatban kiadott INSERT, - UPDATE vagy DELETE kérésben érintett sorok számát adja vissza. - Ha nem adsz meg kapcsolat-azonosítót, akkor az utoljára megnyitott - kapcsolatról kapsz információt. + link_identifier-rel azonosított kapcsolatban + kiadott INSERT, UPDATE vagy DELETE kérésben érintett sorok számát adja + vissza. Ha nem adsz meg kapcsolat-azonosítót, akkor az utolsó + mysql_connect-tel megnyitott kapcsolatról kapsz + információt. - Ha transzakciókezelést hasznnálsz, akkor a + Ha transzakciókezelést használsz, akkor a mysql_affected_rows függvényt az INSERT, UPDATE, vagy DELETE kérés után közvetlenül, nem a kommit után kell meghívni. @@ -65,21 +103,33 @@ Ha az utolsó lekérdezés egy WHERE feltétel nélküli DELETE volt, akkor bár a táblából minden sor törlődik, a függvény nullát fog visszaadni. + + + Ha UPDATE-tel használod, a MySQL nem fogja azokat a sorokat frissíteni, + ahol a sor régi és új értéke megegyezik. Így nem kizárt, hogy a + mysql_affected_rows függvény nem pont az egyező + sorok számát adja vissza, hanem csak a ténylegesen megváltoztatott sorok + számát. + + - Ez a parancs nem hatékony a lekérdező SELECT kéréssel együtt használva, - csak azokkal a lekérdezésekkel, melyek módosítják a táblázat sorait. + A függvény nem működik a lekérdező SELECT kéréssel együtt használva, + csak azokkal a lekérdezésekkel, melyek rekordokat módosítanak. Ha egy SELECT lekérdezésben kapott sorok számát szeretnéd megkapni, akkor használd a mysql_num_rows függvényt. - Ha az utolsó kérés meghiusul, akkor a függvény -1-gyel tér vissza. + Ha az utolsó kérés meghiusult, akkor a függvény -1-gyel tér vissza. + + + Lásd még amysql_num_rows függvényt! - mysql_change_user + mysql_change_user Aktív kapcsolat felhasználójának módosítása @@ -91,27 +141,33 @@ int mysql_change_user string user string password - string + string database - int + resource link_identifier - + A mysql_change_user függvény megváltoztatja az - aktuális, vagy az opcionális paraméterben megadott azonosítójú kapcsolat - felhasználóját. Ha egy adatbázis nevét megadod, akkor ez lesz az - alapértelmezett adatbázis. Ha az új név-jelszó páros helytelen, akkor a - függvényhívás előtti kapcsolat él tovább. - A függvény a PHP 3.0.13 változatával került a nyelvbe és - MySQL 3.23.3, vagy későbbi változata szükséges a használatához. - + aktuális, vagy az opcionális link_identifier + paraméterben megadott azonosítójú kapcsolat felhasználóját. Ha egy + adatbázis nevét megadod, akkor ez lesz az alapértelmezett, illetve az + aktuális adatbázis, miután a mysql felhasználó megváltozott. Ha + az új név-jelszó páros helytelen, akkor a függvényhívás előtti kapcsolat + él tovább. + + + + A függvény a PHP 3.0.13 változatával került a nyelvbe és MySQL 3.23.3, + vagy későbbi változata szükséges a használatához. + + @@ -124,16 +180,16 @@ Leírás - int mysql_close - int + bool mysql_close + resource - link_identifier + link_identifier - A függvény értéke igaz, ha a művelet sikerült, hamis, ha nem. + &return.success; A mysql_close függvény bezárja az adott azonosítójú MySQL kapcsolatot. Ha nem adsz meg @@ -143,26 +199,31 @@ A mysql_close függvény használata általában szükségtelen, mert a nem perzisztens kapcsolatok a szkript végén - bezáródnak. + bezáródnak. Lásd még: + erőforrások + felszabadítása - + A mysql_close függvény nem zárja be a - mysql_pconnect függvénnyel megnyitott kapcsolatokat. + mysql_pconnect függvénnyel megnyitott + kapcsolatokat. MySQL close példa -<?php + +]]> - + Lásd még a mysql_connect és a mysql_pconnect függvényeket! @@ -178,44 +239,41 @@ Leírás - int mysql_connect - string + resource mysql_connect + string - hostname - :port - :/path/to/socket - + server - string + string username - string + string password - - Pozitív MySQL azonosítóval tér vissza, ha a csatlakozás sikerült. Hiba - esetén pedig hibaüzenetet ír a kimenetre és 0-val tér vissza. + + Pozitív MySQL azonosítóval tér vissza, ha a csatlakozás sikerült, + &false;-sal ha nem. A mysql_connect függvény kapcsolatot nyit meg egy MySQL szerverhez. A paramétereket elhagyhatod. Az alapértelmezett - értékek: host:port = 'localhost:3306', + értékek: server = 'localhost:3306', username = a folyamat tulajdonosának belépési neve password = üres karakterlánc. - A hostname paraméter tartalmazhat egy portszámot is, például: - "hostname:port" vagy tartalmazhatja a MySQL socket elérési - útvonalát, például: ":/path/to/socket". Az utóbbi hostname - paramétert használva is a helyi MySQL szerverhez próbál majd kapcsolódni - a függvény. + A server paraméter tartalmazhat egy portszámot is, + például: "hostname:port" vagy tartalmazhatja a MySQL socket + elérési útvonalát, például: ":/path/to/socket". Az utóbbi + hostname paramétert használva is a helyi MySQL szerverhez próbál majd + kapcsolódni a függvény. A ":port" formátumú kiegészítés a PHP 3.0B4-es változatában @@ -239,20 +297,22 @@ A kapcsolat a PHP program végén bezárul, ha előbb nem zártuk volna le a mysql_close függvénnyel. - + MySQL connect példa -<?php - $link = mysql_connect ("kraemer", "marliesle", "titok") + +]]> Lásd még a - mysql_pconnect és + mysql_pconnect és a mysql_close függvényeket. @@ -267,23 +327,27 @@ Leírás - int mysql_create_db + bool mysql_create_db string database name - int + resource link_identifier - + A mysql_create_db függvény megkísérel létrehozni egy új adatbázist a megadott kapcsolatazonosítón keresztül. + + &return.success; + MySQL 'create database' példa -<?php + +]]> - + Kompatíbilitási okokból a mysql_createdb függvény is - használható. + használható, de nem javasolt. - + Lásd még a: mysql_drop_db függvényt. @@ -313,30 +378,30 @@ Leírás - int mysql_data_seek - int result_identifier + bool mysql_data_seek + resource result_identifier int row_number - - Igazzal tér vissza, ha a művelet sikerült + + &return.success; - + A mysql_data_seek függvény az adott azonosítójú - ereményhalmazban ugrik a megadott pozícióra. - A mysql_fetch_row függvény következő hívásakor ezt a + ereményhalmazban ugrik a megadott pozícióra. A + mysql_fetch_row függvény következő hívásakor ezt a sorszámú sort kapod meg. Ha az első sorra akarsz pozicionálni, akkor Row_number 0 legyen! - MySQL data seek példa -<?php - $link = mysql_pconnect ("kron", "jutta", "geheim") +vezeteknev $sor->keresztnev
\n"); } mysql_free_result ($eredmeny); -?> +?> +]]>
@@ -376,34 +442,31 @@ Leírás - int mysql_db_name - int result + string mysql_db_name + resource result int row - mixed + mixed field - + A mysql_db_name függvény első paramétere egy mysql_list_dbs által visszaadott érték. A row paraméter az eredményhalmaz indexe. - - Ha hiba történt, a függvény FALSE-szal tér vissza. - Használd a - mysql_errno és a - mysql_error függvényeket a hiba eredetének - megállapítására! + Ha hiba történt, a függvény &false;-sal tér vissza. Használd a + mysql_errno és a mysql_error + függvényeket a hiba eredetének megállapítására! - <function>Mysql_db_name</function> példa -<?php + +]]> - Kompatíbilitási okokból a mysql_dbname függvény is használható, de használata nem javasolt. - @@ -436,33 +498,40 @@ Leírás - int mysql_db_query + resource mysql_db_query string database string query - int + resource link_identifier - + Visszatérési értéke egy pozitív MySQL eredmény-azonosító, ha a kérés - sikeres volt, hamissal, ha a kérés hibás volt. + sikeres volt; &false;, ha a kérés hibás volt. - + A mysql_db_query függvény kiválaszt egy adatbázist, majd azon végrehajt egy kérést. Ha a kapcsolat azonosító nincs megadva, akkor a függvény keres egyet. Ha nem talál ilyet, akkor megpróbál létrehozni egyet oly módon, mintha meghívta volna a mysql_connect függvényt paraméterek nélkül. - - Lásd még a mysql_connect függvényt. + + Lásd még a mysql_connect és a + mysql_query függvényeket. - Kompatíbilitási okokból a mysql függvény is - használható. + + + A függvény használata a PHP 4.0.6-os változata óta nem javasolt, ezért + NE használd ezt a függvényt. Inkább használd a + mysql_select_db és a + mysql_query függvényeket. + + @@ -476,41 +545,45 @@ Leírás - int mysql_drop_db + bool mysql_drop_db string database_name - int + resource link_identifier - - Visszatérési értéke: igaz, ha sikeres, hamis, ha nem - - + + &return.success; + + A mysql_drop_db függvény megpróbálja az egész adatbázist kitörölni, melyet az adott kapcsolat-azonosító határoz meg. - - Lásd még a mysql_create_db függvényt. + Kompatíbilitási okokból mysql_dropdb néven is - hívható a függvény. [és hallgat is a nevére] + hívható a függvény, de használata nem javasolt. + + + Lásd még a mysql_create_db függvényt! - mysql_errno - Az előző MySQL művelet hibakódját tartalmazza + mysql_errno + + Az előző MySQL művelet hibakódját tartalmazza + Leírás int mysql_errno - int + resource link_identifier @@ -522,30 +595,32 @@ sikeres volt, akkor 0-t (nullát) ad vissza. - A MySQL hibái már nem jelennek meg figyelmeztetésként. [orig.: - Errors coming back from the mySQL database backend no longer + A MySQL hibái már nem jelennek meg figyelmeztetésként. + [orig.: Errors coming back from the mySQL database backend no longer issue warnings.] Ha szeretnéd megkapni a hiba kódját, használd a - mysql_errno függvényt! - Ez a függvény csak az utolsó MySQL művelet hibakódját adja vissza + mysql_errno függvényt! Ez a függvény csak az utolsó + MySQL művelet hibakódját adja vissza [(not including mysql_error and mysql_errno)], ha használni szeretnéd, ügyelj rá, hogy még azelőtt hívd meg a függvényt, mielőtt egy másik MySQL függvényt meghívsz. -<?php +"; +echo mysql_errno().": ".mysql_error()."
"; mysql_select_db("nonexistentdb"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."
"; $conn = mysql_query("SELECT * FROM nonexistenttable"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."
"; +?> +]]>
- + Lásd még a mysql_error függvényt @@ -554,14 +629,16 @@ mysql_error - Az előző MySQL művelet hibaszövegét adja + + Az előző MySQL művelet hibaszövegét adja + Leírás string mysql_error - int + resource link_identifier @@ -573,38 +650,71 @@ '' (üres karakterlánccal) ha nem volt hiba. - A MySQL hibái már nem jelennek meg figyelmeztetésként. [orig.: + A MySQL hibái már nem jelennek meg figyelmeztetésként. [orig.: Errors coming back from the mySQL database backend no longer issue warnings.] Ha szeretnéd megkapni a hiba kódját, használd a mysql_error függvényt! Ez a függvény csak az utolsó MySQL művelet hibakódját adja vissza [(not including mysql_error and - mysql_errno)], ha használni szeretnéd, ügyelj rá, + mysql_errno)], + ha használni szeretnéd, ügyelj rá, hogy még azelőtt hívd meg a függvényt, mielőtt egy másik MySQL függvényt meghívsz. -<?php -mysql_connect("marliesle"); -echo mysql_errno().": ".mysql_error()."<BR>"; -mysql_select_db("nonexistentdb"); -echo mysql_errno().": ".mysql_error()."<BR>"; -$conn = mysql_query("SELECT * FROM nonexistenttable"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +"; +mysql_select_db("nemletezoadatbazis"); +echo mysql_errno().": ".mysql_error()."
"; +$conn = mysql_query("SELECT * FROM nemletezotabla"); +echo mysql_errno().": ".mysql_error()."
"; +?> +]]>
- + Lásd még a mysql_errno függvényt! + + + mysql_escape_string + + Egy karakerláncban szereplő speciális karakterek értelmezését szünteti + meg. + + + + Leírás + + + string mysql_escape_string + string unescaped_string + + + + A függvény az unescaped_string karakterláncot + átalakítja úgy, hogy az biztonságosan elhelyezhető legyen egy + mysql_query függvényben. + + + + A mysql_escape_string függvény nem nyúl a + % és a _ jelekhez. + + + + + - mysql_fetch_array + mysql_fetch_array Kérés egy sorát adja vissza (tetszőleges) tömb formájában. @@ -614,7 +724,7 @@ array mysql_fetch_array - int result + resource result int result_type @@ -622,8 +732,8 @@ - - Az eredmény következő sorával tér vissza tömb formájában, vagy hamissal, + + Az eredmény következő sorával tér vissza tömb formájában, vagy &false;-sal, ha már nincs több sor. A mysql_fetch_array függvény a @@ -635,43 +745,58 @@ Ha az eredmény több sorának ugyanaz a neve, akkor a később szereplő oszlop marad meg. Ha szeretnéd az összes mezőt elérni ilyenkor is, akkor számmal indexeld a tömböt, vagy az SQL parancsban kérj aliast az - oszlopra. + oszlopra. Az alias-olt [ez mi magyarul?] oszlopok tartalmát nem tudod az + oszlopok eredeti nevével elérni (pl. itt a 'field' + használatával). - -select t1.f1 as ize t2.f1 as bigyo from t1, t2 + + Jó tudni, hogy a mysql_fetch_array függvény - használata NEM jelentősen lassabb a mysql_fetch_row - használatánál, de a kapott eredmény feldolgozása jóval kényelmesebb. + használata nem jelentősen lassabb a + mysql_fetch_row használatánál, de a kapott eredmény + feldolgozása jóval kényelmesebb. A mysql_fetch_array függvény elhagyható result_type paramétere a következő lehet: - MYSQL_ASSOC, MYSQL_NUM, vagy MYSQL_BOTH. - (Ez a lehetőség a PHP 3.0.7-es változatában került a nyelvbe.) + MYSQL_ASSOC, MYSQL_NUM, vagy MYSQL_BOTH. Ez a lehetőség a PHP 3.0.7-es + változatában került a nyelvbe. A paraméter alapértelmezett értéke a + MYSQL_BOTH. - További részletekért olvasd még a - mysql_fetch_row és a - mysql_fetch_assoc függvényeket! + A MYSQL_BOTH használatával egy olyan tömböt kapsz, amelyben az elemek + számmal és karakterlánccal is indexelve vannak. MYSQL_ASSOC értékkel + használva csak asszociatív tömböt kapsz (mint a + mysql_fetch_assoc függvénnyel), MYSQL_NUM értékkel + meghívva a fügvényt számozott indexű tömböt kapsz (mint a + mysql_fetch_row függvénnyel). + + + További részletekért olvasd még a mysql_fetch_row és + a mysql_fetch_assoc függvényeket! - <function>Mysql_fetch_array</function> + <function>Mysql_fetch_array</function> példa -<?php +\n"; + echo "felhasznalonev: ".$sor[0]."
\n"; + echo "nev: ".$sor["nev"]."
\n"; + echo "nev: ".$sor[1]."
\n"; } mysql_free_result ($eredmeny); -?> +?> +]]>
@@ -679,7 +804,7 @@ - mysql_fetch_assoc + mysql_fetch_assoc Az eredmény egy sorát asszociatív tömbként adja vissza. @@ -689,27 +814,30 @@ array mysql_fetch_assoc - int result + resource result - + Az eredmény következő sorával, mint asszociatív tömbbel tér vissza, vagy - hamissal, ha nincs több sor. + &false;-sal, ha nincs több sor. + A mysql_fetch_assoc függvény hívásával ugyanazt érjük el, mintha a mysql_fetch_array függvényt hívtuk volna meg MYSQL_ASSOC második paraméterrel. Ez a függvény egy - tisztán asszociatív tömböt ad vissza. Eredetileg a + tisztán asszociatív tömböt ad vissza. Eredetileg a mysql_fetch_array függvény így működött. Ha a számokkal indexelt elemekre is szükséged van, akkor használd a mysql_fetch_array függvényt. - Ha az eredmény több sorának ugyanaz a neve, akkor a később szereplő - oszlop marad meg. Ha szeretnéd az összes mezőt elérni ilyenkor is, akkor - az SQL parancsban kérj aliast az oszlopra, vagy használd a - mysql_fetch_array függvényt úgy, hogy a számmal - indexelt elemeket is kéred. + Ha az eredmény több oszlopának ugyanaz a neve, akkor a később szereplő + oszlop marad meg. Ha szeretnéd az összes mezőt elérni, akkor vagy + számokkal indexszel érd el az eredményt a + mysql_fetch_array függvény használatával, vagy az + SQL parancsban kérj aliast az oszlopra. Lásd még a + mysql_fetch_array függvénynél szereplő példát az + aliasok leírásáért. Jó tudni, hogy a mysql_fetch_assoc függvény @@ -717,22 +845,23 @@ használatánál, de a kapott eredmény feldolgozása jóval kényelmesebb. - További részletekért lásd még a - mysql_fetch_row és a + További részletekért lásd még a mysql_fetch_row és a mysql_fetch_array függvényeket. - <function>Mysql_fetch_assoc</function> + <function>mysql_fetch_assoc</function> -<?php + +]]> @@ -750,8 +879,8 @@ object mysql_fetch_field - int result - int + resource result + int field_offset @@ -760,113 +889,115 @@ Egy mezőinformációt tartalmazó objektummal tér vissza. - +
A mysql_fetch_field függvényt arra használhatod, hogy az eredmény egy oszlopáról információt kaphass. Ha a mező sorszámát nem adod meg, akkor a következő olyan oszlopról kapsz információt, - amelyre még nem hívtad meg a - mysql_fetch_field függvényt. + amelyre még nem hívtad meg a mysql_fetch_field + függvényt. Az objektum tulajdonságai: - name - az oszlop neve + name - az oszlop neve - table - a tábla neve, amelyhez az oszlop tartozik + table - a tábla neve, amelyhez az oszlop tartozik - max_length - az oszlop maximális hossza + max_length - az oszlop maximális hossza - not_null - értéke 1, ha az oszlop nem veheti fel a NULL értéket + not_null - értéke 1, ha az oszlop nem veheti fel a &null; értéket - + - primary_key - értéke 1, ha az oszlop elsődleges kulcs + primary_key - értéke 1, ha az oszlop elsődleges kulcs - + - unique_key - értéke 1, ha az oszlop egyszerű kulcs + unique_key - értéke 1, ha az oszlop egyszerű kulcs - + - multiple_key - értéke 1, ha az oszlop összetett kulcs része + multiple_key - értéke 1, ha az oszlop összetett kulcs része - + - numeric - értéke 1, ha az oszlop szám + numeric - értéke 1, ha az oszlop szám - + - blob - értéke 1, ha az oszlop BLOB típusú + blob - értéke 1, ha az oszlop BLOB típusú - type - az oszlop típusa + type - az oszlop típusa - unsigned - értéke 1, ha az oszlop nem előjeles + unsigned - értéke 1, ha az oszlop nem előjeles - zerofill - értéke 1, ha az oszlop nullával feltöltött + zerofill - értéke 1, ha az oszlop nullával feltöltött - <function>Mysql_fetch_field</function> + <function>mysql_fetch_field</function> -<?php +\n"; $meta = mysql_fetch_field ($eredmeny); if (!$meta) { - echo "Nem tudok információt lekérni<BR>gt;\n"; + echo "Nem tudok információt lekérni
gt;\n"; } - echo "<PRE> -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 -</PRE>"; + 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
+
"; $i++; } mysql_free_result ($eredmeny); -?> +?> +]]> @@ -877,7 +1008,7 @@ - mysql_fetch_lengths + mysql_fetch_lengths Az eredmény oszlopainak hosszáról nyújt információt @@ -887,22 +1018,23 @@ array mysql_fetch_lengths - int result + resource result - + Egy tömbbel tér vissza. A tömb elemei az utolsó mysql_fetch_row függvény által betöltött oszlopok - hosszait tartalmazza, vagy hiba esetén hamisat. - + hosszait tartalmazza. Hiba esetén &false; értékkel tér vissza. + A mysql_fetch_lengths függvény a mysql_fetch_row, mysql_fetch_array vagy a - mysql_fetch_object által betöltött sor hosszait adja - vissza számmal indexelt tömb formájában. - - + mysql_fetch_object által visszaadott + eredmény-oszlopok hosszát tárolja, illetve megmondja + számmal indexelt tömb formájában. + + Lásd még a mysql_fetch_row függvényt! @@ -911,15 +1043,16 @@ mysql_fetch_object - Az eredmény következő sorát objektum formájában adja - vissza + + Az eredmény következő sorát objektum formájában adja vissza + Leírás object mysql_fetch_object - int result + resource result int result_type @@ -927,21 +1060,23 @@ - + Egy objektummal tér vissza, amelynek tulajdonságai a betöltött sor - oszlopait tartalmazzák. Ha nincs több sor, a függvény hamisat ad + oszlopait tartalmazzák. Ha nincs több sor, a függvény &false;-at ad eredményül. - + A mysql_fetch_object függvény hasonló a mysql_fetch_array függvényhez, egy különbséggel: nem tömböt, hanem objektumot ad vissza a függvény. Ez azt jelenti, hogy a - mezőket csak a nevük alapján tudod elérni, mivel a számok nem - érvényes tulajdonságnevek. + mezőket csak a nevük alapján tudod elérni, mivel a számok nem érvényes + tulajdonságnevek. Az elhagyható result_type parméter egy konstans, - ami MYSQL_ASSOC, MYSQL_NUM vagy MYSQL_BOTH lehet. + ami MYSQL_ASSOC, MYSQL_NUM vagy MYSQL_BOTH lehet. Lásd még a + mysql_fetch_array függvényt, ha kíváncsi vagy az + állandók leírására. Sebesség szempontjából a mysql_fetch_array @@ -951,7 +1086,8 @@ <function>mysql_fetch_object</function> példa -<?php + +]]> - - Lásd még a mysql_fetch_array és a + + Lásd még a mysql_fetch_array és a mysql_fetch_row függvényt! @@ -981,10 +1118,10 @@ array mysql_fetch_row - int result + resource result - + Egy számmal indexelt tömbbel tér vissza, ami a betöltött sorokat tartalmazza, vagy hamissal, ha nincs több sor. @@ -996,13 +1133,13 @@ A mysql_fetch_row többszöri alkamazásával végig tudjuk járni az eredményhalmazt, mivel az mindig a következő sort tölti - be, majd ha elfogytak a sorok, hamisat ad vissza. + be, majd ha elfogytak a sorok, &false;-at ad vissza. Lásd még a mysql_fetch_array, mysql_fetch_object, mysql_data_seek, - mysql_fetch_lengths és a + mysql_fetch_lengths és a mysql_result függvényeket! @@ -1020,11 +1157,11 @@ string mysql_field_flags - int result + resource result int field_offset - + A mysql_field_flags függvény az adott mező flagjeit adja vissza. A flagek egyszerű szavak, melyeket egyetlen szóköz választ el, így a kapott értéket feldolgozhatod a explode @@ -1035,16 +1172,16 @@ "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". - + Kompatíbilitási okokból a mysql_fieldflags függvény - is használható. + is használható, de nem javasolt. - mysql_field_name + mysql_field_name Adott mező nevét adja vissza @@ -1054,15 +1191,15 @@ string mysql_field_name - int result + resource result int field_index A mysql_field_name függvény az eredményben szereplő megadott indexű mező nevét adja vissza. A result - paraméternek érvényes eredményazonosítónak kell lennie, - a field_index paraméter pedig a mező indexe. + paraméternek érvényes eredményazonosítónak kell lennie, a + field_index paraméter pedig a mező indexe. @@ -1076,37 +1213,39 @@ <function>mysql_field_name</function> példa + - - - - A fenti példa ay alábbi kimenetet eredményezi: - - -user_id + + A fenti példa ay alábbi kimenetet eredményezi: + + - +]]> + + + Kompatíbilitási okokból a mysql_fieldname - függvény is használható. + függvény is használható, de nem ajánlott. - mysql_field_len + mysql_field_len A kérdezett mező hosszát adja vissza @@ -1116,7 +1255,7 @@ int mysql_field_len - int result + resource result int field_offset @@ -1126,7 +1265,7 @@ Kompatíbilitási okokból a mysql_fieldlen - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1143,16 +1282,15 @@ int mysql_field_seek - int result + resource result int field_offset A megadott helyre mozgatja az eredmény-mutatót. Ha a következő mysql_fetch_field függvényhívás nem tartalmaz mező - pozíciót, akkor a - mysql_field_seek függvény által visszaadott - mezőpozíciót fogja visszaadni. + pozíciót, akkor a mysql_field_seek függvény által + visszaadott mezőpozíciót fogja visszaadni. Lásd még a mysql_fetch_field függvényt! @@ -1172,17 +1310,17 @@ string mysql_field_table - int result + resource result int field_offset - + A függvény annak a táblának a nevével tér vissza, melyben a megadott mező szerepel. Kompatíbilitási okokból a mysql_fieldtable - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1199,7 +1337,7 @@ string mysql_field_type - int result + resource result int field_offset @@ -1213,7 +1351,8 @@ mysql mezőtípusok -<?php +"; +echo "A táblának az alábbi mezői vannak
"; +while ($i < $mezo) { $tipus = mysql_field_type ($eredmeny, $i); $nev = mysql_field_name ($eredmeny, $i); $hossz = mysql_field_hossz ($eredmeny, $i); $flags = mysql_field_flags ($eredmeny, $i); - echo "$tipus $nev $hossz $flags."<BR>"; + echo "$tipus $nev $hossz $flags."
"; $i++; } mysql_close(); ?> +]]>
- + Kompatíbilitási okokból a mysql_fieldtype - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1254,8 +1394,8 @@ Leírás - int mysql_free_result - int result + bool mysql_free_result + resource result @@ -1269,8 +1409,11 @@ memória a php program végén úgyis felszabadul. + &return.success; + + Kompatíbilitási okokból a mysql_freeresult - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1287,7 +1430,7 @@ int mysql_insert_id - int + resource link_identifier @@ -1299,13 +1442,12 @@ műveletben szereplő AUTO_INCREMENT tulajdonságú mező értékét adja vissza. Ha megadjuk link_identifier-t az adott linkkel rendelekező, ha nem adunk meg paramétert, az utolsó megnyitott - linkhez tartozó eredményt szolgáltatja. + linkhez tartozó eredményt szolgáltatja. A mysql_insert_id függvény 0-val tér vissza, ha az előző kérésben nem jött létre AUTO_INCREMENT érték. Ha szükséged van - később az értékre, hívd meg a mysql_insert_id + később az értékre, hívd meg a mysql_insert_id függvényt rögtön az értéket generáló lekérdezés után! @@ -1317,12 +1459,12 @@ - A mysql_insert_id függvény a MySQL C API függvény - mysql_insert_id() visszatérési értékét - long-gá konvertálja. Ha az AUTO_INCREMENT meződ - mondjuk BIGINT típusú, akkor a + A mysql_insert_id függvény a MySQL C API függvény + mysql_insert_id() visszatérési értékét + long-gá (PHP-ban ez az int) konvertálja. Ha az + AUTO_INCREMENT meződ mondjuk BIGINT típusú, akkor a mysql_insert_id függvény rossz eredményt adhat - vissza. Ezért inkább a belső + vissza. Ezért inkább az SQL-be beépített LAST_INSERT_ID() MySQL függvényt használd! @@ -1331,7 +1473,7 @@ - mysql_list_dbs + mysql_list_dbs Kilistázza a MySQL szerveren elérhető adatbázisokat @@ -1340,8 +1482,8 @@ Leírás - int mysql_list_dbs - int + resource mysql_list_dbs + resource link_identifier @@ -1351,32 +1493,37 @@ A mysql_list_dbs függvény egy eredménymutatót ad vissza, ami a mysql démontól elérhető adatbázisokat tartalmazza. - Használd a mysql_tablename függvényt, hogy az összes - táblát elérd! + Használd a mysql_tablename függvényt az + eredménymutatón történő végigjárásra, vagy bármely függvényt az + eredménytáblákra! <function>mysql_list_dbs</function> példa +Database . "\n"; } +?> +]]> - - - - A fenti példa az alábbi kimenetet eredményezi. - - + + A fenti példa az alábbi kimenetet eredményezi. + + - +]]> + + +
@@ -1387,7 +1534,10 @@ Kompatíbilitási okokból a mysql_listdbs függvény - is használható. + is használható, de nem javasolt. + + + Lásd még a mysql_db_name függvényt! @@ -1401,10 +1551,10 @@ Leírás - int mysql_list_fields + resource mysql_list_fields string database_name string table_name - int + resource link_identifier @@ -1414,49 +1564,44 @@ A mysql_list_fields függvény az adott tábláról szolgáltat információt. A paraméterek az adatbázis és a tábla neve. A - függvény egy eredmény-azonosító tér vissza, amit a + függvény egy eredmény-azonosító tér vissza, amit a mysql_field_flags, mysql_field_len, mysql_field_name, és a mysql_field_type függvényekkel hámozhatsz meg. - Az eredmény-azonosító egy pozitív egész szám. A függvény hiba esetén - -1-gyel tér vissza. A hiba szöveges leírása a - $phperrmsg változóban található, és ha nem -  <email protected>() <- így hívtad meg a függvényt, akkor a - hiba kiírásra kerül [már ha nem pl. egy Javascript kód belsejében, vagy - egy keretrendszer tetején akarná kiírni szegény PHP...]. - - <function>mysql_list_fields</function> példa + - - - - A fenti példa az alábbi kimenetet eredményezi: - - + + A fenti példa az alábbi kimenetet eredményezi: + + - +]]> + + + Kompatíbilitási okokból a mysql_listfields - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1470,25 +1615,25 @@ Leírás - int mysql_list_tables + resource mysql_list_tables string database - int + resource link_identifier - + A mysql_list_tables függvény veszi az adatbázisnevet, és egy eredmény-mutatót ad vissza, a mysql_db_query függvényhez hasonlóan. A - mysql_tablename függvény használható arra, hogy az - eredmény-mutatóból a tényleges táblaneveket megállapítsd. + mysql_tablename függvényt használhatod arra, hogy az + eredmény-mutatóból, vagy más tábla eredményéből a tényleges táblaneveket megállapítsd. Kompatíbilitási okokból a mysql_listtables - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1503,22 +1648,22 @@ int mysql_num_fields - int result + resource result - + A mysql_num_fields függvény az eredményhalmazban levő mezők számát adja vissza. - - Lásd még a + + Lásd még a mysql_db_query, mysql_query, mysql_fetch_field és a mysql_num_rows függvényeket! Kompatíbilitási okokból a mysql_numfields - függvény is használható. + függvény is használható, de nem ajánlott. @@ -1533,7 +1678,7 @@ int mysql_num_rows - int result + resource result @@ -1543,38 +1688,39 @@ számát szeretnéd megtudni, használd a DELETE, use mysql_affected_rows függvényt! - - <function> - mysql_num_rows példa Szerző: crubel <<i>email protected</i>> - </function> - + <function>mysql_num_rows</function> példa -<?php -$conn = mysql_connect("hostcim", "juzer", "jelszo"); -mysql_select_db("adatbázis",$conn); // kell, ha több adatbázis van -$Eredmenytagokszama = mysql_query("SELECT * FROM Szamla",$conn); -$Tagokszama = mysql_num_rows($Eredmenytagokszama); -echo "$Tagokszama tag van"; -?> + +]]> - Lásd még a - mysql_db_query, - mysql_query és a - mysql_fetch_row függvényeket! + Lásd még a + mysql_affected_rows, + mysql_connect, + mysql_select_db és a + mysql_query függvényeket! - Kompatíbilitási okokból a mysql_numrows can - also be used. + Kompatíbilitási okokból a mysql_numrows függvény is + használható, de nem javasolt. - mysql_pconnect + mysql_pconnect Perzisztens kapcsolatot nyit meg a MySQL szerverhez @@ -1583,38 +1729,33 @@ Leírás - int mysql_pconnect - string + resource mysql_pconnect + string - hostname - :port - :/path/to/socket - + server - string + string username - string + string password - + Visszatérési értéke: Egy pozitív MySQL perzisztens kapcsolatazonosító - siker esetén, vagy false, ha hiba történt. + siker esetén, vagy &false;, ha hiba történt. A mysql_pconnect függvény létrehoz egy kapcsolatot a MySQL szerverhez. Az elhagyott paraméterek az alábbi értékeket veszik - fel: - host:port = - 'localhost:3306', username = annak a - felhasználónak a neve, akié a szerver folyamat és végül: - password = üres jelszó. + fel: server = 'localhost:3306', + username = annak a felhasználónak a neve, akié a + szerver folyamat és végül: password = üres jelszó. - A hostname karakterlánc a port számát is + A server karakterlánc a port számát is tartalmazhatja; pl.: "hostname:port" vagy a socket teljes elérési útvonalát pl.: ":/path/to/socket". Ez persze csak a helyi gépen működik. @@ -1627,27 +1768,33 @@ támogatott. - + A mysql_pconnect függvény a mysql_connect függvényhez hasonlóan működik, csupán két nagyobb különbség van: - + Először is, a kapcsolat felvételekor a függvény először megpróbál egy (perzisztens) kapcsolatot találni, amely már nyitva van arra a hostra ugyanazzal a név/jelszó párossal. Ha talál ilyet, akkor ennek a kapocsnak az azonosítóját adja vissza és nem nyit újat. - + Másodszor pedig a kapcsolat az SQL szerverhez nem kerül bezárásra, amikor a php program véget ér, hanem megmarad későbbi felhasználásra. (A mysql_close függvény nem fogja neked lezárni a mysql_pconnect függvénnyel megnyitott kapcsolatokat). - + Az ilyen típusú kapcsolatot ezért hívják 'perzisztensnek'. + + + Ügyelj rá, hogy ezek a fajta kapcsolatok csak a PHP betölthető modulos + változatában működnek. Lást a + Perzisztens Adatbázis + Kapcsolatok fejezetet további információkért! @@ -1660,14 +1807,14 @@ Leírás - int mysql_query + resource mysql_query string query - int + resource link_identifier - + A mysql_query függvény kérést küld a megadott kapcsolat-azonosítójú szerver aktív adatbázisához. Ha nem adsz meg link_identifier-t, akkor a @@ -1678,49 +1825,55 @@ - A kérésnek nem szabad pontosvesszőre végződnie. + A kérésnek nem szabad pontosvesszővel végződnie. - A mysql_query függvény TRUE-val (nemnulla) vagy - FALSE-szal tér vissza, attól függően, hogy a kérés teljesítése sikeres - volt-e. A TRUE visszatérési érték azt jelenti, hogy a kérés - szintaktikailag helyes volt, és lefuttatta a szerver. Az érintett sorok - számáról azonban nem mond semmit. Előfordulhat ugyanis, hogy a kérés - sikeresen lefutott, de nem érintett egyetlen sort sem, vagy az - eredményben egyetlen sor sincs. + A SELECT utasításra alkalmazott mysql_query függvény + eredményazonosítóval vagy &false;-sal tér vissza a kérés végrehajtásától + függően. Egyéb esetekben mysql_query függvény + TRUE-val (nemnulla) vagy FALSE-szal tér vissza, attól függően, hogy a + kérés teljesítése sikeres volt-e. A TRUE visszatérési érték azt jelenti, + hogy a kérés szintaktikailag helyes volt, és lefuttatta a szerver. Az + érintett sorok számáról azonban nem mond semmit. Előfordulhat ugyanis, + hogy a kérés sikeresen lefutott, de nem érintett egyetlen sort sem, vagy + az eredményben egyetlen sor sincs. - A következő kérés szintaktikailag rossz, igy a - mysql_query függvény meghiúsul és FALSE eredményt + A következő kérés szintaktikailag rossz, igy a + mysql_query függvény meghiúsul és &false; eredményt ad: <function>mysql_query</function> -<?php + +]]> - Az alábbi kérés szemantikailag helytelen, ha nincs - my_col nevű oszlop a + Az alábbi kérés szemantikailag helytelen, ha nincs + my_col nevű oszlop a my_tbl nevű táblában, így a - mysql_query meghiúsul és FALSE értékkel tér vissza. + mysql_query meghiúsul és &false; értékkel tér vissza. <function>mysql_query</function> -<?php + +]]> - A mysql_query függvény akkor is meghiúsul és FALSE + A mysql_query függvény akkor is meghiúsul és &false; értékkel tér vissza, ha nincs megfelelő engedélyed a kérés által hivatkozott táblá(k)hoz. @@ -1732,24 +1885,73 @@ sort érintett a DELETE, NSERT, REPLACE vagy UPDATE kérésed. - SELECT kérés esetében a mysql_query függvény - egy új eredmény-azonosítót ad vissza, amit később a - mysql_result függvénnyel használhatsz. - Ha az eredményre már nincs szükség és memóriafóbiád van, akkor a - mysql_free_result függvénnyel a foglalt memóriát - felszabadíthatod, normál esetben megvárod a program végét és a memória - felszabadul. + SELECT kérés esetében a mysql_query függvény egy új + eredmény-azonosítót ad vissza, amit később a + mysql_fetch_array vagy más eredménytáblákkal + foglalkozó függvénnyel használhatsz. Ha az eredményre már nincs szükség + és memóriafóbiád van, akkor a mysql_free_result + függvénnyel a foglalt memóriát felszabadíthatod, normál esetben megvárod + a program végét és a memória felszabadul. - Lásd még a mysql_affected_rows, + Lásd még a mysql_num_rows, + mysql_affected_rows, mysql_db_query, + mysql_unbuffered_query, mysql_free_result, + mysql_fetch_array, + mysql_fetch_row, + mysql_fetch_assoc, mysql_result, mysql_select_db és a mysql_connect függvényeket! + + + mysql_unbuffered_query + + SQL kérést küld küld a MySQL-nek anélkül, hogy az eredményt + előfeldolgozná. + + + + Leírás + + + resource mysql_unbuffered_query + string query + resource + link_identifier + + + + + A mysql_unbuffered_query függvény a + query SQL kérést küldi a MySQL-nek anélkül, hogy + bármi módon betöltené, vagy pufferelni, mint azt a + mysql_query függvény teszi. Egyfelől, ez elég + jelentős memória-megtakarítást tesz lehetővé az olyan SQL kérések + számára, amelyek nagy eredményhalmazt állítanak elő. Másfelől, az + eredményhalmazzal rögtön dolgozni kezdhetsz, amint az első sor + megérkezik: nem kell megvárnod a teljes SQL kérés lefutását. Ha több + adatbáziskapcsolatot használsz, meg kell mondanod a + link_identifier paraméterben, hogy melyik + kapcsolatra vonatkozik a kérés. + + + + A mysql_unbuffered_query függvénynek az a hátránya, + hogy nem használhatod a mysql_num_rows függvényt a + visszakapott eredményhalmazra. A bufferelés nélküli SQL kérés minden + sorát be kell töltened, mielőtt egy új SQL kérést küldesz a MySQL-nek. + + + + Lásd még a mysql_queryfüggvényt! + + @@ -1761,9 +1963,9 @@ mixed mysql_result - int result + resource result int row - mixed + mixed field @@ -1794,7 +1996,7 @@ Ajánlott az alábbi, gyors [és programozóbarát] függvények használata: - mysql_fetch_row, + mysql_fetch_row, mysql_fetch_array és mysql_fetch_object. @@ -1810,19 +2012,19 @@ Leírás - int mysql_select_db + bool mysql_select_db string database_name - int + resource link_identifier - - Visszatérési érték: true, ha sikeres; false ha hiba történt. + + &return.success; - + A mysql_select_db függvény az adott kapcsolat-azonosítójú szerverkapcsolat adatbázisát módosítja. Ha nincs kapcsolat-azonosító megadva, akkor az utoljára megnyitott kapcsolatban @@ -1835,13 +2037,13 @@ adatbázison fog történni. Lásd még a - mysql_connect, + mysql_connect, mysql_pconnect és a mysql_query függvényeket! Kompatíbilitási okokból a mysql_selectdb - függvény is használható. + függvény is használható, de használata nem ajánlott. @@ -1856,11 +2058,11 @@ string mysql_tablename - int result + resource result int i - + A mysql_tablename függvény veszi a mysql_list_tables függvény által visszaadott eredmény-mutatót és egy indexet, majd megmondja az oszlophoz tartozó @@ -1870,22 +2072,133 @@ <function>Mysql_tablename</function> példa -<?php +"; +while ($i < mysql_num_rows ($eredmeny)) { + $tb_nevek[$i] = mysql_tablename ($eredmeny, $i); + echo $tb_nevek[$i] . "
"; $i++; } ?> +]]>
+ + + mysql_get_client_info + MySQL kliens információ + + + Leírás + + + string mysql_get_client_info + + + + + A mysql_get_client_info függvény a kliensprogram + által használt könyvtár verziójáról ad információt. + + + A mysql_get_client_info függvény a PHP 4.0.5-ös + verziójában került a nyelvbe. + + + + + + + mysql_get_host_info + MySQL kiszolgáló információ + + + Leírás + + + string mysql_get_host_info + resource + link_identifier + + + + + A mysql_get_host_info függvény egy karakterlánccal + tér vissza, ami a link_identifier által használt + kapcsolatról ad információt, például a kiszolgáló gép nevét. Ha a + link_identifier paramétert elhagyjuk, akkor a + legutóbb megnyitott kapcsolatról kapunk információt. + + + A mysql_get_host_info függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + + + + + + + mysql_get_proto_info + MySQL protokoll információ + + + Leírás + + + int mysql_get_proto_info + resource + link_identifier + + + + + A mysql_get_proto_info függvény a + link_identifier által használt protokoll verzióját + adja vissza. Ha a link_identifier paramétert nem + adod meg, akkor az utoljára használt kapcsolatról kapsz információt. + + + mysql_get_proto_info függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + + + + + + + mysql_get_server_info + MySQL szerver információ + + + Leírás + + + int mysql_get_server_info + resource + link_identifier + + + + + A mysql_get_server_info függvény a + link_identifier-ban megadott kapcsolat + által használt szerver verzióját adja. Ha nincs megadva + link_identifier, akkor az utoljára használt + kapcsolatról kapsz információt. + + + A mysql_get_server_info függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + + +