goba Sun Mar 17 10:49:25 2002 EDT
Modified files:
/phpdoc/hu/functions session.xml
Log:
Commit long awaited translation of session.xml (only 50% of it ready),
next 50% is coming the next week.
Index: phpdoc/hu/functions/session.xml
diff -u /dev/null phpdoc/hu/functions/session.xml:1.3
--- /dev/null Sun Mar 17 10:49:25 2002
+++ phpdoc/hu/functions/session.xml Sun Mar 17 10:49:25 2002
@@ -0,0 +1,1305 @@
+<?xml version="1.0" encoding="iso-8859-2"?>
+<!-- EN-Revision: 1.83 Maintainer: goba Status: half translated -->
+ <reference id="ref.session">
+ <title>Munkamenet kezel� f�ggv�nyek</title>
+ <titleabbrev>Munkamenetek</titleabbrev>
+
+ <partintro>
+ <para>
+ A PHP munkamenet kezel�se lehet�v� teszi adatok meg�rz�s�t az
+ egym�st k�vet� oldal lek�rdez�sek k�z�tt. Ez k�pess� tesz
+ m�g testreszabhat�bb oldalak k�sz�t�s�re.
+ </para>
+ <para>
+ Ha ismered a PHPLIB munkamenet kezel�s�t, sok hasonl�s�got
+ fogsz felfedezni a PHP munkamenet kezel� f�ggv�nyeit illet�en.
+ </para>
+ <para>
+ Minden webhelyedre l�togat� egy-egy egyedi azonos�t�t kap,
+ az �gynevezett munkamenet azonos�t�t (session azonos�t�t).
+ Ez vagy egy s�tiben (cookie) t�rol�dik a l�togat� g�p�n,
+ vagy az URL-ben k�zlekedik oldalr�l oldalra.
+ </para>
+ <para>
+ A munkamenet t�mogat�s lehet�v� teszi tetsz�leges sz�m� v�ltoz�
+ meg�rz�s�t a PHP oldal lek�rdez�sek k�z�tt. Ha egy l�togat�
+ �rkezik webhelyedre, h�romf�lek�ppen kezd�dhet el, vagy folytat�dhat
+ a munkamenete. Mindh�rom esetben a PHP egy munkamenet
+ azonos�t� �rkez�s�t v�rja. Ha nem �rkezik, �j munkamenetet
+ ind�t.
+ </para>
+ <para>
+ Ha a session.auto_start be van kapcsolva, a PHP automatikusan
+ megkezdni / folytatja a munkamenetet. Ha ez nincs bekapcsolva,
+ akkor k�zvetlen�l a <function>session_start</function>
+ f�ggv�nnyel, vagy k�zvetve a <function>session_register</function>
+ f�ggv�nnyel tudod a munkamenetet folytatni / megkezdeni.
+ Ha egy �rv�nyes azonos�t� �rkezett, a kor�bban be�ll�tott
+ munkamenet k�rnyezet vissza�ll�t�sra ker�l.
+ </para>
+ <para>
+ Minden a munkamenethez rendelt v�ltoz� szerializ�l�dik a
+ PHP oldal fut�s�nak befejez�d�sekor. A nem defini�lt,
+ de munkamenethez rendelt v�ltoz�k a k�s�bbi folytat�sokban
+ nem j�nnek �jb�l l�tre.
+ </para>
+ <para>
+ A <link
+ linkend="ini.track-vars"><literal>track_vars</literal></link> �s
+ <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ ini be�ll�t�sok befoly�solj�k a munkamenet v�ltoz�k t�rol�s�nak
+ �s vissza�ll�t�s�nak m�dj�t.
+ </para>
+
+ <note>
+ <para>
+ A PHP 4.0.3 verzi�t�l kezdve a <link
+ linkend="ini.track-vars"><literal>track_vars</literal></link> mindig
+ be van kapcsolva, kikapcsol�s�ra nincs m�d.
+ </para>
+ </note>
+ <note>
+ <para>
+ A 4.1.0 verzi�t�l kezdve a <varname>$_SESSION</varname> szuperglob�lis
+ v�ltoz� rendelkez�sre �ll, csak�gy mint a <varname>$_POST</varname>,
+ <varname>$_GET</varname>, <varname>$_REQUEST</varname> �s �gy tov�bb.
+ A <varname>$HTTP_SESSION_VARS</varname> v�ltoz�t�l elt�r�en a
+ <varname>$_SESSION</varname> mindig el�rhet� (szuperglob�lis).
+ Ez�rt a <literal>global</literal> kulcssz�val nem szabad egy�tt
+ haszn�lni a <varname>$_SESSION</varname> v�ltoz�t.
+ </para>
+ </note>
+
+ <para>
+ Ha a <link
+ linkend="ini.track-vars"><literal>track_vars</literal></link> be
+ van kapcsolva, �s a <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ ki van kapcsolva, csak a <varname>$HTTP_SESSION_VARS</varname>
+ asszociat�v t�mb elemei a munkamenet v�ltoz�k. A vissza�ll�tott
+ munkamenet v�ltoz�k is csak a <varname>$HTTP_SESSION_VARS</varname>
+ t�mbben lesznek megtal�lhat�ak.
+ <example>
+ <title>
+ V�ltoz� bejegyz�se a munkamenetbe a <link
+ linkend="ini.track-vars"><literal>track_vars</literal></link>
+ bekapcsolt �llapot�ban.
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+if (isset($HTTP_SESSION_VARS['szamlalo'])) {
+ $HTTP_SESSION_VARS['szamlalo']++;
+}
+else {
+ $HTTP_SESSION_VARS['szamlalo'] = 0;
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ A <varname>$_SESSION</varname> v�ltoz� haszn�lata (vagy
+ a <varname>$HTTP_SESSION_VARS</varname> v�ltoz� haszn�lata
+ PHP 4.0.6 vagy r�gebbi verzi� eset�n) javasolt biztons�gi
+ �s olvashat�s�gi szempontok miatt. A
+ <varname>$_SESSION</varname> vagy
+ <varname>$HTTP_SESSION_VARS</varname> haszn�lat�val nincs sz�ks�g
+ a session_register()/session_unregister()/session_is_registered()
+ f�ggv�nyekre. A programoz�k �ppen �gy dolgozhatnak a munkamenet
+ v�ltoz�kkal, mint a "norm�lis" v�ltoz�kkal.
+ <example>
+ <title>
+ V�ltoz� bejegyz�se a munkamenetbe a $_SESSION t�mbbel.
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Haszn�ld a $HTTP_SESSION_VARS t�mb�t PHP 4.0.6 vagy r�gebbi verzi�ban
+if (!isset($_SESSION['szamlalo'])) {
+ $_SESSION['szamlalo'] = 0;
+} else {
+ $_SESSION['szamlalo']++;
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ <example>
+ <title>
+ V�ltoz� bejegyz�s t�rl�se a $_SESSION t�mbbel.
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+// Haszn�ld a $HTTP_SESSION_VARS t�mb�t PHP 4.0.6 vagy r�gebbi verzi�ban
+unset($_SESSION['szamlalo']);
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Ha a <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ be van kapcsolva, akkor minden glob�lis v�ltoz� lehet munkamenet
+ v�ltoz�k�nt regisztr�lva, �s a munkamenet k�s�bbi folytat�saiban is
+ l�tre fognak j�nni glob�lis v�ltoz�kk�nt a bejegyzett v�ltoz�k.
+ Mivel ebben az esetben a PHP-nek tudnia kell, hogy mely glob�lis
+ v�ltoz�k bejegyzett munkamenet v�ltoz�k is egyben, a programoz�nak
+ a session_register() f�ggv�nyt kell haszn�lnia. Eml�keztet�k�nt a
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>
+ t�mb�k haszn�latakor nincs sz�ks�g a session_register() f�ggv�nyre.
+ <caution>
+ <para>
+ Ha a
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>
+ t�mb�t haszn�lod �s kikapcsolod a <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ be�ll�t�st, ne haszn�ld a <function>session_register</function>,
+ <function>session_is_registered</function> �s
+ <function>session_unregister</function> f�ggv�nyeket.
+ </para>
+ <para>
+ Ha bekapcsolod a <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ be�ll�t�st, a <function>session_unregister</function> f�ggv�nyt
+ kell haszn�lnod, mivel a munkamenet v�ltoz�k glob�lis v�ltoz�kban
+ jelennek meg. A <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ kikapcsol�sa javasolt mind biztons�gi, mind teljes�tm�ny szempontokb�l.
+ </para>
+ </caution>
+ <example>
+ <title>
+ V�ltoz� bejegyz�se a <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ bekapcsolt �llapota mellett.
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+if (!session_is_registered('szamlalo')) {
+ session_register("szamlalo");
+ $szamlalo = 0;
+}
+else {
+ $szamlalo++;
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Ha mind a <link
+ linkend="ini.track-vars"><literal>track_vars</literal></link>, mind a
+ <link
+ linkend="ini.register-globals"><literal>register_globals</literal></link>
+ be�ll�t�sok be vannak kapcsolva, a glob�lis v�ltoz�k �s a
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>
+ t�mb�k elemei ugynazokra az �rt�kekre fognak mutatni a m�r
+ bejegyzett v�ltoz�kat illet�en.
+ </para>
+ <para>
+ Ha a programoz� a session_register() f�ggv�nyt haszn�lja munkamenet
+ v�ltoz�k bejegyz�s�re, akkor ebben az esetben a
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>
+ t�mb�kben nem fog megjelenni ez a v�ltoz� a k�vetkez� munkamenet
+ folytat�sa el�tt (azaz a k�vetkez� PHP program fut�s el�tt).
+ </para>
+ <para>
+ K�tf�lek�ppen "k�zlekedhet" a munkamenet azonos�t�:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ S�ti form�j�ban
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ URL / �rlap param�terben
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>
+ A munkamenetkezel� modul mindk�t form�t t�mogatja. A s�tik
+ optim�lisak, de sajnos nem megb�zhat�ak (sokan nem fogadj�k
+ a s�tiket), ez�rt nem lehet r�juk biztons�ggal �p�teni.
+ A m�sodik m�dszer az azonos�t�t k�zvetlen�l az URL-ekbe
+ �s �rlapokba helyezi.
+ </para>
+ <para>
+ A PHP k�pes ezut�bbi azonos�t� terjeszt�st �tl�tsz�an v�gezni, ha az
+ <link linkend="install.configure.enable-trans-sid">
+ <literal>--enable-trans-sid</literal></link> opci�val fod�tottad.
+ Ha ezt az opci�t bekapcsolod, a relt�v URL-ekhez �s �rlapokhoz
+ automatikusan hozz�teszi a PHP a munkamenet azonos�t�t. Alternat�v
+ m�dszerk�nt haszn�lhatod a <literal>SID</literal> konstanst, ami
+ defini�lt, ha a kliens nem k�ldte vissza a megfelel� s�tit. A
+ <literal>SID</literal> vagy <literal>session_name=session_id</literal>
+ (munkamenet n�v, munkamenet azonos�t�) form�tum�, vagy egy �res
+ karektersorozat.
+ </para>
+ <para>
+ A k�vetkez� p�lda egy v�ltoz� bejegyz�st, �s egy k�vetkez� oldalra
+ mutat� link k�sz�t�s�t mutatja,
+ <example>
+ <title>Egy l�togat� �ltal leh�vott oldalak sz�ml�l�sa</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+if (!session_is_registered('szamlalo')) {
+ session_register('szamlalo');
+ $szamlalo = 1;
+}
+else {
+ $szamlalo++;
+}
+?>
+
+�dv l�togat�, eddig <?php echo $szamlalo; ?> alkalommal
+l�ttad ezt az oldalt.<p>
+
+<?php
+# Az <?php echo SID?> sz�ks�ges, hogy a munkamenet azonos�t�t
+# meg�rizz�k abban az esetben is, ha a l�togat� nem fogadja
+# a s�tit. (<?=SID?> haszn�lhat�, ha a r�vid tagek enged�lyezettek)
+?>
+
+A tov�bbl�p�shez <A HREF="kovoldal.php?<?php echo SID?>">kattints ide</A>.
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ A <literal><?=SID?></literal> nem sz�ks�ges, ha az
+ <link linkend="install.configure.enable-trans-sid">
+ <literal>--enable-trans-sid</literal></link> opci�val
+ ford�tottad a PHP-t.
+ </para>
+ <note>
+ <para>
+ A nem relat�v hivatkoz�sok felt�telezetten k�ls� oldalakra
+ mutatnak, ez�rt nem eg�sz�lnek ki automatikusan a SID-el.
+ Komoly biztons�gi probl�m�kat okozna, ha a SID-ek
+ elker�ln�nek egy m�sik kiszolg�l�hoz.
+ </para>
+ </note>
+ <para>
+ A munkamenethez tartoz� adatok �llom�nyokban t�rol�dnak.
+ Ha adatb�zisban, vagy m�s t�rol� eszk�z�n szeretn�d r�gz�teni
+ a munkamenethez tartoz� adatokat, a
+ <function>session_set_save_handler</function> f�ggv�nyt
+ kell haszn�lnod a saj�t t�rol� f�ggv�nyeid bejegyz�s�hez.
+ </para>
+ <para>
+ A munkamenet kezel� f�ggv�nyek sz�mos be�ll�t�si lehet�s�get
+ biztos�tanak, amiket a php.ini �llom�nyban helyezhetsz el.
+ Egy r�vid �ttekint�s k�vetkezik.
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ A <literal>session.save_handler</literal> be�ll�t�s adja
+ meg a haszn�lt t�rol�s kezel�t, ami a munkamenet adatok
+ elment�s�re, �s visszakeres�s�re szolg�l. Az alap�rt�ke
+ <literal>files</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.save_path</literal> be�ll�t�s az a param�ter,
+ amit a t�rol�s kezel� megkap. Ha az alap�rtelmezett �llom�ny
+ kezel�t haszn�lod, ez a munkamenetek t�rol�s�ra haszn�lt
+ ideiglenes �llom�nyok k�nyt�r�nak el�r�si �tja. Alap�rtelmez�se
+ <literal>/tmp</literal>. Ha a <literal>session.save_path</literal>
+ m�lys�ge t�bb mint kett�, az automatikus szem�t takar�t�s
+ nem fog m�k�dni.
+ </simpara>
+ <warning>
+ <para>
+ Ha ezt az �rt�ket egy mindenki �ltal olvashat� k�nyvt�rra
+ �ll�tod (mint az alapbe�ll�t�s� <filename>/tmp</filename>),
+ akkor a kiszolg�l�n l�v� t�bbi felhaszn�l� el tudja kapni
+ a munkameneteidet a k�nyvt�rban l�v� �llom�nyok neve �s
+ tartalma alapj�n.
+ </para>
+ </warning>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.name</literal> a munkamenet neve, amit
+ a PHP a s�ti be�ll�t�sakor, az URL / �rlap param�terek
+ felv�telekor �s a munkamenet folytat�sakor haszn�l. Csak
+ alfanumerikus karaktereket tartalmazhat. Alap�rt�ke
+ <literal>PHPSESSID</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.auto_start</literal> be�ll�t�s adja meg,
+ hogy a PHP kezdjen-e / folytasson-e minden PHP oldal
+ futatt�sn�l automatikusan munkamenetet. Alap�rt�ke
+ <literal>0</literal> (kikapcsolt).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.cookie_lifetime</literal> a be�ll�tott
+ s�ti �lettartalm�t szab�lyozza m�sodpercekben megadva.
+ A nulla �rt�k azt jelenti, hogy "am�g a b�ng�sz�t be
+ nem z�rj�k". Alap�rt�ke �ppen <literal>0</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.serialize_handler</literal> a
+ szerializ�l�shoz haszn�lt kezel� nev�t adja meg.
+ Jelenleg egy be�p�tett PHP form�tum (<literal>php</literal>
+ n�ven) �s egy WDDX form�tum t�mogatott
+ (<literal>wddx</literal> n�ven). A WDDX form�tumhoz
+ sz�ks�ges, hogy a WDDX t�mogat�s a PHP-be legyen
+ ford�tva. L�sd <link linkend="ref.wddx">WDDX</link>.
+ Alap�rt�ke a be�p�tett <literal>php</literal> kezel�.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.gc_probability</literal> megadja, hogy
+ mekkora val�sz�n�s�ggel indul el a gc (garbage collection -
+ szem�tgy�jt�s) az egyes PHP lek�rdez�sekkor. Az �rt�ket
+ sz�zal�kban kell megadni. Alap�rt�ke <literal>1</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.gc_maxlifetime</literal> megadja, hogy
+ h�ny m�sodperc eltelt�vel tekinti a szem�tgy�tjt� szem�tnek,
+ �s eltakar�tand�nak a munkamenet adatokat.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.referer_check</literal> azt a
+ r�sz-karaktersorozatot tartalmazza, amit minden HTTP
+ Referer fejl�cben keresni szeretn�l a munkamenetek m�g
+ biztons�gosabb azonos�t�sa c�lj�b�l. Ha a megadott
+ r�sz-karaktersorozatot nem tal�lja meg a PHP a Refererben,
+ a k�ld�tt munkamenet azonos�t�t nem fogja elfogadni.
+ Alap�rt�ke az �res karaktersorozat.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.entropy_file</literal> egy el�r�si utat
+ hat�roz meg ahhoz az "�llom�nyhoz", amit a PHP k�ls� entr�pia
+ forr�snak haszn�l a munkamenet azonos�t� el��ll�t�sakor.
+ Ez lehet p�ld�ul <literal>/dev/random</literal> vagy
+ <literal>/dev/urandom</literal>. Ezek sok Unix rendszeren
+ el�rhet�ek.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.entropy_length</literal> az olvasott
+ byte-ok sz�m�t adja meg, amennyit a fent eml�tett
+ �llom�nyb�l olvas a PHP. Alap�rt�ke <literal>0</literal>
+ (kikapcsolt).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.use_cookies</literal> hat�rozza meg,
+ hogy a PHP haszn�l-e s�tiket a munkamenet azonos�t�
+ t�rol�s�ra a kliens oldalon. Alap�rt�ke
+ <literal>1</literal> (enged�lyezett).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.cookie_path</literal> azt az el�r�si
+ utat hat�rozza meg, amit a munkamenet s�tiben be�ll�t
+ a PHP. Alap�rt�ke <literal>/</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.cookie_domain</literal> azt a domain
+ �rt�ket hat�rozza meg, amit a PHP a munkamenet s�tiben
+ be�ll�t. Alap�rt�ke semmi.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.cache_limiter</literal> azt a cache met�dust
+ hat�rozza meg, amit a munkamenet oldalakra alkalmazni kell.
+ Lehets�ges �rt�kei: none, nocache, private, private_no_expire �s
+ public. Alap�rt�ke <literal>nocache</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.cache_expire</literal> megadja, hogy h�ny
+ percig legyen aktu�lis a cache-ben egy munkamenetet haszn�l�
+ oldal. Ennek nincs hat�sa, ha nocache m�dot v�lasztasz.
+ Alap�rt�ke <literal>180</literal>.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ A <literal>session.use_trans_sid</literal> szab�lyozza, hogy
+ az �tl�tsz� SID hozz�ad�s be van-e kapcsolva vagy nincs.
+ Ehhez sz�ks�ges, hogy a
+ <link linkend="install.configure.enable-trans-sid">
+ <literal>--enable-trans-sid</literal></link> opci�val
+ ford�tsd kor�bban a PHP-t. Alap�rt�ke <literal>1</literal>
+ (enged�lyezett).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ Az <literal>url_rewriter.tags</literal> adja meg, hogy mely
+ HTML elemeket kell �t�rni, ha a munkamenet azonos�t�k
+ �tl�tsz� elhelyez�se be van kapcsolva. Alap�rt�ke
+ <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ <note>
+ <para>
+ A munkamenetek t�mogat�sa a PHP 4.0 verzi�ban jelent meg.
+ </para>
+ </note>
+ </para>
+ </partintro>
+
+ <refentry id="function.session-start">
+ <refnamediv>
+ <refname>session_start</refname>
+ <refpurpose>Munkamenet megkezd�se / folytat�sa</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_start</methodname>
+ <void/>
+ </methodsynopsis>
+ <simpara>
+ A <function>session_start</function> elkezd egy �j munkamenetet,
+ vagy folytat egy kor�bbit, ha a PHP �rv�nyes munkamenet azonos�t�
+ �rkez�s�t �rz�kelte GET/POST param�terben vagy s�tiben.
+ </simpara>
+ <simpara>
+ Ha az alapbe�ll�t�s� n�vt�l elt�r� nevet szeretn�l haszn�lni
+ a munkamenet sz�m�ra, haszn�ld a <function>session_name</function>
+ f�ggv�nyt a <function>session_start</function> megh�v�sa
+ <emphasis>el�tt</emphasis>.
+ </simpara>
+ <simpara>
+ Ez a f�ggv�ny mindig &true; �rt�kkel t�r vissza.
+ </simpara>
+ <note>
+ <para>
+ Ha s�ti alap� munkameneteket haszn�lsz, a
+ <function>session_start</function> h�v�snak minden
+ kimenetet meg kell el�znie.
+ </para>
+ </note>
+ <simpara>
+ A <function>session_start</function> egy bels� kimenet kezel�t
+ regisztr�l az URL-ek �s �rlapok �t�r�s�ra, ha a
+ <literal>trans-sid</literal> funkci� be van kapcsolva.
+ Ha az <literal>ob_gzhandler</literal>-t vagy m�s hasonl� kimenet
+ kezel�ket haszn�lsz az <function>ob_start</function> f�ggv�nnyel,
+ a kimenet kezel�k sorrendje fontos a megfelel� kimenet �rdek�ben.
+ Ez�rt az <literal>ob_gzhandler</literal>-t a munkamenet megkezd�se
+ el�tt kell regisztr�lni.
+ </simpara>
+ <note>
+ <simpara>
+ A <literal>zlib.output_compression</literal> haszn�lata javasolt
+ az <literal>ob_gzhandler</literal> helyett.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-destroy">
+ <refnamediv>
+ <refname>session_destroy</refname>
+ <refpurpose>Adott munkamenethez tartoz� minden adat t�rl�se</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_destroy</methodname>
+ <void/>
+ </methodsynopsis>
+ <simpara>
+ A <function>session_destroy</function> az aktu�lis munkamenethez
+ tartoz� minden adatot t�r�l. Nem t�rli azonban a glob�lis
+ v�ltoz�kat, vagy a munkamenethez be�ll�tott s�tit.
+ </simpara>
+ <simpara>
+ Ez a f�ggv�ny &true; �rt�kkel t�r vissza siker eset�n,
+ &false; �rt�kkel t�r vissza, ha nem tudja a munkamenet
+ adatait t�r�lni.
+ </simpara>
+ <para>
+ <example>
+ <title>Munkamenet t�rl�se</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// Munkamenet megkezd�se / folytat�sa.
+// Ha haszn�lsz session_name("valami") h�v�st, ne feledd itt!
+session_start();
+// Minden munkamenet v�ltoz� t�rl�se.
+session_unset();
+// A munkamenet t�rl�se.
+session_destroy();
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Munkamenet t�rl�se a $_SESSION t�mbbel</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// Munkamenet megkezd�se / folytat�sa.
+// Ha haszn�lsz session_name("valami") h�v�st, ne feledd itt!
+session_start();
+// Minden munkamenet v�ltoz� t�rl�se.
+$_SESSION = array();
+// A munkamenet t�rl�se.
+session_destroy();
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-name">
+ <refnamediv>
+ <refname>session_name</refname>
+ <refpurpose>Az aktu�lis munkamenet n�v lek�rdez�se / be�ll�t�sa</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <methodsynopsis>
+ <type>string</type><methodname>session_name</methodname>
+ <methodparam
+choice="opt"><type>string</type><parameter>name</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ A <function>session_name</function> visszaadja az aktu�lis munkamenet
+ nev�t. Ha a <parameter>name</parameter> param�ter meg van adva, az
+ aktu�lis munkamenet neve erre v�ltozik.
+ </para>
+ <para>
+ A munkamenet neve azonos�tja a munkamenetet a s�tikben,
+ URL-ekben �s �rlapokban. Csak alfanumerikus karaktereket
+ tartalmazhat, r�vidnek �s �rthet�nek kell lennie (azon
+ l�togat�k sz�m�ra, akik p�ld�ul bekapcsolt s�ti
+ figyelmeztet�k olvas�sa alapj�n d�ntik el a s�ti
+ enged�lyez�s�t). A munkamenet neve visszat�r a php.ini
+ <literal>session.name</literal> be�ll�t�s�ra a PHP
+ program fut�sa kezdet�n. Ez�rt mindig meg kell h�vni
+ a <function>session_name</function> f�ggv�nyt a k�v�nt
+ n�vvel a <function>session_start</function> �s/vagy
+ <function>session_register</function> h�v�sok el�tt,
+ ha nem az alap�rtelmezett munkamenet nevet szeretn�d
+ haszn�lni.
+ </para>
+ <example>
+ <title><function>session_name</function> p�lda</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+// a munkamenet nev�t webhelyneve-re �ll�jtuk
+
+$elozo_nev = session_name("webhelyneve");
+
+echo "A megel�z� munkamenet n�v $elozo_nev volt.<p>";
+?>
+]]>
+ </programlisting>
+ </example>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-module-name">
+ <refnamediv>
+ <refname>session_module_name</refname>
+ <refpurpose>Get and/or set the current session module</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>session_module_name</methodname>
+ <methodparam
+choice="opt"><type>string</type><parameter>module</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_module_name</function> returns the name of the
+ current session module. If <parameter>module</parameter> is
+ specified, that module will be used instead.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-save-path">
+ <refnamediv>
+ <refname>session_save_path</refname>
+ <refpurpose>Get and/or set the current session save path</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>session_save_path</methodname>
+ <methodparam
+choice="opt"><type>string</type><parameter>path</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_save_path</function> returns the path of the current
+ directory used to save session data. If <parameter>path</parameter>
+ is specified, the path to which data is saved will be changed.
+ <note>
+ <para>
+ On some operating systems, you may want to specify a path on a
+ filesystem that handles lots of small files efficiently. For
+ example, on Linux, reiserfs may provide better performance than
+ ext2fs.
+ </para>
+ </note>
+ </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. If <parameter>id</parameter> is specified, it
+ will replace the current session id.
+ </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.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-register">
+ <refnamediv>
+ <refname>session_register</refname>
+ <refpurpose>
+ Register one or more variables with the current session
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_register</methodname>
+ <methodparam><type>mixed</type><parameter>name</parameter></methodparam>
+ <methodparam
+choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_register</function> accepts a variable number of
+ arguments, any of which can be either a string holding the name of a
+ variable or an array consisting of variable names or other arrays. For
+ each name, <function>session_register</function> registers the global
+ variable with that name in the current session.
+ </para>
+ <caution>
+ <para>
+ This registers a <emphasis>global</emphasis> variable. If you want to
+ register a session variable inside a function, you need to make sure to
+ make it global using <function>global</function> or use the session
+ arrays as noted below.
+ </para>
+ </caution>
+ <caution>
+ <para>
+ If you are using
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>,
+ 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.
+ </para>
+ <para>
+ If <function>session_start</function> was not called before this function
+ is called, an implicit call to <function>session_start</function> with no
+ parameters will be made.
+ </para>
+ <para>
+ You can also create a session variable by simply setting the
+ appropriate member of the <varname>$HTTP_SESSION_VARS</varname>
+ or <varname>$_SESSION</varname> (PHP >= 4.1.0) array.
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+$barney = "A big purple dinosaur.";
+session_register("barney");
+
+$HTTP_SESSION_VARS["zim"] = "An invader from another planet.";
+
+# the auto-global $_SESSION array was introduced in PHP 4.1.0
+$_SESSION["spongebob"] = "He's got square pants.";
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ <note>
+ <para>
+ It is not currently possible to register resource variables in a
+ session. For example, you can not create a connection to a
+ database and store the connection id as a session variable and
+ expect the connection to still be valid the next time the
+ session is restored. PHP functions that return a resource are
+ identified by having a return type of
+ <literal>resource</literal> in their function definitions. A
+ list of functions that return resources are available in the
+ <link linkend="resource">resource types</link> appendix.
+ </para>
+ <para>
+ If <varname>$_SESSION</varname> (or
+ <varname>$HTTP_SESSION_VARS</varname> for PHP 4.0.6 or less) is
+ used, assign variable to
+ <varname>$_SESSION</varname>. i.e. $_SESSION['var'] = 'ABC';
+ </para>
+ </note>
+ <para>
+ See also <function>session_is_registered</function> and
+ <function>session_unregister</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-unregister">
+ <refnamediv>
+ <refname>session_unregister</refname>
+ <refpurpose>
+ Unregister a variable from the current session
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_unregister</methodname>
+ <methodparam><type>string</type><parameter>name</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_unregister</function> unregisters (forgets)
+ the global variable named <parameter>name</parameter> from the
+ current session.
+ </para>
+ <para>
+ This function returns &true; when the variable is successfully
+ unregistered from the session.
+ </para>
+ <note>
+ <para>
+ If <varname>$_SESSION</varname> (or
+ <varname>$HTTP_SESSION_VARS</varname> for PHP 4.0.6 or less) is
+ used, use <function>unset</function> to unregister a session
+ variable.
+ </para>
+ </note>
+ <caution>
+ <para>
+ This function doesn't unset the corresponding global variable for
+ <parameter>name</parameter>, it only prevents the variable from being
+ saved as part of the session. You must call <function>unset</function>
+ to remove the corresponding global variable.
+ </para>
+ </caution>
+ <caution>
+ <para>
+ If you are using
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>,
+ do not use <function>session_register</function>,
+ <function>session_is_registered</function> and
+ <function>session_unregister</function>.
+ </para>
+ </caution>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-unset">
+ <refnamediv>
+ <refname>session_unset</refname>
+ <refpurpose>
+ Free all session variables
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>void</type><methodname>session_unset</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ The <function>session_unset</function> function free's all session variables
+ currently registered.
+ </para>
+ <note>
+ <para>
+ If <varname>$_SESSION</varname> (or
+ <varname>$HTTP_SESSION_VARS</varname> for PHP 4.0.6 or less) is
+ used, use <function>unset</function> to unregister session
+ variable. i.e. $_SESSION = array();
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-is-registered">
+ <refnamediv>
+ <refname>session_is_registered</refname>
+ <refpurpose>
+ Find out if a variable is registered in a session
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_is_registered</methodname>
+ <methodparam><type>string</type><parameter>name</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_is_registered</function> returns &true; if there
+ is a variable with the name <parameter>name</parameter>
+ registered in the current session.
+ </para>
+ <note>
+ <para>
+ If <varname>$_SESSION</varname> (or
+ <varname>$HTTP_SESSION_VARS</varname> for PHP 4.0.6 or less) is
+ used, use <function>isset</function> to check a variable is
+ registered in <varname>$_SESSION</varname>.
+ </para>
+ </note>
+ <caution>
+ <para>
+ If you are using
+ <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>,
+ do not use <function>session_register</function>,
+ <function>session_is_registered</function> and
+ <function>session_unregister</function>.
+ </para>
+ </caution>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-get-cookie-params">
+ <refnamediv>
+ <refname>session_get_cookie_params</refname>
+ <refpurpose>
+ Get the session cookie parameters
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>array</type><methodname>session_get_cookie_params</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ The <function>session_get_cookie_params</function> function returns an
+ array with the current session cookie information, the array contains
+ the following items:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ "lifetime" - The lifetime of the cookie.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "path" - The path where information is stored.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "domain" - The domain of the cookie.
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ "secure" - The cookie should only be sent over secure connections.
+ (This item was added in PHP 4.0.4.)
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-set-cookie-params">
+ <refnamediv>
+ <refname>session_set_cookie_params</refname>
+ <refpurpose>
+ Set the session cookie parameters
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>void</type><methodname>session_set_cookie_params</methodname>
+ <methodparam><type>int</type><parameter>lifetime</parameter></methodparam>
+ <methodparam
+choice="opt"><type>string</type><parameter>path</parameter></methodparam>
+ <methodparam
+choice="opt"><type>string</type><parameter>domain</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Set cookie parameters defined in the php.ini file. The effect of this
+ function only lasts for the duration of the script.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-decode">
+ <refnamediv>
+ <refname>session_decode</refname>
+ <refpurpose>Decodes session data from a string</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>session_decode</methodname>
+ <methodparam><type>string</type><parameter>data</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_decode</function> decodes the session data in
+ <parameter>data</parameter>, setting variables stored in the
+ session.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-encode">
+ <refnamediv>
+ <refname>session_encode</refname>
+ <refpurpose>
+ Encodes the current session data as a string
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>session_encode</methodname>
+ <void/>
+ </methodsynopsis>
+ <para>
+ <function>session_encode</function> returns a string with the
+ contents of the current session encoded within.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-set-save-handler">
+ <refnamediv>
+ <refname>session_set_save_handler</refname>
+ <refpurpose>
+ Sets user-level session storage functions
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>void</type><methodname>session_set_save_handler</methodname>
+
+<methodparam><type>string</type><parameter>open</parameter></methodparam><methodparam><type>string</type><parameter>close</parameter></methodparam><methodparam><type>string</type><parameter>read</parameter></methodparam><methodparam><type>string</type><parameter>write</parameter></methodparam><methodparam><type>string</type><parameter>destroy</parameter></methodparam><methodparam><type>string</type><parameter>gc</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_set_save_handler</function> sets the user-level
+ session storage functions which are used for storing and
+ retrieving data associated with a session. This is most useful
+ when a storage method other than those supplied by PHP sessions
+ is preferred. i.e. Storing the session data in a local database.
+ </para>
+ <note>
+ <para>
+ You must set the configuration option
+ <parameter>session.save_handler</parameter> to
+ <parameter>user</parameter> in your php.ini file for
+ <function>session_set_save_handler</function> to take effect.
+ </para>
+ </note>
+ <note>
+ <para>
+ The "write" handler is not executed until after the output
+ stream is closed. Thus, output from debugging statements in the
+ "write" handler will never be seen in the browser. If debugging
+ output is necessary, it is suggested that the debug output be
+ written to a file instead.
+ </para>
+ </note>
+ <para>
+ The following example provides file based session
+ storage similar to the PHP sessions default save handler
+ <parameter>files</parameter>. This example could easily be
+ extended to cover database storage using your favorite PHP
+ supported database engine.
+ </para>
+ <para>
+ Read function must return string value always to make save
+ handler work as expected. Return empty string if there is no data
+ to read. Return values from other handlers are converted to
+ boolean expression. TRUE for success, FALSE for failure.
+ </para>
+ <para>
+ <example>
+ <title>
+ <function>session_set_save_handler</function> example
+ </title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function open ($save_path, $session_name) {
+ global $sess_save_path, $sess_session_name;
+
+ $sess_save_path = $save_path;
+ $sess_session_name = $session_name;
+ return(true);
+}
+
+function close() {
+ return(true);
+}
+
+function read ($id) {
+ global $sess_save_path, $sess_session_name;
+
+ $sess_file = "$sess_save_path/sess_$id";
+ if ($fp = @fopen($sess_file, "r")) {
+ $sess_data = fread($fp, filesize($sess_file));
+ return($sess_data);
+ } else {
+ return(""); // Must return "" here.
+ }
+
+}
+
+function write ($id, $sess_data) {
+ global $sess_save_path, $sess_session_name;
+
+ $sess_file = "$sess_save_path/sess_$id";
+ if ($fp = @fopen($sess_file, "w")) {
+ return(fwrite($fp, $sess_data));
+ } else {
+ return(false);
+ }
+
+}
+
+function destroy ($id) {
+ global $sess_save_path, $sess_session_name;
+
+ $sess_file = "$sess_save_path/sess_$id";
+ return(@unlink($sess_file));
+}
+
+/*********************************************
+ * WARNING - You will need to implement some *
+ * sort of garbage collection routine here. *
+ *********************************************/
+function gc ($maxlifetime) {
+ return true;
+}
+
+session_set_save_handler ("open", "close", "read", "write", "destroy", "gc");
+
+session_start();
+
+// proceed to use sessions normally
+
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-cache-limiter">
+ <refnamediv>
+ <refname>session_cache_limiter</refname>
+ <refpurpose>Get and/or set the current cache limiter</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>session_cache_limiter</methodname>
+ <methodparam
+choice="opt"><type>string</type><parameter>cache_limiter</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_cache_limiter</function> returns the name of the
+ current cache limiter. If <parameter>cache_limiter</parameter> is
+ specified, the name of the current cache limiter is changed to the
+ new value.
+ </para>
+ <para>
+ The cache limiter controls the cache control HTTP headers sent to the
+ client. These headers determine the rules by which the page content
+ may be cached. Setting the cache limiter to <literal>nocache</literal>,
+ for example, would disallow any client-side caching. A value of
+ <literal>public</literal>, however, would permit caching. It can also
+ be set to <literal>private</literal>, which is slightly more restrictive
+ than <literal>public</literal>.
+ </para>
+ <para>
+ In <literal>private</literal> mode, Expire header sent to the
+ client, may cause confusion for some browser including Mozilla.
+ You can avoid this problem with
+ <literal>private_no_expire</literal> mode. Expire header is never
+ sent to the client in this mode.
+ </para>
+ <note>
+ <para>
+ <literal>private_no_expire</literal> was added in PHP 4.2.0dev.
+ </para>
+ </note>
+ <para>
+ The cache limiter is reset to the default value stored in
+ <literal>session.cache_limiter</literal> at request startup time. Thus,
+ you need to call <function>session_cache_limiter</function> for every
+ request (and before <function>session_start</function> is called).
+ </para>
+ <example>
+ <title><function>session_cache_limiter</function> examples</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+
+# set the cache limiter to 'private'
+
+session_cache_limiter('private');
+$cache_limiter = session_cache_limiter();
+
+echo "The cache limiter is now set to $cache_limiter<p>";
+?>
+]]>
+ </programlisting>
+ </example>
+ </refsect1>
+ </refentry>
+
+ <refentry id='function.session-cache-expire'>
+ <refnamediv>
+ <refname>session_cache_expire</refname>
+ <refpurpose>Return current cache expire</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>int</type><methodname>session_cache_expire</methodname>
+ <methodparam
+choice="opt"><type>int</type><parameter>new_cache_expire</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>session_cache_expire</function> returns current cache expire.
+ If <parameter>new_cache_expire</parameter> is given, the current
+ cache expire is replaced with <parameter>new_cache_expire</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.session-write-close">
+ <refnamediv>
+ <refname>session_write_close</refname>
+ <refpurpose>Write session data and end session</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>void</type><methodname>session_write_close</methodname>
+ <void/>
+ </methodsynopsis>
+ <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_write_close</function>, but as
+ session data is locked to prevent 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
+ load all the frames by ending the session as soon as all changes
+ to session variables are done.
+ </para>
+<!-- commented out until final decision on implementation
+ <para>
+ See also: <function>session_readonly</function>.
+ </para>
+-->
+ </refsect1>
+ </refentry>
+
+<!-- commented out until final decision on implementation
+ <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>
+ <methodsynopsis>
+ <type>void</type><methodname>session_readonly</methodname>
+ <void/>
+ </methodsynopsis>
+ <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
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
