cvs: phpdoc /hu/functions mysql.xml
| From: | Kontra Gergely | Date: | Tue, 15 Jan 2002 11:19:46 +0000 |
| Subject: | cvs: phpdoc /hu/functions mysql.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969341277@lists.php.net to get a copy of this message | ||
kgergely Tue Jan 15 06:19:46 2002 EDT
Modified files:
/phpdoc/hu/functions mysql.xml
Log:
Update
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 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.35 Maintainer: kgergely Status: ready --> +<!-- EN-Revision: 1.76 Maintainer: kgergely Status: ready --> <reference id="ref.mysql"> <title>MySQL függvények</title> @@ -7,13 +7,13 @@ <partintro> <simpara> 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 <option role="configure">--with-mysql</option> 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 <option role="configure">--with-mysql=/path/to/mysql</option> 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 <ulink url="&url.mysql.docs;">&url.mysql.docs;</ulink>. </simpara> + <para> + 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. + <example> + <title>MySQL modul áttekintõ példa</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Csatlakozás, adatbázis kiválasztása +$kapcsolat = mysql_connect("mysql_hoszt", "mysql_azonosito", "mysql_jelszo") + or die("Nem tudok csatlakozni"); +print "A kapcsolódás sikerül"; +mysql_select_db("az_en_adatbazisom") + or die("Nem sikerült kiválasztanom az adatbázist"); + +// SQL kérés végrehajtása +$keres = "SELECT * FROM az_en_tablam"; +$eredmeny = mysql_query($keres) or die("Hiba a kérésben"); + +// Az eredmény kiírása HTML-ben +print "<table>\n"; +while ($line = mysql_fetch_array($eredmeny, MYSQL_ASSOC)) { + print "\t<tr>\n"; + foreach ($sor as $egy_oszlop) { + print "\t\t<td>$egy_oszlop</td>\n"; + } + print "\t</tr>\n"; +} +print "</table>\n"; +// Kapcsolat lezárása +mysql_close($kapcsolat); +?> +]]> + </programlisting> + </example> + </para> </partintro> <refentry id="function.mysql-affected-rows"> <refnamediv> - <refname>mysql_affected_rows</refname> + <refname>mysql_affected_rows</refname> <refpurpose>Az elõzõ MySQL mûveletben érintett sorok számát adja meg</refpurpose> </refnamediv> @@ -40,23 +77,24 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_affected_rows</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_affected_rows</function> 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. + <parameter>link_identifier</parameter>-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ó + <function>mysql_connect</function>-tel megnyitott kapcsolatról kapsz + információt. </para> <note> <para> - Ha transzakciókezelést hasznnálsz, akkor a + Ha transzakciókezelést használsz, akkor a <function>mysql_affected_rows</function> függvényt az INSERT, UPDATE, vagy DELETE kérés után közvetlenül, nem a kommit után kell meghívni. </para> @@ -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. </para> + <note> + <para> + 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 + <function>mysql_affected_rows</function> függvény nem pont az egyezõ + sorok számát adja vissza, hanem csak a ténylegesen megváltoztatott sorok + számát. + </para> + </note> <para> - 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 <function>mysql_num_rows</function> függvényt. </para> <para> - 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. + </para> + <para> + Lásd még a<function>mysql_num_rows</function> függvényt! </para> </refsect1> </refentry> <refentry id="function.mysql-change-user"> <refnamediv> - <refname>mysql_change_user</refname> + <refname>mysql_change_user</refname> <refpurpose> Aktív kapcsolat felhasználójának módosítása </refpurpose> @@ -91,27 +141,33 @@ <funcdef>int <function>mysql_change_user</function></funcdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>database</optional> </parameter> </paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_change_user</function> 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.</para> - <note><para>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. - </para></note> + aktuális, vagy az opcionális <parameter>link_identifier</parameter> + 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. + </para> + <note> + <para> + 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. + </para> + </note> </refsect1> </refentry> @@ -124,16 +180,16 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_close</function></funcdef> - <paramdef>int + <funcdef>bool <function>mysql_close</function></funcdef> + <paramdef>resource <parameter> - <optional>link_identifier</optional> + <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - A függvény értéke igaz, ha a mûvelet sikerült, hamis, ha nem. + &return.success; </para> <para>A <function>mysql_close</function> függvény bezárja az adott azonosítójú MySQL kapcsolatot. Ha nem adsz meg @@ -143,26 +199,31 @@ <para> A <function>mysql_close</function> 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: + <link linkend="language.types.resource.self-destruct">erõforrások + felszabadítása</link> </para> <note> - <para> + <para> A <function>mysql_close</function> függvény nem zárja be a - <function>mysql_pconnect</function> függvénnyel megnyitott kapcsolatokat. + <function>mysql_pconnect</function> függvénnyel megnyitott + kapcsolatokat. </para> </note> <example> <title>MySQL close példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_connect ("kraemer", "marliesle", "titok") or die ("Nem lehet csatlakozni"); print ("A csatlakozás sikerült"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> - <para> + <para> Lásd még a <function>mysql_connect</function> és a <function>mysql_pconnect</function> függvényeket! </para> @@ -178,44 +239,41 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_connect</function></funcdef> - <paramdef>string + <funcdef>resource <function>mysql_connect</function></funcdef> + <paramdef>string <parameter> - <optional>hostname - <optional>:port</optional> - <optional>:/path/to/socket</optional> - </optional> + <optional>server</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>username</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>password</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> - 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. + <para> + Pozitív MySQL azonosítóval tér vissza, ha a csatlakozás sikerült, + &false;-sal ha nem. </para> <para> A <function>mysql_connect</function> függvény kapcsolatot nyit meg egy MySQL szerverhez. A paramétereket elhagyhatod. Az alapértelmezett - értékek: <parameter>host:port</parameter> = 'localhost:3306', + értékek: <parameter>server</parameter> = 'localhost:3306', <parameter>username</parameter> = a folyamat tulajdonosának belépési neve <parameter>password</parameter> = üres karakterlánc. </para> <para> - 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 <parameter>server</parameter> 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. <note> <para> A ":port" formátumú kiegészítés a PHP 3.0B4-es változatában @@ -239,20 +297,22 @@ <para> A kapcsolat a PHP program végén bezárul, ha elõbb nem zártuk volna le a <function>mysql_close</function> függvénnyel. - </para> + </para> <example> <title>MySQL connect példa</title> <programlisting role="php"> -<?php - $link = mysql_connect ("kraemer", "marliesle", "titok") +<![CDATA[ +<?php + $link = mysql_connect ("localhost", "felhasználónév", "titok") or die ("Nem lehet csatlakozni"); print ("A csatlakozás sikerült"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> <para> Lásd még a - <function>mysql_pconnect</function> és + <function>mysql_pconnect</function> és a <function>mysql_close</function> függvényeket. </para> </refsect1> @@ -267,23 +327,27 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_create_db</function></funcdef> + <funcdef>bool <function>mysql_create_db</function></funcdef> <paramdef>string <parameter>database name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_create_db</function> függvény megkísérel létrehozni egy új adatbázist a megadott kapcsolatazonosítón keresztül. </para> + <para> + &return.success; + </para> <example> <title>MySQL 'create database' példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("kron", "jutta", "geheim") or die ("Nem lehet csatlakozni") if (mysql_create_db ("my_db")) { @@ -291,14 +355,15 @@ } else { printf ("Hiba az adatbázis létrehozásakor: %s\n", mysql_error ()); } -?> +?> +]]> </programlisting> </example> - <para> + <para> Kompatíbilitási okokból a <function>mysql_createdb</function> függvény is - használható. + használható, de nem javasolt. </para> - <para> + <para> Lásd még a: <function>mysql_drop_db</function> függvényt. </para> </refsect1> @@ -313,30 +378,30 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_data_seek</function></funcdef> - <paramdef>int <parameter>result_identifier</parameter></paramdef> + <funcdef>bool <function>mysql_data_seek</function></funcdef> + <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Igazzal tér vissza, ha a mûvelet sikerült + <para> + &return.success; </para> - <para> + <para> A <function>mysql_data_seek</function> függvény az adott azonosítójú - ereményhalmazban ugrik a megadott pozícióra. - A <function>mysql_fetch_row</function> függvény következõ hívásakor ezt a + ereményhalmazban ugrik a megadott pozícióra. A + <function>mysql_fetch_row</function> függvény következõ hívásakor ezt a sorszámú sort kapod meg. </para> <para> Ha az elsõ sorra akarsz pozicionálni, akkor <parameter>Row_number</parameter> 0 legyen! </para> - <example> <title>MySQL data seek példa</title> <programlisting role="php"> -<?php - $link = mysql_pconnect ("kron", "jutta", "geheim") +<![CDATA[ +<?php + $link = mysql_pconnect ("weblabor", "kgergely", "titok") or die ("Nem tudok csatlakozni"); mysql_select_db ("samp_db") @@ -346,22 +411,23 @@ $eredmeny = mysql_query ($query) or die ("Rossz kérés"); - # fetch rows in reverse order + // fetch rows in reverse order for ($i = mysql_num_rows ($eredmeny) - 1; $i >=0; $i--) { if (!mysql_data_seek ($eredmeny, $i)) { - printf ("Nem tudok a %d. sorra ugorni\n", $i); + echo ("Nem tudok a $i. sorra ugorni\n"); continue; } if(!($sor = mysql_fetch_object ($eredmeny))) continue; - printf ("%s %s<BR>\n", $sor->last_name, $sor->first_name); + echo "$sor->vezeteknev $sor->keresztnev<br />\n"); } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -376,34 +442,31 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_db_name</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <funcdef>string <function>mysql_db_name</function></funcdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_db_name</function> függvény elsõ paramétere egy <function>mysql_list_dbs</function> által visszaadott érték. A <parameter>row</parameter> paraméter az eredményhalmaz indexe. </para> - <para> - Ha hiba történt, a függvény FALSE-szal tér vissza. - Használd a - <function>mysql_errno</function> és a - <function>mysql_error</function> 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 + <function>mysql_errno</function> és a <function>mysql_error</function> + függvényeket a hiba eredetének megállapítására! </para> - <example> <title><function>Mysql_db_name</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php error_reporting(E_ALL); mysql_connect('dbhost', 'név', 'jelszó'); @@ -411,19 +474,18 @@ $i = 0; $cnt = mysql_num_rows($db_list); -while ($i < $cnt) { +while ($i < $cnt) { echo mysql_db_name($db_list, $i) . "\n"; $i++; } -?> +?> +]]> </programlisting> </example> - <para> Kompatíbilitási okokból a <function>mysql_dbname</function> függvény is használható, de használata nem javasolt. </para> - </refsect1> </refentry> @@ -436,33 +498,40 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_db_query</function></funcdef> + <funcdef>resource <function>mysql_db_query</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> 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. </para> - <para> + <para> A <function>mysql_db_query</function> 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 <function>mysql_connect</function> függvényt paraméterek nélkül. </para> - <para> - Lásd még a <function>mysql_connect</function> függvényt. + <para> + Lásd még a <function>mysql_connect</function> és a + <function>mysql_query</function> függvényeket. </para> <para> - Kompatíbilitási okokból a <function>mysql</function> függvény is - használható. + <note> + <simpara> + 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 + <function>mysql_select_db</function> és a + <function>mysql_query</function> függvényeket. + </simpara> + </note> </para> </refsect1> </refentry> @@ -476,41 +545,45 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_drop_db</function></funcdef> + <funcdef>bool <function>mysql_drop_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> - Visszatérési értéke: igaz, ha sikeres, hamis, ha nem - </para> - <para> + <para> + &return.success; + </para> + <para> A <function>mysql_drop_db</function> függvény megpróbálja az egész adatbázist kitörölni, melyet az adott kapcsolat-azonosító határoz meg. </para> - <para> - Lásd még a <function>mysql_create_db</function> függvényt. + <para> Kompatíbilitási okokból <function>mysql_dropdb</function> 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. + </para> + <para> + Lásd még a <function>mysql_create_db</function> függvényt! </para> </refsect1> </refentry> <refentry id="function.mysql-errno"> <refnamediv> - <refname>mysql_errno</refname> - <refpurpose>Az elõzõ MySQL mûvelet hibakódját tartalmazza</refpurpose> + <refname>mysql_errno</refname> + <refpurpose> + Az elõzõ MySQL mûvelet hibakódját tartalmazza + </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_errno</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -522,30 +595,32 @@ sikeres volt, akkor <literal>0</literal>-t (nullát) ad vissza. </para> <para> - 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 - <function>mysql_errno</function> függvényt! - Ez a függvény csak az utolsó MySQL mûvelet hibakódját adja vissza + <function>mysql_errno</function> függvényt! Ez a függvény csak az utolsó + MySQL mûvelet hibakódját adja vissza [(not including <function>mysql_error</function> and <function>mysql_errno</function>)], 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. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect("marliesle"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("nonexistentdb"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM nonexistenttable"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> - <para> + <para> Lásd még a <function>mysql_error</function> függvényt </para> </refsect1> @@ -554,14 +629,16 @@ <refentry id="function.mysql-error"> <refnamediv> <refname>mysql_error</refname> - <refpurpose>Az elõzõ MySQL mûvelet hibaszövegét adja</refpurpose> + <refpurpose> + Az elõzõ MySQL mûvelet hibaszövegét adja + </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_error</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -573,38 +650,71 @@ <literal>''</literal> (üres karakterlánccal) ha nem volt hiba. </para> <para> - 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 <function>mysql_error</function> függvényt! Ez a függvény csak az utolsó MySQL mûvelet hibakódját adja vissza [(not including <function>mysql_error</function> and - <function>mysql_errno</function>)], ha használni szeretnéd, ügyelj rá, + <function>mysql_errno</function>)], + 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. <informalexample> <programlisting role="php"> -<?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>"; -?> +<![CDATA[ +<?php +mysql_connect("mcl"); +echo mysql_errno().": ".mysql_error()."<BR>"; +mysql_select_db("nemletezoadatbazis"); +echo mysql_errno().": ".mysql_error()."<BR>"; +$conn = mysql_query("SELECT * FROM nemletezotabla"); +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> - <para> + <para> Lásd még a <function>mysql_errno</function> függvényt! </para> </refsect1> </refentry> + <refentry id="function.mysql-escape-string"> + <refnamediv> + <refname>mysql_escape_string</refname> + <refpurpose> + Egy karakerláncban szereplõ speciális karakterek értelmezését szünteti + meg. + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mysql_escape_string</function></funcdef> + <paramdef>string <parameter>unescaped_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A függvény az <parameter>unescaped_string</parameter> karakterláncot + átalakítja úgy, hogy az biztonságosan elhelyezhetõ legyen egy + <function>mysql_query</function> függvényben. + </para> + <note> + <simpara> + A <function>mysql_escape_string</function> függvény nem nyúl a + <literal>%</literal> és a <literal>_</literal> jelekhez. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.mysql-fetch-array"> <refnamediv> - <refname>mysql_fetch_array</refname> + <refname>mysql_fetch_array</refname> <refpurpose> Kérés egy sorát adja vissza (tetszõleges) tömb formájában. </refpurpose> @@ -614,7 +724,7 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_array</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter> <optional>result_type</optional> @@ -622,8 +732,8 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> - Az eredmény következõ sorával tér vissza tömb formájában, vagy hamissal, + <para> + 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.</para> <para> A <function>mysql_fetch_array</function> 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 <literal>'field'</literal> + használatával). <informalexample> - <programlisting> -select t1.f1 as ize t2.f1 as bigyo from t1, t2 + <programlisting role="sql"> +<![CDATA[ +select tik.f1 as ize tak.f1 as bigyo from tik, tak +]]> </programlisting> </informalexample> </para> <para> Jó tudni, hogy a <function>mysql_fetch_array</function> függvény - használata NEM jelentõsen lassabb a <function>mysql_fetch_row</function> - használatánál, de a kapott eredmény feldolgozása jóval kényelmesebb. + használata <emphasis>nem jelentõsen</emphasis> lassabb a + <function>mysql_fetch_row</function> használatánál, de a kapott eredmény + feldolgozása jóval kényelmesebb. </para> <para> A <function>mysql_fetch_array</function> függvény elhagyható <parameter>result_type</parameter> 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. </para> <para> - További részletekért olvasd még a - <function>mysql_fetch_row</function> és a - <function>mysql_fetch_assoc</function> 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 + <function>mysql_fetch_assoc</function> függvénnyel), MYSQL_NUM értékkel + meghívva a fügvényt számozott indexû tömböt kapsz (mint a + <function>mysql_fetch_row</function> függvénnyel). + </para> + <para> + További részletekért olvasd még a <function>mysql_fetch_row</function> és + a <function>mysql_fetch_assoc</function> függvényeket! </para> <example> - <title><function>Mysql_fetch_array</function></title> + <title><function>Mysql_fetch_array</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo); $eredmeny = mysql_db_query ("adatbázis","select user_id, teljesnev from table"); while ($sor = mysql_fetch_array ($eredmeny)) { - echo "user_id: ".$sor["user_id"]."<br>\n"; - echo "user_id: ".$sor[0]."<br>\n"; - echo "fullname: ".$sor["fullname"]."<br>\n"; - echo "fullname: ".$sor[1]."<br>\n"; + echo "felhasznalonev: ".$sor["felhasznalonev"]."<br>\n"; + echo "felhasznalonev: ".$sor[0]."<br>\n"; + echo "nev: ".$sor["nev"]."<br>\n"; + echo "nev: ".$sor[1]."<br>\n"; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -679,7 +804,7 @@ <refentry id="function.mysql-fetch-assoc"> <refnamediv> - <refname>mysql_fetch_assoc</refname> + <refname>mysql_fetch_assoc</refname> <refpurpose> Az eredmény egy sorát asszociatív tömbként adja vissza. </refpurpose> @@ -689,27 +814,30 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_assoc</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> Az eredmény következõ sorával, mint asszociatív tömbbel tér vissza, vagy - hamissal, ha nincs több sor.</para> + &false;-sal, ha nincs több sor. + </para> <para> A <function>mysql_fetch_assoc</function> függvény hívásával ugyanazt érjük el, mintha a <function>mysql_fetch_array</function> 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 <function>mysql_fetch_array</function> függvény így mûködött. Ha a számokkal indexelt elemekre is szükséged van, akkor használd a <function>mysql_fetch_array</function> függvényt. </para> <para> - 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 - <function>mysql_fetch_array</function> 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 + <function>mysql_fetch_array</function> függvény használatával, vagy az + SQL parancsban kérj aliast az oszlopra. Lásd még a + <function>mysql_fetch_array</function> függvénynél szereplõ példát az + aliasok leírásáért. </para> <para> Jó tudni, hogy a <function>mysql_fetch_assoc</function> függvény @@ -717,22 +845,23 @@ használatánál, de a kapott eredmény feldolgozása jóval kényelmesebb. </para> <para> - További részletekért lásd még a - <function>mysql_fetch_row</function> és a + További részletekért lásd még a <function>mysql_fetch_row</function> és a <function>mysql_fetch_array</function> függvényeket. </para> <example> - <title><function>Mysql_fetch_assoc</function></title> + <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo); $eredmeny = mysql_db_query ("adatbázis","select * from table"); while ($sor = mysql_fetch_assoc ($eredmeny)) { - echo $sor["user_id"]; - echo $sor["fullname"]; + echo $sor["felhasznalonev"]; + echo $sor["nev"]; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -750,8 +879,8 @@ <funcsynopsis> <funcprototype> <funcdef>object <function>mysql_fetch_field</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter>result</parameter></paramdef> + <paramdef>int <parameter> <optional>field_offset</optional> </parameter> @@ -760,113 +889,115 @@ </funcsynopsis> <para> Egy mezõinformációt tartalmazó objektummal tér vissza. - </para> + </para> <para> A <function>mysql_fetch_field</function> 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 - <function>mysql_fetch_field</function> függvényt. + amelyre még nem hívtad meg a <function>mysql_fetch_field</function> + függvényt. </para> <para> Az objektum tulajdonságai: <itemizedlist> <listitem> <simpara> - name - az oszlop neve + name - az oszlop neve </simpara> </listitem> <listitem> <simpara> - table - a tábla neve, amelyhez az oszlop tartozik + table - a tábla neve, amelyhez az oszlop tartozik </simpara> </listitem> <listitem> <simpara> - max_length - az oszlop maximális hossza + max_length - az oszlop maximális hossza </simpara> </listitem> <listitem> <simpara> - 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 </simpara> - </listitem> + </listitem> <listitem> <simpara> - primary_key - értéke 1, ha az oszlop elsõdleges kulcs + primary_key - értéke 1, ha az oszlop elsõdleges kulcs </simpara> - </listitem> + </listitem> <listitem> <simpara> - unique_key - értéke 1, ha az oszlop egyszerû kulcs + unique_key - értéke 1, ha az oszlop egyszerû kulcs </simpara> - </listitem> + </listitem> <listitem> <simpara> - multiple_key - értéke 1, ha az oszlop összetett kulcs része + multiple_key - értéke 1, ha az oszlop összetett kulcs része </simpara> - </listitem> + </listitem> <listitem> <simpara> - numeric - értéke 1, ha az oszlop szám + numeric - értéke 1, ha az oszlop szám </simpara> - </listitem> + </listitem> <listitem> <simpara> - blob - értéke 1, ha az oszlop BLOB típusú + blob - értéke 1, ha az oszlop BLOB típusú </simpara> </listitem> <listitem> <simpara> - type - az oszlop típusa + type - az oszlop típusa </simpara> </listitem> <listitem> <simpara> - unsigned - értéke 1, ha az oszlop nem elõjeles + unsigned - értéke 1, ha az oszlop nem elõjeles </simpara> </listitem> <listitem> <simpara> - zerofill - értéke 1, ha az oszlop nullával feltöltött + zerofill - értéke 1, ha az oszlop nullával feltöltött </simpara> </listitem> </itemizedlist> </para> <example> - <title><function>Mysql_fetch_field</function></title> + <title><function>mysql_fetch_field</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo) or die ("Nem lehet csatlakozni az adatbázishoz"); $eredmeny = mysql_db_query ("adatbázis", "select * from table") or die ("Hibás kérés"); # oszlopinformáció lekérése $i = 0; -while ($i < mysql_num_fields ($eredmeny)) { - echo "Információ a $i. oszlopról:<BR>\n"; +while ($i < mysql_num_fields ($eredmeny)) { + echo "Információ a $i. oszlopról:<BR>\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<BR>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 "<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>"; $i++; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> <para> @@ -877,7 +1008,7 @@ <refentry id="function.mysql-fetch-lengths"> <refnamediv> - <refname>mysql_fetch_lengths</refname> + <refname>mysql_fetch_lengths</refname> <refpurpose> Az eredmény oszlopainak hosszáról nyújt információt </refpurpose> @@ -887,22 +1018,23 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_lengths</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> Egy tömbbel tér vissza. A tömb elemei az utolsó <function>mysql_fetch_row</function> függvény által betöltött oszlopok - hosszait tartalmazza, vagy hiba esetén hamisat. - </para> + hosszait tartalmazza. Hiba esetén &false; értékkel tér vissza. + </para> <para> A <function>mysql_fetch_lengths</function> függvény a <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> vagy a - <function>mysql_fetch_object</function> által betöltött sor hosszait adja - vissza számmal indexelt tömb formájában. - </para> - <para> + <function>mysql_fetch_object</function> által visszaadott + eredmény-oszlopok hosszát tárolja, illetve megmondja + számmal indexelt tömb formájában. + </para> + <para> Lásd még a <function>mysql_fetch_row</function> függvényt! </para> </refsect1> @@ -911,15 +1043,16 @@ <refentry id="function.mysql-fetch-object"> <refnamediv> <refname>mysql_fetch_object</refname> - <refpurpose>Az eredmény következõ sorát objektum formájában adja - vissza</refpurpose> + <refpurpose> + Az eredmény következõ sorát objektum formájában adja vissza + </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>object <function>mysql_fetch_object</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter> <optional>result_type</optional> @@ -927,21 +1060,23 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> 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. </para> - <para> + <para> A <function>mysql_fetch_object</function> függvény hasonló a <function>mysql_fetch_array</function> 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. </para> <para> Az elhagyható <parameter>result_type</parameter> 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 + <function>mysql_fetch_array</function> függvényt, ha kíváncsi vagy az + állandók leírására. </para> <para> Sebesség szempontjából a <function>mysql_fetch_array</function> @@ -951,7 +1086,8 @@ <example> <title><function>mysql_fetch_object</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo); $eredmeny = mysql_db_query ("adatbázis", "select * from table"); while ($sor = mysql_fetch_object ($eredmeny)) { @@ -959,12 +1095,13 @@ echo $sor->fullname; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </para> - <para> - Lásd még a <function>mysql_fetch_array</function> és a + <para> + Lásd még a <function>mysql_fetch_array</function> és a <function>mysql_fetch_row</function> függvényt! </para> </refsect1> @@ -981,10 +1118,10 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_row</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> Egy számmal indexelt tömbbel tér vissza, ami a betöltött sorokat tartalmazza, vagy hamissal, ha nincs több sor. </para> @@ -996,13 +1133,13 @@ <para> A <function>mysql_fetch_row</function> 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. </para> <para> Lásd még a <function>mysql_fetch_array</function>, <function>mysql_fetch_object</function>, <function>mysql_data_seek</function>, - <function>mysql_fetch_lengths</function> és a + <function>mysql_fetch_lengths</function> és a <function>mysql_result</function> függvényeket! </para> </refsect1> @@ -1020,11 +1157,11 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_flags</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_field_flags</function> 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 <function>explode</function> @@ -1035,16 +1172,16 @@ "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". </para> - <para> + <para> Kompatíbilitási okokból a <function>mysql_fieldflags</function> függvény - is használható. + is használható, de nem javasolt. </para> </refsect1> </refentry> <refentry id="function.mysql-field-name"> <refnamediv> - <refname>mysql_field_name</refname> + <refname>mysql_field_name</refname> <refpurpose> Adott mezõ nevét adja vissza </refpurpose> @@ -1054,15 +1191,15 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_name</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_index</parameter></paramdef> </funcprototype> </funcsynopsis> <para> A <function>mysql_field_name</function> függvény az eredményben szereplõ megadott indexû mezõ nevét adja vissza. A <parameter>result</parameter> - paraméternek érvényes eredményazonosítónak kell lennie, - a <parameter>field_index</parameter> paraméter pedig a mezõ indexe. + paraméternek érvényes eredményazonosítónak kell lennie, a + <parameter>field_index</parameter> paraméter pedig a mezõ indexe. </para> <note> <para> @@ -1076,37 +1213,39 @@ <example> <title><function>mysql_field_name</function> példa</title> <programlisting role="php"> +<![CDATA[ // A felhasznalok tábla három mezõbõl áll: -// user_id +// azonosito // felhasznalonev // jelszo. -$res = mysql_db_query("felhasznalok", "select * from felhasznalok", $link); +$eredmeny = mysql_db_query("felhasznalok", "select * from felhasznalok", $link); -echo mysql_field_name($res, 0) . "\n"; -echo mysql_field_name($res, 2); +echo mysql_field_name($eredmeny, 0) . "\n"; +echo mysql_field_name($eredmeny, 2); +]]> </programlisting> - </example> - </para> - <para> - A fenti példa ay alábbi kimenetet eredményezi: - <informalexample> - <programlisting> -user_id + <para> + A fenti példa ay alábbi kimenetet eredményezi: + <screen> +<![CDATA[ +azonosito jelszo - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Kompatíbilitási okokból a <function>mysql_fieldname</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> <refentry id="function.mysql-field-len"> <refnamediv> - <refname>mysql_field_len</refname> + <refname>mysql_field_len</refname> <refpurpose> A kérdezett mezõ hosszát adja vissza </refpurpose> @@ -1116,7 +1255,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_field_len</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1126,7 +1265,7 @@ </para> <para> Kompatíbilitási okokból a <function>mysql_fieldlen</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1143,16 +1282,15 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_field_seek</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> A megadott helyre mozgatja az eredmény-mutatót. Ha a következõ <function>mysql_fetch_field</function> függvényhívás nem tartalmaz mezõ - pozíciót, akkor a - <function>mysql_field_seek</function> függvény által visszaadott - mezõpozíciót fogja visszaadni. + pozíciót, akkor a <function>mysql_field_seek</function> függvény által + visszaadott mezõpozíciót fogja visszaadni. </para> <para> Lásd még a <function>mysql_fetch_field</function> függvényt! @@ -1172,17 +1310,17 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_table</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A függvény annak a táblának a nevével tér vissza, melyben a megadott mezõ szerepel. </para> <para> Kompatíbilitási okokból a <function>mysql_fieldtable</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1199,7 +1337,7 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_type</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1213,7 +1351,8 @@ <example> <title>mysql mezõtípusok</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("localhost:3306"); mysql_select_db ("wisconsin"); @@ -1222,25 +1361,26 @@ $sor = mysql_num_rows ($eredmeny); $i = 0; $table = mysql_field_table ($eredmeny, $i); -echo "A '$table' nevû táblának $mezo mezõje és $sor sora van <BR>"; -echo "A táblának az alábbi mezõi vannak<BR>"; -while ($i < $mezo) { +echo "A '$table' nevû táblának $mezo mezõje és $sor sora van <BR>"; +echo "A táblának az alábbi mezõi vannak<BR>"; +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."<BR>"; $i++; } mysql_close(); ?> +]]> </programlisting> </example> </para> - <para> + <para> Kompatíbilitási okokból a <function>mysql_fieldtype</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1254,8 +1394,8 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_free_result</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <funcdef>bool <function>mysql_free_result</function></funcdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1269,8 +1409,11 @@ memória a php program végén úgyis felszabadul. </para> <para> + &return.success; + </para> + <para> Kompatíbilitási okokból a <function>mysql_freeresult</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1287,7 +1430,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_insert_id</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -1299,13 +1442,12 @@ mûveletben szereplõ AUTO_INCREMENT tulajdonságú mezõ értékét adja vissza. Ha megadjuk <parameter>link_identifier</parameter>-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. </para> <para> A <function>mysql_insert_id</function> 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 <function>mysql_insert_id</function> <!-- - nem volt function tag --> + késõbb az értékre, hívd meg a <function>mysql_insert_id</function> függvényt rögtön az értéket generáló lekérdezés után! </para> <note> @@ -1317,12 +1459,12 @@ </note> <warning> <para> - A <function>mysql_insert_id</function> függvény a MySQL C API függvény - <literal>mysql_insert_id()</literal> visszatérési értékét - <literal>long</literal>-gá konvertálja. Ha az AUTO_INCREMENT mezõd - mondjuk BIGINT típusú, akkor a + A <function>mysql_insert_id</function> függvény a MySQL C API függvény + <literal>mysql_insert_id()</literal> visszatérési értékét + <literal>long</literal>-gá (PHP-ban ez az int) konvertálja. Ha az + AUTO_INCREMENT mezõd mondjuk BIGINT típusú, akkor a <function>mysql_insert_id</function> 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 <literal>LAST_INSERT_ID()</literal> MySQL függvényt használd! </para> </warning> @@ -1331,7 +1473,7 @@ <refentry id="function.mysql-list-dbs"> <refnamediv> - <refname>mysql_list_dbs</refname> + <refname>mysql_list_dbs</refname> <refpurpose> Kilistázza a MySQL szerveren elérhetõ adatbázisokat </refpurpose> @@ -1340,8 +1482,8 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_list_dbs</function></funcdef> - <paramdef>int + <funcdef>resource <function>mysql_list_dbs</function></funcdef> + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -1351,32 +1493,37 @@ <para> A <function>mysql_list_dbs</function> függvény egy eredménymutatót ad vissza, ami a mysql démontól elérhetõ adatbázisokat tartalmazza. - Használd a <function>mysql_tablename</function> függvényt, hogy az összes - táblát elérd! <!--vagy valami ilyesmi... --> + Használd a <function>mysql_tablename</function> 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! </para> <para> <example> <title><function>mysql_list_dbs</function> példa</title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect('localhost', 'nevem', 'titok'); $db_list = mysql_list_dbs($link); while ($sor = mysql_fetch_object($db_list)) { echo $sor->Database . "\n"; } +?> +]]> </programlisting> - </example> - </para> - <para> - A fenti példa az alábbi kimenetet eredményezi. - <informalexample> - <programlisting> + <para> + A fenti példa az alábbi kimenetet eredményezi. + <screen> +<![CDATA[ adatbázis1 adatbázis2 adatbázis3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <note> <para> @@ -1387,7 +1534,10 @@ </note> <para> Kompatíbilitási okokból a <function>mysql_listdbs</function> függvény - is használható. + is használható, de nem javasolt. + </para> + <para> + Lásd még a <function>mysql_db_name</function> függvényt! </para> </refsect1> </refentry> @@ -1401,10 +1551,10 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_list_fields</function></funcdef> + <funcdef>resource <function>mysql_list_fields</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>string <parameter>table_name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -1414,49 +1564,44 @@ <para> A <function>mysql_list_fields</function> 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 <function>mysql_field_flags</function>, <function>mysql_field_len</function>, <function>mysql_field_name</function>, és a <function>mysql_field_type</function> függvényekkel hámozhatsz meg. </para> <para> - 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 - <literal>$phperrmsg</literal> változóban található, és ha nem - <literal>@mysql()</literal> <- í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...]. - </para> - <para> <example> <title><function>mysql_list_fields</function> példa</title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect('localhost', 'nevem', 'titok'); $mezo = mysql_list_fields("adatbázis1", "tabla1", $link); $oszlop = mysql_num_fields($mezo); -for ($i = 0; $i < $oszlop; $i++) { +for ($i = 0; $i < $oszlop; $i++) { echo mysql_field_name($mezo, $i) . "\n";; } +]]> </programlisting> - </example> - </para> - <para> - A fenti példa az alábbi kimenetet eredményezi: - <informalexample> - <programlisting> + <para> + A fenti példa az alábbi kimenetet eredményezi: + <screen> +<![CDATA[ mezo1 mezo2 mezo3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Kompatíbilitási okokból a <function>mysql_listfields</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1470,25 +1615,25 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_list_tables</function></funcdef> + <funcdef>resource <function>mysql_list_tables</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_list_tables</function> függvény veszi az adatbázisnevet, és egy eredmény-mutatót ad vissza, a <function>mysql_db_query</function> függvényhez hasonlóan. A - <function>mysql_tablename</function> függvény használható arra, hogy az - eredmény-mutatóból a tényleges táblaneveket megállapítsd. + <function>mysql_tablename</function> 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. </para> <para> Kompatíbilitási okokból a <function>mysql_listtables</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1503,22 +1648,22 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_num_fields</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_num_fields</function> függvény az eredményhalmazban levõ mezõk számát adja vissza. </para> - <para> - Lásd még a + <para> + Lásd még a <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function> és a <function>mysql_num_rows</function> függvényeket!</para> <para> Kompatíbilitási okokból a <function>mysql_numfields</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1533,7 +1678,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_num_rows</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1543,38 +1688,39 @@ számát szeretnéd megtudni, használd a DELETE, use <function>mysql_affected_rows</function> függvényt! <example> - <title> - <function> - mysql_num_rows példa Szerzõ: crubel@trilizio.org - </function> - </title> + <title><function>mysql_num_rows</function> példa</title> <programlisting role="php"> -<?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"; -?> +<![CDATA[ +<?php +$conn = mysql_connect("mlabdial", "juzer", "jelszo"); +mysql_select_db("adatbázis",$conn); + +$eredmeny = mysql_query("SELECT * FROM tabla1", $conn); +$sorok_szama = mysql_num_rows($eredmeny); + +echo "$sorok_szama sor van"; +?> +]]> </programlisting> </example> </para> <para> - Lásd még a - <function>mysql_db_query</function>, - <function>mysql_query</function> és a - <function>mysql_fetch_row</function> függvényeket! + Lásd még a + <function>mysql_affected_rows</function>, + <function>mysql_connect</function>, + <function>mysql_select_db</function> és a + <function>mysql_query</function> függvényeket! </para> <para> - Kompatíbilitási okokból a <function>mysql_numrows</function> can - also be used. + Kompatíbilitási okokból a <function>mysql_numrows</function> függvény is + használható, de nem javasolt. </para> </refsect1> </refentry> <refentry id="function.mysql-pconnect"> <refnamediv> - <refname>mysql_pconnect</refname> + <refname>mysql_pconnect</refname> <refpurpose> Perzisztens kapcsolatot nyit meg a MySQL szerverhez </refpurpose> @@ -1583,38 +1729,33 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_pconnect</function></funcdef> - <paramdef>string + <funcdef>resource <function>mysql_pconnect</function></funcdef> + <paramdef>string <parameter> - <optional>hostname - <optional>:port</optional> - <optional>:/path/to/socket</optional> - </optional> + <optional>server</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>username</optional></parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>password</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> 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. </para> <para> A <function>mysql_pconnect</function> függvény létrehoz egy kapcsolatot a MySQL szerverhez. Az elhagyott paraméterek az alábbi értékeket veszik - fel: - <parameter>host:port</parameter> = - 'localhost:3306', <parameter>username</parameter> = annak a - felhasználónak a neve, akié a szerver folyamat és végül: - <parameter>password</parameter> = üres jelszó. + fel: <parameter>server</parameter> = 'localhost:3306', + <parameter>username</parameter> = annak a felhasználónak a neve, akié a + szerver folyamat és végül: <parameter>password</parameter> = üres jelszó. </para> <para> - A <parameter>hostname</parameter> karakterlánc a port számát is + A <parameter>server</parameter> 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. </para> </note> - </para> + </para> <para> A <function>mysql_pconnect</function> függvény a <function>mysql_connect</function> függvényhez hasonlóan mûködik, csupán két nagyobb különbség van: </para> - <para> + <para> 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. </para> - <para> + <para> 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 <function>mysql_close</function> függvény nem fogja neked lezárni a <function>mysql_pconnect</function> függvénnyel megnyitott kapcsolatokat). </para> - <para> + <para> Az ilyen típusú kapcsolatot ezért hívják 'perzisztensnek'. </para> + <note> + <para> + Ügyelj rá, hogy ezek a fajta kapcsolatok csak a PHP betölthetõ modulos + változatában mûködnek. Lást a + <link linkend="features.persistent-connections">Perzisztens Adatbázis + Kapcsolatok</link> fejezetet további információkért! </refsect1> </refentry> @@ -1660,14 +1807,14 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_query</function></funcdef> + <funcdef>resource <function>mysql_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_query</function> függvény kérést küld a megadott kapcsolat-azonosítójú szerver aktív adatbázisához. Ha nem adsz meg <parameter>link_identifier</parameter>-t, akkor a @@ -1678,49 +1825,55 @@ </para> <note> <para> - A kérésnek nem szabad pontosvesszõre végzõdnie. + A kérésnek nem szabad pontosvesszõvel végzõdnie. </para> </note> <para> - A <function>mysql_query</function> 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 <function>mysql_query</function> 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 <function>mysql_query</function> 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. </para> <para> - A következõ kérés szintaktikailag rossz, igy a - <function>mysql_query</function> függvény meghiúsul és FALSE eredményt + A következõ kérés szintaktikailag rossz, igy a + <function>mysql_query</function> függvény meghiúsul és &false; eredményt ad: <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $eredmeny = mysql_query ("SELECT * WHERE 1=1") or die ("Érvénytelen lekérdezés"); ?> +]]> </programlisting> </example> </para> <para> - Az alábbi kérés szemantikailag helytelen, ha nincs - <literal>my_col</literal> nevû oszlop a + Az alábbi kérés szemantikailag helytelen, ha nincs + <literal>my_col</literal> nevû oszlop a <literal>my_tbl</literal> nevû táblában, így a - <function>mysql_query</function> meghiúsul és FALSE értékkel tér vissza. + <function>mysql_query</function> meghiúsul és &false; értékkel tér vissza. <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $eredmeny = mysql_query ("SELECT my_col FROM my_tbl") or die ("Érvénytelen kérés"); ?> +]]> </programlisting> </example> </para> <para> - A <function>mysql_query</function> függvény akkor is meghiúsul és FALSE + A <function>mysql_query</function> 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. </para> @@ -1732,24 +1885,73 @@ sort érintett a DELETE, NSERT, REPLACE vagy UPDATE kérésed. </para> <para> - SELECT kérés esetében a <function>mysql_query</function> függvény - egy új eredmény-azonosítót ad vissza, amit késõbb a - <function>mysql_result</function> függvénnyel használhatsz. - Ha az eredményre már nincs szükség és memóriafóbiád van, akkor a - <function>mysql_free_result</function> 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 <function>mysql_query</function> függvény egy új + eredmény-azonosítót ad vissza, amit késõbb a + <function>mysql_fetch_array</function> 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 <function>mysql_free_result</function> + 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. </para> <para> - Lásd még a <function>mysql_affected_rows</function>, + Lásd még a <function>mysql_num_rows</function>, + <function>mysql_affected_rows</function>, <function>mysql_db_query</function>, + <function>mysql_unbuffered_query</function>, <function>mysql_free_result</function>, + <function>mysql_fetch_array</function>, + <function>mysql_fetch_row</function>, + <function>mysql_fetch_assoc</function>, <function>mysql_result</function>, <function>mysql_select_db</function> és a <function>mysql_connect</function> függvényeket! </para> </refsect1> </refentry> + <refentry id="function.mysql-unbuffered-query"> + <refnamediv> + <refname>mysql_unbuffered_query</refname> + <refpurpose> + SQL kérést küld küld a MySQL-nek anélkül, hogy az eredményt + elõfeldolgozná. + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>mysql_unbuffered_query</function></funcdef> + <paramdef>string <parameter>query</parameter></paramdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_unbuffered_query</function> függvény a + <parameter>query</parameter> SQL kérést küldi a MySQL-nek anélkül, hogy + bármi módon betöltené, vagy pufferelni, mint azt a + <function>mysql_query</function> 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 + <parameter>link_identifier</parameter> paraméterben, hogy melyik + kapcsolatra vonatkozik a kérés. + </para> + <note> + <para> + A <function>mysql_unbuffered_query</function> függvénynek az a hátránya, + hogy nem használhatod a <function>mysql_num_rows</function> 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. + </para> + </note> + <para> + Lásd még a <function>mysql_query</function>függvényt! + </para> + </refsect1> <refentry id="function.mysql-result"> <refnamediv> @@ -1761,9 +1963,9 @@ <funcsynopsis> <funcprototype> <funcdef>mixed <function>mysql_result</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> @@ -1794,7 +1996,7 @@ </para> <para> Ajánlott az alábbi, gyors [és programozóbarát] függvények használata: - <function>mysql_fetch_row</function>, + <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> és <function>mysql_fetch_object</function>. </para> @@ -1810,19 +2012,19 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_select_db</function></funcdef> + <funcdef>bool <function>mysql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> - Visszatérési érték: true, ha sikeres; false ha hiba történt. + <para> + &return.success; </para> - <para> + <para> A <function>mysql_select_db</function> 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. </para> <para> Lásd még a - <function>mysql_connect</function>, + <function>mysql_connect</function>, <function>mysql_pconnect</function> és a <function>mysql_query</function> függvényeket! </para> <para> Kompatíbilitási okokból a <function>mysql_selectdb</function> - függvény is használható. + függvény is használható, de használata nem ajánlott. </para> </refsect1> </refentry> @@ -1856,11 +2058,11 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_tablename</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_tablename</function> függvény veszi a <function>mysql_list_tables</function> függvény által visszaadott eredmény-mutatót és egy indexet, majd megmondja az oszlophoz tartozó @@ -1870,22 +2072,133 @@ <example> <title><function>Mysql_tablename</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("localhost:3306"); $eredmeny = mysql_list_tables ("wisconsin"); $i = 0; -while ($i < mysql_num_rows ($eredmeny)) { - $tb_names[$i] = mysql_tablename ($eredmeny, $i); - echo $tb_names[$i] . "<BR>"; +while ($i < mysql_num_rows ($eredmeny)) { + $tb_nevek[$i] = mysql_tablename ($eredmeny, $i); + echo $tb_nevek[$i] . "<BR>"; $i++; } ?> +]]> </programlisting> </example> </para> </refsect1> </refentry> + <refentry id="function.mysql-get-client-info"> + <refnamediv> + <refname>mysql_get_client_info</refname> + <refpurpose>MySQL kliens információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mysql_get_client_info</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_client_info</function> függvény a kliensprogram + által használt könyvtár verziójáról ad információt. + </para> + <para> + A <function>mysql_get_client_info</function> függvény a PHP 4.0.5-ös + verziójában került a nyelvbe. + </para> + </refsect1> + </refentry> + + <refentry id="function.mysql-get-host-info"> + <refnamediv> + <refname>mysql_get_host_info</refname> + <refpurpose>MySQL kiszolgáló információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mysql_get_host_info</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_host_info</function> függvény egy karakterlánccal + tér vissza, ami a <parameter>link_identifier</parameter> által használt + kapcsolatról ad információt, például a kiszolgáló gép nevét. Ha a + <parameter>link_identifier</parameter> paramétert elhagyjuk, akkor a + legutóbb megnyitott kapcsolatról kapunk információt. + </para> + <para> + A <function>mysql_get_host_info</function> függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + </para> + </refsect1> + </refentry> + + <refentry id="function.mysql-get-proto-info"> + <refnamediv> + <refname>mysql_get_proto_info</refname> + <refpurpose>MySQL protokoll információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mysql_get_proto_info</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_proto_info</function> függvény a + <parameter>link_identifier</parameter> által használt protokoll verzióját + adja vissza. Ha a <parameter>link_identifier</parameter> paramétert nem + adod meg, akkor az utoljára használt kapcsolatról kapsz információt. + </para> + <para> + <function>mysql_get_proto_info</function> függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + </para> + </refsect1> + </refentry> + + <refentry id="function.mysql-get-server-info"> + <refnamediv> + <refname>mysql_get_server_info</refname> + <refpurpose>MySQL szerver információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mysql_get_server_info</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_server_info</function> függvény a + <parameter>link_identifier</parameter>-ban megadott kapcsolat + által használt szerver verzióját adja. Ha nincs megadva + <parameter>link_identifier</parameter>, akkor az utoljára használt + kapcsolatról kapsz információt. + </para> + <para> + A <function>mysql_get_server_info</function> függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file @@ -1904,4 +2217,7 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml lcs=tab\:>-,trail\:- +vi: ts=1 sw=1 list -->
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 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.35 Maintainer: kgergely Status: ready --> +<!-- EN-Revision: 1.76 Maintainer: kgergely Status: ready --> <reference id="ref.mysql"> <title>MySQL függvények</title> @@ -7,13 +7,13 @@ <partintro> <simpara> 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 <option role="configure">--with-mysql</option> 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 <option role="configure">--with-mysql=/path/to/mysql</option> 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 <ulink url="&url.mysql.docs;">&url.mysql.docs;</ulink>. </simpara> + <para> + 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. + <example> + <title>MySQL modul áttekintõ példa</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Csatlakozás, adatbázis kiválasztása +$kapcsolat = mysql_connect("mysql_hoszt", "mysql_azonosito", "mysql_jelszo") + or die("Nem tudok csatlakozni"); +print "A kapcsolódás sikerül"; +mysql_select_db("az_en_adatbazisom") + or die("Nem sikerült kiválasztanom az adatbázist"); + +// SQL kérés végrehajtása +$keres = "SELECT * FROM az_en_tablam"; +$eredmeny = mysql_query($keres) or die("Hiba a kérésben"); + +// Az eredmény kiírása HTML-ben +print "<table>\n"; +while ($line = mysql_fetch_array($eredmeny, MYSQL_ASSOC)) { + print "\t<tr>\n"; + foreach ($sor as $egy_oszlop) { + print "\t\t<td>$egy_oszlop</td>\n"; + } + print "\t</tr>\n"; +} +print "</table>\n"; +// Kapcsolat lezárása +mysql_close($kapcsolat); +?> +]]> + </programlisting> + </example> + </para> </partintro> <refentry id="function.mysql-affected-rows"> <refnamediv> - <refname>mysql_affected_rows</refname> + <refname>mysql_affected_rows</refname> <refpurpose>Az elõzõ MySQL mûveletben érintett sorok számát adja meg</refpurpose> </refnamediv> @@ -40,23 +77,24 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_affected_rows</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_affected_rows</function> 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. + <parameter>link_identifier</parameter>-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ó + <function>mysql_connect</function>-tel megnyitott kapcsolatról kapsz + információt. </para> <note> <para> - Ha transzakciókezelést hasznnálsz, akkor a + Ha transzakciókezelést használsz, akkor a <function>mysql_affected_rows</function> függvényt az INSERT, UPDATE, vagy DELETE kérés után közvetlenül, nem a kommit után kell meghívni. </para> @@ -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. </para> + <note> + <para> + 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 + <function>mysql_affected_rows</function> függvény nem pont az egyezõ + sorok számát adja vissza, hanem csak a ténylegesen megváltoztatott sorok + számát. + </para> + </note> <para> - 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 <function>mysql_num_rows</function> függvényt. </para> <para> - 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. + </para> + <para> + Lásd még a<function>mysql_num_rows</function> függvényt! </para> </refsect1> </refentry> <refentry id="function.mysql-change-user"> <refnamediv> - <refname>mysql_change_user</refname> + <refname>mysql_change_user</refname> <refpurpose> Aktív kapcsolat felhasználójának módosítása </refpurpose> @@ -91,27 +141,33 @@ <funcdef>int <function>mysql_change_user</function></funcdef> <paramdef>string <parameter>user</parameter></paramdef> <paramdef>string <parameter>password</parameter></paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>database</optional> </parameter> </paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_change_user</function> 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.</para> - <note><para>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. - </para></note> + aktuális, vagy az opcionális <parameter>link_identifier</parameter> + 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. + </para> + <note> + <para> + 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. + </para> + </note> </refsect1> </refentry> @@ -124,16 +180,16 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_close</function></funcdef> - <paramdef>int + <funcdef>bool <function>mysql_close</function></funcdef> + <paramdef>resource <parameter> - <optional>link_identifier</optional> + <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - A függvény értéke igaz, ha a mûvelet sikerült, hamis, ha nem. + &return.success; </para> <para>A <function>mysql_close</function> függvény bezárja az adott azonosítójú MySQL kapcsolatot. Ha nem adsz meg @@ -143,26 +199,31 @@ <para> A <function>mysql_close</function> 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: + <link linkend="language.types.resource.self-destruct">erõforrások + felszabadítása</link> </para> <note> - <para> + <para> A <function>mysql_close</function> függvény nem zárja be a - <function>mysql_pconnect</function> függvénnyel megnyitott kapcsolatokat. + <function>mysql_pconnect</function> függvénnyel megnyitott + kapcsolatokat. </para> </note> <example> <title>MySQL close példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_connect ("kraemer", "marliesle", "titok") or die ("Nem lehet csatlakozni"); print ("A csatlakozás sikerült"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> - <para> + <para> Lásd még a <function>mysql_connect</function> és a <function>mysql_pconnect</function> függvényeket! </para> @@ -178,44 +239,41 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_connect</function></funcdef> - <paramdef>string + <funcdef>resource <function>mysql_connect</function></funcdef> + <paramdef>string <parameter> - <optional>hostname - <optional>:port</optional> - <optional>:/path/to/socket</optional> - </optional> + <optional>server</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>username</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter> <optional>password</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> - 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. + <para> + Pozitív MySQL azonosítóval tér vissza, ha a csatlakozás sikerült, + &false;-sal ha nem. </para> <para> A <function>mysql_connect</function> függvény kapcsolatot nyit meg egy MySQL szerverhez. A paramétereket elhagyhatod. Az alapértelmezett - értékek: <parameter>host:port</parameter> = 'localhost:3306', + értékek: <parameter>server</parameter> = 'localhost:3306', <parameter>username</parameter> = a folyamat tulajdonosának belépési neve <parameter>password</parameter> = üres karakterlánc. </para> <para> - 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 <parameter>server</parameter> 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. <note> <para> A ":port" formátumú kiegészítés a PHP 3.0B4-es változatában @@ -239,20 +297,22 @@ <para> A kapcsolat a PHP program végén bezárul, ha elõbb nem zártuk volna le a <function>mysql_close</function> függvénnyel. - </para> + </para> <example> <title>MySQL connect példa</title> <programlisting role="php"> -<?php - $link = mysql_connect ("kraemer", "marliesle", "titok") +<![CDATA[ +<?php + $link = mysql_connect ("localhost", "felhasználónév", "titok") or die ("Nem lehet csatlakozni"); print ("A csatlakozás sikerült"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> <para> Lásd még a - <function>mysql_pconnect</function> és + <function>mysql_pconnect</function> és a <function>mysql_close</function> függvényeket. </para> </refsect1> @@ -267,23 +327,27 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_create_db</function></funcdef> + <funcdef>bool <function>mysql_create_db</function></funcdef> <paramdef>string <parameter>database name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_create_db</function> függvény megkísérel létrehozni egy új adatbázist a megadott kapcsolatazonosítón keresztül. </para> + <para> + &return.success; + </para> <example> <title>MySQL 'create database' példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("kron", "jutta", "geheim") or die ("Nem lehet csatlakozni") if (mysql_create_db ("my_db")) { @@ -291,14 +355,15 @@ } else { printf ("Hiba az adatbázis létrehozásakor: %s\n", mysql_error ()); } -?> +?> +]]> </programlisting> </example> - <para> + <para> Kompatíbilitási okokból a <function>mysql_createdb</function> függvény is - használható. + használható, de nem javasolt. </para> - <para> + <para> Lásd még a: <function>mysql_drop_db</function> függvényt. </para> </refsect1> @@ -313,30 +378,30 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_data_seek</function></funcdef> - <paramdef>int <parameter>result_identifier</parameter></paramdef> + <funcdef>bool <function>mysql_data_seek</function></funcdef> + <paramdef>resource <parameter>result_identifier</parameter></paramdef> <paramdef>int <parameter>row_number</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Igazzal tér vissza, ha a mûvelet sikerült + <para> + &return.success; </para> - <para> + <para> A <function>mysql_data_seek</function> függvény az adott azonosítójú - ereményhalmazban ugrik a megadott pozícióra. - A <function>mysql_fetch_row</function> függvény következõ hívásakor ezt a + ereményhalmazban ugrik a megadott pozícióra. A + <function>mysql_fetch_row</function> függvény következõ hívásakor ezt a sorszámú sort kapod meg. </para> <para> Ha az elsõ sorra akarsz pozicionálni, akkor <parameter>Row_number</parameter> 0 legyen! </para> - <example> <title>MySQL data seek példa</title> <programlisting role="php"> -<?php - $link = mysql_pconnect ("kron", "jutta", "geheim") +<![CDATA[ +<?php + $link = mysql_pconnect ("weblabor", "kgergely", "titok") or die ("Nem tudok csatlakozni"); mysql_select_db ("samp_db") @@ -346,22 +411,23 @@ $eredmeny = mysql_query ($query) or die ("Rossz kérés"); - # fetch rows in reverse order + // fetch rows in reverse order for ($i = mysql_num_rows ($eredmeny) - 1; $i >=0; $i--) { if (!mysql_data_seek ($eredmeny, $i)) { - printf ("Nem tudok a %d. sorra ugorni\n", $i); + echo ("Nem tudok a $i. sorra ugorni\n"); continue; } if(!($sor = mysql_fetch_object ($eredmeny))) continue; - printf ("%s %s<BR>\n", $sor->last_name, $sor->first_name); + echo "$sor->vezeteknev $sor->keresztnev<br />\n"); } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -376,34 +442,31 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_db_name</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <funcdef>string <function>mysql_db_name</function></funcdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_db_name</function> függvény elsõ paramétere egy <function>mysql_list_dbs</function> által visszaadott érték. A <parameter>row</parameter> paraméter az eredményhalmaz indexe. </para> - <para> - Ha hiba történt, a függvény FALSE-szal tér vissza. - Használd a - <function>mysql_errno</function> és a - <function>mysql_error</function> 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 + <function>mysql_errno</function> és a <function>mysql_error</function> + függvényeket a hiba eredetének megállapítására! </para> - <example> <title><function>Mysql_db_name</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php error_reporting(E_ALL); mysql_connect('dbhost', 'név', 'jelszó'); @@ -411,19 +474,18 @@ $i = 0; $cnt = mysql_num_rows($db_list); -while ($i < $cnt) { +while ($i < $cnt) { echo mysql_db_name($db_list, $i) . "\n"; $i++; } -?> +?> +]]> </programlisting> </example> - <para> Kompatíbilitási okokból a <function>mysql_dbname</function> függvény is használható, de használata nem javasolt. </para> - </refsect1> </refentry> @@ -436,33 +498,40 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_db_query</function></funcdef> + <funcdef>resource <function>mysql_db_query</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> 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. </para> - <para> + <para> A <function>mysql_db_query</function> 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 <function>mysql_connect</function> függvényt paraméterek nélkül. </para> - <para> - Lásd még a <function>mysql_connect</function> függvényt. + <para> + Lásd még a <function>mysql_connect</function> és a + <function>mysql_query</function> függvényeket. </para> <para> - Kompatíbilitási okokból a <function>mysql</function> függvény is - használható. + <note> + <simpara> + 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 + <function>mysql_select_db</function> és a + <function>mysql_query</function> függvényeket. + </simpara> + </note> </para> </refsect1> </refentry> @@ -476,41 +545,45 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_drop_db</function></funcdef> + <funcdef>bool <function>mysql_drop_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> - Visszatérési értéke: igaz, ha sikeres, hamis, ha nem - </para> - <para> + <para> + &return.success; + </para> + <para> A <function>mysql_drop_db</function> függvény megpróbálja az egész adatbázist kitörölni, melyet az adott kapcsolat-azonosító határoz meg. </para> - <para> - Lásd még a <function>mysql_create_db</function> függvényt. + <para> Kompatíbilitási okokból <function>mysql_dropdb</function> 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. + </para> + <para> + Lásd még a <function>mysql_create_db</function> függvényt! </para> </refsect1> </refentry> <refentry id="function.mysql-errno"> <refnamediv> - <refname>mysql_errno</refname> - <refpurpose>Az elõzõ MySQL mûvelet hibakódját tartalmazza</refpurpose> + <refname>mysql_errno</refname> + <refpurpose> + Az elõzõ MySQL mûvelet hibakódját tartalmazza + </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_errno</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -522,30 +595,32 @@ sikeres volt, akkor <literal>0</literal>-t (nullát) ad vissza. </para> <para> - 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 - <function>mysql_errno</function> függvényt! - Ez a függvény csak az utolsó MySQL mûvelet hibakódját adja vissza + <function>mysql_errno</function> függvényt! Ez a függvény csak az utolsó + MySQL mûvelet hibakódját adja vissza [(not including <function>mysql_error</function> and <function>mysql_errno</function>)], 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. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect("marliesle"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("nonexistentdb"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM nonexistenttable"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> - <para> + <para> Lásd még a <function>mysql_error</function> függvényt </para> </refsect1> @@ -554,14 +629,16 @@ <refentry id="function.mysql-error"> <refnamediv> <refname>mysql_error</refname> - <refpurpose>Az elõzõ MySQL mûvelet hibaszövegét adja</refpurpose> + <refpurpose> + Az elõzõ MySQL mûvelet hibaszövegét adja + </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_error</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -573,38 +650,71 @@ <literal>''</literal> (üres karakterlánccal) ha nem volt hiba. </para> <para> - 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 <function>mysql_error</function> függvényt! Ez a függvény csak az utolsó MySQL mûvelet hibakódját adja vissza [(not including <function>mysql_error</function> and - <function>mysql_errno</function>)], ha használni szeretnéd, ügyelj rá, + <function>mysql_errno</function>)], + 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. <informalexample> <programlisting role="php"> -<?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>"; -?> +<![CDATA[ +<?php +mysql_connect("mcl"); +echo mysql_errno().": ".mysql_error()."<BR>"; +mysql_select_db("nemletezoadatbazis"); +echo mysql_errno().": ".mysql_error()."<BR>"; +$conn = mysql_query("SELECT * FROM nemletezotabla"); +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> - <para> + <para> Lásd még a <function>mysql_errno</function> függvényt! </para> </refsect1> </refentry> + <refentry id="function.mysql-escape-string"> + <refnamediv> + <refname>mysql_escape_string</refname> + <refpurpose> + Egy karakerláncban szereplõ speciális karakterek értelmezését szünteti + meg. + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mysql_escape_string</function></funcdef> + <paramdef>string <parameter>unescaped_string</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A függvény az <parameter>unescaped_string</parameter> karakterláncot + átalakítja úgy, hogy az biztonságosan elhelyezhetõ legyen egy + <function>mysql_query</function> függvényben. + </para> + <note> + <simpara> + A <function>mysql_escape_string</function> függvény nem nyúl a + <literal>%</literal> és a <literal>_</literal> jelekhez. + </simpara> + </note> + </refsect1> + </refentry> + <refentry id="function.mysql-fetch-array"> <refnamediv> - <refname>mysql_fetch_array</refname> + <refname>mysql_fetch_array</refname> <refpurpose> Kérés egy sorát adja vissza (tetszõleges) tömb formájában. </refpurpose> @@ -614,7 +724,7 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_array</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter> <optional>result_type</optional> @@ -622,8 +732,8 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> - Az eredmény következõ sorával tér vissza tömb formájában, vagy hamissal, + <para> + 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.</para> <para> A <function>mysql_fetch_array</function> 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 <literal>'field'</literal> + használatával). <informalexample> - <programlisting> -select t1.f1 as ize t2.f1 as bigyo from t1, t2 + <programlisting role="sql"> +<![CDATA[ +select tik.f1 as ize tak.f1 as bigyo from tik, tak +]]> </programlisting> </informalexample> </para> <para> Jó tudni, hogy a <function>mysql_fetch_array</function> függvény - használata NEM jelentõsen lassabb a <function>mysql_fetch_row</function> - használatánál, de a kapott eredmény feldolgozása jóval kényelmesebb. + használata <emphasis>nem jelentõsen</emphasis> lassabb a + <function>mysql_fetch_row</function> használatánál, de a kapott eredmény + feldolgozása jóval kényelmesebb. </para> <para> A <function>mysql_fetch_array</function> függvény elhagyható <parameter>result_type</parameter> 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. </para> <para> - További részletekért olvasd még a - <function>mysql_fetch_row</function> és a - <function>mysql_fetch_assoc</function> 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 + <function>mysql_fetch_assoc</function> függvénnyel), MYSQL_NUM értékkel + meghívva a fügvényt számozott indexû tömböt kapsz (mint a + <function>mysql_fetch_row</function> függvénnyel). + </para> + <para> + További részletekért olvasd még a <function>mysql_fetch_row</function> és + a <function>mysql_fetch_assoc</function> függvényeket! </para> <example> - <title><function>Mysql_fetch_array</function></title> + <title><function>Mysql_fetch_array</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo); $eredmeny = mysql_db_query ("adatbázis","select user_id, teljesnev from table"); while ($sor = mysql_fetch_array ($eredmeny)) { - echo "user_id: ".$sor["user_id"]."<br>\n"; - echo "user_id: ".$sor[0]."<br>\n"; - echo "fullname: ".$sor["fullname"]."<br>\n"; - echo "fullname: ".$sor[1]."<br>\n"; + echo "felhasznalonev: ".$sor["felhasznalonev"]."<br>\n"; + echo "felhasznalonev: ".$sor[0]."<br>\n"; + echo "nev: ".$sor["nev"]."<br>\n"; + echo "nev: ".$sor[1]."<br>\n"; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -679,7 +804,7 @@ <refentry id="function.mysql-fetch-assoc"> <refnamediv> - <refname>mysql_fetch_assoc</refname> + <refname>mysql_fetch_assoc</refname> <refpurpose> Az eredmény egy sorát asszociatív tömbként adja vissza. </refpurpose> @@ -689,27 +814,30 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_assoc</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> Az eredmény következõ sorával, mint asszociatív tömbbel tér vissza, vagy - hamissal, ha nincs több sor.</para> + &false;-sal, ha nincs több sor. + </para> <para> A <function>mysql_fetch_assoc</function> függvény hívásával ugyanazt érjük el, mintha a <function>mysql_fetch_array</function> 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 <function>mysql_fetch_array</function> függvény így mûködött. Ha a számokkal indexelt elemekre is szükséged van, akkor használd a <function>mysql_fetch_array</function> függvényt. </para> <para> - 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 - <function>mysql_fetch_array</function> 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 + <function>mysql_fetch_array</function> függvény használatával, vagy az + SQL parancsban kérj aliast az oszlopra. Lásd még a + <function>mysql_fetch_array</function> függvénynél szereplõ példát az + aliasok leírásáért. </para> <para> Jó tudni, hogy a <function>mysql_fetch_assoc</function> függvény @@ -717,22 +845,23 @@ használatánál, de a kapott eredmény feldolgozása jóval kényelmesebb. </para> <para> - További részletekért lásd még a - <function>mysql_fetch_row</function> és a + További részletekért lásd még a <function>mysql_fetch_row</function> és a <function>mysql_fetch_array</function> függvényeket. </para> <example> - <title><function>Mysql_fetch_assoc</function></title> + <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo); $eredmeny = mysql_db_query ("adatbázis","select * from table"); while ($sor = mysql_fetch_assoc ($eredmeny)) { - echo $sor["user_id"]; - echo $sor["fullname"]; + echo $sor["felhasznalonev"]; + echo $sor["nev"]; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -750,8 +879,8 @@ <funcsynopsis> <funcprototype> <funcdef>object <function>mysql_fetch_field</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter>result</parameter></paramdef> + <paramdef>int <parameter> <optional>field_offset</optional> </parameter> @@ -760,113 +889,115 @@ </funcsynopsis> <para> Egy mezõinformációt tartalmazó objektummal tér vissza. - </para> + </para> <para> A <function>mysql_fetch_field</function> 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 - <function>mysql_fetch_field</function> függvényt. + amelyre még nem hívtad meg a <function>mysql_fetch_field</function> + függvényt. </para> <para> Az objektum tulajdonságai: <itemizedlist> <listitem> <simpara> - name - az oszlop neve + name - az oszlop neve </simpara> </listitem> <listitem> <simpara> - table - a tábla neve, amelyhez az oszlop tartozik + table - a tábla neve, amelyhez az oszlop tartozik </simpara> </listitem> <listitem> <simpara> - max_length - az oszlop maximális hossza + max_length - az oszlop maximális hossza </simpara> </listitem> <listitem> <simpara> - 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 </simpara> - </listitem> + </listitem> <listitem> <simpara> - primary_key - értéke 1, ha az oszlop elsõdleges kulcs + primary_key - értéke 1, ha az oszlop elsõdleges kulcs </simpara> - </listitem> + </listitem> <listitem> <simpara> - unique_key - értéke 1, ha az oszlop egyszerû kulcs + unique_key - értéke 1, ha az oszlop egyszerû kulcs </simpara> - </listitem> + </listitem> <listitem> <simpara> - multiple_key - értéke 1, ha az oszlop összetett kulcs része + multiple_key - értéke 1, ha az oszlop összetett kulcs része </simpara> - </listitem> + </listitem> <listitem> <simpara> - numeric - értéke 1, ha az oszlop szám + numeric - értéke 1, ha az oszlop szám </simpara> - </listitem> + </listitem> <listitem> <simpara> - blob - értéke 1, ha az oszlop BLOB típusú + blob - értéke 1, ha az oszlop BLOB típusú </simpara> </listitem> <listitem> <simpara> - type - az oszlop típusa + type - az oszlop típusa </simpara> </listitem> <listitem> <simpara> - unsigned - értéke 1, ha az oszlop nem elõjeles + unsigned - értéke 1, ha az oszlop nem elõjeles </simpara> </listitem> <listitem> <simpara> - zerofill - értéke 1, ha az oszlop nullával feltöltött + zerofill - értéke 1, ha az oszlop nullával feltöltött </simpara> </listitem> </itemizedlist> </para> <example> - <title><function>Mysql_fetch_field</function></title> + <title><function>mysql_fetch_field</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo) or die ("Nem lehet csatlakozni az adatbázishoz"); $eredmeny = mysql_db_query ("adatbázis", "select * from table") or die ("Hibás kérés"); # oszlopinformáció lekérése $i = 0; -while ($i < mysql_num_fields ($eredmeny)) { - echo "Információ a $i. oszlopról:<BR>\n"; +while ($i < mysql_num_fields ($eredmeny)) { + echo "Információ a $i. oszlopról:<BR>\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<BR>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 "<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>"; $i++; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> <para> @@ -877,7 +1008,7 @@ <refentry id="function.mysql-fetch-lengths"> <refnamediv> - <refname>mysql_fetch_lengths</refname> + <refname>mysql_fetch_lengths</refname> <refpurpose> Az eredmény oszlopainak hosszáról nyújt információt </refpurpose> @@ -887,22 +1018,23 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_lengths</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> Egy tömbbel tér vissza. A tömb elemei az utolsó <function>mysql_fetch_row</function> függvény által betöltött oszlopok - hosszait tartalmazza, vagy hiba esetén hamisat. - </para> + hosszait tartalmazza. Hiba esetén &false; értékkel tér vissza. + </para> <para> A <function>mysql_fetch_lengths</function> függvény a <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> vagy a - <function>mysql_fetch_object</function> által betöltött sor hosszait adja - vissza számmal indexelt tömb formájában. - </para> - <para> + <function>mysql_fetch_object</function> által visszaadott + eredmény-oszlopok hosszát tárolja, illetve megmondja + számmal indexelt tömb formájában. + </para> + <para> Lásd még a <function>mysql_fetch_row</function> függvényt! </para> </refsect1> @@ -911,15 +1043,16 @@ <refentry id="function.mysql-fetch-object"> <refnamediv> <refname>mysql_fetch_object</refname> - <refpurpose>Az eredmény következõ sorát objektum formájában adja - vissza</refpurpose> + <refpurpose> + Az eredmény következõ sorát objektum formájában adja vissza + </refpurpose> </refnamediv> <refsect1> <title>Leírás</title> <funcsynopsis> <funcprototype> <funcdef>object <function>mysql_fetch_object</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter> <optional>result_type</optional> @@ -927,21 +1060,23 @@ </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> 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. </para> - <para> + <para> A <function>mysql_fetch_object</function> függvény hasonló a <function>mysql_fetch_array</function> 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. </para> <para> Az elhagyható <parameter>result_type</parameter> 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 + <function>mysql_fetch_array</function> függvényt, ha kíváncsi vagy az + állandók leírására. </para> <para> Sebesség szempontjából a <function>mysql_fetch_array</function> @@ -951,7 +1086,8 @@ <example> <title><function>mysql_fetch_object</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ($host, $felhasznalo, $jelszo); $eredmeny = mysql_db_query ("adatbázis", "select * from table"); while ($sor = mysql_fetch_object ($eredmeny)) { @@ -959,12 +1095,13 @@ echo $sor->fullname; } mysql_free_result ($eredmeny); -?> +?> +]]> </programlisting> </example> </para> - <para> - Lásd még a <function>mysql_fetch_array</function> és a + <para> + Lásd még a <function>mysql_fetch_array</function> és a <function>mysql_fetch_row</function> függvényt! </para> </refsect1> @@ -981,10 +1118,10 @@ <funcsynopsis> <funcprototype> <funcdef>array <function>mysql_fetch_row</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> Egy számmal indexelt tömbbel tér vissza, ami a betöltött sorokat tartalmazza, vagy hamissal, ha nincs több sor. </para> @@ -996,13 +1133,13 @@ <para> A <function>mysql_fetch_row</function> 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. </para> <para> Lásd még a <function>mysql_fetch_array</function>, <function>mysql_fetch_object</function>, <function>mysql_data_seek</function>, - <function>mysql_fetch_lengths</function> és a + <function>mysql_fetch_lengths</function> és a <function>mysql_result</function> függvényeket! </para> </refsect1> @@ -1020,11 +1157,11 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_flags</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_field_flags</function> 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 <function>explode</function> @@ -1035,16 +1172,16 @@ "unique_key", "multiple_key", "blob", "unsigned", "zerofill", "binary", "enum", "auto_increment", "timestamp". </para> - <para> + <para> Kompatíbilitási okokból a <function>mysql_fieldflags</function> függvény - is használható. + is használható, de nem javasolt. </para> </refsect1> </refentry> <refentry id="function.mysql-field-name"> <refnamediv> - <refname>mysql_field_name</refname> + <refname>mysql_field_name</refname> <refpurpose> Adott mezõ nevét adja vissza </refpurpose> @@ -1054,15 +1191,15 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_name</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_index</parameter></paramdef> </funcprototype> </funcsynopsis> <para> A <function>mysql_field_name</function> függvény az eredményben szereplõ megadott indexû mezõ nevét adja vissza. A <parameter>result</parameter> - paraméternek érvényes eredményazonosítónak kell lennie, - a <parameter>field_index</parameter> paraméter pedig a mezõ indexe. + paraméternek érvényes eredményazonosítónak kell lennie, a + <parameter>field_index</parameter> paraméter pedig a mezõ indexe. </para> <note> <para> @@ -1076,37 +1213,39 @@ <example> <title><function>mysql_field_name</function> példa</title> <programlisting role="php"> +<![CDATA[ // A felhasznalok tábla három mezõbõl áll: -// user_id +// azonosito // felhasznalonev // jelszo. -$res = mysql_db_query("felhasznalok", "select * from felhasznalok", $link); +$eredmeny = mysql_db_query("felhasznalok", "select * from felhasznalok", $link); -echo mysql_field_name($res, 0) . "\n"; -echo mysql_field_name($res, 2); +echo mysql_field_name($eredmeny, 0) . "\n"; +echo mysql_field_name($eredmeny, 2); +]]> </programlisting> - </example> - </para> - <para> - A fenti példa ay alábbi kimenetet eredményezi: - <informalexample> - <programlisting> -user_id + <para> + A fenti példa ay alábbi kimenetet eredményezi: + <screen> +<![CDATA[ +azonosito jelszo - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Kompatíbilitási okokból a <function>mysql_fieldname</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> <refentry id="function.mysql-field-len"> <refnamediv> - <refname>mysql_field_len</refname> + <refname>mysql_field_len</refname> <refpurpose> A kérdezett mezõ hosszát adja vissza </refpurpose> @@ -1116,7 +1255,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_field_len</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1126,7 +1265,7 @@ </para> <para> Kompatíbilitási okokból a <function>mysql_fieldlen</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1143,16 +1282,15 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_field_seek</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> <para> A megadott helyre mozgatja az eredmény-mutatót. Ha a következõ <function>mysql_fetch_field</function> függvényhívás nem tartalmaz mezõ - pozíciót, akkor a - <function>mysql_field_seek</function> függvény által visszaadott - mezõpozíciót fogja visszaadni. + pozíciót, akkor a <function>mysql_field_seek</function> függvény által + visszaadott mezõpozíciót fogja visszaadni. </para> <para> Lásd még a <function>mysql_fetch_field</function> függvényt! @@ -1172,17 +1310,17 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_table</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A függvény annak a táblának a nevével tér vissza, melyben a megadott mezõ szerepel. </para> <para> Kompatíbilitási okokból a <function>mysql_fieldtable</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1199,7 +1337,7 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_field_type</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>field_offset</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1213,7 +1351,8 @@ <example> <title>mysql mezõtípusok</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("localhost:3306"); mysql_select_db ("wisconsin"); @@ -1222,25 +1361,26 @@ $sor = mysql_num_rows ($eredmeny); $i = 0; $table = mysql_field_table ($eredmeny, $i); -echo "A '$table' nevû táblának $mezo mezõje és $sor sora van <BR>"; -echo "A táblának az alábbi mezõi vannak<BR>"; -while ($i < $mezo) { +echo "A '$table' nevû táblának $mezo mezõje és $sor sora van <BR>"; +echo "A táblának az alábbi mezõi vannak<BR>"; +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."<BR>"; $i++; } mysql_close(); ?> +]]> </programlisting> </example> </para> - <para> + <para> Kompatíbilitási okokból a <function>mysql_fieldtype</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1254,8 +1394,8 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_free_result</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <funcdef>bool <function>mysql_free_result</function></funcdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1269,8 +1409,11 @@ memória a php program végén úgyis felszabadul. </para> <para> + &return.success; + </para> + <para> Kompatíbilitási okokból a <function>mysql_freeresult</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1287,7 +1430,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_insert_id</function></funcdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -1299,13 +1442,12 @@ mûveletben szereplõ AUTO_INCREMENT tulajdonságú mezõ értékét adja vissza. Ha megadjuk <parameter>link_identifier</parameter>-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. </para> <para> A <function>mysql_insert_id</function> 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 <function>mysql_insert_id</function> <!-- - nem volt function tag --> + késõbb az értékre, hívd meg a <function>mysql_insert_id</function> függvényt rögtön az értéket generáló lekérdezés után! </para> <note> @@ -1317,12 +1459,12 @@ </note> <warning> <para> - A <function>mysql_insert_id</function> függvény a MySQL C API függvény - <literal>mysql_insert_id()</literal> visszatérési értékét - <literal>long</literal>-gá konvertálja. Ha az AUTO_INCREMENT mezõd - mondjuk BIGINT típusú, akkor a + A <function>mysql_insert_id</function> függvény a MySQL C API függvény + <literal>mysql_insert_id()</literal> visszatérési értékét + <literal>long</literal>-gá (PHP-ban ez az int) konvertálja. Ha az + AUTO_INCREMENT mezõd mondjuk BIGINT típusú, akkor a <function>mysql_insert_id</function> 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 <literal>LAST_INSERT_ID()</literal> MySQL függvényt használd! </para> </warning> @@ -1331,7 +1473,7 @@ <refentry id="function.mysql-list-dbs"> <refnamediv> - <refname>mysql_list_dbs</refname> + <refname>mysql_list_dbs</refname> <refpurpose> Kilistázza a MySQL szerveren elérhetõ adatbázisokat </refpurpose> @@ -1340,8 +1482,8 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_list_dbs</function></funcdef> - <paramdef>int + <funcdef>resource <function>mysql_list_dbs</function></funcdef> + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -1351,32 +1493,37 @@ <para> A <function>mysql_list_dbs</function> függvény egy eredménymutatót ad vissza, ami a mysql démontól elérhetõ adatbázisokat tartalmazza. - Használd a <function>mysql_tablename</function> függvényt, hogy az összes - táblát elérd! <!--vagy valami ilyesmi... --> + Használd a <function>mysql_tablename</function> 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! </para> <para> <example> <title><function>mysql_list_dbs</function> példa</title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect('localhost', 'nevem', 'titok'); $db_list = mysql_list_dbs($link); while ($sor = mysql_fetch_object($db_list)) { echo $sor->Database . "\n"; } +?> +]]> </programlisting> - </example> - </para> - <para> - A fenti példa az alábbi kimenetet eredményezi. - <informalexample> - <programlisting> + <para> + A fenti példa az alábbi kimenetet eredményezi. + <screen> +<![CDATA[ adatbázis1 adatbázis2 adatbázis3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <note> <para> @@ -1387,7 +1534,10 @@ </note> <para> Kompatíbilitási okokból a <function>mysql_listdbs</function> függvény - is használható. + is használható, de nem javasolt. + </para> + <para> + Lásd még a <function>mysql_db_name</function> függvényt! </para> </refsect1> </refentry> @@ -1401,10 +1551,10 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_list_fields</function></funcdef> + <funcdef>resource <function>mysql_list_fields</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> <paramdef>string <parameter>table_name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> @@ -1414,49 +1564,44 @@ <para> A <function>mysql_list_fields</function> 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 <function>mysql_field_flags</function>, <function>mysql_field_len</function>, <function>mysql_field_name</function>, és a <function>mysql_field_type</function> függvényekkel hámozhatsz meg. </para> <para> - 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 - <literal>$phperrmsg</literal> változóban található, és ha nem - <literal>@mysql()</literal> <- í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...]. - </para> - <para> <example> <title><function>mysql_list_fields</function> példa</title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect('localhost', 'nevem', 'titok'); $mezo = mysql_list_fields("adatbázis1", "tabla1", $link); $oszlop = mysql_num_fields($mezo); -for ($i = 0; $i < $oszlop; $i++) { +for ($i = 0; $i < $oszlop; $i++) { echo mysql_field_name($mezo, $i) . "\n";; } +]]> </programlisting> - </example> - </para> - <para> - A fenti példa az alábbi kimenetet eredményezi: - <informalexample> - <programlisting> + <para> + A fenti példa az alábbi kimenetet eredményezi: + <screen> +<![CDATA[ mezo1 mezo2 mezo3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Kompatíbilitási okokból a <function>mysql_listfields</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1470,25 +1615,25 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_list_tables</function></funcdef> + <funcdef>resource <function>mysql_list_tables</function></funcdef> <paramdef>string <parameter>database</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_list_tables</function> függvény veszi az adatbázisnevet, és egy eredmény-mutatót ad vissza, a <function>mysql_db_query</function> függvényhez hasonlóan. A - <function>mysql_tablename</function> függvény használható arra, hogy az - eredmény-mutatóból a tényleges táblaneveket megállapítsd. + <function>mysql_tablename</function> 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. </para> <para> Kompatíbilitási okokból a <function>mysql_listtables</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1503,22 +1648,22 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_num_fields</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_num_fields</function> függvény az eredményhalmazban levõ mezõk számát adja vissza. </para> - <para> - Lásd még a + <para> + Lásd még a <function>mysql_db_query</function>, <function>mysql_query</function>, <function>mysql_fetch_field</function> és a <function>mysql_num_rows</function> függvényeket!</para> <para> Kompatíbilitási okokból a <function>mysql_numfields</function> - függvény is használható. + függvény is használható, de nem ajánlott. </para> </refsect1> </refentry> @@ -1533,7 +1678,7 @@ <funcsynopsis> <funcprototype> <funcdef>int <function>mysql_num_rows</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1543,38 +1688,39 @@ számát szeretnéd megtudni, használd a DELETE, use <function>mysql_affected_rows</function> függvényt! <example> - <title> - <function> - mysql_num_rows példa Szerzõ: crubel@trilizio.org - </function> - </title> + <title><function>mysql_num_rows</function> példa</title> <programlisting role="php"> -<?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"; -?> +<![CDATA[ +<?php +$conn = mysql_connect("mlabdial", "juzer", "jelszo"); +mysql_select_db("adatbázis",$conn); + +$eredmeny = mysql_query("SELECT * FROM tabla1", $conn); +$sorok_szama = mysql_num_rows($eredmeny); + +echo "$sorok_szama sor van"; +?> +]]> </programlisting> </example> </para> <para> - Lásd még a - <function>mysql_db_query</function>, - <function>mysql_query</function> és a - <function>mysql_fetch_row</function> függvényeket! + Lásd még a + <function>mysql_affected_rows</function>, + <function>mysql_connect</function>, + <function>mysql_select_db</function> és a + <function>mysql_query</function> függvényeket! </para> <para> - Kompatíbilitási okokból a <function>mysql_numrows</function> can - also be used. + Kompatíbilitási okokból a <function>mysql_numrows</function> függvény is + használható, de nem javasolt. </para> </refsect1> </refentry> <refentry id="function.mysql-pconnect"> <refnamediv> - <refname>mysql_pconnect</refname> + <refname>mysql_pconnect</refname> <refpurpose> Perzisztens kapcsolatot nyit meg a MySQL szerverhez </refpurpose> @@ -1583,38 +1729,33 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_pconnect</function></funcdef> - <paramdef>string + <funcdef>resource <function>mysql_pconnect</function></funcdef> + <paramdef>string <parameter> - <optional>hostname - <optional>:port</optional> - <optional>:/path/to/socket</optional> - </optional> + <optional>server</optional> </parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>username</optional></parameter> </paramdef> - <paramdef>string + <paramdef>string <parameter><optional>password</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> 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. </para> <para> A <function>mysql_pconnect</function> függvény létrehoz egy kapcsolatot a MySQL szerverhez. Az elhagyott paraméterek az alábbi értékeket veszik - fel: - <parameter>host:port</parameter> = - 'localhost:3306', <parameter>username</parameter> = annak a - felhasználónak a neve, akié a szerver folyamat és végül: - <parameter>password</parameter> = üres jelszó. + fel: <parameter>server</parameter> = 'localhost:3306', + <parameter>username</parameter> = annak a felhasználónak a neve, akié a + szerver folyamat és végül: <parameter>password</parameter> = üres jelszó. </para> <para> - A <parameter>hostname</parameter> karakterlánc a port számát is + A <parameter>server</parameter> 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. </para> </note> - </para> + </para> <para> A <function>mysql_pconnect</function> függvény a <function>mysql_connect</function> függvényhez hasonlóan mûködik, csupán két nagyobb különbség van: </para> - <para> + <para> 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. </para> - <para> + <para> 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 <function>mysql_close</function> függvény nem fogja neked lezárni a <function>mysql_pconnect</function> függvénnyel megnyitott kapcsolatokat). </para> - <para> + <para> Az ilyen típusú kapcsolatot ezért hívják 'perzisztensnek'. </para> + <note> + <para> + Ügyelj rá, hogy ezek a fajta kapcsolatok csak a PHP betölthetõ modulos + változatában mûködnek. Lást a + <link linkend="features.persistent-connections">Perzisztens Adatbázis + Kapcsolatok</link> fejezetet további információkért! </refsect1> </refentry> @@ -1660,14 +1807,14 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_query</function></funcdef> + <funcdef>resource <function>mysql_query</function></funcdef> <paramdef>string <parameter>query</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter><optional>link_identifier</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_query</function> függvény kérést küld a megadott kapcsolat-azonosítójú szerver aktív adatbázisához. Ha nem adsz meg <parameter>link_identifier</parameter>-t, akkor a @@ -1678,49 +1825,55 @@ </para> <note> <para> - A kérésnek nem szabad pontosvesszõre végzõdnie. + A kérésnek nem szabad pontosvesszõvel végzõdnie. </para> </note> <para> - A <function>mysql_query</function> 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 <function>mysql_query</function> 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 <function>mysql_query</function> 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. </para> <para> - A következõ kérés szintaktikailag rossz, igy a - <function>mysql_query</function> függvény meghiúsul és FALSE eredményt + A következõ kérés szintaktikailag rossz, igy a + <function>mysql_query</function> függvény meghiúsul és &false; eredményt ad: <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $eredmeny = mysql_query ("SELECT * WHERE 1=1") or die ("Érvénytelen lekérdezés"); ?> +]]> </programlisting> </example> </para> <para> - Az alábbi kérés szemantikailag helytelen, ha nincs - <literal>my_col</literal> nevû oszlop a + Az alábbi kérés szemantikailag helytelen, ha nincs + <literal>my_col</literal> nevû oszlop a <literal>my_tbl</literal> nevû táblában, így a - <function>mysql_query</function> meghiúsul és FALSE értékkel tér vissza. + <function>mysql_query</function> meghiúsul és &false; értékkel tér vissza. <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $eredmeny = mysql_query ("SELECT my_col FROM my_tbl") or die ("Érvénytelen kérés"); ?> +]]> </programlisting> </example> </para> <para> - A <function>mysql_query</function> függvény akkor is meghiúsul és FALSE + A <function>mysql_query</function> 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. </para> @@ -1732,24 +1885,73 @@ sort érintett a DELETE, NSERT, REPLACE vagy UPDATE kérésed. </para> <para> - SELECT kérés esetében a <function>mysql_query</function> függvény - egy új eredmény-azonosítót ad vissza, amit késõbb a - <function>mysql_result</function> függvénnyel használhatsz. - Ha az eredményre már nincs szükség és memóriafóbiád van, akkor a - <function>mysql_free_result</function> 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 <function>mysql_query</function> függvény egy új + eredmény-azonosítót ad vissza, amit késõbb a + <function>mysql_fetch_array</function> 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 <function>mysql_free_result</function> + 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. </para> <para> - Lásd még a <function>mysql_affected_rows</function>, + Lásd még a <function>mysql_num_rows</function>, + <function>mysql_affected_rows</function>, <function>mysql_db_query</function>, + <function>mysql_unbuffered_query</function>, <function>mysql_free_result</function>, + <function>mysql_fetch_array</function>, + <function>mysql_fetch_row</function>, + <function>mysql_fetch_assoc</function>, <function>mysql_result</function>, <function>mysql_select_db</function> és a <function>mysql_connect</function> függvényeket! </para> </refsect1> </refentry> + <refentry id="function.mysql-unbuffered-query"> + <refnamediv> + <refname>mysql_unbuffered_query</refname> + <refpurpose> + SQL kérést küld küld a MySQL-nek anélkül, hogy az eredményt + elõfeldolgozná. + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>resource <function>mysql_unbuffered_query</function></funcdef> + <paramdef>string <parameter>query</parameter></paramdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_unbuffered_query</function> függvény a + <parameter>query</parameter> SQL kérést küldi a MySQL-nek anélkül, hogy + bármi módon betöltené, vagy pufferelni, mint azt a + <function>mysql_query</function> 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 + <parameter>link_identifier</parameter> paraméterben, hogy melyik + kapcsolatra vonatkozik a kérés. + </para> + <note> + <para> + A <function>mysql_unbuffered_query</function> függvénynek az a hátránya, + hogy nem használhatod a <function>mysql_num_rows</function> 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. + </para> + </note> + <para> + Lásd még a <function>mysql_query</function>függvényt! + </para> + </refsect1> <refentry id="function.mysql-result"> <refnamediv> @@ -1761,9 +1963,9 @@ <funcsynopsis> <funcprototype> <funcdef>mixed <function>mysql_result</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>row</parameter></paramdef> - <paramdef>mixed + <paramdef>mixed <parameter> <optional>field</optional> </parameter> @@ -1794,7 +1996,7 @@ </para> <para> Ajánlott az alábbi, gyors [és programozóbarát] függvények használata: - <function>mysql_fetch_row</function>, + <function>mysql_fetch_row</function>, <function>mysql_fetch_array</function> és <function>mysql_fetch_object</function>. </para> @@ -1810,19 +2012,19 @@ <title>Leírás</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_select_db</function></funcdef> + <funcdef>bool <function>mysql_select_db</function></funcdef> <paramdef>string <parameter>database_name</parameter></paramdef> - <paramdef>int + <paramdef>resource <parameter> <optional>link_identifier</optional> </parameter> </paramdef> </funcprototype> </funcsynopsis> - <para> - Visszatérési érték: true, ha sikeres; false ha hiba történt. + <para> + &return.success; </para> - <para> + <para> A <function>mysql_select_db</function> 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. </para> <para> Lásd még a - <function>mysql_connect</function>, + <function>mysql_connect</function>, <function>mysql_pconnect</function> és a <function>mysql_query</function> függvényeket! </para> <para> Kompatíbilitási okokból a <function>mysql_selectdb</function> - függvény is használható. + függvény is használható, de használata nem ajánlott. </para> </refsect1> </refentry> @@ -1856,11 +2058,11 @@ <funcsynopsis> <funcprototype> <funcdef>string <function>mysql_tablename</function></funcdef> - <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>resource <parameter>result</parameter></paramdef> <paramdef>int <parameter>i</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> + <para> A <function>mysql_tablename</function> függvény veszi a <function>mysql_list_tables</function> függvény által visszaadott eredmény-mutatót és egy indexet, majd megmondja az oszlophoz tartozó @@ -1870,22 +2072,133 @@ <example> <title><function>Mysql_tablename</function> példa</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("localhost:3306"); $eredmeny = mysql_list_tables ("wisconsin"); $i = 0; -while ($i < mysql_num_rows ($eredmeny)) { - $tb_names[$i] = mysql_tablename ($eredmeny, $i); - echo $tb_names[$i] . "<BR>"; +while ($i < mysql_num_rows ($eredmeny)) { + $tb_nevek[$i] = mysql_tablename ($eredmeny, $i); + echo $tb_nevek[$i] . "<BR>"; $i++; } ?> +]]> </programlisting> </example> </para> </refsect1> </refentry> + <refentry id="function.mysql-get-client-info"> + <refnamediv> + <refname>mysql_get_client_info</refname> + <refpurpose>MySQL kliens információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mysql_get_client_info</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_client_info</function> függvény a kliensprogram + által használt könyvtár verziójáról ad információt. + </para> + <para> + A <function>mysql_get_client_info</function> függvény a PHP 4.0.5-ös + verziójában került a nyelvbe. + </para> + </refsect1> + </refentry> + + <refentry id="function.mysql-get-host-info"> + <refnamediv> + <refname>mysql_get_host_info</refname> + <refpurpose>MySQL kiszolgáló információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mysql_get_host_info</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_host_info</function> függvény egy karakterlánccal + tér vissza, ami a <parameter>link_identifier</parameter> által használt + kapcsolatról ad információt, például a kiszolgáló gép nevét. Ha a + <parameter>link_identifier</parameter> paramétert elhagyjuk, akkor a + legutóbb megnyitott kapcsolatról kapunk információt. + </para> + <para> + A <function>mysql_get_host_info</function> függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + </para> + </refsect1> + </refentry> + + <refentry id="function.mysql-get-proto-info"> + <refnamediv> + <refname>mysql_get_proto_info</refname> + <refpurpose>MySQL protokoll információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mysql_get_proto_info</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_proto_info</function> függvény a + <parameter>link_identifier</parameter> által használt protokoll verzióját + adja vissza. Ha a <parameter>link_identifier</parameter> paramétert nem + adod meg, akkor az utoljára használt kapcsolatról kapsz információt. + </para> + <para> + <function>mysql_get_proto_info</function> függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + </para> + </refsect1> + </refentry> + + <refentry id="function.mysql-get-server-info"> + <refnamediv> + <refname>mysql_get_server_info</refname> + <refpurpose>MySQL szerver információ</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mysql_get_server_info</function></funcdef> + <paramdef>resource + <parameter><optional>link_identifier</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>mysql_get_server_info</function> függvény a + <parameter>link_identifier</parameter>-ban megadott kapcsolat + által használt szerver verzióját adja. Ha nincs megadva + <parameter>link_identifier</parameter>, akkor az utoljára használt + kapcsolatról kapsz információt. + </para> + <para> + A <function>mysql_get_server_info</function> függvény a PHP 4.0.5-ös + változatával került a nyelvbe. + </para> + </refsect1> + </refentry> </reference> <!-- Keep this comment at the end of the file @@ -1904,4 +2217,7 @@ sgml-local-catalogs:nil sgml-local-ecat-files:nil End: +vim600: syn=xml fen fdm=syntax fdl=2 si +vim: et tw=78 syn=sgml lcs=tab\:>-,trail\:- +vi: ts=1 sw=1 list -->