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>
