cvs: phpdoc-pl /reference/session reference.xml /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-decode.xml
session-destroy.xml session-encode.xml session-get-cookie-params.xml session-id.xml session-is-registered.xml session-module-name.xml session-name.xml
session-readonly.xml session-register.xml session-save-path.xml session-set-cookie-params.xml session-set-save-handler.xml session-start.xml
session-unregister.xml session-unset.xml session-write-close.xml
| From: | Leszek Krupinski | Date: | Mon, 13 May 2002 21:10:00 +0000 |
| Subject: | cvs: phpdoc-pl /reference/session reference.xml /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-decode.xml session-destroy.xml session-encode.xml session-get-cookie-params.xml session-id.xml session-is-registered.xml session-module-name.xml session-name.xml session-readonly.xml session-register.xml session-save-path.xml session-set-cookie-params.xml session-set-save-handler.xml session-start.xml session-unregister.xml session-unset.xml session-write-close.xml |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969345553@lists.php.net to get a copy of this message | ||
leszek Mon May 13 17:10:00 2002 EDT
Modified files:
/phpdoc-pl/reference/session reference.xml
/phpdoc-pl/reference/session/functions session-cache-expire.xml
session-cache-limiter.xml
session-decode.xml
session-destroy.xml
session-encode.xml
session-get-cookie-params.xml
session-id.xml
session-is-registered.xml
session-module-name.xml
session-name.xml
session-readonly.xml
session-register.xml
session-save-path.xml
session-set-cookie-params.xml
session-set-save-handler.xml
session-start.xml
session-unregister.xml
session-unset.xml
session-write-close.xml
Log:
Updated session reference to newest version - 1.2, 1.3
Index: phpdoc-pl/reference/session/reference.xml diff -u phpdoc-pl/reference/session/reference.xml:1.2 phpdoc-pl/reference/session/reference.xml:1.3 --- phpdoc-pl/reference/session/reference.xml:1.2 Tue Apr 16 20:05:32 2002 +++ phpdoc-pl/reference/session/reference.xml Mon May 13 17:09:56 2002 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.3 $ --> <reference id="ref.session"> <title>Sesje</title> <titleabbrev>Sesje</titleabbrev> @@ -13,7 +14,7 @@ </para> <para> Je¶li jeste¶ zaznajomiony z zarz±dzaniem sesj± w PHPLIB, zauwa¿ysz ¿e - pewnie koncepcje s± podobne w ob³udze sesji PHP. + pewnie koncepcje s± podobne w obs³udze sesji PHP. </para> <para> Go¶æ wchodz±cy na twoj± stronê WWW otrzymuje unikalny identyfikator, tzw. @@ -32,7 +33,7 @@ <para> Wszystkie zarejestrowane zmienne s± serializowane po wykonaniu ca³ego kodu strony. Zarejestrowane zmienne, które s± niezdefiniowane, s± zaznaczane - jako niezdefijiowane. Nie s± one definiowane przez modu³ sesji w + jako niezdefiniowane. Nie s± one definiowane przez modu³ sesji w nastêpuj±cych po sobie wywo³aniach, chyba ¿e u¿ytkownik zdefiniuje je pó¼niej. </para> @@ -51,17 +52,27 @@ w³±czona. </para> </note> - + <note> + <para> + Od wersji PHP 4.1.0 dostêpna jest globalna zmienna + <varname>$_SESSION</varname>, podobnie jak <varname>$_POST</varname>, + <varname>$_GET</varname>, <varname>$_REQUEST</varname> i tak dalej. W + odró¿nieniu od <varname>$HTTP_SESSION_VARS</varname>, + <varname>$_SESSION</varname> jest zawsze globalna. W zwi±zku z tym + <literal>global</literal> nie powinno byæ u¿yte do + <varname>$_SESSION</varname>. + </para> + </note> <para> Je¶li w³±czona jest opcja <link linkend="ini.track-vars"><literal>track_vars</literal></link> a <link linkend="ini.register-globals"><literal>register_globals</literal></link> jest wy³±czona, tylko pozycje nale¿±ce do zmiennej asocjacyjnej - $HTTP_SESSION_VARS mog± byæ zarejestrowane jako zmienne sesyjne. - Odtworzone zmienne sesyjne bêd± dostêpne tylko w zmiennej - $HTTP_SESSION_VARS. - <example> + <varname>$HTTP_SESSION_VARS</varname> mog± byæ zarejestrowane jako + zmienne sesyjne. Odtworzone zmienne sesyjne bêd± dostêpne tylko w zmiennej + <varname>$HTTP_SESSION_VARS</varname>. + <example> <title> Rejestracja zmiennej z w³±czon± opcj± <link linkend="ini.track-vars"><literal>track_vars</literal></link> @@ -69,8 +80,53 @@ <programlisting role="php"> <![CDATA[ <?php -session_register("count"); -$HTTP_SESSION_VARS["count"]++; +if (isset($HTTP_SESSION_VARS['count'])) { + $HTTP_SESSION_VARS['count']++; +} +else { + $HTTP_SESSION_VARS['count'] = 0; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + U¿ycie <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla wersji PHP 4.0.6 i starszych) + jest wskazane ze wzglêdów bezpieczeñstwa i czytelno¶ci kodu. U¿ywaj±c + <varname>$_SESSION</varname> lub <varname>$HTTP_SESSION_VARS</varname> nie + ma potrzeby u¿ywaæ funkcji + session_register()/session_unregister()/session_is_registered(). + U¿ytkownicy mog± uzyskiwaæ dostêp do zmiennych sesyjnych tak jak do + normalnych zmiennych. + <example> + <title> + Rejestrowanie zmiennych przez $_SESSION + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// U¿yj $HTTP_SESSION_VARS dla PHP 4.0.6 i starszych +if (!isset($_SESSION['count'])) { + $_SESSION['count'] = 0; +} else { + $_SESSION['count']++; +} +?> +]]> + </programlisting> + </example> + <example> + <title> + Wyrejestrowywanie zmiennej korzystaj±c z $_SESSION + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// U¿yj $HTTP_SESSION_VARS dla PHP 4.0.6 i starszych +unset($_SESSION['count']); + ?> ]]> </programlisting> @@ -81,17 +137,46 @@ linkend="ini.register-globals"><literal>register_globals</literal></link>, wszystkie globalne zmienne mog± byæ zarejestrowane jako zmienne sesyjne a zmienne sesyjne bêd± odtworzone do odpowiadaj±cych im zmiennych - globalnych. - <example> + globalnych. Poniewa¿ PHP musi wiedzieæ które globalne zmienne s± + zarejestrowane jako zmienne sesyjne, u¿ytkownik musi u¿yæ funkcji + session_register() podczas gdy + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> nie + musz± u¿ywaæ session_register(). + <caution> + <para> + Je¶li u¿ywane s± tablice + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> i + i wy³±czona jest opcja <link + linkend="ini.register-globals"><literal>register_globals</literal></link>, + nie powinno siê u¿ywaæ <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> + <para> + Je¶li w³±czona zostanie opcja <link + linkend="ini.register-globals"><literal>register_globals</literal></link>, + powinno siê u¿ywaæ <function>session_unregister</function> poniewa¿ + zmienne sesyjne s± rejestrowane jako zmienne globalne kiedy dane sesyjne + s± deserializowane. Wy³±czenie <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + jest zalecane ze wzglêdów bezpieczeñstwa i wydajno¶ci. + </para> + </caution> + <example> <title> - Rejestracja zminnych z w³±czon± opcj± <link + Rejestracja zmiennych z w³±czon± opcj± <link linkend="ini.register-globals"><literal>register_globals</literal></link> </title> <programlisting role="php"> <![CDATA[ <?php -session_register("count"); -$count++; +if (!session_is_registered('cound')) { + session_register('count'); + $count = 0; +} +else { + $count++; +} ?> ]]> </programlisting> @@ -102,8 +187,16 @@ linkend="ini.track-vars"><literal>track_vars</literal></link> i <link linkend="ini.register-globals"><literal>register_globals</literal></link>, - globalne zmienne i wpisy w $HTTP_SESSION_VARS bêd± referencjami do tej - samej warto¶ci. + globalne zmienne i wpisy w + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> + bêd± referencjami do tej samej, ju¿ zarejestrowanej zmiennej. + </para> + <para> + Je¶li u¿ytkownik u¿yje session_register() do zarejestrowania zmiennej + sesyjnej, + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> nie + bêd± zawiera³y tych zmiennych w tablicy dopóki nie zostanie ona odczytana + z miejsca przechowywania sesji (np. do czasu nastêpnego wywo³ania). </para> <para> Istniej± dwie metody propagacji identyfikatora sesji: @@ -144,18 +237,24 @@ <programlisting role="php"> <![CDATA[ <?php -session_register ("count"); -$count++; +if (!session_is_registered('count')) { + session_register('count'); + $count = 1; +} +else { + $count++; +} ?> Witaj go¶ciu. Ogl±dasz t± stronê <?php echo $count; ?> raz.<p> <?php -# <?=SID?> jest konieczne do zachowania identyfikatora sesji je¶li -# u¿ytkownik wy³±czy³ ciastka +# <?php echo SID?> (<?=SID?> mo¿e byæ u¿yte je¶li w³±czona jest mo¿liwo¶æ +# u¿ywania krótkich tagów) jest konieczne do zachowania identyfikatora +# sesji je¶li u¿ytkownik wy³±czy³ ciastka ?> -Aby kontynuowaæ, <A HREF="nextpage.php?<?=SID?>">kliknij tutaj</A> +Aby kontynuowaæ, <A HREF="nextpage.php?<?php echo SID?>">kliknij tutaj</A> ]]> </programlisting> </example> @@ -181,7 +280,7 @@ </para> <para> System zarz±dzania sesj± obs³uguje wiele opcji konfiguracyjnych, które - mo¿esz wstawiæ do swojego pliku php.ini. Oto ich krótki przegl±d. + mo¿esz wstawiæ do swojego pliku &php.ini;. Oto ich krótki przegl±d. <itemizedlist> <listitem> <simpara> @@ -195,7 +294,9 @@ <literal>session.save_path</literal> definiuje argument, który jest przekazywany procedurze obs³ugi zapisu danych. Je¶li wybierzesz domy¶ln± procedurê obs³ugi, jest to ¶cie¿ka gdzie tworzone bêd± pliki z - danymi. Domy¶lnie <literal>/tmp</literal>. + danymi. Domy¶lnie <literal>/tmp</literal>. Je¶li g³êboko¶æ ¶cie¿ki + okre¶lonej w parametrze <literal>session.save_path</literal> jest + wiêksza ni¿ 2, nie przeprowadzone zostanie zbieranie ¶mieci. </simpara> <warning> <para> Index: phpdoc-pl/reference/session/functions/session-cache-expire.xml diff -u phpdoc-pl/reference/session/functions/session-cache-expire.xml:1.2 phpdoc-pl/reference/session/functions/session-cache-expire.xml:1.3 --- phpdoc-pl/reference/session/functions/session-cache-expire.xml:1.2 Wed Apr 17 03:16:14 2002 +++ phpdoc-pl/reference/session/functions/session-cache-expire.xml Mon May 13 17:09:58 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-cache-expire' in en/ tree in rev 1.38 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.38 --> +<!-- $Revision: 1.3 $ --> <refentry id='function.session-cache-expire'> <refnamediv> <refname>session_cache_expire</refname> Index: phpdoc-pl/reference/session/functions/session-cache-limiter.xml diff -u phpdoc-pl/reference/session/functions/session-cache-limiter.xml:1.2 phpdoc-pl/reference/session/functions/session-cache-limiter.xml:1.3 --- phpdoc-pl/reference/session/functions/session-cache-limiter.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-cache-limiter.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.8 --> -<!-- last change to 'session-cache-limiter' in en/ tree in rev 1.62 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.62 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-cache-limiter"> <refnamediv> <refname>session_cache_limiter</refname> Index: phpdoc-pl/reference/session/functions/session-decode.xml diff -u phpdoc-pl/reference/session/functions/session-decode.xml:1.2 phpdoc-pl/reference/session/functions/session-decode.xml:1.3 --- phpdoc-pl/reference/session/functions/session-decode.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-decode.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-decode' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-decode"> <refnamediv> <refname>session_decode</refname> Index: phpdoc-pl/reference/session/functions/session-destroy.xml diff -u phpdoc-pl/reference/session/functions/session-destroy.xml:1.2 phpdoc-pl/reference/session/functions/session-destroy.xml:1.3 --- phpdoc-pl/reference/session/functions/session-destroy.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-destroy.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-destroy' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-destroy"> <refnamediv> <refname>session_destroy</refname> @@ -30,15 +28,33 @@ <![CDATA[ <?php -# Inicjalizuj sesjê -# Je¶li u¿ywasz sesion_name("co¶tam"), nie zapomnij o tym teraz! +// Inicjalizuj sesjê +// Je¶li u¿ywasz sesion_name("co¶tam"), nie zapomnij o tym teraz! session_start(); -# Usuñ wszystkie zmienne sesyjne +// Usuñ wszystkie zmienne sesyjne session_unset(); -# Na koniec, zniszcz sesjê +// Na koniec, zniszcz sesjê session_destroy(); ?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Niszczenie sesji u¿ywaj±c $_SESSION</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Inicjalizuj sesjê +// Je¶li u¿ywasz session_name("co¶"), nie zapomnij o tym teraz! +session_start(); +// Usuñ wszystkie zmienne sesyjne +$_SESSION = array(); +// Na koniec zniszcz sesjê +session_destroy(); ]]> </programlisting> </example> Index: phpdoc-pl/reference/session/functions/session-encode.xml diff -u phpdoc-pl/reference/session/functions/session-encode.xml:1.2 phpdoc-pl/reference/session/functions/session-encode.xml:1.3 --- phpdoc-pl/reference/session/functions/session-encode.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-encode.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-encode' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-encode"> <refnamediv> <refname>session_encode</refname> Index: phpdoc-pl/reference/session/functions/session-get-cookie-params.xml diff -u phpdoc-pl/reference/session/functions/session-get-cookie-params.xml:1.2 phpdoc-pl/reference/session/functions/session-get-cookie-params.xml:1.3 --- phpdoc-pl/reference/session/functions/session-get-cookie-params.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-get-cookie-params.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-get-cookie-params' in en/ tree in rev 1.8 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.8 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-get-cookie-params"> <refnamediv> <refname>session_get_cookie_params</refname> Index: phpdoc-pl/reference/session/functions/session-id.xml diff -u phpdoc-pl/reference/session/functions/session-id.xml:1.2 phpdoc-pl/reference/session/functions/session-id.xml:1.3 --- phpdoc-pl/reference/session/functions/session-id.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-id.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-id' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> Index: phpdoc-pl/reference/session/functions/session-is-registered.xml diff -u phpdoc-pl/reference/session/functions/session-is-registered.xml:1.2 phpdoc-pl/reference/session/functions/session-is-registered.xml:1.3 --- phpdoc-pl/reference/session/functions/session-is-registered.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-is-registered.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-is-registered' in en/ tree in rev 1.8 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.8 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-is-registered"> <refnamediv> <refname>session_is_registered</refname> @@ -21,6 +19,24 @@ bie¿±cej sesji zarejestrowana jest zmienna o nazwie <parameter>nazwa</parameter>. </para> + <note> + <para> + Je¶li u¿yta zosta³a tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 lub starszych), do + sprawdzenia czy zmienna zosta³a zarejestrowana w sesji nale¿y u¿yæ + funkcji <function>isset</function> na tablicy + <varname>$_SESSION</varname>. + </para> + </note> + <caution> + <para> + Przy u¿yciu + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>, nie + nale¿y u¿ywaæ <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> + </caution> </refsect1> </refentry> Index: phpdoc-pl/reference/session/functions/session-module-name.xml diff -u phpdoc-pl/reference/session/functions/session-module-name.xml:1.2 phpdoc-pl/reference/session/functions/session-module-name.xml:1.3 --- phpdoc-pl/reference/session/functions/session-module-name.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-module-name.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-module-name' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-module-name"> <refnamediv> <refname>session_module_name</refname> Index: phpdoc-pl/reference/session/functions/session-name.xml diff -u phpdoc-pl/reference/session/functions/session-name.xml:1.2 phpdoc-pl/reference/session/functions/session-name.xml:1.3 --- phpdoc-pl/reference/session/functions/session-name.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-name.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-name' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-name"> <refnamediv> <refname>session_name</refname> @@ -35,7 +33,7 @@ <![CDATA[ <?php -# ustaw nazwê sesji na WebsiteID +// ustaw nazwê sesji na WebsiteID $poprzednia_nazwa = session_name ("WebsiteID"); Index: phpdoc-pl/reference/session/functions/session-readonly.xml diff -u phpdoc-pl/reference/session/functions/session-readonly.xml:1.2 phpdoc-pl/reference/session/functions/session-readonly.xml:1.3 --- phpdoc-pl/reference/session/functions/session-readonly.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-readonly.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-readonly' in en/ tree in rev 1.25 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.25 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-readonly"> <refnamediv> <refname>session_readonly</refname> Index: phpdoc-pl/reference/session/functions/session-register.xml diff -u phpdoc-pl/reference/session/functions/session-register.xml:1.2 phpdoc-pl/reference/session/functions/session-register.xml:1.3 --- phpdoc-pl/reference/session/functions/session-register.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-register.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-register' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-register"> <refnamediv> <refname>session_register</refname> @@ -32,6 +30,15 @@ u¿ywaj±c tablic sesyjnych, tak jak to opisano poni¿ej. </para> </caution> + <caution> + <para> + Przy u¿yciu + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> nie + powinno siê u¿ywaæ <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> + </caution> <para> Funkcja ta zwraca warto¶æ &true; je¶li wszystkie zmienne zosta³y pomy¶lnie zarejestrowane w sesji. @@ -43,7 +50,8 @@ </para> <para> Mo¿esz tworzyæ zmienne sesyjne poprostu przez dopisywanie odpowiednicz - wpisów do tablic $HTTP_SESSION_VARS lub $_SESSION (PHP >= 4.1.0). + wpisów do tablic <varname>$HTTP_SESSION_VARS</varname> lub + <varname>$_SESSION</varname> (PHP >= 4.1.0). <informalexample> <programlisting role="php"> <![CDATA[ @@ -68,6 +76,12 @@ zwracanie typu <literal>resource</literal> w definicji funkcji. Listê funkcji, które zwracaj± zasoby, mo¿na znale¼æ w za³±czniku <link linkend="resource">typy zasobów</link>. + </para> + <para> + Je¶li u¿yta jest tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 i starszych), + przypisz zmienn± do <varname>$_SESSION</varname>, na przyk³ad + $_SESSION['var'] = 'ABC'; </para> </note> <para> Index: phpdoc-pl/reference/session/functions/session-save-path.xml diff -u phpdoc-pl/reference/session/functions/session-save-path.xml:1.2 phpdoc-pl/reference/session/functions/session-save-path.xml:1.3 --- phpdoc-pl/reference/session/functions/session-save-path.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-save-path.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-save-path' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-save-path"> <refnamediv> <refname>session_save_path</refname> Index: phpdoc-pl/reference/session/functions/session-set-cookie-params.xml diff -u phpdoc-pl/reference/session/functions/session-set-cookie-params.xml:1.2 phpdoc-pl/reference/session/functions/session-set-cookie-params.xml:1.3 --- phpdoc-pl/reference/session/functions/session-set-cookie-params.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-set-cookie-params.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-set-cookie-params' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-set-cookie-params"> <refnamediv> <refname>session_set_cookie_params</refname> Index: phpdoc-pl/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-pl/reference/session/functions/session-set-save-handler.xml:1.2 phpdoc-pl/reference/session/functions/session-set-save-handler.xml:1.3 --- phpdoc-pl/reference/session/functions/session-set-save-handler.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-set-save-handler.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-set-save-handler' in en/ tree in rev 1.23 --> -<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.23 --> +<!-- EN-Revision: 1.3 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-set-save-handler"> <refnamediv> <refname>session_set_save_handler</refname> @@ -13,7 +11,7 @@ <refsect1> <title>Opis</title> <methodsynopsis> - <type>void</type><methodname>session_set_save_handler</methodname> + <type>bool</type><methodname>session_set_save_handler</methodname> <methodparam><type>string</type><parameter>otwórz</parameter></methodparam><methodparam><type>string</type><parameter>zamknij</parameter></methodparam><methodparam><type>string</type><parameter>czytaj</parameter></methodparam><methodparam><type>string</type><parameter>zapisz</parameter></methodparam><methodparam><type>string</type><parameter>niszcz</parameter></methodparam><methodparam><type>string</type><parameter>gc</parameter></methodparam> </methodsynopsis> <para> @@ -23,10 +21,11 @@ preferowany jest sposób przechowywania sesji inny ni¿ ten, który jest dostarczany z PHP, np. przechowywanie danych sesji w lokalnej bazie danych. + &return.success; </para> <note> <para> - W swoim pliku php.ini musisz ustawiæ opcjê konfiguracji + W swoim pliku &php.ini; musisz ustawiæ opcjê konfiguracji <parameter>session.save_handler</parameter> na <parameter>user</parameter> aby <function>session_set_save_handler</function> zadzia³a³o. @@ -48,6 +47,13 @@ obs³ugiwan± przez PHP. </para> <para> + Funkcja czytaj±ca zawsze musi zwracaæ ci±g aby procedura obs³ugi dzia³a³a + zgodnie z przewidywaniami. Zwróæ pusty ci±g je¶li nie ma ¿adnych danych + do odczytania. Warto¶ci zwracane przez inne procedury obs³ugi s± + konwertowane na wyra¿enia logiczne. TRUE dla sukcesu, FALSE dla + niepowodzenia. + </para> + <para> <example> <title> Przyk³ad <function>session_set_save_handler</function> @@ -76,7 +82,7 @@ $sess_data = fread($fp, filesize($sess_file)); return($sess_data); } else { - return(""); + return(""); // Zawsze musi zwracaæ "" } } Index: phpdoc-pl/reference/session/functions/session-start.xml diff -u phpdoc-pl/reference/session/functions/session-start.xml:1.2 phpdoc-pl/reference/session/functions/session-start.xml:1.3 --- phpdoc-pl/reference/session/functions/session-start.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-start.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-start' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-start"> <refnamediv> <refname>session_start</refname> @@ -33,6 +31,21 @@ <function>session_start</function> musi byæ wywo³ane przed wys³aniem jakichkolwiek danych do przegl±darki. </para> + </note> + <simpara> + <function>session_start</function> zarejestruje wewnêtrzny uchwyt obs³ugi + wyj¶cia dla przepisywania URLi je¶li w³±czona jest opcja + <literal>trans-sid</literal>. Je¶li u¿ytkownik u¿ywa + <literal>ob_gzhandler</literal> lub podobne z + <function>ob_start</function>, kolejno¶æ uchwytów obs³ugi wyj¶cia jest + wa¿na dla prawid³owego wyj¶cia. Na przyk³ad, u¿ytkownik musi + zarejestrowaæ <literal>ob_gzhandler</literal> przed rozpoczêciem sesji. + </simpara> + <note> + <simpara> + Wskazane jest u¿ycie <literal>zlib.output_compression</literal> zamiast + <literal>ob_gzhandler</literal> + </simpara> </note> </refsect1> </refentry> Index: phpdoc-pl/reference/session/functions/session-unregister.xml diff -u phpdoc-pl/reference/session/functions/session-unregister.xml:1.2 phpdoc-pl/reference/session/functions/session-unregister.xml:1.3 --- phpdoc-pl/reference/session/functions/session-unregister.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-unregister.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-unregister' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-unregister"> <refnamediv> <refname>session_unregister</refname> @@ -24,12 +22,28 @@ Funkcja ta zwraca warto¶æ &true; je¶li zmienna zosta³a pomy¶lnie wyrejestrowana z sesji. </para> + <note> + <para> + Je¶li u¿yta zosta³a tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 i starszych), u¿yj + <function>unset</function> aby wyrejestrowaæ zmienn± z sesji. + </para> + </note> <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> + <caution> + <para> + Je¶li u¿ywasz + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>, nie + u¿ywaj <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. </para> </caution> </refsect1> Index: phpdoc-pl/reference/session/functions/session-unset.xml diff -u phpdoc-pl/reference/session/functions/session-unset.xml:1.2 phpdoc-pl/reference/session/functions/session-unset.xml:1.3 --- phpdoc-pl/reference/session/functions/session-unset.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-unset.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-unset' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.8 --> +<!-- EN-Revision: 1.3 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-unset"> <refnamediv> <refname>session_unset</refname> @@ -20,6 +18,13 @@ Funkcja <function>session_unset</function> zwalnia wszystkie zmienne sesyjne, które s± aktualnie zarejestrowane. </para> + <note> + <para> + Je¶li u¿yta zosta³a tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 i starszych), aby + wyrejestrowaæ zmienn± z sesji nale¿y u¿yæ <function>unset</function>. + </para> + </note> </refsect1> </refentry> Index: phpdoc-pl/reference/session/functions/session-write-close.xml diff -u phpdoc-pl/reference/session/functions/session-write-close.xml:1.2 phpdoc-pl/reference/session/functions/session-write-close.xml:1.3 --- phpdoc-pl/reference/session/functions/session-write-close.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-write-close.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-write-close' in en/ tree in rev 1.38 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.38 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-write-close"> <refnamediv> <refname>session_write_close</refname>
Index: phpdoc-pl/reference/session/reference.xml diff -u phpdoc-pl/reference/session/reference.xml:1.2 phpdoc-pl/reference/session/reference.xml:1.3 --- phpdoc-pl/reference/session/reference.xml:1.2 Tue Apr 16 20:05:32 2002 +++ phpdoc-pl/reference/session/reference.xml Mon May 13 17:09:56 2002 @@ -1,5 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.3 $ --> <reference id="ref.session"> <title>Sesje</title> <titleabbrev>Sesje</titleabbrev> @@ -13,7 +14,7 @@ </para> <para> Je¶li jeste¶ zaznajomiony z zarz±dzaniem sesj± w PHPLIB, zauwa¿ysz ¿e - pewnie koncepcje s± podobne w ob³udze sesji PHP. + pewnie koncepcje s± podobne w obs³udze sesji PHP. </para> <para> Go¶æ wchodz±cy na twoj± stronê WWW otrzymuje unikalny identyfikator, tzw. @@ -32,7 +33,7 @@ <para> Wszystkie zarejestrowane zmienne s± serializowane po wykonaniu ca³ego kodu strony. Zarejestrowane zmienne, które s± niezdefiniowane, s± zaznaczane - jako niezdefijiowane. Nie s± one definiowane przez modu³ sesji w + jako niezdefiniowane. Nie s± one definiowane przez modu³ sesji w nastêpuj±cych po sobie wywo³aniach, chyba ¿e u¿ytkownik zdefiniuje je pó¼niej. </para> @@ -51,17 +52,27 @@ w³±czona. </para> </note> - + <note> + <para> + Od wersji PHP 4.1.0 dostêpna jest globalna zmienna + <varname>$_SESSION</varname>, podobnie jak <varname>$_POST</varname>, + <varname>$_GET</varname>, <varname>$_REQUEST</varname> i tak dalej. W + odró¿nieniu od <varname>$HTTP_SESSION_VARS</varname>, + <varname>$_SESSION</varname> jest zawsze globalna. W zwi±zku z tym + <literal>global</literal> nie powinno byæ u¿yte do + <varname>$_SESSION</varname>. + </para> + </note> <para> Je¶li w³±czona jest opcja <link linkend="ini.track-vars"><literal>track_vars</literal></link> a <link linkend="ini.register-globals"><literal>register_globals</literal></link> jest wy³±czona, tylko pozycje nale¿±ce do zmiennej asocjacyjnej - $HTTP_SESSION_VARS mog± byæ zarejestrowane jako zmienne sesyjne. - Odtworzone zmienne sesyjne bêd± dostêpne tylko w zmiennej - $HTTP_SESSION_VARS. - <example> + <varname>$HTTP_SESSION_VARS</varname> mog± byæ zarejestrowane jako + zmienne sesyjne. Odtworzone zmienne sesyjne bêd± dostêpne tylko w zmiennej + <varname>$HTTP_SESSION_VARS</varname>. + <example> <title> Rejestracja zmiennej z w³±czon± opcj± <link linkend="ini.track-vars"><literal>track_vars</literal></link> @@ -69,8 +80,53 @@ <programlisting role="php"> <![CDATA[ <?php -session_register("count"); -$HTTP_SESSION_VARS["count"]++; +if (isset($HTTP_SESSION_VARS['count'])) { + $HTTP_SESSION_VARS['count']++; +} +else { + $HTTP_SESSION_VARS['count'] = 0; +} +?> +]]> + </programlisting> + </example> + </para> + <para> + U¿ycie <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla wersji PHP 4.0.6 i starszych) + jest wskazane ze wzglêdów bezpieczeñstwa i czytelno¶ci kodu. U¿ywaj±c + <varname>$_SESSION</varname> lub <varname>$HTTP_SESSION_VARS</varname> nie + ma potrzeby u¿ywaæ funkcji + session_register()/session_unregister()/session_is_registered(). + U¿ytkownicy mog± uzyskiwaæ dostêp do zmiennych sesyjnych tak jak do + normalnych zmiennych. + <example> + <title> + Rejestrowanie zmiennych przez $_SESSION + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// U¿yj $HTTP_SESSION_VARS dla PHP 4.0.6 i starszych +if (!isset($_SESSION['count'])) { + $_SESSION['count'] = 0; +} else { + $_SESSION['count']++; +} +?> +]]> + </programlisting> + </example> + <example> + <title> + Wyrejestrowywanie zmiennej korzystaj±c z $_SESSION + </title> + <programlisting role="php"> +<![CDATA[ +<?php +// U¿yj $HTTP_SESSION_VARS dla PHP 4.0.6 i starszych +unset($_SESSION['count']); + ?> ]]> </programlisting> @@ -81,17 +137,46 @@ linkend="ini.register-globals"><literal>register_globals</literal></link>, wszystkie globalne zmienne mog± byæ zarejestrowane jako zmienne sesyjne a zmienne sesyjne bêd± odtworzone do odpowiadaj±cych im zmiennych - globalnych. - <example> + globalnych. Poniewa¿ PHP musi wiedzieæ które globalne zmienne s± + zarejestrowane jako zmienne sesyjne, u¿ytkownik musi u¿yæ funkcji + session_register() podczas gdy + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> nie + musz± u¿ywaæ session_register(). + <caution> + <para> + Je¶li u¿ywane s± tablice + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> i + i wy³±czona jest opcja <link + linkend="ini.register-globals"><literal>register_globals</literal></link>, + nie powinno siê u¿ywaæ <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> + <para> + Je¶li w³±czona zostanie opcja <link + linkend="ini.register-globals"><literal>register_globals</literal></link>, + powinno siê u¿ywaæ <function>session_unregister</function> poniewa¿ + zmienne sesyjne s± rejestrowane jako zmienne globalne kiedy dane sesyjne + s± deserializowane. Wy³±czenie <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + jest zalecane ze wzglêdów bezpieczeñstwa i wydajno¶ci. + </para> + </caution> + <example> <title> - Rejestracja zminnych z w³±czon± opcj± <link + Rejestracja zmiennych z w³±czon± opcj± <link linkend="ini.register-globals"><literal>register_globals</literal></link> </title> <programlisting role="php"> <![CDATA[ <?php -session_register("count"); -$count++; +if (!session_is_registered('cound')) { + session_register('count'); + $count = 0; +} +else { + $count++; +} ?> ]]> </programlisting> @@ -102,8 +187,16 @@ linkend="ini.track-vars"><literal>track_vars</literal></link> i <link linkend="ini.register-globals"><literal>register_globals</literal></link>, - globalne zmienne i wpisy w $HTTP_SESSION_VARS bêd± referencjami do tej - samej warto¶ci. + globalne zmienne i wpisy w + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> + bêd± referencjami do tej samej, ju¿ zarejestrowanej zmiennej. + </para> + <para> + Je¶li u¿ytkownik u¿yje session_register() do zarejestrowania zmiennej + sesyjnej, + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> nie + bêd± zawiera³y tych zmiennych w tablicy dopóki nie zostanie ona odczytana + z miejsca przechowywania sesji (np. do czasu nastêpnego wywo³ania). </para> <para> Istniej± dwie metody propagacji identyfikatora sesji: @@ -144,18 +237,24 @@ <programlisting role="php"> <![CDATA[ <?php -session_register ("count"); -$count++; +if (!session_is_registered('count')) { + session_register('count'); + $count = 1; +} +else { + $count++; +} ?> Witaj go¶ciu. Ogl±dasz t± stronê <?php echo $count; ?> raz.<p> <?php -# <?=SID?> jest konieczne do zachowania identyfikatora sesji je¶li -# u¿ytkownik wy³±czy³ ciastka +# <?php echo SID?> (<?=SID?> mo¿e byæ u¿yte je¶li w³±czona jest mo¿liwo¶æ +# u¿ywania krótkich tagów) jest konieczne do zachowania identyfikatora +# sesji je¶li u¿ytkownik wy³±czy³ ciastka ?> -Aby kontynuowaæ, <A HREF="nextpage.php?<?=SID?>">kliknij tutaj</A> +Aby kontynuowaæ, <A HREF="nextpage.php?<?php echo SID?>">kliknij tutaj</A> ]]> </programlisting> </example> @@ -181,7 +280,7 @@ </para> <para> System zarz±dzania sesj± obs³uguje wiele opcji konfiguracyjnych, które - mo¿esz wstawiæ do swojego pliku php.ini. Oto ich krótki przegl±d. + mo¿esz wstawiæ do swojego pliku &php.ini;. Oto ich krótki przegl±d. <itemizedlist> <listitem> <simpara> @@ -195,7 +294,9 @@ <literal>session.save_path</literal> definiuje argument, który jest przekazywany procedurze obs³ugi zapisu danych. Je¶li wybierzesz domy¶ln± procedurê obs³ugi, jest to ¶cie¿ka gdzie tworzone bêd± pliki z - danymi. Domy¶lnie <literal>/tmp</literal>. + danymi. Domy¶lnie <literal>/tmp</literal>. Je¶li g³êboko¶æ ¶cie¿ki + okre¶lonej w parametrze <literal>session.save_path</literal> jest + wiêksza ni¿ 2, nie przeprowadzone zostanie zbieranie ¶mieci. </simpara> <warning> <para> Index: phpdoc-pl/reference/session/functions/session-cache-expire.xml diff -u phpdoc-pl/reference/session/functions/session-cache-expire.xml:1.2 phpdoc-pl/reference/session/functions/session-cache-expire.xml:1.3 --- phpdoc-pl/reference/session/functions/session-cache-expire.xml:1.2 Wed Apr 17 03:16:14 2002 +++ phpdoc-pl/reference/session/functions/session-cache-expire.xml Mon May 13 17:09:58 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-cache-expire' in en/ tree in rev 1.38 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.38 --> +<!-- $Revision: 1.3 $ --> <refentry id='function.session-cache-expire'> <refnamediv> <refname>session_cache_expire</refname> Index: phpdoc-pl/reference/session/functions/session-cache-limiter.xml diff -u phpdoc-pl/reference/session/functions/session-cache-limiter.xml:1.2 phpdoc-pl/reference/session/functions/session-cache-limiter.xml:1.3 --- phpdoc-pl/reference/session/functions/session-cache-limiter.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-cache-limiter.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.8 --> -<!-- last change to 'session-cache-limiter' in en/ tree in rev 1.62 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.62 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-cache-limiter"> <refnamediv> <refname>session_cache_limiter</refname> Index: phpdoc-pl/reference/session/functions/session-decode.xml diff -u phpdoc-pl/reference/session/functions/session-decode.xml:1.2 phpdoc-pl/reference/session/functions/session-decode.xml:1.3 --- phpdoc-pl/reference/session/functions/session-decode.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-decode.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-decode' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-decode"> <refnamediv> <refname>session_decode</refname> Index: phpdoc-pl/reference/session/functions/session-destroy.xml diff -u phpdoc-pl/reference/session/functions/session-destroy.xml:1.2 phpdoc-pl/reference/session/functions/session-destroy.xml:1.3 --- phpdoc-pl/reference/session/functions/session-destroy.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-destroy.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-destroy' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-destroy"> <refnamediv> <refname>session_destroy</refname> @@ -30,15 +28,33 @@ <![CDATA[ <?php -# Inicjalizuj sesjê -# Je¶li u¿ywasz sesion_name("co¶tam"), nie zapomnij o tym teraz! +// Inicjalizuj sesjê +// Je¶li u¿ywasz sesion_name("co¶tam"), nie zapomnij o tym teraz! session_start(); -# Usuñ wszystkie zmienne sesyjne +// Usuñ wszystkie zmienne sesyjne session_unset(); -# Na koniec, zniszcz sesjê +// Na koniec, zniszcz sesjê session_destroy(); ?> +]]> + </programlisting> + </example> + </para> + <para> + <example> + <title>Niszczenie sesji u¿ywaj±c $_SESSION</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// Inicjalizuj sesjê +// Je¶li u¿ywasz session_name("co¶"), nie zapomnij o tym teraz! +session_start(); +// Usuñ wszystkie zmienne sesyjne +$_SESSION = array(); +// Na koniec zniszcz sesjê +session_destroy(); ]]> </programlisting> </example> Index: phpdoc-pl/reference/session/functions/session-encode.xml diff -u phpdoc-pl/reference/session/functions/session-encode.xml:1.2 phpdoc-pl/reference/session/functions/session-encode.xml:1.3 --- phpdoc-pl/reference/session/functions/session-encode.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-encode.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-encode' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-encode"> <refnamediv> <refname>session_encode</refname> Index: phpdoc-pl/reference/session/functions/session-get-cookie-params.xml diff -u phpdoc-pl/reference/session/functions/session-get-cookie-params.xml:1.2 phpdoc-pl/reference/session/functions/session-get-cookie-params.xml:1.3 --- phpdoc-pl/reference/session/functions/session-get-cookie-params.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-get-cookie-params.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-get-cookie-params' in en/ tree in rev 1.8 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.8 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-get-cookie-params"> <refnamediv> <refname>session_get_cookie_params</refname> Index: phpdoc-pl/reference/session/functions/session-id.xml diff -u phpdoc-pl/reference/session/functions/session-id.xml:1.2 phpdoc-pl/reference/session/functions/session-id.xml:1.3 --- phpdoc-pl/reference/session/functions/session-id.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-id.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-id' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-id"> <refnamediv> <refname>session_id</refname> Index: phpdoc-pl/reference/session/functions/session-is-registered.xml diff -u phpdoc-pl/reference/session/functions/session-is-registered.xml:1.2 phpdoc-pl/reference/session/functions/session-is-registered.xml:1.3 --- phpdoc-pl/reference/session/functions/session-is-registered.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-is-registered.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-is-registered' in en/ tree in rev 1.8 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.8 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-is-registered"> <refnamediv> <refname>session_is_registered</refname> @@ -21,6 +19,24 @@ bie¿±cej sesji zarejestrowana jest zmienna o nazwie <parameter>nazwa</parameter>. </para> + <note> + <para> + Je¶li u¿yta zosta³a tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 lub starszych), do + sprawdzenia czy zmienna zosta³a zarejestrowana w sesji nale¿y u¿yæ + funkcji <function>isset</function> na tablicy + <varname>$_SESSION</varname>. + </para> + </note> + <caution> + <para> + Przy u¿yciu + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>, nie + nale¿y u¿ywaæ <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> + </caution> </refsect1> </refentry> Index: phpdoc-pl/reference/session/functions/session-module-name.xml diff -u phpdoc-pl/reference/session/functions/session-module-name.xml:1.2 phpdoc-pl/reference/session/functions/session-module-name.xml:1.3 --- phpdoc-pl/reference/session/functions/session-module-name.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-module-name.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-module-name' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-module-name"> <refnamediv> <refname>session_module_name</refname> Index: phpdoc-pl/reference/session/functions/session-name.xml diff -u phpdoc-pl/reference/session/functions/session-name.xml:1.2 phpdoc-pl/reference/session/functions/session-name.xml:1.3 --- phpdoc-pl/reference/session/functions/session-name.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-name.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-name' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-name"> <refnamediv> <refname>session_name</refname> @@ -35,7 +33,7 @@ <![CDATA[ <?php -# ustaw nazwê sesji na WebsiteID +// ustaw nazwê sesji na WebsiteID $poprzednia_nazwa = session_name ("WebsiteID"); Index: phpdoc-pl/reference/session/functions/session-readonly.xml diff -u phpdoc-pl/reference/session/functions/session-readonly.xml:1.2 phpdoc-pl/reference/session/functions/session-readonly.xml:1.3 --- phpdoc-pl/reference/session/functions/session-readonly.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-readonly.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-readonly' in en/ tree in rev 1.25 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.25 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-readonly"> <refnamediv> <refname>session_readonly</refname> Index: phpdoc-pl/reference/session/functions/session-register.xml diff -u phpdoc-pl/reference/session/functions/session-register.xml:1.2 phpdoc-pl/reference/session/functions/session-register.xml:1.3 --- phpdoc-pl/reference/session/functions/session-register.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-register.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-register' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-register"> <refnamediv> <refname>session_register</refname> @@ -32,6 +30,15 @@ u¿ywaj±c tablic sesyjnych, tak jak to opisano poni¿ej. </para> </caution> + <caution> + <para> + Przy u¿yciu + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname> nie + powinno siê u¿ywaæ <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. + </para> + </caution> <para> Funkcja ta zwraca warto¶æ &true; je¶li wszystkie zmienne zosta³y pomy¶lnie zarejestrowane w sesji. @@ -43,7 +50,8 @@ </para> <para> Mo¿esz tworzyæ zmienne sesyjne poprostu przez dopisywanie odpowiednicz - wpisów do tablic $HTTP_SESSION_VARS lub $_SESSION (PHP >= 4.1.0). + wpisów do tablic <varname>$HTTP_SESSION_VARS</varname> lub + <varname>$_SESSION</varname> (PHP >= 4.1.0). <informalexample> <programlisting role="php"> <![CDATA[ @@ -68,6 +76,12 @@ zwracanie typu <literal>resource</literal> w definicji funkcji. Listê funkcji, które zwracaj± zasoby, mo¿na znale¼æ w za³±czniku <link linkend="resource">typy zasobów</link>. + </para> + <para> + Je¶li u¿yta jest tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 i starszych), + przypisz zmienn± do <varname>$_SESSION</varname>, na przyk³ad + $_SESSION['var'] = 'ABC'; </para> </note> <para> Index: phpdoc-pl/reference/session/functions/session-save-path.xml diff -u phpdoc-pl/reference/session/functions/session-save-path.xml:1.2 phpdoc-pl/reference/session/functions/session-save-path.xml:1.3 --- phpdoc-pl/reference/session/functions/session-save-path.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-save-path.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-save-path' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-save-path"> <refnamediv> <refname>session_save_path</refname> Index: phpdoc-pl/reference/session/functions/session-set-cookie-params.xml diff -u phpdoc-pl/reference/session/functions/session-set-cookie-params.xml:1.2 phpdoc-pl/reference/session/functions/session-set-cookie-params.xml:1.3 --- phpdoc-pl/reference/session/functions/session-set-cookie-params.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-set-cookie-params.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-set-cookie-params' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-set-cookie-params"> <refnamediv> <refname>session_set_cookie_params</refname> Index: phpdoc-pl/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-pl/reference/session/functions/session-set-save-handler.xml:1.2 phpdoc-pl/reference/session/functions/session-set-save-handler.xml:1.3 --- phpdoc-pl/reference/session/functions/session-set-save-handler.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-set-save-handler.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-set-save-handler' in en/ tree in rev 1.23 --> -<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.23 --> +<!-- EN-Revision: 1.3 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-set-save-handler"> <refnamediv> <refname>session_set_save_handler</refname> @@ -13,7 +11,7 @@ <refsect1> <title>Opis</title> <methodsynopsis> - <type>void</type><methodname>session_set_save_handler</methodname> + <type>bool</type><methodname>session_set_save_handler</methodname> <methodparam><type>string</type><parameter>otwórz</parameter></methodparam><methodparam><type>string</type><parameter>zamknij</parameter></methodparam><methodparam><type>string</type><parameter>czytaj</parameter></methodparam><methodparam><type>string</type><parameter>zapisz</parameter></methodparam><methodparam><type>string</type><parameter>niszcz</parameter></methodparam><methodparam><type>string</type><parameter>gc</parameter></methodparam> </methodsynopsis> <para> @@ -23,10 +21,11 @@ preferowany jest sposób przechowywania sesji inny ni¿ ten, który jest dostarczany z PHP, np. przechowywanie danych sesji w lokalnej bazie danych. + &return.success; </para> <note> <para> - W swoim pliku php.ini musisz ustawiæ opcjê konfiguracji + W swoim pliku &php.ini; musisz ustawiæ opcjê konfiguracji <parameter>session.save_handler</parameter> na <parameter>user</parameter> aby <function>session_set_save_handler</function> zadzia³a³o. @@ -48,6 +47,13 @@ obs³ugiwan± przez PHP. </para> <para> + Funkcja czytaj±ca zawsze musi zwracaæ ci±g aby procedura obs³ugi dzia³a³a + zgodnie z przewidywaniami. Zwróæ pusty ci±g je¶li nie ma ¿adnych danych + do odczytania. Warto¶ci zwracane przez inne procedury obs³ugi s± + konwertowane na wyra¿enia logiczne. TRUE dla sukcesu, FALSE dla + niepowodzenia. + </para> + <para> <example> <title> Przyk³ad <function>session_set_save_handler</function> @@ -76,7 +82,7 @@ $sess_data = fread($fp, filesize($sess_file)); return($sess_data); } else { - return(""); + return(""); // Zawsze musi zwracaæ "" } } Index: phpdoc-pl/reference/session/functions/session-start.xml diff -u phpdoc-pl/reference/session/functions/session-start.xml:1.2 phpdoc-pl/reference/session/functions/session-start.xml:1.3 --- phpdoc-pl/reference/session/functions/session-start.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-start.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-start' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-start"> <refnamediv> <refname>session_start</refname> @@ -33,6 +31,21 @@ <function>session_start</function> musi byæ wywo³ane przed wys³aniem jakichkolwiek danych do przegl±darki. </para> + </note> + <simpara> + <function>session_start</function> zarejestruje wewnêtrzny uchwyt obs³ugi + wyj¶cia dla przepisywania URLi je¶li w³±czona jest opcja + <literal>trans-sid</literal>. Je¶li u¿ytkownik u¿ywa + <literal>ob_gzhandler</literal> lub podobne z + <function>ob_start</function>, kolejno¶æ uchwytów obs³ugi wyj¶cia jest + wa¿na dla prawid³owego wyj¶cia. Na przyk³ad, u¿ytkownik musi + zarejestrowaæ <literal>ob_gzhandler</literal> przed rozpoczêciem sesji. + </simpara> + <note> + <simpara> + Wskazane jest u¿ycie <literal>zlib.output_compression</literal> zamiast + <literal>ob_gzhandler</literal> + </simpara> </note> </refsect1> </refentry> Index: phpdoc-pl/reference/session/functions/session-unregister.xml diff -u phpdoc-pl/reference/session/functions/session-unregister.xml:1.2 phpdoc-pl/reference/session/functions/session-unregister.xml:1.3 --- phpdoc-pl/reference/session/functions/session-unregister.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-unregister.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-unregister' in en/ tree in rev 1.2 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.2 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-unregister"> <refnamediv> <refname>session_unregister</refname> @@ -24,12 +22,28 @@ Funkcja ta zwraca warto¶æ &true; je¶li zmienna zosta³a pomy¶lnie wyrejestrowana z sesji. </para> + <note> + <para> + Je¶li u¿yta zosta³a tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 i starszych), u¿yj + <function>unset</function> aby wyrejestrowaæ zmienn± z sesji. + </para> + </note> <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> + <caution> + <para> + Je¶li u¿ywasz + <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>, nie + u¿ywaj <function>session_register</function>, + <function>session_is_registered</function> i + <function>session_unregister</function>. </para> </caution> </refsect1> Index: phpdoc-pl/reference/session/functions/session-unset.xml diff -u phpdoc-pl/reference/session/functions/session-unset.xml:1.2 phpdoc-pl/reference/session/functions/session-unset.xml:1.3 --- phpdoc-pl/reference/session/functions/session-unset.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-unset.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-unset' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.8 --> +<!-- EN-Revision: 1.3 Maintainer: leszek Status: ready --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-unset"> <refnamediv> <refname>session_unset</refname> @@ -20,6 +18,13 @@ Funkcja <function>session_unset</function> zwalnia wszystkie zmienne sesyjne, które s± aktualnie zarejestrowane. </para> + <note> + <para> + Je¶li u¿yta zosta³a tablica <varname>$_SESSION</varname> (lub + <varname>$HTTP_SESSION_VARS</varname> dla PHP 4.0.6 i starszych), aby + wyrejestrowaæ zmienn± z sesji nale¿y u¿yæ <function>unset</function>. + </para> + </note> </refsect1> </refentry> Index: phpdoc-pl/reference/session/functions/session-write-close.xml diff -u phpdoc-pl/reference/session/functions/session-write-close.xml:1.2 phpdoc-pl/reference/session/functions/session-write-close.xml:1.3 --- phpdoc-pl/reference/session/functions/session-write-close.xml:1.2 Wed Apr 17 03:16:15 2002 +++ phpdoc-pl/reference/session/functions/session-write-close.xml Mon May 13 17:09:59 2002 @@ -1,8 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- splitted from ./pl/functions/session.xml, last change in rev 1.1 --> -<!-- last change to 'session-write-close' in en/ tree in rev 1.38 --> <!-- EN-Revision: 1.2 Maintainer: leszek Status: ready --> -<!-- OLD-Revision: 1.70/EN.1.38 --> +<!-- $Revision: 1.3 $ --> <refentry id="function.session-write-close"> <refnamediv> <refname>session_write_close</refname>