cvs: phpdoc /pl Translators /pl/chapters install.xml /pl/functions session.xml
| From: | Leszek Krupinski | Date: | Sat, 22 Dec 2001 17:19:30 +0000 |
| Subject: | cvs: phpdoc /pl Translators /pl/chapters install.xml /pl/functions session.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969340275@lists.php.net to get a copy of this message | ||
leszek Sat Dec 22 12:19:30 2001 EDT
Modified files:
/phpdoc/pl Translators
/phpdoc/pl/chapters install.xml
/phpdoc/pl/functions session.xml
Log:
Updated session.xml to 1.70 and install.xml to 1.96
Index: phpdoc/pl/Translators diff -u phpdoc/pl/Translators:1.23 phpdoc/pl/Translators:1.24 --- phpdoc/pl/Translators:1.23 Thu Dec 20 07:37:10 2001 +++ phpdoc/pl/Translators Sat Dec 22 12:19:29 2001 @@ -30,7 +30,7 @@ resources.xml ------- chapters ---------------------------------------------------------- config.xml Leon done 1.31 -install.xml Leon done 1.94 +install.xml Leon done 1.96 intro.xml Leon done 1.24 security.xml ------- faq --------------------------------------------------------------- @@ -137,7 +137,7 @@ satellite.xml sem.xml sesam.xml -session.xml leon done 1.55 +session.xml leon done 1.70 shmop.xml snmp.xml sockets.xml Index: phpdoc/pl/chapters/install.xml diff -u phpdoc/pl/chapters/install.xml:1.9 phpdoc/pl/chapters/install.xml:1.10 --- phpdoc/pl/chapters/install.xml:1.9 Thu Dec 20 07:38:39 2001 +++ phpdoc/pl/chapters/install.xml Sat Dec 22 12:19:29 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.94 Maintainer: leon Status: ready --> -<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.96 Maintainer: leon Status: ready --> +<!-- $Revision: 1.10 $ --> <chapter id="installation"> <title>Instalacja</title> <sect1 id="install.general"> @@ -169,7 +169,7 @@ <title> Instrukcja szubkiej instalacji PHP 4 (jako modu³ Apache'a) </title> - <programlisting> + <programlisting role="shell"> <![CDATA[ 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar @@ -3259,7 +3259,7 @@ <listitem> <para> Zdekompresuj plik dystrybucyjny do dowolnego katalogu, np. - <filename>C:\php\</filename>. + <filename>c:\php\</filename>. </para> </listitem> <listitem> @@ -5181,6 +5181,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/session.xml diff -u phpdoc/pl/functions/session.xml:1.7 phpdoc/pl/functions/session.xml:1.8 --- phpdoc/pl/functions/session.xml:1.7 Fri Dec 21 18:08:47 2001 +++ phpdoc/pl/functions/session.xml Sat Dec 22 12:19:30 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.55 Maintainer: leon Status: ready --> -<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.70 Maintainer: leon Status: ready --> +<!-- $Revision: 1.8 $ --> <reference id="ref.session"> <title>Funkje obs³ugi sesji</title> <titleabbrev>Sesje</titleabbrev> @@ -149,7 +149,7 @@ $count++; ?> -Witaj go¶ciu. Ogl±dasz t± stronê <?php echo $count; ?> raz.<p> +Witaj go¶ciu. Ogl±dasz t± stronê <?php echo $count; ?> raz.<p> <?php # <?=SID?> jest konieczne do zachowania identyfikatora sesji je¶li @@ -356,13 +356,21 @@ <simpara> <function>session_start</function> tworzy sesjê (lub odtwarza bie¿±c± w oparciu o identyfikator sesji przekazywany przez zmienne GET lub - ciasteczko).</simpara> + ciasteczko). + </simpara> + <simpara> + Je¶li chcesz, aby sesja by³a nazwana, przed wywo³aniem + <function>session_start</function> musisz wywo³aæ + <function>session_name</function>. + </simpara> <simpara> Ta funkcja zawsze zwraca warot¶æ &true;. </simpara> <note> <para> - Ta funkcja zosta³a dodana w PHP 4.0. + Je¶li u¿ywasz sesji opartych o ciasteczka, to + <function>session_start</function> musi byæ wywo³ane przed wys³aniem + jakichkolwiek danych do przegl±darki. </para> </note> </refsect1> @@ -383,12 +391,33 @@ </funcsynopsis> <simpara> <function>session_destroy</function> niszczy wszystkie dane skojarzone z - bie¿±c± sesj±. + bie¿±c± sesj±. Nie usuwa ¿adnych globalnych zmiennych zwi±zanych z sesj±. + Nie usuwa te¿ ciasteczka sesyjnego. </simpara> <simpara> Funkcja ta zawraca &true; w przypadku sukcesu w niszczeniu danych sesji. W przeciwnym przypadku zwracana jest warto¶æ &false;. </simpara> + <para> + <example> + <title>Niszczenie sesji</title> + <programlisting role="php"> +<![CDATA[ +<?php + +# Inicjalizuj sesjê +# Je¶li u¿ywasz sesion_name("co¶tam"), nie zapomnij o tym teraz! +session_start(); +# Usuñ wszystkie zmienne sesyjne +session_unset(); +# Na koniec, zniszcz sesjê +session_destroy(); + +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> @@ -437,11 +466,6 @@ ]]> </programlisting> </example> - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> </refsect1> </refentry> @@ -464,11 +488,6 @@ <function>session_module_name</function> zwraca nazwê bie¿±cego modu³u sesji. Je¶li podany zosta³ parametr <parameter>modu³</parameter>, u¿yty zostanie nowo podany modu³. - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -501,11 +520,6 @@ ni¿ ext2fs. </para> </note> - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -560,9 +574,39 @@ ka¿dej napotkanej nazwy zmiennej, <function>session_register</function> rejestruje w bie¿±cej sesji globaln± zmienn± o danej nazwie. </para> + <caution> + <para> + Funkcja ta rejestruje <emphasis>globaln±</emphasis> zmienn±. Je¶li + chcesz zarejestrowaæ zmienn± w sesji z wnêtrza funkcji, musisz siê + upewniæ ¿e jest ona globalna prez u¿ycie <function>global</function> lub + u¿ywaj±c tablic sesyjnych, tak jak to opisano poni¿ej. + </para> + </caution> <para> - Funkcja ta zwraca warto¶æ &true; je¶li zmienna zosta³a pomy¶lnie - zarejestrowana w sesji. + Funkcja ta zwraca warto¶æ &true; je¶li wszystkie zmienne zosta³y + pomy¶lnie zarejestrowane w sesji. + </para> + <para> + Je¶li przed wywo³aniem tej funkcji nie wywo³ano + <function>session_start</function>, dokonane zostanie niejawne wywo³anie + <function>session_start</function> bez ¿adnych parametrów. + </para> + <para> + Mo¿esz tworzyæ zmienne sesyjne poprostu przez dopisywanie odpowiednicz + wpisów do tablic $HTTP_SESSION_VARS lub $_SESSION (PHP >= 4.1.0). + <informalexample> + <programlisting role="php"> +<![CDATA[ +$barney = "Du¿y fioletowy dinozaur."; +session_register("barney"); + +$HTTP_SESSION_VARS["zim"] = "Naje¼d¼ca z innej planety."; + +# tablica $_SESSION typu auto-global zosta³a wprowadzona w PHP 4.1.0 +#_SESSION["spongebob"] = "Ma kwadratowe spodnie."; +]]> + </programlisting> + </informalexample> </para> <note> <para> @@ -576,11 +620,10 @@ <link linkend="resource">typy zasobów</link>. </para> </note> - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> + <para> + Patrz tak¿e <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> </refsect1> </refentry> @@ -606,12 +649,15 @@ <para> Funkcja ta zwraca warto¶æ &true; je¶li zmienna zosta³a pomy¶lnie wyrejestrowana z sesji. - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> </para> + <caution> + <para> + Ta funkcja nie usuwa zmiennej globalnej o nazwie + <parameter>nazwa</parameter>, a jedynie zapobiega zapisaniu tej zmiennej + jako czê¶ci sesji. Je¶li chcesz usun±æ odpowiedni± zmienn± globaln±, + musisz u¿yæ funkcji <function>unset</function>. + </para> + </caution> </refsect1> </refentry> @@ -656,11 +702,6 @@ <function>session_is_registered</function> zwraca warto¶æ &true; je¶li w bie¿±cej sesji zarejestrowana jest zmienna o nazwie <parameter>nazwa</parameter>. - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -702,6 +743,12 @@ "domain" - Domena ciasteczka. </simpara> </listitem> + <listitem> + <simpara> + "secure" - Ciasteczko powinno byæ przes³ane tylko przez bezpieczne + po³±czenie. (Ten element zosta³ dodany w PHP 4.0.4.) + </simpara> + </listitem> </itemizedlist> </para> </refsect1> @@ -754,11 +801,6 @@ <function>session_decode</function> dekofuje dane sesji zawarte w parametrze <parameter>dane</parameter>, ustawiaj±c zmienne zachowane w sesji. - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -781,11 +823,6 @@ <para> <function>session_encode</function> zwraca string zawieraj±cy zakodowane dane bie¿±cej sesji. - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -987,11 +1024,29 @@ ]]> </programlisting> </example> - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0.3. - </para> - </note> + </refsect1> + </refentry> + + <refentry id='function.session-cache-expire'> + <refnamediv> + <refname>session_cache_expire</refname> + <refpurpose>Zwróæ bie¿±cy czas przedawnienia pamiêci podrêcznej</refpurpose> + </refnamediv> + <refsect1> + <title>Opis</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>session_cache_expire</function></funcdef> + <paramdef>int + <parameter><optional>nowy_czas</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>session_cache_expire</function> zwraca aktualny czas + przedawnienia pamiêci podrêcznej. Je¶li podany zostanie + <parameter>nowy_czas</parameter>, to bie¿±cy czas zostanie + zast±piony przez ten podany w parametrze. + </para> </refsect1> </refentry>
Index: phpdoc/pl/Translators diff -u phpdoc/pl/Translators:1.23 phpdoc/pl/Translators:1.24 --- phpdoc/pl/Translators:1.23 Thu Dec 20 07:37:10 2001 +++ phpdoc/pl/Translators Sat Dec 22 12:19:29 2001 @@ -30,7 +30,7 @@ resources.xml ------- chapters ---------------------------------------------------------- config.xml Leon done 1.31 -install.xml Leon done 1.94 +install.xml Leon done 1.96 intro.xml Leon done 1.24 security.xml ------- faq --------------------------------------------------------------- @@ -137,7 +137,7 @@ satellite.xml sem.xml sesam.xml -session.xml leon done 1.55 +session.xml leon done 1.70 shmop.xml snmp.xml sockets.xml Index: phpdoc/pl/chapters/install.xml diff -u phpdoc/pl/chapters/install.xml:1.9 phpdoc/pl/chapters/install.xml:1.10 --- phpdoc/pl/chapters/install.xml:1.9 Thu Dec 20 07:38:39 2001 +++ phpdoc/pl/chapters/install.xml Sat Dec 22 12:19:29 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.94 Maintainer: leon Status: ready --> -<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.96 Maintainer: leon Status: ready --> +<!-- $Revision: 1.10 $ --> <chapter id="installation"> <title>Instalacja</title> <sect1 id="install.general"> @@ -169,7 +169,7 @@ <title> Instrukcja szubkiej instalacji PHP 4 (jako modu³ Apache'a) </title> - <programlisting> + <programlisting role="shell"> <![CDATA[ 1. gunzip apache_1.3.x.tar.gz 2. tar xvf apache_1.3.x.tar @@ -3259,7 +3259,7 @@ <listitem> <para> Zdekompresuj plik dystrybucyjny do dowolnego katalogu, np. - <filename>C:\php\</filename>. + <filename>c:\php\</filename>. </para> </listitem> <listitem> @@ -5181,6 +5181,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/session.xml diff -u phpdoc/pl/functions/session.xml:1.7 phpdoc/pl/functions/session.xml:1.8 --- phpdoc/pl/functions/session.xml:1.7 Fri Dec 21 18:08:47 2001 +++ phpdoc/pl/functions/session.xml Sat Dec 22 12:19:30 2001 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.55 Maintainer: leon Status: ready --> -<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.70 Maintainer: leon Status: ready --> +<!-- $Revision: 1.8 $ --> <reference id="ref.session"> <title>Funkje obs³ugi sesji</title> <titleabbrev>Sesje</titleabbrev> @@ -149,7 +149,7 @@ $count++; ?> -Witaj go¶ciu. Ogl±dasz t± stronê <?php echo $count; ?> raz.<p> +Witaj go¶ciu. Ogl±dasz t± stronê <?php echo $count; ?> raz.<p> <?php # <?=SID?> jest konieczne do zachowania identyfikatora sesji je¶li @@ -356,13 +356,21 @@ <simpara> <function>session_start</function> tworzy sesjê (lub odtwarza bie¿±c± w oparciu o identyfikator sesji przekazywany przez zmienne GET lub - ciasteczko).</simpara> + ciasteczko). + </simpara> + <simpara> + Je¶li chcesz, aby sesja by³a nazwana, przed wywo³aniem + <function>session_start</function> musisz wywo³aæ + <function>session_name</function>. + </simpara> <simpara> Ta funkcja zawsze zwraca warot¶æ &true;. </simpara> <note> <para> - Ta funkcja zosta³a dodana w PHP 4.0. + Je¶li u¿ywasz sesji opartych o ciasteczka, to + <function>session_start</function> musi byæ wywo³ane przed wys³aniem + jakichkolwiek danych do przegl±darki. </para> </note> </refsect1> @@ -383,12 +391,33 @@ </funcsynopsis> <simpara> <function>session_destroy</function> niszczy wszystkie dane skojarzone z - bie¿±c± sesj±. + bie¿±c± sesj±. Nie usuwa ¿adnych globalnych zmiennych zwi±zanych z sesj±. + Nie usuwa te¿ ciasteczka sesyjnego. </simpara> <simpara> Funkcja ta zawraca &true; w przypadku sukcesu w niszczeniu danych sesji. W przeciwnym przypadku zwracana jest warto¶æ &false;. </simpara> + <para> + <example> + <title>Niszczenie sesji</title> + <programlisting role="php"> +<![CDATA[ +<?php + +# Inicjalizuj sesjê +# Je¶li u¿ywasz sesion_name("co¶tam"), nie zapomnij o tym teraz! +session_start(); +# Usuñ wszystkie zmienne sesyjne +session_unset(); +# Na koniec, zniszcz sesjê +session_destroy(); + +?> +]]> + </programlisting> + </example> + </para> </refsect1> </refentry> @@ -437,11 +466,6 @@ ]]> </programlisting> </example> - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> </refsect1> </refentry> @@ -464,11 +488,6 @@ <function>session_module_name</function> zwraca nazwê bie¿±cego modu³u sesji. Je¶li podany zosta³ parametr <parameter>modu³</parameter>, u¿yty zostanie nowo podany modu³. - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -501,11 +520,6 @@ ni¿ ext2fs. </para> </note> - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -560,9 +574,39 @@ ka¿dej napotkanej nazwy zmiennej, <function>session_register</function> rejestruje w bie¿±cej sesji globaln± zmienn± o danej nazwie. </para> + <caution> + <para> + Funkcja ta rejestruje <emphasis>globaln±</emphasis> zmienn±. Je¶li + chcesz zarejestrowaæ zmienn± w sesji z wnêtrza funkcji, musisz siê + upewniæ ¿e jest ona globalna prez u¿ycie <function>global</function> lub + u¿ywaj±c tablic sesyjnych, tak jak to opisano poni¿ej. + </para> + </caution> <para> - Funkcja ta zwraca warto¶æ &true; je¶li zmienna zosta³a pomy¶lnie - zarejestrowana w sesji. + Funkcja ta zwraca warto¶æ &true; je¶li wszystkie zmienne zosta³y + pomy¶lnie zarejestrowane w sesji. + </para> + <para> + Je¶li przed wywo³aniem tej funkcji nie wywo³ano + <function>session_start</function>, dokonane zostanie niejawne wywo³anie + <function>session_start</function> bez ¿adnych parametrów. + </para> + <para> + Mo¿esz tworzyæ zmienne sesyjne poprostu przez dopisywanie odpowiednicz + wpisów do tablic $HTTP_SESSION_VARS lub $_SESSION (PHP >= 4.1.0). + <informalexample> + <programlisting role="php"> +<![CDATA[ +$barney = "Du¿y fioletowy dinozaur."; +session_register("barney"); + +$HTTP_SESSION_VARS["zim"] = "Naje¼d¼ca z innej planety."; + +# tablica $_SESSION typu auto-global zosta³a wprowadzona w PHP 4.1.0 +#_SESSION["spongebob"] = "Ma kwadratowe spodnie."; +]]> + </programlisting> + </informalexample> </para> <note> <para> @@ -576,11 +620,10 @@ <link linkend="resource">typy zasobów</link>. </para> </note> - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> + <para> + Patrz tak¿e <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> </refsect1> </refentry> @@ -606,12 +649,15 @@ <para> Funkcja ta zwraca warto¶æ &true; je¶li zmienna zosta³a pomy¶lnie wyrejestrowana z sesji. - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> </para> + <caution> + <para> + Ta funkcja nie usuwa zmiennej globalnej o nazwie + <parameter>nazwa</parameter>, a jedynie zapobiega zapisaniu tej zmiennej + jako czê¶ci sesji. Je¶li chcesz usun±æ odpowiedni± zmienn± globaln±, + musisz u¿yæ funkcji <function>unset</function>. + </para> + </caution> </refsect1> </refentry> @@ -656,11 +702,6 @@ <function>session_is_registered</function> zwraca warto¶æ &true; je¶li w bie¿±cej sesji zarejestrowana jest zmienna o nazwie <parameter>nazwa</parameter>. - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -702,6 +743,12 @@ "domain" - Domena ciasteczka. </simpara> </listitem> + <listitem> + <simpara> + "secure" - Ciasteczko powinno byæ przes³ane tylko przez bezpieczne + po³±czenie. (Ten element zosta³ dodany w PHP 4.0.4.) + </simpara> + </listitem> </itemizedlist> </para> </refsect1> @@ -754,11 +801,6 @@ <function>session_decode</function> dekofuje dane sesji zawarte w parametrze <parameter>dane</parameter>, ustawiaj±c zmienne zachowane w sesji. - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -781,11 +823,6 @@ <para> <function>session_encode</function> zwraca string zawieraj±cy zakodowane dane bie¿±cej sesji. - <note> - <para> - Ta funkcja zosta³a dodana w PHP 4.0. - </para> - </note> </para> </refsect1> </refentry> @@ -987,11 +1024,29 @@ ]]> </programlisting> </example> - <note> - <para> - Funkcja ta zosta³a dodana w PHP 4.0.3. - </para> - </note> + </refsect1> + </refentry> + + <refentry id='function.session-cache-expire'> + <refnamediv> + <refname>session_cache_expire</refname> + <refpurpose>Zwróæ bie¿±cy czas przedawnienia pamiêci podrêcznej</refpurpose> + </refnamediv> + <refsect1> + <title>Opis</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>session_cache_expire</function></funcdef> + <paramdef>int + <parameter><optional>nowy_czas</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>session_cache_expire</function> zwraca aktualny czas + przedawnienia pamiêci podrêcznej. Je¶li podany zostanie + <parameter>nowy_czas</parameter>, to bie¿±cy czas zostanie + zast±piony przez ten podany w parametrze. + </para> </refsect1> </refentry>