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>
