Re: cvs: phpdoc /en/reference/session reference.xml /en/reference/session/functions session-unregister.xml session-unset.xml

The tip is to use $_SESSION = array(); instead I guess ;) Goba Derick Rethans írta:

derick Mon May 19 08:09:26 2003 EDT

  Modified files:                  /phpdoc/en/reference/session	reference.xml     /phpdoc/en/reference/session/functions	session-unregister.xml                                           	session-unset.xml   Log:

- Add some warnings about using unset() on $_SESSION Index: phpdoc/en/reference/session/reference.xml diff -u phpdoc/en/reference/session/reference.xml:1.36 phpdoc/en/reference/session/reference.xml:1.37 --- phpdoc/en/reference/session/reference.xml:1.36 Fri May 16 12:10:00 2003 +++ phpdoc/en/reference/session/reference.xml Mon May 19 08:09:26 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.36 $ --> +<!-- $Revision: 1.37 $ --> <reference id="ref.session"> <title>Session handling functions</title> <titleabbrev>Sessions</titleabbrev> @@ -200,6 +200,18 @@ ]]>

       </programlisting>
      </example>
+    </para>
+    <para>
+     <caution>
+      <para>
+       Do NOT unset the whole <varname>$_SESSION</varname> with
+       <literal>unset($_SESSION)</literal> as this will disable the
+       registering of session variables through the
+       <varname>$_SESSION</varname> superglobal.
+      </para>
+     </caution>
+    </para>
+    <para>
      <example>
       <title>
        Unregistering a variable with <link Index: phpdoc/en/reference/session/functions/session-unregister.xml

diff -u phpdoc/en/reference/session/functions/session-unregister.xml:1.4 phpdoc/en/reference/session/functions/session-unregister.xml:1.5 --- phpdoc/en/reference/session/functions/session-unregister.xml:1.4 Tue Dec 17 05:30:05 2002 +++ phpdoc/en/reference/session/functions/session-unregister.xml Mon May 19 08:09:26 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-unregister">

    <refnamediv>

@@ -28,7 +28,9 @@

       If <varname>$_SESSION</varname> (or
       <varname>$HTTP_SESSION_VARS</varname> for PHP 4.0.6 or less) is
       used, use <function>unset</function> to unregister a session
-      variable.
+      variable. Do not <function>unset</function> <varname>$_SESSION</varname>
+      itself as this will disable the special function of the
+      <varname>$_SESSION</varname> superglobal.
      </para>
     </note>
     <caution>

Index: phpdoc/en/reference/session/functions/session-unset.xml diff -u phpdoc/en/reference/session/functions/session-unset.xml:1.3 phpdoc/en/reference/session/functions/session-unset.xml:1.4 --- phpdoc/en/reference/session/functions/session-unset.xml:1.3 Fri May 3 03:29:59 2002 +++ phpdoc/en/reference/session/functions/session-unset.xml Mon May 19 08:09:26 2003 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.8 --> <refentry id="function.session-unset">

    <refnamediv>

@@ -26,6 +26,16 @@

       variable. i.e. $_SESSION = array();
      </para>
     </note>
+    <para>
+     <caution>
+      <para>
+       Do NOT unset the whole <varname>$_SESSION</varname> with
+       <literal>unset($_SESSION)</literal> as this will disable the
+       registering of session variables through the
+       <varname>$_SESSION</varname> superglobal.
+      </para>
+     </caution>
+    </para>
    </refsect1>

</refentry>