session_end() and session_readonly() added

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@49900 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Hartmut Holzgraefe 2001-06-20 17:21:08 +00:00
parent f0568677de
commit b607876481

View file

@ -1,7 +1,7 @@
<reference id="ref.session">
<title>Session handling functions</title>
<titleabbrev>Sessions</titleabbrev>
<partintro>
<para>
Session support in PHP consists of a way to preserve certain data
@ -937,6 +937,58 @@ echo "The cache limiter is now set to $cache_limiter&lt;p&gt;";
</refsect1>
</refentry>
<refentry id="function.session-end">
<refnamediv>
<refname>session_end</refname>
<refpurpose>Write session data and end session</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_end</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
End the current session and store session data.
</para>
<para>
Session data is usually stored after your script terminated
without the need to call <function>session_end</function>, but as
session data is locked to prevend concurrent writes only one
script may operate on a session at any time. When using framesets
together with sessions you will experience the frames loading one
by one due to this locking. You can reduce the time needed to
laod all the frames by ending the session as soon as all changes
to session variables are done.
</para>
<para>
See also: <function>session_readonly</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.session-readonly">
<refnamediv>
<refname>session_readonly</refname>
<refpurpose>Begin session - reinitializes freezed variables, but no writeback on request end</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
<funcprototype>
<funcdef>void <function>session_readonly</function></funcdef>
<void/>
</funcprototype>
</funcsynopsis>
<para>
Read in session data without locking the session data. Changing
session data is not possible, but frameset performance will be improved.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file