cvs: phpdoc /pl/language variables.xml
| From: | Slawomir Pucia | Date: | Sat, 30 Mar 2002 16:18:16 +0000 |
| Subject: | cvs: phpdoc /pl/language variables.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969343862@lists.php.net to get a copy of this message | ||
slawek Sat Mar 30 11:18:16 2002 EDT
Modified files:
/phpdoc/pl/language variables.xml
Log:
Updated to EN 1.42 (qrak)
Index: phpdoc/pl/language/variables.xml diff -u phpdoc/pl/language/variables.xml:1.5 phpdoc/pl/language/variables.xml:1.6 --- phpdoc/pl/language/variables.xml:1.5 Mon Feb 11 16:34:21 2002 +++ phpdoc/pl/language/variables.xml Sat Mar 30 11:18:16 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.35 Maintainer: Qrak Status: ready --> -<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.42 Maintainer: Qrak Status: ready --> +<!-- $Revision: 1.6 $ --> <chapter id="language.variables"> <title>Zmienne</title> @@ -112,13 +112,169 @@ <title>Zmienne predefiniowane</title> <simpara> - PHP udostêpnia du¿± ilo¶æ predefiniowanych zmiennych dla ka¿dego pracuj±cego - skryptu. Jednak¿e wiele spo¶ród tych zmiennych nie mo¿e byæ w pe³ni + PHP udostêpnia dla ka¿dego pracuj±cego skryptu du¿± ilo¶æ predefiniowanych + zmiennych. Jednak¿e wiele spo¶ród tych zmiennych nie mo¿e byæ w pe³ni obja¶nionych, gdy¿ s± zale¿ne od rodzaju serwera, jego wersji i ustawieñ i innych czynników. Niektóre z tych zmiennych nie bêd± dostêpne dla - skryptów PHP uruchomionych z linii poleceñ. + skryptów PHP uruchomionych z linii poleceñ. Lista tych zmiennych znajduje + siê w rozdziale <link linkend="reserved.variables">predefiniowane + zmienne</link>. </simpara> - + <warning> + <simpara> + W PHP 4.2.0 i pó¼niejszych, domy¶lne ustawienie, które udostêpnia³o + predefiniowane zmienne w zasiêgu globalnym, zosta³o zmienione. Zmienne + nadchodz±ce metod± GET i POST oraz zmienne serwera + <emphasis>domy¶lnie</emphasis> nie s± ju¿ umieszczane w zasiêgu globalnym. + Zamiast tego umieszczane s± w odpowiednich <link + linkend="language.variables.superglobals">tablicach superglobalnych</link>. + </simpara> + <simpara> + Nadal mo¿na uruchomiæ udostêpnianie tych zmiennych w zasiêgu globalnym + przez ustawienie dyrektywy konfiguracyjnej <link + linkend="ini.register-globals">register_globals</link> na "On" w pliku + &php.ini;. + </simpara> + <simpara> + Wiêcej informacji odno¶nie tej zmiany, wraz z wyja¶nieniem + przyczyn, w <ulink url="&url.php.release4.1.0;">PHP 4.1.0 Release + Announcement</ulink>. <!-- zostawi³em oryginaln± nazwê z 2 powodów: + - uzna³em to za nazwê oficjaln±, która nie podlega t³umaczeniu + - nie mog³em wymy¶liæ ¿adnego zgrabnego t³umaczenia tego na polski + (Informacja o wydaniu PHP 4.1.0 ?)--> + </simpara> + </warning> + <simpara> + Pocz±wszy od wersji 4.1.0, PHP udostêpnia zestaw predefiniowanych tablic, + które zawieraj± zmienne serwera, zmienne ¶rodowiskowe oraz zmienne + u¿ytkownika. Tablice te s± do¶æ specyficzne, gdy¿ s± one automatycznie + globalne, tzn. automatycznie dostêpne w ka¿dym zasiêgu. Dlatego nazywa siê + je "autoglobalami" albo "superglobalami". (W PHP nie ma mechanizmu + pozwalaj±cego u¿ytkownikowi na definiowanie w³asnych superglobali.) + Superglobale PHP wymienione s± poni¿ej, jednak¿e wykaz ich zawarto¶ci i + g³êbsze omówienie prefiniowanych zmiennych PHP oraz ich natury znajduje + siê w rozdziale <link linkend="reserved.variables">predefiniowane + zmienne</link>. + </simpara> + <variablelist id="language.variables.superglobals"> + <title>Superglobale PHP</title> + <varlistentry> + <term><link +linkend="reserved.variables.globals">$GLOBALS</link></term> + <listitem> + <simpara> + Zawiera referencje do ka¿dej ze zmiennych aktualnie dostêpnych w zasiêgu + globalnym skryptu. Kluczami tablicy s± nazwy zmiennych globalnych. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.server">$_SERVER</link></term> + <listitem> + <simpara> + Zmienne tworzone przez serwer lub bezpo¶rednio powi±zane ze ¶rodowiskiem + uruchomieniowym danego skryptu. Analogiczna do dawnej tablicy + <varname>$HTTP_SERVER_VARS</varname> (która jest nadal dostêpna, ale + uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.get">$_GET</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu za pomoc± metod± GET protoko³u HTTP. + Analogiczna do dawnej tablicy <varname>$HTTP_GET_VARS</varname> (która + jest nadal dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.post">$_POST</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu metod± POST protoko³u HTTP. Analogiczna + do dawnej tablicy <varname>$HTTP_POST_VARS</varname> (która jest nadal + dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.cookies">$_COOKIE</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu przez ciasteczka HTTP. Analogiczna do + dawnej tablicy <varname>$HTTP_COOKIE_VARS</varname> (która jest nadal + dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.files">$_FILES</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu przez przes³anie plików do serwera metod± + POST protoko³u HTTP. Analogiczna do dawnej tablicy + <varname>$HTTP_POST_FILES</varname> (która jest nadal dostêpna, ale + uznana za przestarza³±). Wiêcej na ten temat w rozdziale <link + linkend="features.file-upload.post-method">przesy³anie plików metod± + POST</link>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.environment">$_ENV</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu przez ¶rodowisko operacyjne. Analogiczna + do dawnej tablicy <varname>$HTTP_ENV_VARS</varname> (która jest nadal + dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.request">$_REQUEST</link></term> + <listitem> + <simpara> + Zmienne u¿ytkownika dostarczone do skryptu przez ka¿dy mechanizm wej¶cia, + przez co nie mog± byæ godne zaufania. Uwaga: kiedy skrypt jest + uruchomiony z linii poleceñ, tablica ta <emphasis>nie</emphasis> zawiera + zmiennych <varname>argv</varname> i <varname>argc</varname>. Zmienne + te s± dostêpne w tablicy <varname>$_SERVER</varname>. Obecno¶æ i + kolejno¶æ do³±czania zmiennych do tej tablicy zale¿y od dyrektywy + konfiguracyjnej <link + linkend="ini.variables-order">variables_order</link>. Tablica ta nie + posiada swoich odpowiedników we wcze¶niejszych wersjach PHP. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.session">$_SESSION</link></term> + <listitem> + <simpara> + Zmienne aktualnie zarejestrowane jako sesyjne. Analogiczne do dawnej + tablicy <varname>$HTTP_SESSION_VARS</varname> (która jest wci±¿ dostêpna, + ale uznana za przestarza³±). Wiêcej informacji w rozdziale <link + linkend="ref.session">funkcje obs³ugi sesji</link>. + </simpara> + </listitem> + </varlistentry> + </variablelist> + <!-- + + na razie nie usuwaæ tego - przyda siê przy t³umaczeniu rozdzia³u, + do którego zosta³o to przeniesione + + Qrak + <simpara> Niezale¿nie od wymienionych czynników, poni¿ej przedstawiamy listê predefiniowanych zmiennych, dostêpnych w typowej instalacji PHP 3, @@ -156,7 +312,8 @@ dostêpnych (albo bêdzie mieæ jakiekolwiek znaczenie) kiedy skrypt PHP jest uruchomiony z linii poleceñ. </simpara> - + + <para> <variablelist> <varlistentry> @@ -410,7 +567,7 @@ </varlistentry> </variablelist> </para> - + </sect2> <sect2 id="language.variables.predefined.environment"> @@ -686,7 +843,7 @@ </para> </sect2> - + --> </sect1>
Index: phpdoc/pl/language/variables.xml diff -u phpdoc/pl/language/variables.xml:1.5 phpdoc/pl/language/variables.xml:1.6 --- phpdoc/pl/language/variables.xml:1.5 Mon Feb 11 16:34:21 2002 +++ phpdoc/pl/language/variables.xml Sat Mar 30 11:18:16 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.35 Maintainer: Qrak Status: ready --> -<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.42 Maintainer: Qrak Status: ready --> +<!-- $Revision: 1.6 $ --> <chapter id="language.variables"> <title>Zmienne</title> @@ -112,13 +112,169 @@ <title>Zmienne predefiniowane</title> <simpara> - PHP udostêpnia du¿± ilo¶æ predefiniowanych zmiennych dla ka¿dego pracuj±cego - skryptu. Jednak¿e wiele spo¶ród tych zmiennych nie mo¿e byæ w pe³ni + PHP udostêpnia dla ka¿dego pracuj±cego skryptu du¿± ilo¶æ predefiniowanych + zmiennych. Jednak¿e wiele spo¶ród tych zmiennych nie mo¿e byæ w pe³ni obja¶nionych, gdy¿ s± zale¿ne od rodzaju serwera, jego wersji i ustawieñ i innych czynników. Niektóre z tych zmiennych nie bêd± dostêpne dla - skryptów PHP uruchomionych z linii poleceñ. + skryptów PHP uruchomionych z linii poleceñ. Lista tych zmiennych znajduje + siê w rozdziale <link linkend="reserved.variables">predefiniowane + zmienne</link>. </simpara> - + <warning> + <simpara> + W PHP 4.2.0 i pó¼niejszych, domy¶lne ustawienie, które udostêpnia³o + predefiniowane zmienne w zasiêgu globalnym, zosta³o zmienione. Zmienne + nadchodz±ce metod± GET i POST oraz zmienne serwera + <emphasis>domy¶lnie</emphasis> nie s± ju¿ umieszczane w zasiêgu globalnym. + Zamiast tego umieszczane s± w odpowiednich <link + linkend="language.variables.superglobals">tablicach superglobalnych</link>. + </simpara> + <simpara> + Nadal mo¿na uruchomiæ udostêpnianie tych zmiennych w zasiêgu globalnym + przez ustawienie dyrektywy konfiguracyjnej <link + linkend="ini.register-globals">register_globals</link> na "On" w pliku + &php.ini;. + </simpara> + <simpara> + Wiêcej informacji odno¶nie tej zmiany, wraz z wyja¶nieniem + przyczyn, w <ulink url="&url.php.release4.1.0;">PHP 4.1.0 Release + Announcement</ulink>. <!-- zostawi³em oryginaln± nazwê z 2 powodów: + - uzna³em to za nazwê oficjaln±, która nie podlega t³umaczeniu + - nie mog³em wymy¶liæ ¿adnego zgrabnego t³umaczenia tego na polski + (Informacja o wydaniu PHP 4.1.0 ?)--> + </simpara> + </warning> + <simpara> + Pocz±wszy od wersji 4.1.0, PHP udostêpnia zestaw predefiniowanych tablic, + które zawieraj± zmienne serwera, zmienne ¶rodowiskowe oraz zmienne + u¿ytkownika. Tablice te s± do¶æ specyficzne, gdy¿ s± one automatycznie + globalne, tzn. automatycznie dostêpne w ka¿dym zasiêgu. Dlatego nazywa siê + je "autoglobalami" albo "superglobalami". (W PHP nie ma mechanizmu + pozwalaj±cego u¿ytkownikowi na definiowanie w³asnych superglobali.) + Superglobale PHP wymienione s± poni¿ej, jednak¿e wykaz ich zawarto¶ci i + g³êbsze omówienie prefiniowanych zmiennych PHP oraz ich natury znajduje + siê w rozdziale <link linkend="reserved.variables">predefiniowane + zmienne</link>. + </simpara> + <variablelist id="language.variables.superglobals"> + <title>Superglobale PHP</title> + <varlistentry> + <term><link +linkend="reserved.variables.globals">$GLOBALS</link></term> + <listitem> + <simpara> + Zawiera referencje do ka¿dej ze zmiennych aktualnie dostêpnych w zasiêgu + globalnym skryptu. Kluczami tablicy s± nazwy zmiennych globalnych. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.server">$_SERVER</link></term> + <listitem> + <simpara> + Zmienne tworzone przez serwer lub bezpo¶rednio powi±zane ze ¶rodowiskiem + uruchomieniowym danego skryptu. Analogiczna do dawnej tablicy + <varname>$HTTP_SERVER_VARS</varname> (która jest nadal dostêpna, ale + uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.get">$_GET</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu za pomoc± metod± GET protoko³u HTTP. + Analogiczna do dawnej tablicy <varname>$HTTP_GET_VARS</varname> (która + jest nadal dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.post">$_POST</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu metod± POST protoko³u HTTP. Analogiczna + do dawnej tablicy <varname>$HTTP_POST_VARS</varname> (która jest nadal + dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.cookies">$_COOKIE</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu przez ciasteczka HTTP. Analogiczna do + dawnej tablicy <varname>$HTTP_COOKIE_VARS</varname> (która jest nadal + dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.files">$_FILES</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu przez przes³anie plików do serwera metod± + POST protoko³u HTTP. Analogiczna do dawnej tablicy + <varname>$HTTP_POST_FILES</varname> (która jest nadal dostêpna, ale + uznana za przestarza³±). Wiêcej na ten temat w rozdziale <link + linkend="features.file-upload.post-method">przesy³anie plików metod± + POST</link>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.environment">$_ENV</link></term> + <listitem> + <simpara> + Zmienne dostarczone do skryptu przez ¶rodowisko operacyjne. Analogiczna + do dawnej tablicy <varname>$HTTP_ENV_VARS</varname> (która jest nadal + dostêpna, ale uznana za przestarza³±). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.request">$_REQUEST</link></term> + <listitem> + <simpara> + Zmienne u¿ytkownika dostarczone do skryptu przez ka¿dy mechanizm wej¶cia, + przez co nie mog± byæ godne zaufania. Uwaga: kiedy skrypt jest + uruchomiony z linii poleceñ, tablica ta <emphasis>nie</emphasis> zawiera + zmiennych <varname>argv</varname> i <varname>argc</varname>. Zmienne + te s± dostêpne w tablicy <varname>$_SERVER</varname>. Obecno¶æ i + kolejno¶æ do³±czania zmiennych do tej tablicy zale¿y od dyrektywy + konfiguracyjnej <link + linkend="ini.variables-order">variables_order</link>. Tablica ta nie + posiada swoich odpowiedników we wcze¶niejszych wersjach PHP. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link +linkend="reserved.variables.session">$_SESSION</link></term> + <listitem> + <simpara> + Zmienne aktualnie zarejestrowane jako sesyjne. Analogiczne do dawnej + tablicy <varname>$HTTP_SESSION_VARS</varname> (która jest wci±¿ dostêpna, + ale uznana za przestarza³±). Wiêcej informacji w rozdziale <link + linkend="ref.session">funkcje obs³ugi sesji</link>. + </simpara> + </listitem> + </varlistentry> + </variablelist> + <!-- + + na razie nie usuwaæ tego - przyda siê przy t³umaczeniu rozdzia³u, + do którego zosta³o to przeniesione + + Qrak + <simpara> Niezale¿nie od wymienionych czynników, poni¿ej przedstawiamy listê predefiniowanych zmiennych, dostêpnych w typowej instalacji PHP 3, @@ -156,7 +312,8 @@ dostêpnych (albo bêdzie mieæ jakiekolwiek znaczenie) kiedy skrypt PHP jest uruchomiony z linii poleceñ. </simpara> - + + <para> <variablelist> <varlistentry> @@ -410,7 +567,7 @@ </varlistentry> </variablelist> </para> - + </sect2> <sect2 id="language.variables.predefined.environment"> @@ -686,7 +843,7 @@ </para> </sect2> - + --> </sect1>