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>
