cvs: phpdoc /en/functions session.xml

yohgaki Sun Jan 20 04:07:28 2002 EDT Modified files: /phpdoc/en/functions session.xml Log: Added more warnings for mixed usage for track vars ($HTTP_SESSION_VARS/$_SESSION) and functions for global vars session handleing functions (session_register/session_is_register/ session_unregister) # These warnings are required since session module does not handle # PS(vars) and PS(http_session_vars) cocnsistent manner :) Index: phpdoc/en/functions/session.xml diff -u phpdoc/en/functions/session.xml:1.75 phpdoc/en/functions/session.xml:1.76 --- phpdoc/en/functions/session.xml:1.75 Sat Jan 19 02:48:07 2002 +++ phpdoc/en/functions/session.xml Sun Jan 20 04:07:28 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.75 $ --> +<!-- $Revision: 1.76 $ --> <reference id="ref.session"> <title>Session handling functions</title> <titleabbrev>Sessions</titleabbrev> @@ -51,6 +51,8 @@ linkend="ini.track-vars"><literal>track_vars</literal></link> is always turned on. </para> + </note> + <note> <para> As of PHP 4.1.0, $_SESSION is available as global variable just like $_POST, $_GET, $_REQUEST and so on. Not like @@ -94,7 +96,7 @@ $HTTP_SESSION_VARS, there is no need to use session_register()/session_unregister()/session_is_registered() functions. Users can access session variable like a normal - variable. + variable. <example> <title> Registering a variable with $_SESSION. @@ -137,6 +139,15 @@ variables with session_register() function while $HTTP_SESSION_VARS/$_SESSION does not need to use session_register(). + <caution> + <para> + If you are using $HTTP_SESSION_VARS/$_SESSION, do not use + <function>session_register</function>, + <function>session_is_registered</function> and + <function>session_unregister</function> unless you know internal + of session module. + </para> + </caution> <example> <title> Registering a variable with <link @@ -690,6 +701,14 @@ arrays as noted below. </para> </caution> + <caution> + <para> + If you are using $HTTP_SESSION_VARS/$_SESSION, do not use + <function>session_register</function>, + <function>session_is_registered</function> and + <function>session_unregister</function>. + </para> + </caution> <para> This function returns &true; when all of the variables are successfully registered with the session. @@ -780,6 +799,14 @@ to remove the corresponding global variable. </para> </caution> + <caution> + <para> + If you are using $HTTP_SESSION_VARS/$_SESSION, do not use + <function>session_register</function>, + <function>session_is_registered</function> and + <function>session_unregister</function>. + </para> + </caution> </refsect1> </refentry> @@ -839,6 +866,14 @@ registered in $_SESSION. </para> </note> + <caution> + <para> + If you are using $HTTP_SESSION_VARS/$_SESSION, do not use + <function>session_register</function>, + <function>session_is_registered</function> and + <function>session_unregister</function>. + </para> + </caution> </refsect1> </refentry>