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
