slawek Sun Mar 17 08:41:54 2002 EDT
Modified files:
/phpdoc/pl/functions mysql.xml
Log:
Updated to EN 1.91
Index: phpdoc/pl/functions/mysql.xml
diff -u phpdoc/pl/functions/mysql.xml:1.22 phpdoc/pl/functions/mysql.xml:1.23
--- phpdoc/pl/functions/mysql.xml:1.22 Wed Mar 13 17:14:11 2002
+++ phpdoc/pl/functions/mysql.xml Sun Mar 17 08:41:54 2002
@@ -1,92 +1,163 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.85 Maintainer: slawek Status: ready -->
-<!-- $Revision: 1.22 $ -->
+<!-- EN-Revision: 1.91 Maintainer: slawek Status: ready -->
+<!-- $Revision: 1.23 $ -->
<reference id="ref.mysql">
<title>MySQL</title>
<titleabbrev>MySQL</titleabbrev>
<partintro>
- <simpara>
- Funkcje te umo�liwiaj� dost�p do serwer�w baz danych MySQL. Aby je
- uaktywni� musisz skompilowa� PHP z obs�ug� MySQL u�ywaj�c opcji
- <option role="configure">--with-mysql</option>. Je�li u�yjesz tej opcji
- bez podania �cie�ki do MySQL, PHP wykorzysta w�asne biblioteki klienta.
- U�ytkownicy, kt�rzy uruchamiaj� inne aplikacje korzystaj�ce z MySQL
- (na przyk�ad r�wnocze�nie PHP3 i PHP4 jako modu�y apache, lub modu�
- auth-mysql) powinni zawsze podawa� �cie�k� do MySQL:
- <option role="configure">--with-mysql=/sciezka/do/mysql</option>. To
- wymusi na PHP u�ycie bibliotek zainstalowanych przez MySQL, co pozwoli
- unikn�� konflikt�w.
- </simpara>
- <simpara>
+ <para id="mysql.intro">
+ Funkcje te umo�liwiaj� dost�p do serwer�w baz danych MySQL.
Wi�cej informacji o MySQL mo�na znale�� na stronie <ulink
url="&url.mysql;">&url.mysql;</ulink>.
- </simpara>
- <simpara>
+ </para>
+ <para>
Dokumentacja do MySQL znajduje si� pod adresem <ulink
url="&url.mysql.docs;">&url.mysql.docs;</ulink>.
- </simpara>
- <para>
- Zachowanie funkcji MySQL zale�y od ustawie� w
- <link linkend="configuration">pliku konfiguracyjnym</link>.
- <table>
- <title><link linkend="ini.sect.mysql">Opcje konfiguracyjne MySQL</link></title>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Nazwa</entry>
- <entry>Domy�lnie</entry>
- <entry>Zmiana</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>mysql.allow_persistent</entry>
- <entry>"On"</entry>
- <entry>PHP_INI_SYSTEM</entry>
- </row>
- <row>
- <entry>mysql.max_persistent</entry>
- <entry>"-1"</entry>
- <entry>PHP_INI_SYSTEM</entry>
- </row>
- <row>
- <entry>mysql.max_links</entry>
- <entry>"-1"</entry>
- <entry>PHP_INI_SYSTEM</entry>
- </row>
- <row>
- <entry>mysql.default_port</entry>
- <entry>NULL</entry>
- <entry>PHP_INI_ALL</entry>
- </row>
- <row>
- <entry>mysql.default_socket</entry>
- <entry>NULL</entry>
- <entry>PHP_INI_ALL</entry>
- </row>
- <row>
- <entry>mysql.default_host</entry>
- <entry>NULL</entry>
- <entry>PHP_INI_ALL</entry>
- </row>
- <row>
- <entry>mysql.default_user</entry>
- <entry>NULL</entry>
- <entry>PHP_INI_ALL</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
- By uzyska� wi�cej informacji na temat sta�ych PHP_INI_* zobacz
<function>ini_set</function>.
</para>
- <para>
- Ten prosty przyk�ad demonstruje jak si� po��czy�, wykona� zapytanie,
- wy�wietli� wyniki i roz��czy� z baz� MySQL.
- <example>
- <title>Wykorzystanie funkcji MySQL</title>
- <programlisting role="php">
-<![CDATA[
+ <section id="mysql.requirements">
+ <title>Wymagania</title>
+ <para>
+ Aby funkcje by�y dost�pne, nale�y skompilowa� PHP z obs�ug� MySQL
+ </para>
+ </section>
+
+ <section id="mysql.installation">
+ <title>Installation</title>
+ <para>
+ Podaj�c opcj� konfiguracyjn� <option role="configure">--with-mysql</option>
+ umo�liwiasz PHP dost�p do baz MySQL. Je�li u�yjesz jej bez podania �cie�ki
+ do MySQL, PHP wykorzysta w�asne biblioteki klienta.
+ W PHP4 obs�uga MySQL jest zawsze w��czona, wi�c je�li nie podasz tej
+ opcji, PHP r�wnie� u�yje wbudowanych bibliotek. U�ytkownicy, kt�rzy
+ uruchamiaj� inne aplikacje korzystaj�ce z MySQL (na przyk�ad r�wnocze�nie
+ PHP3 i PHP4 jako modu�y apache, lub modu� auth-mysql) powinni zawsze
+ podawa� �cie�k� do MySQL:
+ <option role="configure">--with-mysql=/sciezka/do/mysql</option>. To
+ wymusi na PHP u�ycie bibliotek zainstalowanych przez MySQL, co pozwoli
+ unikn�� konflikt�w.
+ </para>
+ </section>
+
+ <section id="mysql.configuration">
+ <title>Konfiguracja</title>
+ <para>
+ Zachowanie funkcji MySQL zale�y od ustawie� w
+ <link linkend="configuration">pliku konfiguracyjnym</link>.
+ <table>
+ <title><link linkend="ini.sect.mysql">Opcje konfiguracyjne MySQL</link></title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Nazwa</entry>
+ <entry>Domy�lnie</entry>
+ <entry>Zmiana</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>mysql.allow_persistent</entry>
+ <entry>"On"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ </row>
+ <row>
+ <entry>mysql.max_persistent</entry>
+ <entry>"-1"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ </row>
+ <row>
+ <entry>mysql.max_links</entry>
+ <entry>"-1"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ </row>
+ <row>
+ <entry>mysql.default_port</entry>
+ <entry>NULL</entry>
+ <entry>PHP_INI_ALL</entry>
+ </row>
+ <row>
+ <entry>mysql.default_socket</entry>
+ <entry>NULL</entry>
+ <entry>PHP_INI_ALL</entry>
+ </row>
+ <row>
+ <entry>mysql.default_host</entry>
+ <entry>NULL</entry>
+ <entry>PHP_INI_ALL</entry>
+ </row>
+ <row>
+ <entry>mysql.default_user</entry>
+ <entry>NULL</entry>
+ <entry>PHP_INI_ALL</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ Aby uzyska� wi�cej informacji na temat sta�ych PHP_INI_* zobacz
+ <function>ini_set</function>.
+ </para>
+ </section>
+
+ <section id="mysql.resources">
+ <title>Rodzaje zasob�w</title>
+ <para>
+ Modu� MySQL wykorzystuje dwa rodzaje zasob�w. Pierwszym jest identyfikator
+ po��czenia z baz� danych, drugim za� zas�b wyniku, przechowuj�cy rezultat
+ zapytania.
+ </para>
+ </section>
+
+ <section id="mysql.constants">
+ <title>Predefiniowane sta�e</title>
+ <para>
+ Funkcja <function>mysql_fetch_array</function> u�ywa sta�ych dla r�nych
+ typ�w tablic wynikowych. Zdefiniowane s� nast�puj�ce sta�e:
+ <table>
+ <title>Sta�e pobierania MySQL</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>sta�a</entry>
+ <entry>znaczenie</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>MYSQL_ASSOC</entry>
+ <entry>
+ Kolumny s� zwracane jako tablica, kt�rej indeks stanowi� nazwy p�l.
+ </entry>
+ </row>
+ <row>
+ <entry>MYSQL_BOTH</entry>
+ <entry>
+ Kolumny s� zwracane jako tablica, indeksowana zar�wno nazwami p�l,
+ jak i numerycznie.
+ </entry>
+ </row>
+ <row>
+ <entry>MYSQL_NUM</entry>
+ <entry>
+ Kolumny s� zwracane jako tablica indeksowana numerycznie. Indeks
+ zaczyna si� od 0 i wskazuje na pierwsze pole w wyniku.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ </section>
+
+
+ <section id="mysql.examples">
+ <title>Przyk�ady</title>
+ <para>
+ Ten prosty przyk�ad demonstruje jak po��czy� si�, wykona� zapytanie,
+ wy�wietli� wyniki i roz��czy� si� z baz� MySQL.
+ <example>
+ <title>Wykorzystanie funkcji MySQL</title>
+ <programlisting role="php">
+<![CDATA[
<?php
// ��czenie i wybranie bazy
$link = mysql_connect("host", "login", "haslo")
@@ -111,13 +182,17 @@
}
print "</table>\n";
+// Zwalnianie pami�ci
+mysql_free_result($result);
+
// Roz��czanie
mysql_close($link);
?>
]]>
- </programlisting>
- </example>
- </para>
+ </programlisting>
+ </example>
+ </para>
+ </section>
</partintro>
<refentry id="function.mysql-affected-rows">
@@ -292,6 +367,9 @@
<methodparam choice="opt"><type>string</type><parameter>
has�o
</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>
+ nowy_identyfikator
+ </parameter></methodparam>
</methodsynopsis>
<para>
Zwraca identyfikator po��czenia w przypadku powodzenia, lub
@@ -318,15 +396,25 @@
</para>
<para>
Mo�esz pomin�� wy�wietlenie komunikatu b��du przy niepowodzeniu
- poprzedzaj�c nazw� funkcji znakiem '@'.
+ poprzedzaj�c nazw� funkcji znakiem
+ <link linkend="language.operators.errorcontrol">@</link>.
</para>
</note>
</para>
<para>
Przy drugim wywo�aniu <function>mysql_connect</function> z tymi
samymi argumentami, nie b�dzie nawi�zywane nowe po��czenie, lecz
- zwr�cony zostanie identyfikator ju� otwartego po��czenia.
+ zwr�cony zostanie identyfikator ju� otwartego po��czenia. Argument
+ <parameter>nowy_identyfikator</parameter> zmienia to zachowanie,
+ powoduj�c, �e <function>mysql_connect</function> za ka�dym razem otwiera
+ nowe po��czenie, nawet je�li funkcja by�a wcze�niej wywo�ana z identycznymi
+ parametrami.
</para>
+ <note>
+ <para>
+ Argument <parameter>nowy_identyfikator</parameter> pojawi� si� w PHP 4.2.0
+ </para>
+ </note>
<para>
Po��czenie z serwerem zostanie zamkni�te zaraz po zako�czeniu
wykonywania skryptu, chyba �e zostanie zamkni�te wcze�niej przez
@@ -1769,7 +1857,8 @@
</note>
<para>
<function>mysql_query</function> zwraca identyfikator wyniku (lub &false;
- w przypadku niepowodzenia) jedynie dla zapyta� typu SELECT.
+ w przypadku niepowodzenia) jedynie dla zapyta� typu SELECT, SHOW, EXPLAIN
+ i DESCRIBE.
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
@@ -1822,11 +1911,11 @@
wierszy przetworzonych przez instrukcje DELETE, INSERT, REPLACE i UPDATE.
</para>
<para>
- Jedynie po operacji SELECT, <function>mysql_query</function> zwr�ci
- identyfikator wyniku, kt�ry mo�na przekaza� do
- 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
+ Jedynie po operacjach SELECT, SHOW, EXPLAIN i DESCRIBE
+ <function>mysql_query</function> zwr�ci identyfikator wyniku, kt�ry mo�na
+ przekaza� do funkcji <function>mysql_fetch_array</function> lub innych
+ funkcji operuj�cych na tablicach wynik�w. Po wykonaniu 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>
