samesch Sun Dec 16 18:03:03 2001 EDT
Modified files:
/phpdoc/de/functions session.xml
Log:
Syncing with english rev. 1.62
Index: phpdoc/de/functions/session.xml
diff -u phpdoc/de/functions/session.xml:1.31 phpdoc/de/functions/session.xml:1.32
--- phpdoc/de/functions/session.xml:1.31 Wed Dec 12 15:46:18 2001
+++ phpdoc/de/functions/session.xml Sun Dec 16 18:03:03 2001
@@ -41,66 +41,70 @@
definiert, außer der Benutzer definiert sie später.
</para>
<para>
- Die Konfigurationseinstellungen von <link
- linkend="ini.track-vars"><literal>track_vars</literal></link> und
- <link
- linkend="ini.register-globals"><literal>register_globals</literal></link>
+ Die Konfigurationseinstellungen von
+ <link linkend="ini.track-vars"><literal>track_vars</literal></link>
+ und
+ <link linkend="ini.register-globals"><literal>register_globals</literal></link>
beeinflussen, wie die Session-Variablen gespeichert und
wiederhergestellt werden.
</para>
<note>
<para>
- Seit PHP 4.0.3 ist <link
- linkend="ini.track-vars"><literal>track_vars</literal></link>
+ Seit PHP 4.0.3 ist
+ <link linkend="ini.track-vars"><literal>track_vars</literal></link>
immer aktiviert.
</para>
</note>
<para>
- Falls <link
- linkend="ini.track-vars"><literal>track_vars</literal></link>
- aktiviert und <link
- linkend="ini.register-globals"><literal>register_globals</literal></link>
+ Falls
+ <link linkend="ini.track-vars"><literal>track_vars</literal></link>
+ aktiviert und
+ <link linkend="ini.register-globals"><literal>register_globals</literal></link>
deaktiviert ist, können nur Bestandteile des globalen assoziativen
Arrays $HTTP_SESSION_VARS als Session-Variablen registriert
werden. Wiederhergestellte Session-Variablen stehen nur im Array
$HTTP_SESSION_VARS zur Verfügung.
<example>
<title>
- Registrierung einer Variablen bei aktiviertem <link
- linkend="ini.track-vars"><literal>track_vars</literal></link>
+ Registrierung einer Variablen bei aktiviertem
+ <link linkend="ini.track-vars"><literal>track_vars</literal></link>
</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
session_register("count");
$HTTP_SESSION_VARS["count"]++;
-?>
+?>
+]]>
</programlisting>
</example>
</para>
<para>
- Wenn <link
- linkend="ini.register-globals"><literal>register_globals</literal></link>
+ Wenn
+ <link linkend="ini.register-globals"><literal>register_globals</literal></link>
aktiviert ist, können alle globalen Variablen als
Session-Variablen registriert werden und die Session-Variablen
werden als entsprechende globale Variablen wiederhergestellt.
<example>
<title>
- Registrierung einer Variablen bei aktiviertem <link
- linkend="ini.register-globals"><literal>register_globals</literal></link>
+ Registrierung einer Variablen bei aktiviertem
+ <link linkend="ini.register-globals"><literal>register_globals</literal></link>
</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
session_register("count");
$count++;
-?>
+?>
+]]>
</programlisting>
</example>
</para>
<para>
- Wenn sowohl <link
- linkend="ini.track-vars"><literal>track_vars</literal></link> als
- auch <link
- linkend="ini.register-globals"><literal>register_globals</literal></link>
+ Wenn sowohl
+ <link linkend="ini.track-vars"><literal>track_vars</literal></link>
+ als auch
+ <link linkend="ini.register-globals"><literal>register_globals</literal></link>
aktiviert sind, dann referenzieren die globalen Variablen und die
Einträge von $HTTP_SESSION_VARS den selben Wert.
</para>
@@ -127,13 +131,13 @@
URLs.
</para>
<para>
- Wenn PHP mit <link linkend="install.configure.enable-trans-sid">
- <literal>--enable-trans-sid</literal></link> kompiliert
- wurde, kann es dies transparent machen. Wenn Sie diese Option
- aktivieren, werden relative URIs automatisch geändert, sodass sie
- die Session-ID enthalten. Alternativ können sie die Konstante
- <literal>SID</literal> verwenden, die definiert wird, falls vom
- Client keinen passendes Cookie gesendet wurde.
+ Wenn PHP mit
+ <link
+linkend="install.configure.enable-trans-sid"><literal>--enable-trans-sid</literal></link>
+ kompiliert wurde, kann es dies transparent machen. Wenn Sie diese
+ Option aktivieren, werden relative URIs automatisch geändert,
+ sodass sie die Session-ID enthalten. Alternativ können sie die
+ Konstante <literal>SID</literal> verwenden, die definiert wird,
+ falls vom Client keinen passendes Cookie gesendet wurde.
<literal>SID</literal> hat entweder die Form
<literal>session_name=session_id</literal> oder ist eine leere
Zeichenkette.
@@ -145,27 +149,29 @@
<example>
<title>Zählen der Seitenaufrufe eines einzelnen Benutzers</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
session_register ("count");
$count++;
-?>
+?>
-Hallo Besucher, Sie haben diese Seite <?php echo $count; ?> Mal
-aufgerufen.<p>
+Hallo Besucher, Sie haben diese Seite <?php echo $count; ?> Mal
+aufgerufen.<p>
-<?php
+<?php
# für den Fall, dass der Benutzer Cookies deaktiviert hat,
-# ist das <?=SID?> nötig, um die Session-ID zu erhalten
-?>
+# ist das <?=SID?> nötig, um die Session-ID zu erhalten
+?>
-Hier gehts <A HREF="nextpage.php?<?=SID?>">weiter</A>
+Hier gehts <A HREF="nextpage.php?<?=SID?>">weiter</A>
+]]>
</programlisting>
</example>
</para>
<para>
Das <literal><?=SID?></literal> ist nicht nötig, wenn PHP mit
- <link linkend="install.configure.enable-trans-sid">
- <literal>--enable-trans-sid</literal></link> kompiliert wurde.
+ <link
+linkend="install.configure.enable-trans-sid"><literal>--enable-trans-sid</literal></link>
+ kompiliert wurde.
</para>
<note>
<para>
@@ -312,8 +318,8 @@
<simpara>
<literal>session.cache_limiter</literal> spezifiziert die
Methode der Cacheverwaltung, die bei Session-Seiten benutzt
- wird (nocache/private/public). Grundeinstellung
- <literal>nocache</literal>.
+ wird (nocache/private/private_no_expire/public).
+ Grundeinstellung <literal>nocache</literal>.
</simpara>
</listitem>
<listitem>
@@ -326,18 +332,21 @@
</listitem>
<listitem>
<simpara>
- <literal>session.use_trans_sid</literal> whether transient sid
- support is enabled or not if enabled by compiling with
- <link linkend="install.configure.enable-trans-sid">
- <literal>--enable-trans-sid</literal></link>.
- Defaults to <literal>1</literal> (enabled).
+ <literal>session.use_trans_sid</literal> bestimmt, wenn
+ mit
+ <link
+linkend="install.configure.enable-trans-sid"><literal>--enable-trans-sid</literal></link>
+ kompiliert wurde, ob transparente SID-Unterstützung aktiviert
+ ist oder nicht. Grundeinstellung <literal>1</literal>
+ (aktiviert).
</simpara>
</listitem>
<listitem>
<simpara>
- <literal>url_rewriter.tags</literal> spefifies which html tags are
- rewritten to include session id if transient sid support is enabled.
- Defaults to
<literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
+ <literal>url_rewriter.tags</literal> bestimmt, wenn
+ Unterstützung für transparente SID aktiviert ist, welche
+ HTML-Tags so umgeschrieben werden, dass sie die Session-ID
+ beinhalten. Grundeinstellung
+ <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal>
</simpara>
</listitem>
</itemizedlist>
@@ -356,20 +365,32 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>session_start</function></funcdef>
- <void/>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>bool</type><methodname>session_start</methodname>
+ <void/>
+ </methodsynopsis>
+
<simpara>
<function>session_start</function> erzeugt eine Session (oder
nimmt die aktuelle, basierend auf der Session-ID, die über eine
GET-Variable oder ein Cookie übermittelt wurde, wieder auf).
</simpara>
<simpara>
+ Wenn Sie eine benannte Session verwenden wollen, müssen Sie
+ <function>session_name</function> aufrufen, bevor Sie
+ <function>session_start</function> aufrufen.
+ </simpara>
+ <simpara>
Diese Funktion gibt immer &true; zurück.
</simpara>
+ <note>
+ <para>
+ Bei Verwendung Cookie-basierter Sessions müssen Sie
+ <function>session_start</function> aufrufen, bevor irgend
+ etwas an den Browser geschickt wird.
+ </para>
+ </note>
</refsect1>
</refentry>
@@ -382,20 +403,41 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>session_destroy</function></funcdef>
- <void/>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>bool</type><methodname>session_destroy</methodname>
+ <void/>
+ </methodsynopsis>
+
<simpara>
- <function>session_destroy</function> löscht alle in Verbindung mit der
- aktuellen Session stehenden Daten.
+ <function>session_destroy</function> löscht alle in Verbindung
+ mit der aktuellen Session stehenden Daten. Mit der Session
+ zusammenhängende Globale Variablen und das Session-Cookie werden
+ nicht gelöscht.
</simpara>
<simpara>
Diese Funktion gibt nach erfolgtem Löschen der Daten &true; zurück
und &false;, wenn dabei ein Fehler auftritt.
</simpara>
+ <para>
+ <example>
+ <title>Löschen einer Session</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+# Initialisierung der Session.
+# Wenn Sie session_name("something") verwenden, vergessen Sie es jetzt
+# nicht!
+session_start();
+# Löschen aller Session-Variablen.
+session_unset();
+# Zum Schluß, löschen der Session.
+session_destroy();
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
</refsect1>
</refentry>
@@ -408,17 +450,17 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>session_name</function></funcdef>
- <paramdef>string
- <parameter><optional>name</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>string</type><methodname>session_name</methodname>
+ <methodparam choice="opt">
+ <type>string</type><parameter>Name</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_name</function> gibt den Namen der aktuellen
- Session zurück. Wenn <parameter>name</parameter> angegeben wird,
+ Session zurück. Wenn <parameter>Name</parameter> angegeben wird,
wird der Name der aktuellen Session durch dessen Wert ersetzt.
</para>
<para>
@@ -435,14 +477,13 @@
<example>
<title><function>session_name</function> Beispiele</title>
<programlisting role="php">
-<?php
-
+<![CDATA[
+<?php
# den Session-Namen auf WebsiteID setzen
-
$previous_name = session_name ("WebsiteID");
-
-echo "Der vorhergehende Session-Name war $previous_name<p>";
-?>
+echo "Der vorhergehende Session-Name war $previous_name<p>";
+?>
+]]>
</programlisting>
</example>
</refsect1>
@@ -457,14 +498,14 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>session_module_name</function></funcdef>
- <paramdef>string
- <parameter><optional>module</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <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> gibt den Namen des
aktuellen Session-Moduls zurück. Wenn
@@ -483,18 +524,18 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>session_save_path</function></funcdef>
- <paramdef>string
- <parameter><optional>path</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>string</type><methodname>session_save_path</methodname>
+ <methodparam choice="opt">
+ <type>string</type><parameter>Pfad</parameter>
+ </paramdef>
+ </methodsynopsis>
+
<para>
<function>session_save_path</function> gibt den Pfad des
aktuellen Verzeichnisses zurück, das zum Speichern der
- Session-Daten verwendet wird. Wenn <parameter>path</parameter>
+ Session-Daten verwendet wird. Wenn <parameter>Pfad</parameter>
angegeben wird, wird der Pfad, unter dem Daten gespeichert
werden, entsprechend geändert.
<note>
@@ -518,17 +559,17 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>session_id</function></funcdef>
- <paramdef>string
- <parameter><optional>id</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>string</type><methodname>session_id</methodname>
+ <methodparam choice="opt">
+ <type>string</type><parameter>ID</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_id</function> gibt die Session-ID der aktuellen
- Session zurück. Wenn <parameter>id</parameter> angegeben wird,
+ Session zurück. Wenn <parameter>ID</parameter> angegeben wird,
wird die die aktuelle Session-ID ersetzt.
</para>
<para>
@@ -548,14 +589,17 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>session_register</function></funcdef>
- <paramdef>mixed <parameter>name</parameter></paramdef>
- <paramdef>mixed
- <parameter><optional>...</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>bool</type><methodname>session_register</methodname>
+ <methodparam>
+ <type>mixed</type><parameter>Name</parameter>
+ </methodparam>
+ <methodparam>
+ <type>mixed</type><parameter>...</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_register</function> variable Anzahl von
Argumenten die jeweils entweder eine Zeichenkette sein können,
@@ -570,20 +614,16 @@
</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>
- </note>
- <note>
- <para>
- This function was added in PHP 4.0.
+ Gegenwärtig ist es nicht möglich, Ressourcen-Variablen in einer
+ Session zu registrieren. Zum Beispiel können Sie nicht erwarten,
+ dass die als Session-Variable gespeicherte Verbindungs-Kennung
+ der zu einer Datenbank aufgebauten Verbindung bei der nächsten
+ Wiederherstellung der Session noch gültig ist. PHP-Funktionen,
+ die eine Ressource zurückgeben, können daran erkannt werden,
+ dass sie einen Rückgabewert <literal>resource</literal> in ihrer
+ Funktionsdefinition haben. Eine Liste der Funktionen, die
+ Ressourcen zurückgeben befindet sich im Anhang
+ <link linkend="resource">Liste von PHP Ressourcen</link>.
</para>
</note>
</refsect1>
@@ -598,15 +638,17 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>session_unregister</function></funcdef>
- <paramdef>string <parameter>name</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>bool</type><methodname>session_unregister</methodname>
+ <methodparam>
+ <type>string</type><parameter>Name</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_unregister</function> hebt die Registrierung
- der globalen Variablen namens <parameter>name</parameter> in der
+ der globalen Variablen namens <parameter>Name</parameter> in der
aktuellen Session auf.
</para>
<para>
@@ -625,13 +667,12 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>session_unset</function>
- </funcdef>
- <void/>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>void</type><methodname>session_unset</methodname>
+ <void/>
+ </methodsynopsis>
+
<para>
Die Funktion <function>session_unset</function> befreit alle
Session-Variablen, die gegenwärtig registriert sind.
@@ -648,18 +689,18 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool
- <function>session_is_registered</function>
- </funcdef>
- <paramdef>string <parameter>name</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>bool</type><methodname>session_is_registered</methodname>
+ <methodparam>
+ <type>string</type><parameter>Name</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_is_registered</function> gibt &true; zurück, wenn
in der aktuellen Session eine Variable mit dem Namen
- <parameter>name</parameter> registriert ist.
+ <parameter>Name</parameter> registriert ist.
</para>
</refsect1>
</refentry>
@@ -673,14 +714,12 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>
- array <function>session_get_cookie_params</function>
- </funcdef>
- <void/>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>array</type><methodname>session_get_cookie_params</methodname>
+ <void/>
+ </methodsynopsis>
+
<para>
Die Funktion <function>session_get_cookie_params</function> gibt
ein Array mit der Information des aktuellen Session-Cookies
@@ -715,22 +754,20 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void
- <function>session_set_cookie_params</function>
- </funcdef>
- <paramdef>
- int <parameter>lifetime</parameter>
- </paramdef>
- <paramdef>
- string <parameter><optional>path</optional></parameter>
- </paramdef>
- <paramdef>
- string <parameter><optional>domain</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <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>Pfad</parameter>
+ </methodparam>
+ <methodparam choice="opt">
+ <type>string</type><parameter>Domain</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
Setzen der Cookie-Parameter, die in der php.ini definiert
sind. Diese Funktion wirkt sich nur für die Dauer des Scripts
@@ -748,14 +785,16 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>session_decode</function></funcdef>
- <paramdef>string <parameter>data</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>bool</type><methodname>session_decode</methodname>
+ <methodparam>
+ <type>string</type><parameter>data</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
- <function>session_decode</function> decodiert die Daten der
+ <function>session_decode</function> dekodiert die Daten der
Session in <parameter>data</parameter> und setzt die Variablen,
die in der Session gespeichert sind.
</para>
@@ -766,20 +805,20 @@
<refnamediv>
<refname>session_encode</refname>
<refpurpose>
- Codiert die Daten der aktuellen Session als Zeichenkette
+ Kodiert die Daten der aktuellen Session als Zeichenkette
</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>session_encode</function></funcdef>
- <void/>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>>string</type><methodname>session_encode</methodname>
+ <void/>
+ </methodsynopsis>
+
<para>
<function>session_encode</function> gibt eine Zeichenkette mit
- dem codierten Inhalt der aktuellen Session zurück.
+ dem kodierten Inhalt der aktuellen Session zurück.
</para>
</refsect1>
</refentry>
@@ -793,20 +832,29 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>
- void <function>session_set_save_handler</function>
- </funcdef>
- <paramdef>string
- <parameter>öffnen</parameter></paramdef><paramdef>string
- <parameter>schließen</parameter></paramdef><paramdef>string
- <parameter>lesen</parameter></paramdef><paramdef>string
- <parameter>schreiben</parameter></paramdef><paramdef>string
- <parameter>löschen</parameter></paramdef><paramdef>string
- <parameter>gc</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>void</type><methodname>session_set_save_handler</methodname>
+ <methodparam>
+ <type>string</type><parameter>öffnen</parameter>
+ </methodparam>
+ <methodparam>
+ <type>string</type><parameter>schließen</parameter>
+ </methodparam>
+ <methodparam>
+ <type>string</type><parameter>lesen</parameter>
+ </methodparam>
+ <methodparam>
+ <type>string</type><parameter>schreiben</parameter>
+ </methodparam>
+ <methodparam>
+ <type>string</type><parameter>löschen</parameter>
+ </methodparam>
+ <methodparam>
+ <type>string</type><parameter>gc</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_set_save_handler</function> setzt die
benutzerdefinierten Session-Speicherfunktionen, die zur
@@ -847,11 +895,11 @@
<function>session_set_save_handler</function> Beispiel
</title>
<programlisting role="php">
-<?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);
@@ -906,8 +954,8 @@
session_start();
// verfahren Sie mit Sessions wie gewohnt
-
-?>
+?>
+]]>
</programlisting>
</example>
</para>
@@ -923,16 +971,14 @@
</refnamediv>
<refsect1>
<title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string
- <function>session_cache_limiter</function>
- </funcdef>
- <paramdef>string
- <parameter><optional>Cacheverwaltung</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
+
+ <methodsynopsis>
+ <type>string</type><methodname>session_cache_limiter</methodname>
+ <methodparam choice="opt">
+ <type>string</type><parameter>Cacheverwaltung</parameter>
+ </methodparam>
+ </methodsynopsis>
+
<para>
<function>session_cache_limiter</function> gibt die Bezeichnung
der aktuellen Cacheverwaltung zurück. Wenn
@@ -951,6 +997,19 @@
etwas restriktiver ist, als <literal>public</literal>.
</para>
<para>
+ Im <literal>private</literal>-Modus könnte ein zum Client
+ gesendeter Expire-Header manche Browser, inklusive Mozilla,
+ verwirren. Sie können dieses Problem mit dem
+ <literal>private_no_expire</literal>-Modus vermeiden. In diesem
+ Modus wird nie ein Expire-Header zum Client gesendet.
+ </para>
+ <note>
+ <para>
+ <literal>private_no_expire</literal> wurde in PHP 4.2.0dev
+ hinzugefügt.
+ </para>
+ </note>
+ <para>
Zu Beginn einer Anfrage wird die Cacheverwaltung auf den
voreingestellten Wert zurückesetzt, der in
<literal>session.cache_limiter</literal> gespeichert ist. Daher
@@ -961,20 +1020,44 @@
<example>
<title><function>session_cache_limiter</function> Beispiel</title>
<programlisting role="php">
-<?php
-
+<![CDATA[
+<?php
# setzen der Cacheverwaltung auf 'private'
-
session_cache_limiter('private');
$cacheverwaltung = session_cache_limiter();
-
-echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<p>";
-?>
+echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<p>";
+?>
+]]>
</programlisting>
</example>
</refsect1>
</refentry>
+ <refentry id='function.session-cache-expire'>
+ <refnamediv>
+ <refname>session_cache_expire</refname>
+ <refpurpose>
+ Liefert den aktuellen cache expire. Wenn new_cache_expire gegeben
+ ist, wird der aktuelle cache_expire durch new_cache_expire
+ ersetzt
+ </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>
+ &warn.undocumented.func;
+ </para>
+ </refsect1>
+ </refentry>
+
<refentry id="function.session-write-close">
<refnamediv>
<refname>session_write_close</refname>
@@ -984,31 +1067,34 @@
</refnamediv>
<refsect1>
<title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>session_write_close</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_write_close</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 load all the
- frames by ending the session as soon as all changes to session
- variables are done.
+
+ <methodsynopsis>
+ <type>void</type><methodname>session_write_close</methodname>
+ <void/>
+ </methodsynopsis>
+
+ <para>
+ Beendet die aktuelle Session und speichert die Session-Daten.
+ </para>
+ <para>
+ Session-Daten werden normalerweise nach Beenden eines Scripts
+ gespeichert, ohne dass <function>session_write_close</function>
+ aufgerufen werden muss, aber da Session-Daten gesperrt werden, um
+ gleichzeitiges Schreiben zu verhindern, kann jeweils immer nur
+ ein Script auf eine Session einwirken. Bei der Verwendung von
+ Framesets zusammen mit Sessions werden Sie merken, dass wegen
+ dieser Sperrung ein Frame nach dem anderen geladen wird. Sie
+ können die Zeit zum Laden aller Frames reduzieren, indem Sie die
+ Session beenden, sobald alle Änderungen an den Session-Variablen
+ durchgeführt sind.
</para>
+
<!-- commented out until final decision on implementation
<para>
See also: <function>session_readonly</function>.
</para>
-->
+
</refsect1>
</refentry>
@@ -1016,23 +1102,26 @@
<refentry id="function.session-readonly">
<refnamediv>
<refname>session_readonly</refname>
- <refpurpose>Begin session - reinitializes freezed variables, but no writeback on
request end</refpurpose>
+ <refpurpose>Begin session - reinitializes freezed variables, but
+ no writeback on request end</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
- <funcsynopsis>
+ <methodsynopsis>
<funcprototype>
<funcdef>void <function>session_readonly</function></funcdef>
<void/>
</funcprototype>
- </funcsynopsis>
+ </methodsynopsis>
<para>
Read in session data without locking the session data. Changing
- session data is not possible, but frameset performance will be improved.
+ session data is not possible, but frameset performance will be
+ improved.
</para>
</refsect1>
</refentry>
-->
+
</reference>
<!-- Keep this comment at the end of the file
@@ -1051,4 +1140,7 @@
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
-->
