WS fix only

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@190277 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Friedhelm Betz 2005-07-08 17:25:53 +00:00
parent c78ed10a19
commit b2be0a875e

View file

@ -1,51 +1,51 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- $Revision: 1.9 $ -->
<!-- splitted from ./en/functions/session.xml, last change in rev 1.2 -->
<refentry id="function.session-id">
<refnamediv>
<refname>session_id</refname>
<refpurpose>Get and/or set the current session id</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>session_id</methodname>
<methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
<function>session_id</function> returns the session id for the
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>
<note>
<simpara>
When using session cookies, specifying an <parameter>id</parameter> for
<function>session_id</function> will always send a new cookie when
<function>session_start</function> is called, regardless if the current
session id is identical to the one being set.
</simpara>
</note>
<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. Note that <systemitem>SID</systemitem> is only defined if
the client didn't send the right cookie. See also <link
linkend="ref.session">Session handling</link>.
</para>
<para>
See also <function>session_start</function>,
<function>session_set_save_handler</function>, and
<link linkend="ini.session.save-handler">session.save_handler</link>.
</para>
</refsect1>
</refentry>
<refentry id="function.session-id">
<refnamediv>
<refname>session_id</refname>
<refpurpose>Get and/or set the current session id</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>session_id</methodname>
<methodparam choice="opt"><type>string</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
<function>session_id</function> returns the session id for the 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>
<note>
<simpara>
When using session cookies, specifying an <parameter>id</parameter> for
<function>session_id</function> will always send a new cookie when
<function>session_start</function> is called, regardless if the current
session id is identical to the one being set.
</simpara>
</note>
<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. Note that <systemitem>SID</systemitem> is only defined if
the client didn't send the right cookie. See also <link
linkend="ref.session">Session handling</link>.
</para>
<para>
See also <function>session_start</function>,
<function>session_set_save_handler</function>, and
<link linkend="ini.session.save-handler">session.save_handler</link>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables: