cvs: phpdoc /pl/functions mysql.xml
| From: | Slawomir Pucia | Date: | Fri, 21 Dec 2001 23:00:19 +0000 |
| Subject: | cvs: phpdoc /pl/functions mysql.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969340235@lists.php.net to get a copy of this message | ||
slawek Fri Dec 21 18:00:19 2001 EDT
Modified files:
/phpdoc/pl/functions mysql.xml
Log:
Updated to 1.77
Index: phpdoc/pl/functions/mysql.xml diff -u phpdoc/pl/functions/mysql.xml:1.9 phpdoc/pl/functions/mysql.xml:1.10 --- phpdoc/pl/functions/mysql.xml:1.9 Thu Dec 20 07:47:47 2001 +++ phpdoc/pl/functions/mysql.xml Fri Dec 21 18:00:19 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.70 Maintainer: slawek Status: ready --> -<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.77 Maintainer: slawek Status: ready --> +<!-- $Revision: 1.10 $ --> <reference id="ref.mysql"> <title>Funkcje MySQL</title> <titleabbrev>MySQL</titleabbrev> @@ -192,7 +192,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu lub &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_close</function> zamyka po³±czenie z serwerem MySQL @@ -216,12 +216,14 @@ <example> <title>MySQL close</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_connect ("serwer", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); print ("Po³±czenie nawi±zane"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> <para> @@ -301,12 +303,14 @@ <example> <title>MySQL connect</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_connect ("localhost", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); print ("Po³±czenie nawi±zane"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> <para> Patrz tak¿e @@ -339,11 +343,14 @@ tworzy now± bazê na serwerze skojarzonym z podanym identyfikatorem po³±czenia. </para> - <!-- returns?? bool -> succes? --> + <para> + &return.success; + </para> <example> <title>tworzenie bazy MySQL</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("serwer", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); if (mysql_create_db ("my_db")) { @@ -351,12 +358,13 @@ } else { printf ("B³±d podczas tworzenia bazy: %s\n", mysql_error ()); } -?> +?> +]]> </programlisting> </example> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_createdb</function>. + <function>mysql_createdb</function>. Jest to jednak niezalecane. </para> <para> Patrz tak¿e: <function>mysql_drop_db</function>. @@ -379,7 +387,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu lub &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_data_seek</function> przesuwa wewnêtrzny @@ -393,7 +401,8 @@ <example> <title>mysql_data_seek</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("serwer", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); @@ -404,7 +413,7 @@ $result = mysql_query ($query) or die ("Zapytanie zakoñczone niepowodzeniem"); - # pobieramy wiersze w odwrotnej kolejno¶ci + // pobieramy wiersze w odwrotnej kolejno¶ci for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) { if (!mysql_data_seek ($result, $i)) { @@ -415,11 +424,12 @@ if(!($row = mysql_fetch_object ($result))) continue; - echo ("$row->last_name $row->first_name<BR>\n"; + echo "$row->last_name $row->first_name<br />\n"; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -457,7 +467,8 @@ <example> <title>mysql_db_name</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php error_reporting(E_ALL); mysql_connect("serwer", "uzytkownik", "haslo"); @@ -465,11 +476,12 @@ $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> @@ -499,7 +511,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: dodatni identyfikator wyniku MySQL wskazuj±cy na wynik + Zwraca dodatni identyfikator wyniku MySQL wskazuj±cy na wynik zapytania, lub &false; w przypadku b³êdu. </para> <para> @@ -546,16 +558,18 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu lub &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_drop_db</function> usuwa ca³± bazê z serwera skojarzonego z podanym identyfikatorem po³±czenia. </para> + <para> + Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ + <function>mysql_dropdb</function>. Jest to jednak niezalecane. + </para> <para> Patrz tak¿e: <function>mysql_create_db</function>. - Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_dropdb</function>. </para> </refsect1> </refentry> @@ -593,14 +607,16 @@ nastêpnej funkcji MySQL. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect("serwer","uzytkownik","haslo"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("niematakiejbazy"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM niematakiejtabeli"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> @@ -643,14 +659,16 @@ nastêpnej funkcji MySQL. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect("serwer","uzytkownik","haslo"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("niematakiejbazy"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM niematakiejtabeli"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> @@ -723,24 +741,35 @@ Je¿eli dwie lub wiêcej kolumn wyniku ma te same nazwy, ostatnia kolumna bêdzie brana pod uwagê. Dostêp do innych kolumn o tej samej nazwie jest mo¿liwy jedynie przez indeksowanie numeryczne - lub przez stworzenie aliasa. + lub przez stworzenie aliasa. Po stworzeniu aliasa nie mo¿na + ju¿ odwo³ywaæ siê do danej kolumny u¿ywaj±c jej prawdziwej nazwy + (w tym przyk³adzie u¿ywaj±c <literal>'pole'</literal>). <informalexample> - <programlisting> -select t1.f1 as foo t2.f1 as bar from t1, t2 + <programlisting role="sql"> +<![CDATA[ +select tjeden.pole as cos tdwa.pole as cos2 from tjeden, tdwa +]]> </programlisting> </informalexample> </para> <para> Godne uwagi jest to, ¿e u¿ycie <function>mysql_fetch_array</function> - NIE jest znacz±co wolniejsze od u¿ycia + <emphasis>nie jest</emphasis> znacz±co wolniejsze od u¿ycia <function>mysql_fetch_row</function>, a jest bardziej funkcjonalne. </para> <para> Opcjonalny drugi argument <parameter>result_type</parameter> w funkcji <function>mysql_fetch_array</function> jest sta³± i mo¿e przyjmowaæ nastêpuj±ce warto¶ci: MYSQL_ASSOC, MYSQL_NUM i MYSQL_BOTH. - (funkcjonalno¶æ tê dodano w PHP 3.0.7) + Tê funkcjonalno¶æ dodano w PHP 3.0.7. Warto¶ci± domy¶ln± jest MYSQL_BOTH. </para> + <para> + U¿ywaj±c MYSQL_BOTH otrzymasz tablicê indeksowan± zarówno asocjacyjnie + jak i numerycznie. MYSQL_ASSOC dostarczy tablicy indeksowanej tylko + asocjacyjnie (jak w <function>mysql_fetch_assoc</function>), natomiast + MYSQL_NUM indeksowanej tylko numerycznie (jak w + <function>mysql_fetch_row</function>). + </para> <para> Po dalsze szczegó³y patrz tak¿e <function>mysql_fetch_row</function> i @@ -749,17 +778,19 @@ <example> <title><function>mysql_fetch_array</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_db_query ("database","select id_uzytkownika, pelna_nazwa from tabela"); while ($row = mysql_fetch_array ($result)) { - echo "id_uzytkownika: ".$row["id_uzytkownika"]."<br>\n"; - echo "id_uzytkownika: ".$row[0]."<br>\n"; - echo "pelna_nazwa: ".$row["pelna_nazwa"]."<br>\n"; - echo "pelna_nazwa: ".$row[1]."<br>\n"; + echo "id_uzytkownika: ".$row["id_uzytkownika"]."<br>\n"; + echo "id_uzytkownika: ".$row[0]."<br>\n"; + echo "pelna_nazwa: ".$row["pelna_nazwa"]."<br>\n"; + echo "pelna_nazwa: ".$row[1]."<br>\n"; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -802,7 +833,7 @@ </para> <para> Godne uwagi jest to, ¿e u¿ycie <function>mysql_fetch_assoc</function> - NIE jest znacz±co wolniejsze od u¿ycia + <emphasis>nie</emphasis> jest znacz±co wolniejsze od u¿ycia <function>mysql_fetch_row</function>, a jest bardziej funkcjonalne. </para> <para> @@ -813,7 +844,8 @@ <example> <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_db_query ("database","select * from tabela"); while ($row = mysql_fetch_assoc ($result)) { @@ -821,7 +853,8 @@ echo $row["pelna_nazwa"]; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -924,20 +957,21 @@ <example> <title><function>mysql_fetch_field</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); or die ("Nie mo¿na siê po³±czyæ"); $result = mysql_db_query ("database", "select * from table") or die ("Zapytanie zakoñczone niepowodzeniem"); # pobieramy dane kolumny $i = 0; -while ($i < mysql_num_fields ($result)) { - echo "Informacje o kolumnie $i:<BR>\n"; +while ($i < mysql_num_fields ($result)) { + echo "Informacje o kolumnie $i:<BR>\n"; $meta = mysql_fetch_field ($result); if (!$meta) { - echo "Informacje niedostêpne<BR>\n"; + echo "Informacje niedostêpne<BR>\n"; } - echo "<PRE> + echo "<PRE> blob: $meta->blob max_length: $meta->max_length multiple_key: $meta->multiple_key @@ -950,11 +984,12 @@ unique_key: $meta->unique_key unsigned: $meta->unsigned zerofill: $meta->zerofill -</PRE>"; +</PRE>"; $i++; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> <para> @@ -979,7 +1014,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: Tablicê zawieraj±c± d³ugo¶æ ka¿dego pola z wiersza + Zwraca tablicê zawieraj±c± d³ugo¶æ ka¿dego pola z wiersza ostatnio pobranego przez <function>mysql_fetch_row</function>, lub &false;, je¿eli wyst±pi b³±d. </para> @@ -1029,7 +1064,8 @@ <para> Opcjonalny argument <parameter>result_typ</parameter> jest sta³± i mo¿e przyjmowaæ nastêpuj±ce warto¶ci: MYSQL_ASSOC, - MYSQL_NUM, and MYSQL_BOTH. + MYSQL_NUM, and MYSQL_BOTH. Zobacz <function>mysql_fetch_array</function>, + by zapoznaæ siê z opisem tych sta³ych. </para> <para> Szybko¶æ tej funkcji jest identyczna jak @@ -1039,7 +1075,8 @@ <example> <title><function>mysql_fetch_object</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_db_query ("baza", "select * from tabela"); while ($row = mysql_fetch_object ($result)) { @@ -1047,7 +1084,8 @@ echo $row->pelna_nazwa; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </para> @@ -1072,7 +1110,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: Tablicê zawieraj±c± wiersz lub &false; je¿eli + Zwraca tablicê zawieraj±c± wiersz lub &false; je¿eli nie ma wiêcej wierszy w <parameter>wynik</parameter>. </para> <para> @@ -1124,7 +1162,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldflags</function>. + <function>mysql_fieldflags</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1161,6 +1199,8 @@ <example> <title><function>mysql_field_name</function></title> <programlisting role="php"> +<![CDATA[ +<?php // Tabela sk³ada siê z trzech pól: // id_uzytkownika // nazwa_uzytkownika @@ -1170,21 +1210,23 @@ echo mysql_field_name($res, 0) . "\n"; echo mysql_field_name($res, 2); +?> +]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad da nastêpuj±cy wynik: - <informalexample> - <programlisting> + <para> + Powy¿szy przyk³ad da nastêpuj±cy wynik: + <screen> +<![CDATA[ id_uzytkownika haslo - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldname</function>. + <function>mysql_fieldname</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1208,7 +1250,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldlen</function>. + <function>mysql_fieldlen</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1259,7 +1301,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldtable</function>. + <function>mysql_fieldtable</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1289,7 +1331,8 @@ <example> <title>Typy pól MySQL</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); mysql_select_db ("baza"); @@ -1298,25 +1341,26 @@ $rows = mysql_num_rows ($result); $i = 0; $table = mysql_field_table ($result, $i); -echo "Tabela '".$table."' ma ".$fields." pól i ".$rows." wierszy <BR>"; -echo "Tabela ma nastêpuj±ce pola <BR>"; +echo "Tabela '".$table."' ma ".$fields." pól i ".$rows." wierszy <BR>"; +echo "Tabela ma nastêpuj±ce pola <BR>"; while ($i < $fields) { $type = mysql_field_type ($result, $i); $name = mysql_field_name ($result, $i); $len = mysql_field_len ($result, $i); $flags = mysql_field_flags ($result, $i); - echo $type." ".$name." ".$len." ".$flags."<BR>"; + echo $type." ".$name." ".$len." ".$flags."<BR>"; $i++; } mysql_close(); -?> +?> +]]> </programlisting> </example> </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldtype</function>. + <function>mysql_fieldtype</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1330,7 +1374,7 @@ <title>Opis</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_free_result</function></funcdef> + <funcdef>bool <function>mysql_free_result</function></funcdef> <paramdef>resource <parameter>wynik</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1346,10 +1390,12 @@ identyfikatorem wyniku bêdzie automatycznie zwolniona. <!-- TODO and as of PHP4 before, see freeing resources --> </para> - <!-- returns?? --> + <para> + &return.success; + </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_freeresult</function>. + <function>mysql_freeresult</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1398,9 +1444,10 @@ <para> <function>mysql_insert_id</function> konwertuje typ warto¶ci otrzymanej od natywnej funkcji MySQL C API <literal>mysql_insert_id()</literal> - na typ <literal>long</literal>. Je¶li kolumna AUTO_INCREMENT jest typu - BIGINT, warto¶æ zwracana przez <function>mysql_insert_id</function> - bêdzie niepoprawna. Nale¿y u¿yæ wewnêtrznej funkcji MySQL + na typ <literal>long</literal> (czyli <type>int</type> w PHP). Je¶li + kolumna AUTO_INCREMENT jest typu BIGINT, warto¶æ zwracana przez + <function>mysql_insert_id</function> bêdzie niepoprawna. Nale¿y w + zapytaniu SQL u¿yæ wewnêtrznej funkcji MySQL <literal>LAST_INSERT_ID()</literal>. </para> </warning> @@ -1430,31 +1477,36 @@ <function>mysql_list_dbs</function> zwróci wynik zawieraj±cy nazwy baz dostêpnych na serwerze skojarzonym z identyfikatorem po³±czenia. ¯eby uzyskaæ nazwy za wska¼nika wyniku nale¿y - u¿yæ funkcji <function>mysql_tablename</function>. + u¿yæ funkcji <function>mysql_tablename</function> lub innej operuj±cej na + tablicach wyników. </para> <para> <example> <title><function>mysql_list_dbs</function></title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect ("serwer","uzytkownik","haslo"); $db_list = mysql_list_dbs($link); while ($row = mysql_fetch_object($db_list)) { echo $row->Database . "\n"; } +?> +]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad da nastêpuj±cy wynik: - <informalexample> - <programlisting> + <para> + Powy¿szy przyk³ad da nastêpuj±cy wynik: + <screen> +<![CDATA[ baza1 baza2 baza3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <note> <para> @@ -1464,7 +1516,7 @@ </note> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_listdbs</function>. + <function>mysql_listdbs</function>. Jest to jednak niezalecane. </para> <para> Patrz tak¿e <function>mysql_db_name</function>. @@ -1500,44 +1552,39 @@ <function>mysql_field_name</function> i <function>mysql_field_type</function>. </para> - <!-- - this is very outdated, and now incorrect - <para> - A result identifier is a positive integer. The function returns - -1 if a error occurs. A string describing the error will be - placed in <literal>$phperrmsg</literal>, and unless the function - was called as <literal>@mysql()</literal> then this error string - will also be printed out. - </para> --> <para> <example> <title><function>mysql_list_fields</function></title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect ("serwer","uzytkownik","haslo"); $fields = mysql_list_fields("baza", "tabela", $link); $columns = mysql_num_fields($fields); -for ($i = 0; $i < $columns; $i++) { +for ($i = 0; $i < $columns; $i++) { echo mysql_field_name($fields, $i) . "\n"; } +?> +]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad da nastêpuj±cy wynik: - <informalexample> - <programlisting> + <para> + Powy¿szy przyk³ad da nastêpuj±cy wynik: + <screen> +<![CDATA[ pole1 pole2 pole3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_listfields</function>. + <function>mysql_listfields</function>. Jest to jednak niezalecane. </para> <!-- TODO: this is equiv. with 'select * from $table where &false;,' which implies you can better use the field-research functions @@ -1569,11 +1616,12 @@ nazwê bazy i zwraca wska¼nik wyniku podobnie jak funkcja <function>mysql_db_query</function>. ¯eby uzyskaæ nazwy tabel za wska¼nika wyniku nale¿y u¿yæ funkcji - <function>mysql_tablename</function>. + <function>mysql_tablename</function> lub innej operuj±cej na + tablicach wyników. </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_listtables</function>. + <function>mysql_listtables</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1628,8 +1676,8 @@ <example> <title><function>mysql_num_rows</function></title> <programlisting role="php"> -<?php - +<![CDATA[ +<?php $link = mysql_connect ("serwer","uzytkownik","haslo"); mysql_select_db("baza", $link); @@ -1637,8 +1685,8 @@ $num_rows = mysql_num_rows($result); echo "$num_rows wierszy\n"; - -?> +?> +]]> </programlisting> </example> </para> @@ -1651,7 +1699,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_numrows</function>. + <function>mysql_numrows</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1731,6 +1779,21 @@ <para> Dlatego te¿ ten typ po³±czeñ nazywany jest 'sta³ym'. </para> + <note> + <para> + Trzeba zaznaczyæ, ¿e sta³e po³±czenia dzia³aj± jedynie z PHP pracuj±cym + jako modu³. Przeczytaj rozdzia³ + <link linkend="features.persistent-connections">Sta³e po³±czenia z bazami + danych</link> by dowiedzieæ siê wiêcej. + </para> + </note> + <warning> + <para> + U¿ywanie sta³ych po³±czeñ mo¿e wymagaæ dostrojenia konfiguracji + Apache'a i MySQLa, aby nie przekroczyæ limitu jednoczesnych po³±czeñ + dozwolonych przez MySQL. + </para> + </warning> </refsect1> </refentry> @@ -1764,11 +1827,13 @@ </para> </note> <para> - <function>mysql_query</function> zwraca &true; lub &false; - informuj±c czy zapytanie zakoñczy³o siê sukcesem czy te¿ nie. - Zwrócona warto¶æ &true; oznacza, ¿e zapytanie by³o prawid³owe i - mo¿e byæ wykonane przez serwer. Nie mówi natomiast nic o liczbie - przetworzonych lub zwróconych wierszy. Jest równie¿ mo¿liwe, ¿e + <function>mysql_query</function> zwraca identyfikator wyniku (lub &false; + w przypadku niepowodzenia) jedynie dla zapytañ typu SELECT. + Dla innych zapytañ SQL <function>mysql_query</function> zwraca &true; + lub &false; informuj±c czy zapytanie zakoñczy³o siê sukcesem czy te¿ nie. + Je¶li nie zosta³a zwrócona warto¶æ &false; to znaczy, ¿e zapytanie by³o + prawid³owe i mo¿e byæ wykonane przez serwer. Nie mówi natomiast nic o + liczbie przetworzonych lub zwróconych wierszy. Jest równie¿ mo¿liwe, ¿e zapytanie zostanie wykonane poprawnie, nie przetwarzaj±c lub zwracaj±c ¿adnych wierszy. </para> @@ -1778,10 +1843,12 @@ <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $result = mysql_query ("SELECT * WHERE 1=1") or die ("Zapytanie niepoprawne"); -?> +?> +]]> </programlisting> </example> </para> @@ -1793,10 +1860,12 @@ <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $result = mysql_query ("SELECT kolumna FROM tabela") or die ("Zapytanie niepoprawne"); -?> +?> +]]> </programlisting> </example> </para> @@ -1812,18 +1881,23 @@ wierszy przetworzonych przez instrukcje DELETE, INSERT, REPLACE i UPDATE. </para> <para> - Jedynie Po operacji SELECT, <function>mysql_query</function> zwróci + Jedynie po operacji SELECT, <function>mysql_query</function> zwróci identyfikator wyniku, który mo¿na przekazaæ do - funkcji <function>mysql_result</function>. Po zakoñczeniu operacji na - wyniku, mo¿na zwolniæ zasoby przez niego wykorzystywane wywo³uj±c + funkcji <function>mysql_result</function> lub innych funkcji operuj±cych + na tablicach wyników. Po zakoñczeniu operacji na wyniku, mo¿na zwolniæ + zasoby przez niego wykorzystywane wywo³uj±c <function>mysql_free_result</function>. Po zakoñczeniu dzia³ania skryptu pamiêæ i tak bêdzie automatycznie zwolniona. </para> <para> - Patrz tak¿e: <function>mysql_affected_rows</function>, + Patrz tak¿e: <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> i <function>mysql_connect</function>. @@ -1944,7 +2018,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu, &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_select_db</function> ustawia aktywn± bazê danych @@ -1952,7 +2026,7 @@ Je¿eli identyfikator nie zostanie podany, wykorzystane zostanie ostatnio otwarte po³±czenie. Je¿eli ¿adne po³±czenie nie jest otwarte, funkcja spróbuje je nawi±zaæ wywo³uj±c - <function>mysql_connect</function>. + <function>mysql_connect</function> bez argumentów. </para> <para> Kolejne wywo³ania funkcji <function>mysql_query</function> bêd± @@ -1965,7 +2039,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_selectdb</function>. + <function>mysql_selectdb</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1992,16 +2066,18 @@ <example> <title>Przyk³ad u¿ycia <function>mysql_tablename</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_list_tables ("baza"); $i = 0; -while ($i < mysql_num_rows ($result)) { +while ($i < mysql_num_rows ($result)) { $tb_names[$i] = mysql_tablename ($result, $i); - echo $tb_names[$i] . "<BR>"; + echo $tb_names[$i] . "<BR>"; $i++; } -?> +?> +]]> </programlisting> </example> </para> @@ -2126,6 +2202,7 @@ sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t +indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil
Index: phpdoc/pl/functions/mysql.xml diff -u phpdoc/pl/functions/mysql.xml:1.9 phpdoc/pl/functions/mysql.xml:1.10 --- phpdoc/pl/functions/mysql.xml:1.9 Thu Dec 20 07:47:47 2001 +++ phpdoc/pl/functions/mysql.xml Fri Dec 21 18:00:19 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.70 Maintainer: slawek Status: ready --> -<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.77 Maintainer: slawek Status: ready --> +<!-- $Revision: 1.10 $ --> <reference id="ref.mysql"> <title>Funkcje MySQL</title> <titleabbrev>MySQL</titleabbrev> @@ -192,7 +192,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu lub &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_close</function> zamyka po³±czenie z serwerem MySQL @@ -216,12 +216,14 @@ <example> <title>MySQL close</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_connect ("serwer", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); print ("Po³±czenie nawi±zane"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> <para> @@ -301,12 +303,14 @@ <example> <title>MySQL connect</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_connect ("localhost", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); print ("Po³±czenie nawi±zane"); mysql_close ($link); -?> +?> +]]> </programlisting> </example> <para> Patrz tak¿e @@ -339,11 +343,14 @@ tworzy now± bazê na serwerze skojarzonym z podanym identyfikatorem po³±czenia. </para> - <!-- returns?? bool -> succes? --> + <para> + &return.success; + </para> <example> <title>tworzenie bazy MySQL</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("serwer", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); if (mysql_create_db ("my_db")) { @@ -351,12 +358,13 @@ } else { printf ("B³±d podczas tworzenia bazy: %s\n", mysql_error ()); } -?> +?> +]]> </programlisting> </example> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_createdb</function>. + <function>mysql_createdb</function>. Jest to jednak niezalecane. </para> <para> Patrz tak¿e: <function>mysql_drop_db</function>. @@ -379,7 +387,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu lub &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_data_seek</function> przesuwa wewnêtrzny @@ -393,7 +401,8 @@ <example> <title>mysql_data_seek</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $link = mysql_pconnect ("serwer", "uzytkownik", "haslo") or die ("Nie mo¿na siê po³±czyæ"); @@ -404,7 +413,7 @@ $result = mysql_query ($query) or die ("Zapytanie zakoñczone niepowodzeniem"); - # pobieramy wiersze w odwrotnej kolejno¶ci + // pobieramy wiersze w odwrotnej kolejno¶ci for ($i = mysql_num_rows ($result) - 1; $i >=0; $i--) { if (!mysql_data_seek ($result, $i)) { @@ -415,11 +424,12 @@ if(!($row = mysql_fetch_object ($result))) continue; - echo ("$row->last_name $row->first_name<BR>\n"; + echo "$row->last_name $row->first_name<br />\n"; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -457,7 +467,8 @@ <example> <title>mysql_db_name</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php error_reporting(E_ALL); mysql_connect("serwer", "uzytkownik", "haslo"); @@ -465,11 +476,12 @@ $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> @@ -499,7 +511,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: dodatni identyfikator wyniku MySQL wskazuj±cy na wynik + Zwraca dodatni identyfikator wyniku MySQL wskazuj±cy na wynik zapytania, lub &false; w przypadku b³êdu. </para> <para> @@ -546,16 +558,18 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu lub &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_drop_db</function> usuwa ca³± bazê z serwera skojarzonego z podanym identyfikatorem po³±czenia. </para> + <para> + Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ + <function>mysql_dropdb</function>. Jest to jednak niezalecane. + </para> <para> Patrz tak¿e: <function>mysql_create_db</function>. - Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_dropdb</function>. </para> </refsect1> </refentry> @@ -593,14 +607,16 @@ nastêpnej funkcji MySQL. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect("serwer","uzytkownik","haslo"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("niematakiejbazy"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM niematakiejtabeli"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> @@ -643,14 +659,16 @@ nastêpnej funkcji MySQL. <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect("serwer","uzytkownik","haslo"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; mysql_select_db("niematakiejbazy"); -echo mysql_errno().": ".mysql_error()."<BR>"; +echo mysql_errno().": ".mysql_error()."<BR>"; $conn = mysql_query("SELECT * FROM niematakiejtabeli"); -echo mysql_errno().": ".mysql_error()."<BR>"; -?> +echo mysql_errno().": ".mysql_error()."<BR>"; +?> +]]> </programlisting> </informalexample> </para> @@ -723,24 +741,35 @@ Je¿eli dwie lub wiêcej kolumn wyniku ma te same nazwy, ostatnia kolumna bêdzie brana pod uwagê. Dostêp do innych kolumn o tej samej nazwie jest mo¿liwy jedynie przez indeksowanie numeryczne - lub przez stworzenie aliasa. + lub przez stworzenie aliasa. Po stworzeniu aliasa nie mo¿na + ju¿ odwo³ywaæ siê do danej kolumny u¿ywaj±c jej prawdziwej nazwy + (w tym przyk³adzie u¿ywaj±c <literal>'pole'</literal>). <informalexample> - <programlisting> -select t1.f1 as foo t2.f1 as bar from t1, t2 + <programlisting role="sql"> +<![CDATA[ +select tjeden.pole as cos tdwa.pole as cos2 from tjeden, tdwa +]]> </programlisting> </informalexample> </para> <para> Godne uwagi jest to, ¿e u¿ycie <function>mysql_fetch_array</function> - NIE jest znacz±co wolniejsze od u¿ycia + <emphasis>nie jest</emphasis> znacz±co wolniejsze od u¿ycia <function>mysql_fetch_row</function>, a jest bardziej funkcjonalne. </para> <para> Opcjonalny drugi argument <parameter>result_type</parameter> w funkcji <function>mysql_fetch_array</function> jest sta³± i mo¿e przyjmowaæ nastêpuj±ce warto¶ci: MYSQL_ASSOC, MYSQL_NUM i MYSQL_BOTH. - (funkcjonalno¶æ tê dodano w PHP 3.0.7) + Tê funkcjonalno¶æ dodano w PHP 3.0.7. Warto¶ci± domy¶ln± jest MYSQL_BOTH. </para> + <para> + U¿ywaj±c MYSQL_BOTH otrzymasz tablicê indeksowan± zarówno asocjacyjnie + jak i numerycznie. MYSQL_ASSOC dostarczy tablicy indeksowanej tylko + asocjacyjnie (jak w <function>mysql_fetch_assoc</function>), natomiast + MYSQL_NUM indeksowanej tylko numerycznie (jak w + <function>mysql_fetch_row</function>). + </para> <para> Po dalsze szczegó³y patrz tak¿e <function>mysql_fetch_row</function> i @@ -749,17 +778,19 @@ <example> <title><function>mysql_fetch_array</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_db_query ("database","select id_uzytkownika, pelna_nazwa from tabela"); while ($row = mysql_fetch_array ($result)) { - echo "id_uzytkownika: ".$row["id_uzytkownika"]."<br>\n"; - echo "id_uzytkownika: ".$row[0]."<br>\n"; - echo "pelna_nazwa: ".$row["pelna_nazwa"]."<br>\n"; - echo "pelna_nazwa: ".$row[1]."<br>\n"; + echo "id_uzytkownika: ".$row["id_uzytkownika"]."<br>\n"; + echo "id_uzytkownika: ".$row[0]."<br>\n"; + echo "pelna_nazwa: ".$row["pelna_nazwa"]."<br>\n"; + echo "pelna_nazwa: ".$row[1]."<br>\n"; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -802,7 +833,7 @@ </para> <para> Godne uwagi jest to, ¿e u¿ycie <function>mysql_fetch_assoc</function> - NIE jest znacz±co wolniejsze od u¿ycia + <emphasis>nie</emphasis> jest znacz±co wolniejsze od u¿ycia <function>mysql_fetch_row</function>, a jest bardziej funkcjonalne. </para> <para> @@ -813,7 +844,8 @@ <example> <title><function>mysql_fetch_assoc</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_db_query ("database","select * from tabela"); while ($row = mysql_fetch_assoc ($result)) { @@ -821,7 +853,8 @@ echo $row["pelna_nazwa"]; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </refsect1> @@ -924,20 +957,21 @@ <example> <title><function>mysql_fetch_field</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); or die ("Nie mo¿na siê po³±czyæ"); $result = mysql_db_query ("database", "select * from table") or die ("Zapytanie zakoñczone niepowodzeniem"); # pobieramy dane kolumny $i = 0; -while ($i < mysql_num_fields ($result)) { - echo "Informacje o kolumnie $i:<BR>\n"; +while ($i < mysql_num_fields ($result)) { + echo "Informacje o kolumnie $i:<BR>\n"; $meta = mysql_fetch_field ($result); if (!$meta) { - echo "Informacje niedostêpne<BR>\n"; + echo "Informacje niedostêpne<BR>\n"; } - echo "<PRE> + echo "<PRE> blob: $meta->blob max_length: $meta->max_length multiple_key: $meta->multiple_key @@ -950,11 +984,12 @@ unique_key: $meta->unique_key unsigned: $meta->unsigned zerofill: $meta->zerofill -</PRE>"; +</PRE>"; $i++; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> <para> @@ -979,7 +1014,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: Tablicê zawieraj±c± d³ugo¶æ ka¿dego pola z wiersza + Zwraca tablicê zawieraj±c± d³ugo¶æ ka¿dego pola z wiersza ostatnio pobranego przez <function>mysql_fetch_row</function>, lub &false;, je¿eli wyst±pi b³±d. </para> @@ -1029,7 +1064,8 @@ <para> Opcjonalny argument <parameter>result_typ</parameter> jest sta³± i mo¿e przyjmowaæ nastêpuj±ce warto¶ci: MYSQL_ASSOC, - MYSQL_NUM, and MYSQL_BOTH. + MYSQL_NUM, and MYSQL_BOTH. Zobacz <function>mysql_fetch_array</function>, + by zapoznaæ siê z opisem tych sta³ych. </para> <para> Szybko¶æ tej funkcji jest identyczna jak @@ -1039,7 +1075,8 @@ <example> <title><function>mysql_fetch_object</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_db_query ("baza", "select * from tabela"); while ($row = mysql_fetch_object ($result)) { @@ -1047,7 +1084,8 @@ echo $row->pelna_nazwa; } mysql_free_result ($result); -?> +?> +]]> </programlisting> </example> </para> @@ -1072,7 +1110,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: Tablicê zawieraj±c± wiersz lub &false; je¿eli + Zwraca tablicê zawieraj±c± wiersz lub &false; je¿eli nie ma wiêcej wierszy w <parameter>wynik</parameter>. </para> <para> @@ -1124,7 +1162,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldflags</function>. + <function>mysql_fieldflags</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1161,6 +1199,8 @@ <example> <title><function>mysql_field_name</function></title> <programlisting role="php"> +<![CDATA[ +<?php // Tabela sk³ada siê z trzech pól: // id_uzytkownika // nazwa_uzytkownika @@ -1170,21 +1210,23 @@ echo mysql_field_name($res, 0) . "\n"; echo mysql_field_name($res, 2); +?> +]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad da nastêpuj±cy wynik: - <informalexample> - <programlisting> + <para> + Powy¿szy przyk³ad da nastêpuj±cy wynik: + <screen> +<![CDATA[ id_uzytkownika haslo - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldname</function>. + <function>mysql_fieldname</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1208,7 +1250,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldlen</function>. + <function>mysql_fieldlen</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1259,7 +1301,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldtable</function>. + <function>mysql_fieldtable</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1289,7 +1331,8 @@ <example> <title>Typy pól MySQL</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); mysql_select_db ("baza"); @@ -1298,25 +1341,26 @@ $rows = mysql_num_rows ($result); $i = 0; $table = mysql_field_table ($result, $i); -echo "Tabela '".$table."' ma ".$fields." pól i ".$rows." wierszy <BR>"; -echo "Tabela ma nastêpuj±ce pola <BR>"; +echo "Tabela '".$table."' ma ".$fields." pól i ".$rows." wierszy <BR>"; +echo "Tabela ma nastêpuj±ce pola <BR>"; while ($i < $fields) { $type = mysql_field_type ($result, $i); $name = mysql_field_name ($result, $i); $len = mysql_field_len ($result, $i); $flags = mysql_field_flags ($result, $i); - echo $type." ".$name." ".$len." ".$flags."<BR>"; + echo $type." ".$name." ".$len." ".$flags."<BR>"; $i++; } mysql_close(); -?> +?> +]]> </programlisting> </example> </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_fieldtype</function>. + <function>mysql_fieldtype</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1330,7 +1374,7 @@ <title>Opis</title> <funcsynopsis> <funcprototype> - <funcdef>int <function>mysql_free_result</function></funcdef> + <funcdef>bool <function>mysql_free_result</function></funcdef> <paramdef>resource <parameter>wynik</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1346,10 +1390,12 @@ identyfikatorem wyniku bêdzie automatycznie zwolniona. <!-- TODO and as of PHP4 before, see freeing resources --> </para> - <!-- returns?? --> + <para> + &return.success; + </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_freeresult</function>. + <function>mysql_freeresult</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1398,9 +1444,10 @@ <para> <function>mysql_insert_id</function> konwertuje typ warto¶ci otrzymanej od natywnej funkcji MySQL C API <literal>mysql_insert_id()</literal> - na typ <literal>long</literal>. Je¶li kolumna AUTO_INCREMENT jest typu - BIGINT, warto¶æ zwracana przez <function>mysql_insert_id</function> - bêdzie niepoprawna. Nale¿y u¿yæ wewnêtrznej funkcji MySQL + na typ <literal>long</literal> (czyli <type>int</type> w PHP). Je¶li + kolumna AUTO_INCREMENT jest typu BIGINT, warto¶æ zwracana przez + <function>mysql_insert_id</function> bêdzie niepoprawna. Nale¿y w + zapytaniu SQL u¿yæ wewnêtrznej funkcji MySQL <literal>LAST_INSERT_ID()</literal>. </para> </warning> @@ -1430,31 +1477,36 @@ <function>mysql_list_dbs</function> zwróci wynik zawieraj±cy nazwy baz dostêpnych na serwerze skojarzonym z identyfikatorem po³±czenia. ¯eby uzyskaæ nazwy za wska¼nika wyniku nale¿y - u¿yæ funkcji <function>mysql_tablename</function>. + u¿yæ funkcji <function>mysql_tablename</function> lub innej operuj±cej na + tablicach wyników. </para> <para> <example> <title><function>mysql_list_dbs</function></title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect ("serwer","uzytkownik","haslo"); $db_list = mysql_list_dbs($link); while ($row = mysql_fetch_object($db_list)) { echo $row->Database . "\n"; } +?> +]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad da nastêpuj±cy wynik: - <informalexample> - <programlisting> + <para> + Powy¿szy przyk³ad da nastêpuj±cy wynik: + <screen> +<![CDATA[ baza1 baza2 baza3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <note> <para> @@ -1464,7 +1516,7 @@ </note> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_listdbs</function>. + <function>mysql_listdbs</function>. Jest to jednak niezalecane. </para> <para> Patrz tak¿e <function>mysql_db_name</function>. @@ -1500,44 +1552,39 @@ <function>mysql_field_name</function> i <function>mysql_field_type</function>. </para> - <!-- - this is very outdated, and now incorrect - <para> - A result identifier is a positive integer. The function returns - -1 if a error occurs. A string describing the error will be - placed in <literal>$phperrmsg</literal>, and unless the function - was called as <literal>@mysql()</literal> then this error string - will also be printed out. - </para> --> <para> <example> <title><function>mysql_list_fields</function></title> <programlisting role="php"> +<![CDATA[ +<?php $link = mysql_connect ("serwer","uzytkownik","haslo"); $fields = mysql_list_fields("baza", "tabela", $link); $columns = mysql_num_fields($fields); -for ($i = 0; $i < $columns; $i++) { +for ($i = 0; $i < $columns; $i++) { echo mysql_field_name($fields, $i) . "\n"; } +?> +]]> </programlisting> - </example> - </para> - <para> - Powy¿szy przyk³ad da nastêpuj±cy wynik: - <informalexample> - <programlisting> + <para> + Powy¿szy przyk³ad da nastêpuj±cy wynik: + <screen> +<![CDATA[ pole1 pole2 pole3 ... - </programlisting> - </informalexample> +]]> + </screen> + </para> + </example> </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_listfields</function>. + <function>mysql_listfields</function>. Jest to jednak niezalecane. </para> <!-- TODO: this is equiv. with 'select * from $table where &false;,' which implies you can better use the field-research functions @@ -1569,11 +1616,12 @@ nazwê bazy i zwraca wska¼nik wyniku podobnie jak funkcja <function>mysql_db_query</function>. ¯eby uzyskaæ nazwy tabel za wska¼nika wyniku nale¿y u¿yæ funkcji - <function>mysql_tablename</function>. + <function>mysql_tablename</function> lub innej operuj±cej na + tablicach wyników. </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_listtables</function>. + <function>mysql_listtables</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1628,8 +1676,8 @@ <example> <title><function>mysql_num_rows</function></title> <programlisting role="php"> -<?php - +<![CDATA[ +<?php $link = mysql_connect ("serwer","uzytkownik","haslo"); mysql_select_db("baza", $link); @@ -1637,8 +1685,8 @@ $num_rows = mysql_num_rows($result); echo "$num_rows wierszy\n"; - -?> +?> +]]> </programlisting> </example> </para> @@ -1651,7 +1699,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_numrows</function>. + <function>mysql_numrows</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1731,6 +1779,21 @@ <para> Dlatego te¿ ten typ po³±czeñ nazywany jest 'sta³ym'. </para> + <note> + <para> + Trzeba zaznaczyæ, ¿e sta³e po³±czenia dzia³aj± jedynie z PHP pracuj±cym + jako modu³. Przeczytaj rozdzia³ + <link linkend="features.persistent-connections">Sta³e po³±czenia z bazami + danych</link> by dowiedzieæ siê wiêcej. + </para> + </note> + <warning> + <para> + U¿ywanie sta³ych po³±czeñ mo¿e wymagaæ dostrojenia konfiguracji + Apache'a i MySQLa, aby nie przekroczyæ limitu jednoczesnych po³±czeñ + dozwolonych przez MySQL. + </para> + </warning> </refsect1> </refentry> @@ -1764,11 +1827,13 @@ </para> </note> <para> - <function>mysql_query</function> zwraca &true; lub &false; - informuj±c czy zapytanie zakoñczy³o siê sukcesem czy te¿ nie. - Zwrócona warto¶æ &true; oznacza, ¿e zapytanie by³o prawid³owe i - mo¿e byæ wykonane przez serwer. Nie mówi natomiast nic o liczbie - przetworzonych lub zwróconych wierszy. Jest równie¿ mo¿liwe, ¿e + <function>mysql_query</function> zwraca identyfikator wyniku (lub &false; + w przypadku niepowodzenia) jedynie dla zapytañ typu SELECT. + Dla innych zapytañ SQL <function>mysql_query</function> zwraca &true; + lub &false; informuj±c czy zapytanie zakoñczy³o siê sukcesem czy te¿ nie. + Je¶li nie zosta³a zwrócona warto¶æ &false; to znaczy, ¿e zapytanie by³o + prawid³owe i mo¿e byæ wykonane przez serwer. Nie mówi natomiast nic o + liczbie przetworzonych lub zwróconych wierszy. Jest równie¿ mo¿liwe, ¿e zapytanie zostanie wykonane poprawnie, nie przetwarzaj±c lub zwracaj±c ¿adnych wierszy. </para> @@ -1778,10 +1843,12 @@ <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $result = mysql_query ("SELECT * WHERE 1=1") or die ("Zapytanie niepoprawne"); -?> +?> +]]> </programlisting> </example> </para> @@ -1793,10 +1860,12 @@ <example> <title><function>mysql_query</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $result = mysql_query ("SELECT kolumna FROM tabela") or die ("Zapytanie niepoprawne"); -?> +?> +]]> </programlisting> </example> </para> @@ -1812,18 +1881,23 @@ wierszy przetworzonych przez instrukcje DELETE, INSERT, REPLACE i UPDATE. </para> <para> - Jedynie Po operacji SELECT, <function>mysql_query</function> zwróci + Jedynie po operacji SELECT, <function>mysql_query</function> zwróci identyfikator wyniku, który mo¿na przekazaæ do - funkcji <function>mysql_result</function>. Po zakoñczeniu operacji na - wyniku, mo¿na zwolniæ zasoby przez niego wykorzystywane wywo³uj±c + funkcji <function>mysql_result</function> lub innych funkcji operuj±cych + na tablicach wyników. Po zakoñczeniu operacji na wyniku, mo¿na zwolniæ + zasoby przez niego wykorzystywane wywo³uj±c <function>mysql_free_result</function>. Po zakoñczeniu dzia³ania skryptu pamiêæ i tak bêdzie automatycznie zwolniona. </para> <para> - Patrz tak¿e: <function>mysql_affected_rows</function>, + Patrz tak¿e: <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> i <function>mysql_connect</function>. @@ -1944,7 +2018,7 @@ </funcprototype> </funcsynopsis> <para> - Zwraca: &true; w przypadku sukcesu, &false; je¶li wyst±pi b³±d. + &return.success; </para> <para> <function>mysql_select_db</function> ustawia aktywn± bazê danych @@ -1952,7 +2026,7 @@ Je¿eli identyfikator nie zostanie podany, wykorzystane zostanie ostatnio otwarte po³±czenie. Je¿eli ¿adne po³±czenie nie jest otwarte, funkcja spróbuje je nawi±zaæ wywo³uj±c - <function>mysql_connect</function>. + <function>mysql_connect</function> bez argumentów. </para> <para> Kolejne wywo³ania funkcji <function>mysql_query</function> bêd± @@ -1965,7 +2039,7 @@ </para> <para> Aby zachowaæ zgodno¶æ z poprzednimi wersjami, mo¿na u¿yæ równie¿ - <function>mysql_selectdb</function>. + <function>mysql_selectdb</function>. Jest to jednak niezalecane. </para> </refsect1> </refentry> @@ -1992,16 +2066,18 @@ <example> <title>Przyk³ad u¿ycia <function>mysql_tablename</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php mysql_connect ("serwer","uzytkownik","haslo"); $result = mysql_list_tables ("baza"); $i = 0; -while ($i < mysql_num_rows ($result)) { +while ($i < mysql_num_rows ($result)) { $tb_names[$i] = mysql_tablename ($result, $i); - echo $tb_names[$i] . "<BR>"; + echo $tb_names[$i] . "<BR>"; $i++; } -?> +?> +]]> </programlisting> </example> </para> @@ -2126,6 +2202,7 @@ sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t +indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil