cvs: phpdoc /en/reference/session/functions session-id.xml

mfischer Thu May 30 07:59:16 2002 EDT Modified files: /phpdoc/en/reference/session/functions session-id.xml Log: - Add note about file session handlers and allowed characters. Index: phpdoc/en/reference/session/functions/session-id.xml diff -u phpdoc/en/reference/session/functions/session-id.xml:1.2 phpdoc/en/reference/session/functions/session-id.xml:1.3 --- phpdoc/en/reference/session/functions/session-id.xml:1.2 Wed Apr 17 02:43:58 2002 +++ phpdoc/en/reference/session/functions/session-id.xml Thu May 30 07:59:16 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/session.xml, last change in rev 1.2 --> <refentry id="function.session-id"> <refnamediv> @@ -14,13 +14,25 @@ </methodsynopsis> <para> <function>session_id</function> returns the session id for the - current session. If <parameter>id</parameter> is specified, it - will replace the current session id. + current session. + </para> + <para> + If <parameter>id</parameter> is specified, it will replace the current + session id. <function>session_id</function> needs to be called before + <function>session_start</function> for that purpose. Depending on the + session handler, not all characters are allowed within the session id. + For example, the file session handler only allows characters in the range + <literal>a-z, A-Z and 0-9</literal>! </para> <para> The constant <systemitem>SID</systemitem> can also be used to retrieve the current name and session id as a string suitable for - adding to URLs. + adding to URLs. Note that <systemitem>SID</systemitem> is only defined if + the client didn't sent the right cookie. See also <link + linkend="ref.session">Session handling</link>. + </para> + <para> + See also <function>session_start</function>. </para> </refsect1> </refentry>