cvs: phpdoc-de /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-commit.xml session-decode.xml
session-destroy.xml session-encode.xml session-get-cookie-params.xml session-id.xml session-is-registered.xml session-module-name.xml session-name.xml
session-regenerate-id.xml session-register.xml session-save-path.xml session-set-cookie-params.xml session-set-save-handler.xml session-start.xml
session-unregister.xml session-unset.xml session-write-close.xml
| From: | Martin Samesch | Date: | Tue, 31 Jul 2007 21:37:45 +0000 |
| Subject: | cvs: phpdoc-de /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-commit.xml session-decode.xml session-destroy.xml session-encode.xml session-get-cookie-params.xml session-id.xml session-is-registered.xml session-module-name.xml session-name.xml session-regenerate-id.xml session-register.xml session-save-path.xml session-set-cookie-params.xml session-set-save-handler.xml session-start.xml session-unregister.xml session-unset.xml session-write-close.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2205@lists.php.net to get a copy of this message | ||
samesch Tue Jul 31 21:37:45 2007 UTC
Modified files:
/phpdoc-de/reference/session/functions session-cache-expire.xml
session-cache-limiter.xml
session-commit.xml
session-decode.xml
session-destroy.xml
session-encode.xml
session-get-cookie-params.xml
session-id.xml
session-is-registered.xml
session-module-name.xml
session-name.xml
session-regenerate-id.xml
session-register.xml
session-save-path.xml
session-set-cookie-params.xml
session-set-save-handler.xml
session-start.xml
session-unregister.xml
session-unset.xml
session-write-close.xml
Log:
syncing with EN
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-cache-expire.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-cache-expire.xml diff -u phpdoc-de/reference/session/functions/session-cache-expire.xml:1.10 phpdoc-de/reference/session/functions/session-cache-expire.xml:1.11 --- phpdoc-de/reference/session/functions/session-cache-expire.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-cache-expire.xml Tue Jul 31 21:37:45 2007 @@ -1,38 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.32 --> -<!-- last change to 'session-cache-expire' in en/ tree in rev 1.38 --> -<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.38 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> <refentry xml:id='function.session-cache-expire' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_cache_expire</refname> <refpurpose>Liefert die aktuelle Cache-Verfallszeit</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>int</type><methodname>session_cache_expire</methodname> <methodparam choice="opt"><type>int</type><parameter>neue_cache_verfallszeit</parameter></methodparam> </methodsynopsis> <para> <function>session_cache_expire</function> gibt die aktuelle Einstellung von - <literal>session.cache_expire</literal> zurück. Der zurückgegebene Wert - wird in Minuten angegeben und ist standardmäßig auf 180 gesetzt. Wenn - <parameter>neue_cache_verfallszeit</parameter> angegeben wurde, wird die - aktuelle cache_expire durch <parameter>neue_cache_verfallszeit</parameter> - ersetzt. + <literal>session.cache_expire</literal> zurück. </para> <para> Die Cache-Verfallszeit wird zu Beginn einer Anfrage auf den standardmäßigen Wert von 180, der in <literal>session.cache_limiter</literal> gespeichert - ist, zurück gesetzt. Folglich müssen Sie + ist, zurückgesetzt. Folglich müssen Sie <function>session_cache_expire</function> bei jeder Anfrage (und vor dem Aufruf von <function>session_start</function>) aufrufen. </para> - <example> - <title><function>session_cache_expire</function> Beispiel</title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>neue_cache_verfallszeit</parameter></term> + <listitem> + <para> + Wenn <parameter>neue_cache_verfallszeit</parameter> angegeben wurde, + wird die aktuelle cache_expire durch + <parameter>neue_cache_verfallszeit</parameter> ersetzt. + </para> + <para> + <note> + <simpara> + Das Setzen von <parameter>neue_cache_verfallszeit</parameter> bewirkt nur + dann etwas, wenn <literal>session.cache_limiter</literal> auf einen + <emphasis>anderen</emphasis> Wert als <literal>nocache</literal> + gesetzt ist. + </simpara> + </note> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die aktuelle Einstellung von <literal>session.cache_expire</literal> + zurück. Der zurückgegebene Wert wird in Minuten angegeben und ist + standardmäßig auf 180 gesetzt. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>session_cache_expire</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php @@ -53,23 +89,26 @@ echo "Die Session wird für $cache_expire Minuten im Cache gespeichert"; ?> ]]> - </programlisting> - </example> - <note> - <simpara> - Das Setzen von <parameter>new_cache_expire</parameter> bewirkt nur dann - etwas, wenn <literal>session.cache_limiter</literal> auf einen - <emphasis>anderen</emphasis> Wert als <literal>nocache</literal> gesetzt - ist. - </simpara> - </note> - <para> - Siehe auch <link - linkend="ini.session.cache-expire">session.cache_expire</link> und <link - linkend="ini.session.cache-limiter">session.cache_limiter</link> - Konfigurations-Anweisungen und <function>session_cache_limiter</function>. + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member> + <link linkend="ini.session.cache-expire">session.cache_expire</link> + </member> + <member> + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> + </member> + <member><function>session_cache_limiter</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-cache-limiter.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/session/functions/session-cache-limiter.xml diff -u phpdoc-de/reference/session/functions/session-cache-limiter.xml:1.9 phpdoc-de/reference/session/functions/session-cache-limiter.xml:1.10 --- phpdoc-de/reference/session/functions/session-cache-limiter.xml:1.9 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-cache-limiter.xml Tue Jul 31 21:37:45 2007 @@ -1,25 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.22 --> -<!-- last change to 'session-cache-limiter' in en/ tree in rev 1.62 --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.62 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-cache-limiter" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_cache_limiter</refname> <refpurpose>Liefert und/oder setzt die aktuelle Cacheverwaltung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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 - <parameter>Cacheverwaltung</parameter> angegeben wurde, wird diese dem - neuen Wert entsprechend geändert. + aktuellen Cacheverwaltung zurück. </para> <para> Die Cacheverwaltung definiert, welche Cache-Kontroll-HTTP-Header, zum @@ -39,11 +35,6 @@ <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.0 hinzugefügt. - </para> - </note> <para> Zu Beginn einer Anfrage wird die Cacheverwaltung auf den voreingestellten Wert zurückesetzt, der in <link @@ -52,9 +43,62 @@ <function>session_cache_limiter</function> bei jeder Anfrage aufrufen (und zwar bevor <function>session_start</function> aufgerufen wird). </para> - <example> - <title><function>session_cache_limiter</function> Beispiel</title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Cacheverwaltung</parameter></term> + <listitem> + <para> + Wenn <parameter>Cacheverwaltung</parameter> angegeben wurde, wird diese + dem neuen Wert entsprechend geändert. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Bezeichnung der aktuellen Cacheverwaltung zurück. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.0</entry> + <entry> + Die Cacheverwaltung <literal>private_no_expire</literal> hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>session_cache_limiter</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php /* setzen der Cacheverwaltung auf 'private' */ @@ -63,14 +107,22 @@ echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<br />"; ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.cache-limiter">session.cache_limiter</link> - Konfigurationsanweisung. + <simplelist> + <member> + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-commit.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/session/functions/session-commit.xml diff -u phpdoc-de/reference/session/functions/session-commit.xml:1.3 phpdoc-de/reference/session/functions/session-commit.xml:1.4 --- phpdoc-de/reference/session/functions/session-commit.xml:1.3 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-commit.xml Tue Jul 31 21:37:45 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-commit" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_commit</refname> @@ -16,6 +16,7 @@ <function>session_write_close</function>. </simpara> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-decode.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-decode.xml diff -u phpdoc-de/reference/session/functions/session-decode.xml:1.6 phpdoc-de/reference/session/functions/session-decode.xml:1.7 --- phpdoc-de/reference/session/functions/session-decode.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-decode.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-decode' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-decode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_decode</refname> <refpurpose>Dekodiert die Daten einer Session aus einer Zeichenkette</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_decode</methodname> <methodparam><type>string</type><parameter>Daten</parameter></methodparam> @@ -20,10 +18,40 @@ <parameter>Daten</parameter> und setzt die Variablen, die in der Session gespeichert sind. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Daten</parameter></term> + <listitem> + <para> + Die kodierten Daten, die gespeichert werden sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>session_encode</function>. + <simplelist> + <member><function>session_encode</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-destroy.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/session/functions/session-destroy.xml diff -u phpdoc-de/reference/session/functions/session-destroy.xml:1.7 phpdoc-de/reference/session/functions/session-destroy.xml:1.8 --- phpdoc-de/reference/session/functions/session-destroy.xml:1.7 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-destroy.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-destroy' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-destroy" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_destroy</refname> <refpurpose>Löscht alle in einer Session registrierten Daten</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_destroy</methodname> <void/> @@ -27,9 +25,17 @@ Session-Cookie gelöscht werden. Dafür kann <function>setcookie</function> verwendet werden. </para> - <simpara> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> &return.success; - </simpara> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>Löschen einer Session mit <varname>$_SESSION</varname></title> @@ -58,16 +64,28 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Verwenden Sie <function>session_unset</function> nur bei veraltetem Code, bei dem nicht <varname>$_SESSION</varname> benutzt wird. </para> </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>unset</function> und <function>setcookie</function>. + <simplelist> + <member><function>unset</function></member> + <member><function>setcookie</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-encode.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-encode.xml diff -u phpdoc-de/reference/session/functions/session-encode.xml:1.6 phpdoc-de/reference/session/functions/session-encode.xml:1.7 --- phpdoc-de/reference/session/functions/session-encode.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-encode.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.18 --> -<!-- last change to 'session-encode' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-encode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_encode</refname> <refpurpose>Kodiert die Daten der aktuellen Session als Zeichenkette</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>session_encode</methodname> <void/> @@ -19,10 +17,24 @@ <function>session_encode</function> gibt eine Zeichenkette mit dem kodierten Inhalt der aktuellen Session zurück. </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt Inhalt der aktuellen Session kodiert zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>session_decode</function>. + <simplelist> + <member><function>session_decode</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-get-cookie-params.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-get-cookie-params.xml diff -u phpdoc-de/reference/session/functions/session-get-cookie-params.xml:1.8 phpdoc-de/reference/session/functions/session-get-cookie-params.xml:1.9 --- phpdoc-de/reference/session/functions/session-get-cookie-params.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-get-cookie-params.xml Tue Jul 31 21:37:45 2007 @@ -1,24 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.11 --> -<!-- last change to 'session-get-cookie-params' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.8 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-get-cookie-params" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_get_cookie_params</refname> <refpurpose>Liefert die Session-Cookie Parameter</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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 zurück. Das Array enthält - folgende Elemente: + Liefert die Parameter des Session-Cookie. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein Array mit der Information des aktuellen Session-Cookies zurück. + Das Array enthält folgende Elemente: <itemizedlist> <listitem> <simpara>"lifetime" - Die Lebensdauer des Cookies in Sekunden.</simpara> @@ -34,27 +38,76 @@ <listitem> <simpara> "secure" - Das Cookie soll nur über sichere Verbindungen gesendet - werden. (Dieses Element wurde in PHP 4.0.4 hinzugefügt.) + werden. </simpara> </listitem> <listitem> <simpara> "httponly" - Auf das Cookie kann nur durch das HTTP-Protokoll - zugegriffen werden. (Dieses Element wurde in PHP 5.2.0 hinzugefügt.) + zugegriffen werden. </simpara> </listitem> </itemizedlist> </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.0</entry> + <entry> + Das Element "httponly" wurde im zurückgegebenen Array hinzugefügt? + </entry> + </row> + <row> + <entry>4.0.4</entry> + <entry> + Das Element "secure" wurde im zurückgegebenen Array hinzugefügt? + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die Konfigurationsanweisungen - <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, - <link linkend="ini.session.cookie-path">session.cookie_path</link>, - <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, - <link linkend="ini.session.cookie-secure">session.cookie_secure</link>, - <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> - und <function>session_set_cookie_params</function>. + <simplelist> + <member> + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link> + </member> + <member> + <link linkend="ini.session.cookie-path">session.cookie_path</link> + </member> + <member> + <link linkend="ini.session.cookie-domain">session.cookie_domain</link> + </member> + <member> + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> + </member> + <member> + <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> + </member> + <member> + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link> + </member> + <member><function>session_set_cookie_params</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-id.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/session/functions/session-id.xml diff -u phpdoc-de/reference/session/functions/session-id.xml:1.11 phpdoc-de/reference/session/functions/session-id.xml:1.12 --- phpdoc-de/reference/session/functions/session-id.xml:1.11 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-id.xml Tue Jul 31 21:37:45 2007 @@ -1,14 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-id' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_id</refname> <refpurpose>Liefert und/oder setzt die aktuelle Session-ID</refpurpose> </refnamediv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-is-registered.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-is-registered.xml diff -u phpdoc-de/reference/session/functions/session-is-registered.xml:1.8 phpdoc-de/reference/session/functions/session-is-registered.xml:1.9 --- phpdoc-de/reference/session/functions/session-is-registered.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-is-registered.xml Tue Jul 31 21:37:45 2007 @@ -1,25 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-is-registered' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.8 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-is-registered" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_is_registered</refname> <refpurpose>Überprüft, ob eine globale Variable in einer Session registriert ist</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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 globale Variable mit dem Namen - <parameter>Name</parameter> registriert ist. + Überprüft, ob eine globale Variable in einer Session registriert ist. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Der Variablenname + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Falls in der aktuellen Session eine globale Variable mit dem Namen + <parameter>Name</parameter> registriert ist, gibt + <function>session_is_registered</function> &true; zurück, andernfalls + &false;. </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Benutzen Sie bei Verwendung von <varname>$_SESSION</varname> (oder @@ -38,6 +64,7 @@ </para> </caution> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-module-name.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/session/functions/session-module-name.xml diff -u phpdoc-de/reference/session/functions/session-module-name.xml:1.5 phpdoc-de/reference/session/functions/session-module-name.xml:1.6 --- phpdoc-de/reference/session/functions/session-module-name.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-module-name.xml Tue Jul 31 21:37:45 2007 @@ -1,26 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-module-name' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-module-name" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_module_name</refname> <refpurpose>Liefert und/oder setzt das aktuelle Session-Modul</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>session_module_name</methodname> <methodparam choice="opt"><type>string</type><parameter>Modul</parameter></methodparam> </methodsynopsis> <para> <function>session_module_name</function> gibt den Namen des aktuellen - Session-Moduls zurück. Wenn <parameter>Modul</parameter> angegeben wird, - wird stattdessen dieses Modul verwendet. + Session-Moduls zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Modul</parameter></term> + <listitem> + <para> + Wenn <parameter>Modul</parameter> angegeben wird, wird stattdessen + dieses Modul verwendet. + </para> + </listitem> + </varlistentry> + </variablelist> </para> </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Namen des aktuellen Session-Moduls zurück. + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-name.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-name.xml diff -u phpdoc-de/reference/session/functions/session-name.xml:1.8 phpdoc-de/reference/session/functions/session-name.xml:1.9 --- phpdoc-de/reference/session/functions/session-name.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-name.xml Tue Jul 31 21:37:45 2007 @@ -1,45 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-name' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-name" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_name</refname> <refpurpose>Liefert und/oder setzt den Namen der aktuellen Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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, wird der Name der - aktuellen Session durch dessen Wert ersetzt. + zurück. </para> <para> - Der Sessionname referenziert die Session-ID in Cookies und URLs. Er sollte - nur alphanumerische Zeichen enthalten und sollte kurz und beschreibend sein - (z.B. für Benutzer mit aktivierter Cookie-Warnung). Der Sessionname wird - auf den Ausgangswert zurückgesetzt, der zu Beginn in + Der Sessionname wird auf den Ausgangswert zurückgesetzt, der zu Beginn in <literal>session.name</literal> gespeichert wurde. Deshalb muss <function>session_name</function> bei jeder Anfrage aufgerufen werden (und bevor <function>session_start</function> oder <function>session_register</function> aufgerufen wurden). </para> - <warning> - <para> - Der Sessionname kann nicht nur aus Zahlen bestehen, sondern muss - mindestens einen Buchstaben enthalten. Andernfalls wird jedesmal eine neue - Session-ID erzeugt. - </para> - </warning> - <example> - <title><function>session_name</function> Beispiele</title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Der Sessionname referenziert die Session-ID in Cookies und URLs. Er + sollte nur alphanumerische Zeichen enthalten und sollte kurz und + beschreibend sein (z.B. für Benutzer mit aktivierter Cookie-Warnung). + Wenn <parameter>Name</parameter> angegeben wird, wird der Name der + aktuellen Session durch dessen Wert ersetzt. + </para> + <para> + <warning> + <para> + Der Sessionname kann nicht nur aus Zahlen bestehen, sondern muss + mindestens einen Buchstaben enthalten. Andernfalls wird jedesmal eine + neue Session-ID erzeugt. + </para> + </warning> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Namen der aktuellen Session zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>session_name</function> Beispiele</title> + <programlisting role="php"> <![CDATA[ <?php /* den Sessionnamen auf WebsiteID setzen */ @@ -47,13 +75,23 @@ echo "Der vorhergehende Sessionname war $name_vorher<br />"; ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.name">session.name</link> Konfigurationsanweisung. + <simplelist> + <member> + Die <link linkend="ini.session.name">session.name</link> + Konfigurationsanweisung + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-regenerate-id.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-regenerate-id.xml diff -u phpdoc-de/reference/session/functions/session-regenerate-id.xml:1.6 phpdoc-de/reference/session/functions/session-regenerate-id.xml:1.7 --- phpdoc-de/reference/session/functions/session-regenerate-id.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-regenerate-id.xml Tue Jul 31 21:37:45 2007 @@ -1,11 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-regenerate-id" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_regenerate_id</refname> <refpurpose>Ersetzt die aktuelle Session-ID durch eine neu erzeugte</refpurpose> </refnamediv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> @@ -112,6 +113,7 @@ </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-register.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-register.xml diff -u phpdoc-de/reference/session/functions/session-register.xml:1.10 phpdoc-de/reference/session/functions/session-register.xml:1.11 --- phpdoc-de/reference/session/functions/session-register.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-register.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-register' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-register" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_register</refname> <refpurpose>Registriert eine oder mehrere globale Variablen in der aktuellen Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_register</methodname> <methodparam><type>mixed</type><parameter>Name</parameter></methodparam> @@ -24,6 +22,70 @@ <function>session_register</function> die globale Variable mit diesem Namen in der aktuellen Session. </para> + <para> + Sie können eine Session-Variable auch erzeugen, indem Sie das entsprechende + Element des <varname>$_SESSION</varname>- oder (PHP <= 4.1.0) + <varname>$HTTP_SESSION_VARS</varname>-Arrays setzen. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +// Sie sollten session_register() nicht verwenden +$barney = "A big purple dinosaur."; +session_register("barney"); + +// Ab PHP 4.1.0 ist die Verwendung von $_SESSION vorzuziehen +$_SESSION["zim"] = "An invader from another planet."; + +// Die alte Methode war, $HTTP_SESSION_VARS zu verwenden +$HTTP_SESSION_VARS["spongebob"] = "He's got square pants."; +?> +]]> + </programlisting> + </informalexample> + </para> + <para> + Wenn <function>session_start</function> nicht vor dieser Funktion + aufgerufen wurde, erfolgt ein impliziter Aufruf von + <function>session_start</function> ohne Parameter. + <varname>$_SESSION</varname> ahmt dieses Verhalten nicht nach und benötigt + den Aufruf von <function>session_start</function> bevor es verwendet wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Eine Zeichenkette, die den Namen einer Variablen trägt, oder ein Array, + das aus solchen Variablennamen oder anderen Arrays besteht. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <caution> <para> Wenn Sie wollen, dass ihr Script unabhängig von der Einstellung von <link @@ -36,9 +98,7 @@ linkend="ini.register-globals">register_globals</link> deaktiviert ist. </para> </caution> - ¬e.registerglobals; - <caution> <para> Diese Funktion registriert eine <emphasis>globale</emphasis> Variable. @@ -58,39 +118,6 @@ <function>session_unregister</function> verwenden. </para> </caution> - <para> - Diese Funktion gibt &true; zurück, wenn alle Variablen erfolgreich in der - Session registriert wurden. - </para> - <para> - Wenn <function>session_start</function> nicht vor dieser Funktion - aufgerufen wurde, erfolgt ein impliziter Aufruf von - <function>session_start</function> ohne Parameter. - <varname>$_SESSION</varname> ahmt dieses Verhalten nicht nach und benötigt - den Aufruf von <function>session_start</function> bevor es verwendet wird. - </para> - <para> - Sie können eine Session-Variable auch erzeugen, indem Sie das entsprechende - Element des <varname>$_SESSION</varname>- oder (PHP <= 4.1.0) - <varname>$HTTP_SESSION_VARS</varname>-Arrays setzen. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php -// Sie sollten session_register() nicht verwenden -$barney = "A big purple dinosaur."; -session_register("barney"); - -// Ab PHP 4.1.0 ist die Verwendung von $_SESSION vorzuziehen -$_SESSION["zim"] = "An invader from another planet."; - -// Die alte Methode war, $HTTP_SESSION_VARS zu verwenden -$HTTP_SESSION_VARS["spongebob"] = "He's got square pants."; -?> -]]> - </programlisting> - </informalexample> - </para> <note> <para> Gegenwärtig ist es nicht möglich, Ressourcen-Variablen in einer Session zu @@ -110,12 +137,21 @@ 'ABC'; </para> </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>session_is_registered</function>, - <function>session_unregister</function> und <link - linkend="reserved.variables.session">$_SESSION</link>. + <simplelist> + <member><function>session_is_registered</function></member> + <member><function>session_unregister</function></member> + <member> + <link linkend="reserved.variables.session">$_SESSION</link> + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-save-path.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-save-path.xml diff -u phpdoc-de/reference/session/functions/session-save-path.xml:1.6 phpdoc-de/reference/session/functions/session-save-path.xml:1.7 --- phpdoc-de/reference/session/functions/session-save-path.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-save-path.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-save-path' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-save-path" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_save_path</refname> <refpurpose>Liefert und/oder setzt den aktuellen Speicherpfad der Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>session_save_path</methodname> <methodparam choice="opt"><type>string</type><parameter>Pfad</parameter></methodparam> @@ -18,25 +16,58 @@ <para> <function>session_save_path</function> gibt den Pfad des aktuellen Verzeichnisses zurück, das zum Speichern der Session-Daten verwendet wird. - Wenn <parameter>Pfad</parameter> angegeben wird, wird der Pfad, unter dem - Daten gespeichert werden, entsprechend geändert. Zu diesem Zweck muss - <function>session_save_path</function> vor - <function>session_start</function> aufgerufen werden. - <note> - <para> - Unter manchen Betriebssystemen, wollen Sie vielleicht einen Pfad auf - einem Dateisystem angeben, das sehr viele kleine Dateien effizient - behandelt. Unter Linux, zum Beispiel, bietet reiserfs eventuell eine - bessere Performance als ext2fs. - </para> - </note> </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Pfad</parameter></term> + <listitem> + <para> + Der Pfad der Session-Daten. Wenn <parameter>Pfad</parameter> angegeben + wird, wird der Pfad, unter dem Daten gespeichert werden, entsprechend + geändert. Zu diesem Zweck muss <function>session_save_path</function> + vor <function>session_start</function> aufgerufen werden. + </para> + <para> + <note> + <para> + Unter manchen Betriebssystemen, wollen Sie vielleicht einen Pfad auf + einem Dateisystem angeben, das sehr viele kleine Dateien effizient + behandelt. Unter Linux, zum Beispiel, bietet reiserfs eventuell eine + bessere Performance als ext2fs. + </para> + </note> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Pfad des aktuellen Verzeichnisses zurück, das zum Speichern der + Session-Daten verwendet wird. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.save-path">session.save_path</link> - Konfigurationsanweisung. + <simplelist> + <member> + Die <link linkend="ini.session.save-path">session.save_path</link> + Konfigurationsanweisung + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-set-cookie-params.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/session/functions/session-set-cookie-params.xml diff -u phpdoc-de/reference/session/functions/session-set-cookie-params.xml:1.9 phpdoc-de/reference/session/functions/session-set-cookie-params.xml:1.10 --- phpdoc-de/reference/session/functions/session-set-cookie-params.xml:1.9 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-set-cookie-params.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.11 --> -<!-- last change to 'session-set-cookie-params' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-set-cookie-params" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_set_cookie_params</refname> <refpurpose>Setzt die Session-Cookie Parameter</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>session_set_cookie_params</methodname> <methodparam><type>int</type><parameter>Lebensdauer</parameter></methodparam> @@ -25,22 +23,109 @@ <function>session_set_cookie_params</function> bei jeder Anfrage und noch vor dem Aufruf von <function>session_start</function> aufrufen. </para> - <note> - <para> - Der Parameter <parameter>secure</parameter> wurde in PHP 4.0.4 hinzugefügt - und der Parameter <parameter>httponly</parameter> in PHP 5.2.0. - </para> - </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Lebensdauer</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Pfad</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Domain</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>secure</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>httponly</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.0</entry> + <entry> + Den Parameter <parameter>httponly</parameter> hinzugefügt. + </entry> + </row> + <row> + <entry>4.0.4</entry> + <entry> + Den Parameter <parameter>secure</parameter> hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die Konfigurationsanweisungen - <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, - <link linkend="ini.session.cookie-path">session.cookie_path</link>, - <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, - <link linkend="ini.session.cookie-secure">session.cookie_secure</link>, - <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> - und <function>session_get_cookie_params</function>. + <simplelist> + <member> + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link> + </member> + <member> + <link linkend="ini.session.cookie-domain">session.cookie_domain</link> + </member> + <member> + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> + </member> + <member> + <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> + </member> + <member><function>session_get_cookie_params</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-set-save-handler.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-de/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-de/reference/session/functions/session-set-save-handler.xml:1.17 phpdoc-de/reference/session/functions/session-set-save-handler.xml:1.18 --- phpdoc-de/reference/session/functions/session-set-save-handler.xml:1.17 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-set-save-handler.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-set-save-handler' in en/ tree in rev 1.23 --> -<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.23 --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.20 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-set-save-handler" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_set_save_handler</refname> <refpurpose>Setzt benutzerdefinierte Session-Speicherfunktionen</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_set_save_handler</methodname> <methodparam><type>callback</type><parameter>öffnen</parameter></methodparam> @@ -26,44 +24,93 @@ zur Session gehörigen Daten verwendet werden. Dies ist äußerst nützlich, wenn eine andere als die mit PHP-Sessions zur Verfügung stehende Art der Speicherung, z.B. die Speicherung der Session-Daten in einer lokalen - Datenbank, bevorzugt wird. &return.success; - </para> - <note> - <para> - Die "schreiben"-Routine wird nicht ausgeführt, bevor die Ausgabe - abgeschlossen ist. Deshalb werden auch niemals Fehlermeldungen der - "schreiben"-Routine im Browser erscheinen. Wenn die Ausgabe von - Fehlermeldungen nötig ist, sollte diese stattdessen in eine Datei - geschrieben werden. - </para> - </note> + Datenbank, bevorzugt wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Das folgende Beispiel liefert eine dateibasierte Session-Speicherung, die - der Standard-Speicherroutine <parameter>files</parameter> der PHP-Sessions - ähnlich ist. Dieses Beispiel kann problemlos erweitert werden, dass es - Datenbank-Speicherung mittels ihrer bevorzugten PHP-gestützten Datenbank - beinhaltet. + <variablelist> + <varlistentry> + <term><parameter>öffnen</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>schließen</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>lesen</parameter></term> + <listitem> + <para> + Damit die Speicherroutine funktioniert wie erwartet, muss die + read-Funktion immer eine Zeichenkette zurückgeben. Wenn es keine Daten + zu lesen gibt, geben Sie eine leere Zeichenkette zurück. Rückgabewerte + anderer Routinen werden in boolesche Ausdrücke umgewandelt. &true; für + einen Erfolg, &false; für einen Fehler. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>schreiben</parameter></term> + <listitem> + <para> + <note> + <para> + Die "schreiben"-Routine wird nicht ausgeführt, bevor die Ausgabe + abgeschlossen ist. Deshalb werden auch niemals Fehlermeldungen der + "schreiben"-Routine im Browser erscheinen. Wenn die Ausgabe von + Fehlermeldungen nötig ist, sollte diese stattdessen in eine Datei + geschrieben werden. + </para> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>löschen</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>gc</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Damit die Speicherroutine funktioniert wie erwartet, muss die read-Function - immer einen String-Wert zurückgeben. Wenn es keine Daten zu lesen gibt, - geben Sie eine leere Zeichenkette zurück. Rückgabewerte anderer Routinen - werden in boolesche Ausdrücke umgewandelt. &true; für einen Erfolg, &false; - für einen Fehler. + &return.success; </para> - <warning> - <para> - Ab PHP 5.0.5 werden die Routinen für das Speichern und Beenden nach dem - Zerstören von Objekten aufgerufen. Daher können Destruktoren Sessions - verwenden aber Session-Routinen keine Objekte. In vorherigen Versionen - wurden sie in der umgekehrten Reihenfolge aufgerufen. Es ist möglich, - <function>session_write_close</function> über den Destruktor aufzurufen, - um dieses Henne-Ei Problem zu lösen. - </para> - </warning> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>session_set_save_handler</function> Beispiel</title> + <para> + Das folgende Beispiel liefert eine dateibasierte Session-Speicherung, die + der Standard-Speicherroutine <parameter>files</parameter> der + PHP-Sessions ähnlich ist. Dieses Beispiel kann problemlos erweitert + werden, dass es Datenbank-Speicherung mittels ihrer bevorzugten + PHP-gestützten Datenbank beinhaltet. + </para> <programlisting role="php"> <![CDATA[ <?php @@ -100,7 +147,6 @@ } else { return(false); } - } function destroy($id) @@ -133,12 +179,37 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Ab PHP 5.0.5 werden die Routinen <parameter>schreiben</parameter> und + <parameter>schließen</parameter> nach dem Zerstören von Objekten + aufgerufen und können deshalb keine Objekte verwenden oder Exceptions + (Fehler-, Ausnahmesituationen) auslösen. Objekt-Destruktoren können + aber Sessions verwenden. + </para> + <para> + Es ist möglich, <function>session_write_close</function> über den + Destruktor aufzurufen, um dieses Henne-Ei Problem zu lösen. + </para> + </warning> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.save-handler">session.save_handler</link> - Konfigurationsanweisung. + <simplelist> + <member> + Die <link linkend="ini.session.save-handler">session.save_handler</link> + Konfigurationsanweisung + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-start.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-start.xml diff -u phpdoc-de/reference/session/functions/session-start.xml:1.10 phpdoc-de/reference/session/functions/session-start.xml:1.11 --- phpdoc-de/reference/session/functions/session-start.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-start.xml Tue Jul 31 21:37:45 2007 @@ -1,35 +1,76 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-start' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-start" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_start</refname> <refpurpose>Initialisiert eine Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_start</methodname> <void/> </methodsynopsis> - <simpara> + <para> <function>session_start</function> erzeugt eine Session oder nimmt die aktuelle wieder auf, die auf der Session-ID basiert, die mit einer Anfrage, z.B. durch GET, POST oder ein Cookie, übermittelt wurde. - </simpara> - <simpara> + </para> + <para> + Wenn Sie eine benannte Session verwenden wollen, müssen Sie + <function>session_name</function> aufrufen, bevor Sie + <function>session_start</function> aufrufen. + </para> + <para> + Wenn <literal>trans-sid</literal> aktiviert ist, registriert + <function>session_start</function> die interne Ausgaberoutine für das + Umschreiben von URLs. Verwendet ein Benutzer + <literal>ob_gzhandler</literal> oder ähnliches mit + <function>ob_start</function>, ist die Reihenfolge der Augaberoutine + wichtig für eine korrekte Ausgabe. Zum Beispiel muss der Benutzer + <literal>ob_gzhandler</literal> vor Beginn der Session registrieren. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> 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> + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.3</entry> + <entry> + Ab sofort resultiert der Aufruf von + <function>session_start</function>, nachdem die Session schon + gestartet wurde, in einem Fehler der Stufe + <constant>E_NOTICE</constant>. Der zweite Session-Start wird in diesem + Fall einfach ignoriert. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title> @@ -89,42 +130,42 @@ </programlisting> </example> </para> - <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> - Wenn <literal>trans-sid</literal> aktiviert ist, registriert - <function>session_start</function> die interne Ausgaberoutine für das - Umschreiben von URLs. Verwendet ein Benutzer - <literal>ob_gzhandler</literal> oder ähnliches mit - <function>ob_start</function>, ist die Reihenfolge der Augaberoutine - wichtig für eine korrekte Ausgabe. Zum Beispiel muss der Benutzer - <literal>ob_gzhandler</literal> vor Beginn der Session registrieren. - </simpara> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> - <simpara> - Die Verwendung von <link - linkend="ini.zlib.output-compression">zlib.output_compression</link> ist - <function>ob_gzhandler</function> vorzuziehen. - </simpara> + <para> + Bei Verwendung Cookie-basierter Sessions müssen Sie + <function>session_start</function> aufrufen, bevor irgend etwas an den + Browser geschickt wird. + </para> </note> <note> <para> - Ab PHP 4.3.3 resultiert der Aufruf von <function>session_start</function>, - nachdem die Session schon gestartet wurde, in einem Fehler der Stufe - <constant>E_NOTICE</constant>. Der zweite Session-Start wird in diesem - Fall einfach ignoriert. + Die Verwendung von <link + linkend="ini.zlib.output-compression">zlib.output_compression</link> ist + <function>ob_gzhandler</function> vorzuziehen. </para> </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: - <link linkend="reserved.variables.session">$_SESSION</link>, - <link linkend="ini.session.auto-start">session.auto_start</link> - und <function>session_id</function>. + <simplelist> + <member> + <link linkend="reserved.variables.session">$_SESSION</link> + </member> + <member> + Die <link linkend="ini.session.auto-start">session.auto_start</link> + Konfigurationsanweisung + </member> + <member><function>session_id</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-unregister.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-unregister.xml diff -u phpdoc-de/reference/session/functions/session-unregister.xml:1.8 phpdoc-de/reference/session/functions/session-unregister.xml:1.9 --- phpdoc-de/reference/session/functions/session-unregister.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-unregister.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-unregister' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-unregister" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_unregister</refname> <refpurpose>Hebt die Registrierung einer globalen Variablen in der aktuellen Session auf</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_unregister</methodname> <methodparam><type>string</type><parameter>Name</parameter></methodparam> @@ -19,10 +17,33 @@ <function>session_unregister</function> hebt die Registrierung der globalen Variablen namens <parameter>Name</parameter> in der aktuellen Session auf. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Der Variablenname + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Diese Funktion gibt &true; zurück, wenn die Aufhebung der Registrierung der - Variablen in der Session erfolgt ist. + &return.success; </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Benutzen Sie bei Verwendung von <varname>$_SESSION</varname> (oder @@ -51,6 +72,7 @@ </para> </caution> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-unset.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-unset.xml diff -u phpdoc-de/reference/session/functions/session-unset.xml:1.10 phpdoc-de/reference/session/functions/session-unset.xml:1.11 --- phpdoc-de/reference/session/functions/session-unset.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-unset.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.11 --> -<!-- last change to 'session-unset' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.8 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-unset" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_unset</refname> <refpurpose>Löscht alle Session-Variablen</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>session_unset</methodname> <void/> @@ -19,6 +17,17 @@ Die Funktion <function>session_unset</function> löscht alle Session-Variablen, die gegenwärtig registriert sind. </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Benutzen Sie bei Verwendung von <varname>$_SESSION</varname> (oder @@ -27,17 +36,16 @@ aufzuheben, d.h. <literal>unset ($_SESSION['varname']);</literal>. </para> </note> - <para> - <caution> - <para> - Heben Sie NICHT die Registrierung der gesamten - <varname>$_SESSION</varname> mit <literal>unset($_SESSION)</literal> auf, - weil dies die Registrierung von Variablen durch die Superglobale - <varname>$_SESSION</varname> deaktivieren würde. - </para> - </caution> - </para> + <caution> + <para> + Heben Sie NICHT die Registrierung der gesamten + <varname>$_SESSION</varname> mit <literal>unset($_SESSION)</literal> auf, + weil dies die Registrierung von Variablen durch die Superglobale + <varname>$_SESSION</varname> deaktivieren würde. + </para> + </caution> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-write-close.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/session/functions/session-write-close.xml diff -u phpdoc-de/reference/session/functions/session-write-close.xml:1.5 phpdoc-de/reference/session/functions/session-write-close.xml:1.6 --- phpdoc-de/reference/session/functions/session-write-close.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-write-close.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.29 --> -<!-- last change to 'session-write-close' in en/ tree in rev 1.38 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.38 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-write-close" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_write_close</refname> <refpurpose>Speichert die Session-Daten und beendet die Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>session_write_close</methodname> <void/> @@ -29,6 +27,14 @@ beenden, sobald alle Änderungen an den Session-Variablen durchgeführt sind. </para> </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-cache-expire.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-cache-expire.xml diff -u phpdoc-de/reference/session/functions/session-cache-expire.xml:1.10 phpdoc-de/reference/session/functions/session-cache-expire.xml:1.11 --- phpdoc-de/reference/session/functions/session-cache-expire.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-cache-expire.xml Tue Jul 31 21:37:45 2007 @@ -1,38 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.32 --> -<!-- last change to 'session-cache-expire' in en/ tree in rev 1.38 --> -<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.38 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> <refentry xml:id='function.session-cache-expire' xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_cache_expire</refname> <refpurpose>Liefert die aktuelle Cache-Verfallszeit</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>int</type><methodname>session_cache_expire</methodname> <methodparam choice="opt"><type>int</type><parameter>neue_cache_verfallszeit</parameter></methodparam> </methodsynopsis> <para> <function>session_cache_expire</function> gibt die aktuelle Einstellung von - <literal>session.cache_expire</literal> zurück. Der zurückgegebene Wert - wird in Minuten angegeben und ist standardmäßig auf 180 gesetzt. Wenn - <parameter>neue_cache_verfallszeit</parameter> angegeben wurde, wird die - aktuelle cache_expire durch <parameter>neue_cache_verfallszeit</parameter> - ersetzt. + <literal>session.cache_expire</literal> zurück. </para> <para> Die Cache-Verfallszeit wird zu Beginn einer Anfrage auf den standardmäßigen Wert von 180, der in <literal>session.cache_limiter</literal> gespeichert - ist, zurück gesetzt. Folglich müssen Sie + ist, zurückgesetzt. Folglich müssen Sie <function>session_cache_expire</function> bei jeder Anfrage (und vor dem Aufruf von <function>session_start</function>) aufrufen. </para> - <example> - <title><function>session_cache_expire</function> Beispiel</title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>neue_cache_verfallszeit</parameter></term> + <listitem> + <para> + Wenn <parameter>neue_cache_verfallszeit</parameter> angegeben wurde, + wird die aktuelle cache_expire durch + <parameter>neue_cache_verfallszeit</parameter> ersetzt. + </para> + <para> + <note> + <simpara> + Das Setzen von <parameter>neue_cache_verfallszeit</parameter> bewirkt nur + dann etwas, wenn <literal>session.cache_limiter</literal> auf einen + <emphasis>anderen</emphasis> Wert als <literal>nocache</literal> + gesetzt ist. + </simpara> + </note> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die aktuelle Einstellung von <literal>session.cache_expire</literal> + zurück. Der zurückgegebene Wert wird in Minuten angegeben und ist + standardmäßig auf 180 gesetzt. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>session_cache_expire</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php @@ -53,23 +89,26 @@ echo "Die Session wird für $cache_expire Minuten im Cache gespeichert"; ?> ]]> - </programlisting> - </example> - <note> - <simpara> - Das Setzen von <parameter>new_cache_expire</parameter> bewirkt nur dann - etwas, wenn <literal>session.cache_limiter</literal> auf einen - <emphasis>anderen</emphasis> Wert als <literal>nocache</literal> gesetzt - ist. - </simpara> - </note> - <para> - Siehe auch <link - linkend="ini.session.cache-expire">session.cache_expire</link> und <link - linkend="ini.session.cache-limiter">session.cache_limiter</link> - Konfigurations-Anweisungen und <function>session_cache_limiter</function>. + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member> + <link linkend="ini.session.cache-expire">session.cache_expire</link> + </member> + <member> + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> + </member> + <member><function>session_cache_limiter</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-cache-limiter.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/session/functions/session-cache-limiter.xml diff -u phpdoc-de/reference/session/functions/session-cache-limiter.xml:1.9 phpdoc-de/reference/session/functions/session-cache-limiter.xml:1.10 --- phpdoc-de/reference/session/functions/session-cache-limiter.xml:1.9 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-cache-limiter.xml Tue Jul 31 21:37:45 2007 @@ -1,25 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.22 --> -<!-- last change to 'session-cache-limiter' in en/ tree in rev 1.62 --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.62 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-cache-limiter" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_cache_limiter</refname> <refpurpose>Liefert und/oder setzt die aktuelle Cacheverwaltung</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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 - <parameter>Cacheverwaltung</parameter> angegeben wurde, wird diese dem - neuen Wert entsprechend geändert. + aktuellen Cacheverwaltung zurück. </para> <para> Die Cacheverwaltung definiert, welche Cache-Kontroll-HTTP-Header, zum @@ -39,11 +35,6 @@ <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.0 hinzugefügt. - </para> - </note> <para> Zu Beginn einer Anfrage wird die Cacheverwaltung auf den voreingestellten Wert zurückesetzt, der in <link @@ -52,9 +43,62 @@ <function>session_cache_limiter</function> bei jeder Anfrage aufrufen (und zwar bevor <function>session_start</function> aufgerufen wird). </para> - <example> - <title><function>session_cache_limiter</function> Beispiel</title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Cacheverwaltung</parameter></term> + <listitem> + <para> + Wenn <parameter>Cacheverwaltung</parameter> angegeben wurde, wird diese + dem neuen Wert entsprechend geändert. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt die Bezeichnung der aktuellen Cacheverwaltung zurück. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.0</entry> + <entry> + Die Cacheverwaltung <literal>private_no_expire</literal> hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>session_cache_limiter</function> Beispiel</title> + <programlisting role="php"> <![CDATA[ <?php /* setzen der Cacheverwaltung auf 'private' */ @@ -63,14 +107,22 @@ echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<br />"; ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.cache-limiter">session.cache_limiter</link> - Konfigurationsanweisung. + <simplelist> + <member> + <link linkend="ini.session.cache-limiter">session.cache_limiter</link> + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-commit.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-de/reference/session/functions/session-commit.xml diff -u phpdoc-de/reference/session/functions/session-commit.xml:1.3 phpdoc-de/reference/session/functions/session-commit.xml:1.4 --- phpdoc-de/reference/session/functions/session-commit.xml:1.3 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-commit.xml Tue Jul 31 21:37:45 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-commit" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_commit</refname> @@ -16,6 +16,7 @@ <function>session_write_close</function>. </simpara> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-decode.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-decode.xml diff -u phpdoc-de/reference/session/functions/session-decode.xml:1.6 phpdoc-de/reference/session/functions/session-decode.xml:1.7 --- phpdoc-de/reference/session/functions/session-decode.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-decode.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-decode' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-decode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_decode</refname> <refpurpose>Dekodiert die Daten einer Session aus einer Zeichenkette</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_decode</methodname> <methodparam><type>string</type><parameter>Daten</parameter></methodparam> @@ -20,10 +18,40 @@ <parameter>Daten</parameter> und setzt die Variablen, die in der Session gespeichert sind. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Daten</parameter></term> + <listitem> + <para> + Die kodierten Daten, die gespeichert werden sollen. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>session_encode</function>. + <simplelist> + <member><function>session_encode</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-destroy.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/session/functions/session-destroy.xml diff -u phpdoc-de/reference/session/functions/session-destroy.xml:1.7 phpdoc-de/reference/session/functions/session-destroy.xml:1.8 --- phpdoc-de/reference/session/functions/session-destroy.xml:1.7 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-destroy.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-destroy' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-destroy" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_destroy</refname> <refpurpose>Löscht alle in einer Session registrierten Daten</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_destroy</methodname> <void/> @@ -27,9 +25,17 @@ Session-Cookie gelöscht werden. Dafür kann <function>setcookie</function> verwendet werden. </para> - <simpara> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> &return.success; - </simpara> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title>Löschen einer Session mit <varname>$_SESSION</varname></title> @@ -58,16 +64,28 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Verwenden Sie <function>session_unset</function> nur bei veraltetem Code, bei dem nicht <varname>$_SESSION</varname> benutzt wird. </para> </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch <function>unset</function> und <function>setcookie</function>. + <simplelist> + <member><function>unset</function></member> + <member><function>setcookie</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-encode.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-encode.xml diff -u phpdoc-de/reference/session/functions/session-encode.xml:1.6 phpdoc-de/reference/session/functions/session-encode.xml:1.7 --- phpdoc-de/reference/session/functions/session-encode.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-encode.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.18 --> -<!-- last change to 'session-encode' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-encode" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_encode</refname> <refpurpose>Kodiert die Daten der aktuellen Session als Zeichenkette</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>session_encode</methodname> <void/> @@ -19,10 +17,24 @@ <function>session_encode</function> gibt eine Zeichenkette mit dem kodierten Inhalt der aktuellen Session zurück. </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt Inhalt der aktuellen Session kodiert zurück. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>session_decode</function>. + <simplelist> + <member><function>session_decode</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-get-cookie-params.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-get-cookie-params.xml diff -u phpdoc-de/reference/session/functions/session-get-cookie-params.xml:1.8 phpdoc-de/reference/session/functions/session-get-cookie-params.xml:1.9 --- phpdoc-de/reference/session/functions/session-get-cookie-params.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-get-cookie-params.xml Tue Jul 31 21:37:45 2007 @@ -1,24 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.11 --> -<!-- last change to 'session-get-cookie-params' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.8 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-get-cookie-params" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_get_cookie_params</refname> <refpurpose>Liefert die Session-Cookie Parameter</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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 zurück. Das Array enthält - folgende Elemente: + Liefert die Parameter des Session-Cookie. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt ein Array mit der Information des aktuellen Session-Cookies zurück. + Das Array enthält folgende Elemente: <itemizedlist> <listitem> <simpara>"lifetime" - Die Lebensdauer des Cookies in Sekunden.</simpara> @@ -34,27 +38,76 @@ <listitem> <simpara> "secure" - Das Cookie soll nur über sichere Verbindungen gesendet - werden. (Dieses Element wurde in PHP 4.0.4 hinzugefügt.) + werden. </simpara> </listitem> <listitem> <simpara> "httponly" - Auf das Cookie kann nur durch das HTTP-Protokoll - zugegriffen werden. (Dieses Element wurde in PHP 5.2.0 hinzugefügt.) + zugegriffen werden. </simpara> </listitem> </itemizedlist> </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.0</entry> + <entry> + Das Element "httponly" wurde im zurückgegebenen Array hinzugefügt? + </entry> + </row> + <row> + <entry>4.0.4</entry> + <entry> + Das Element "secure" wurde im zurückgegebenen Array hinzugefügt? + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die Konfigurationsanweisungen - <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, - <link linkend="ini.session.cookie-path">session.cookie_path</link>, - <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, - <link linkend="ini.session.cookie-secure">session.cookie_secure</link>, - <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> - und <function>session_set_cookie_params</function>. + <simplelist> + <member> + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link> + </member> + <member> + <link linkend="ini.session.cookie-path">session.cookie_path</link> + </member> + <member> + <link linkend="ini.session.cookie-domain">session.cookie_domain</link> + </member> + <member> + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> + </member> + <member> + <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> + </member> + <member> + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link> + </member> + <member><function>session_set_cookie_params</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-id.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/session/functions/session-id.xml diff -u phpdoc-de/reference/session/functions/session-id.xml:1.11 phpdoc-de/reference/session/functions/session-id.xml:1.12 --- phpdoc-de/reference/session/functions/session-id.xml:1.11 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-id.xml Tue Jul 31 21:37:45 2007 @@ -1,14 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-id' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_id</refname> <refpurpose>Liefert und/oder setzt die aktuelle Session-ID</refpurpose> </refnamediv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-is-registered.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-is-registered.xml diff -u phpdoc-de/reference/session/functions/session-is-registered.xml:1.8 phpdoc-de/reference/session/functions/session-is-registered.xml:1.9 --- phpdoc-de/reference/session/functions/session-is-registered.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-is-registered.xml Tue Jul 31 21:37:45 2007 @@ -1,25 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-is-registered' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.8 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-is-registered" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_is_registered</refname> <refpurpose>Überprüft, ob eine globale Variable in einer Session registriert ist</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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 globale Variable mit dem Namen - <parameter>Name</parameter> registriert ist. + Überprüft, ob eine globale Variable in einer Session registriert ist. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Der Variablenname + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Falls in der aktuellen Session eine globale Variable mit dem Namen + <parameter>Name</parameter> registriert ist, gibt + <function>session_is_registered</function> &true; zurück, andernfalls + &false;. </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Benutzen Sie bei Verwendung von <varname>$_SESSION</varname> (oder @@ -38,6 +64,7 @@ </para> </caution> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-module-name.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/session/functions/session-module-name.xml diff -u phpdoc-de/reference/session/functions/session-module-name.xml:1.5 phpdoc-de/reference/session/functions/session-module-name.xml:1.6 --- phpdoc-de/reference/session/functions/session-module-name.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-module-name.xml Tue Jul 31 21:37:45 2007 @@ -1,26 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-module-name' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-module-name" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_module_name</refname> <refpurpose>Liefert und/oder setzt das aktuelle Session-Modul</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>session_module_name</methodname> <methodparam choice="opt"><type>string</type><parameter>Modul</parameter></methodparam> </methodsynopsis> <para> <function>session_module_name</function> gibt den Namen des aktuellen - Session-Moduls zurück. Wenn <parameter>Modul</parameter> angegeben wird, - wird stattdessen dieses Modul verwendet. + Session-Moduls zurück. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Modul</parameter></term> + <listitem> + <para> + Wenn <parameter>Modul</parameter> angegeben wird, wird stattdessen + dieses Modul verwendet. + </para> + </listitem> + </varlistentry> + </variablelist> </para> </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Namen des aktuellen Session-Moduls zurück. + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-name.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-name.xml diff -u phpdoc-de/reference/session/functions/session-name.xml:1.8 phpdoc-de/reference/session/functions/session-name.xml:1.9 --- phpdoc-de/reference/session/functions/session-name.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-name.xml Tue Jul 31 21:37:45 2007 @@ -1,45 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-name' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-name" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_name</refname> <refpurpose>Liefert und/oder setzt den Namen der aktuellen Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <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, wird der Name der - aktuellen Session durch dessen Wert ersetzt. + zurück. </para> <para> - Der Sessionname referenziert die Session-ID in Cookies und URLs. Er sollte - nur alphanumerische Zeichen enthalten und sollte kurz und beschreibend sein - (z.B. für Benutzer mit aktivierter Cookie-Warnung). Der Sessionname wird - auf den Ausgangswert zurückgesetzt, der zu Beginn in + Der Sessionname wird auf den Ausgangswert zurückgesetzt, der zu Beginn in <literal>session.name</literal> gespeichert wurde. Deshalb muss <function>session_name</function> bei jeder Anfrage aufgerufen werden (und bevor <function>session_start</function> oder <function>session_register</function> aufgerufen wurden). </para> - <warning> - <para> - Der Sessionname kann nicht nur aus Zahlen bestehen, sondern muss - mindestens einen Buchstaben enthalten. Andernfalls wird jedesmal eine neue - Session-ID erzeugt. - </para> - </warning> - <example> - <title><function>session_name</function> Beispiele</title> - <programlisting role="php"> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Der Sessionname referenziert die Session-ID in Cookies und URLs. Er + sollte nur alphanumerische Zeichen enthalten und sollte kurz und + beschreibend sein (z.B. für Benutzer mit aktivierter Cookie-Warnung). + Wenn <parameter>Name</parameter> angegeben wird, wird der Name der + aktuellen Session durch dessen Wert ersetzt. + </para> + <para> + <warning> + <para> + Der Sessionname kann nicht nur aus Zahlen bestehen, sondern muss + mindestens einen Buchstaben enthalten. Andernfalls wird jedesmal eine + neue Session-ID erzeugt. + </para> + </warning> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Namen der aktuellen Session zurück. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>session_name</function> Beispiele</title> + <programlisting role="php"> <![CDATA[ <?php /* den Sessionnamen auf WebsiteID setzen */ @@ -47,13 +75,23 @@ echo "Der vorhergehende Sessionname war $name_vorher<br />"; ?> ]]> - </programlisting> - </example> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.name">session.name</link> Konfigurationsanweisung. + <simplelist> + <member> + Die <link linkend="ini.session.name">session.name</link> + Konfigurationsanweisung + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-regenerate-id.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-regenerate-id.xml diff -u phpdoc-de/reference/session/functions/session-regenerate-id.xml:1.6 phpdoc-de/reference/session/functions/session-regenerate-id.xml:1.7 --- phpdoc-de/reference/session/functions/session-regenerate-id.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-regenerate-id.xml Tue Jul 31 21:37:45 2007 @@ -1,11 +1,12 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-regenerate-id" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_regenerate_id</refname> <refpurpose>Ersetzt die aktuelle Session-ID durch eine neu erzeugte</refpurpose> </refnamediv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> @@ -112,6 +113,7 @@ </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-register.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-register.xml diff -u phpdoc-de/reference/session/functions/session-register.xml:1.10 phpdoc-de/reference/session/functions/session-register.xml:1.11 --- phpdoc-de/reference/session/functions/session-register.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-register.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-register' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-register" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_register</refname> <refpurpose>Registriert eine oder mehrere globale Variablen in der aktuellen Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_register</methodname> <methodparam><type>mixed</type><parameter>Name</parameter></methodparam> @@ -24,6 +22,70 @@ <function>session_register</function> die globale Variable mit diesem Namen in der aktuellen Session. </para> + <para> + Sie können eine Session-Variable auch erzeugen, indem Sie das entsprechende + Element des <varname>$_SESSION</varname>- oder (PHP <= 4.1.0) + <varname>$HTTP_SESSION_VARS</varname>-Arrays setzen. + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +// Sie sollten session_register() nicht verwenden +$barney = "A big purple dinosaur."; +session_register("barney"); + +// Ab PHP 4.1.0 ist die Verwendung von $_SESSION vorzuziehen +$_SESSION["zim"] = "An invader from another planet."; + +// Die alte Methode war, $HTTP_SESSION_VARS zu verwenden +$HTTP_SESSION_VARS["spongebob"] = "He's got square pants."; +?> +]]> + </programlisting> + </informalexample> + </para> + <para> + Wenn <function>session_start</function> nicht vor dieser Funktion + aufgerufen wurde, erfolgt ein impliziter Aufruf von + <function>session_start</function> ohne Parameter. + <varname>$_SESSION</varname> ahmt dieses Verhalten nicht nach und benötigt + den Aufruf von <function>session_start</function> bevor es verwendet wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Eine Zeichenkette, die den Namen einer Variablen trägt, oder ein Array, + das aus solchen Variablennamen oder anderen Arrays besteht. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>...</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <caution> <para> Wenn Sie wollen, dass ihr Script unabhängig von der Einstellung von <link @@ -36,9 +98,7 @@ linkend="ini.register-globals">register_globals</link> deaktiviert ist. </para> </caution> - ¬e.registerglobals; - <caution> <para> Diese Funktion registriert eine <emphasis>globale</emphasis> Variable. @@ -58,39 +118,6 @@ <function>session_unregister</function> verwenden. </para> </caution> - <para> - Diese Funktion gibt &true; zurück, wenn alle Variablen erfolgreich in der - Session registriert wurden. - </para> - <para> - Wenn <function>session_start</function> nicht vor dieser Funktion - aufgerufen wurde, erfolgt ein impliziter Aufruf von - <function>session_start</function> ohne Parameter. - <varname>$_SESSION</varname> ahmt dieses Verhalten nicht nach und benötigt - den Aufruf von <function>session_start</function> bevor es verwendet wird. - </para> - <para> - Sie können eine Session-Variable auch erzeugen, indem Sie das entsprechende - Element des <varname>$_SESSION</varname>- oder (PHP <= 4.1.0) - <varname>$HTTP_SESSION_VARS</varname>-Arrays setzen. - <informalexample> - <programlisting role="php"> -<![CDATA[ -<?php -// Sie sollten session_register() nicht verwenden -$barney = "A big purple dinosaur."; -session_register("barney"); - -// Ab PHP 4.1.0 ist die Verwendung von $_SESSION vorzuziehen -$_SESSION["zim"] = "An invader from another planet."; - -// Die alte Methode war, $HTTP_SESSION_VARS zu verwenden -$HTTP_SESSION_VARS["spongebob"] = "He's got square pants."; -?> -]]> - </programlisting> - </informalexample> - </para> <note> <para> Gegenwärtig ist es nicht möglich, Ressourcen-Variablen in einer Session zu @@ -110,12 +137,21 @@ 'ABC'; </para> </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: <function>session_is_registered</function>, - <function>session_unregister</function> und <link - linkend="reserved.variables.session">$_SESSION</link>. + <simplelist> + <member><function>session_is_registered</function></member> + <member><function>session_unregister</function></member> + <member> + <link linkend="reserved.variables.session">$_SESSION</link> + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-save-path.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/session/functions/session-save-path.xml diff -u phpdoc-de/reference/session/functions/session-save-path.xml:1.6 phpdoc-de/reference/session/functions/session-save-path.xml:1.7 --- phpdoc-de/reference/session/functions/session-save-path.xml:1.6 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-save-path.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-save-path' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-save-path" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_save_path</refname> <refpurpose>Liefert und/oder setzt den aktuellen Speicherpfad der Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>string</type><methodname>session_save_path</methodname> <methodparam choice="opt"><type>string</type><parameter>Pfad</parameter></methodparam> @@ -18,25 +16,58 @@ <para> <function>session_save_path</function> gibt den Pfad des aktuellen Verzeichnisses zurück, das zum Speichern der Session-Daten verwendet wird. - Wenn <parameter>Pfad</parameter> angegeben wird, wird der Pfad, unter dem - Daten gespeichert werden, entsprechend geändert. Zu diesem Zweck muss - <function>session_save_path</function> vor - <function>session_start</function> aufgerufen werden. - <note> - <para> - Unter manchen Betriebssystemen, wollen Sie vielleicht einen Pfad auf - einem Dateisystem angeben, das sehr viele kleine Dateien effizient - behandelt. Unter Linux, zum Beispiel, bietet reiserfs eventuell eine - bessere Performance als ext2fs. - </para> - </note> </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Pfad</parameter></term> + <listitem> + <para> + Der Pfad der Session-Daten. Wenn <parameter>Pfad</parameter> angegeben + wird, wird der Pfad, unter dem Daten gespeichert werden, entsprechend + geändert. Zu diesem Zweck muss <function>session_save_path</function> + vor <function>session_start</function> aufgerufen werden. + </para> + <para> + <note> + <para> + Unter manchen Betriebssystemen, wollen Sie vielleicht einen Pfad auf + einem Dateisystem angeben, das sehr viele kleine Dateien effizient + behandelt. Unter Linux, zum Beispiel, bietet reiserfs eventuell eine + bessere Performance als ext2fs. + </para> + </note> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Gibt den Pfad des aktuellen Verzeichnisses zurück, das zum Speichern der + Session-Daten verwendet wird. + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.save-path">session.save_path</link> - Konfigurationsanweisung. + <simplelist> + <member> + Die <link linkend="ini.session.save-path">session.save_path</link> + Konfigurationsanweisung + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-set-cookie-params.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/session/functions/session-set-cookie-params.xml diff -u phpdoc-de/reference/session/functions/session-set-cookie-params.xml:1.9 phpdoc-de/reference/session/functions/session-set-cookie-params.xml:1.10 --- phpdoc-de/reference/session/functions/session-set-cookie-params.xml:1.9 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-set-cookie-params.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.11 --> -<!-- last change to 'session-set-cookie-params' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-set-cookie-params" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_set_cookie_params</refname> <refpurpose>Setzt die Session-Cookie Parameter</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>session_set_cookie_params</methodname> <methodparam><type>int</type><parameter>Lebensdauer</parameter></methodparam> @@ -25,22 +23,109 @@ <function>session_set_cookie_params</function> bei jeder Anfrage und noch vor dem Aufruf von <function>session_start</function> aufrufen. </para> - <note> - <para> - Der Parameter <parameter>secure</parameter> wurde in PHP 4.0.4 hinzugefügt - und der Parameter <parameter>httponly</parameter> in PHP 5.2.0. - </para> - </note> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Lebensdauer</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Pfad</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>Domain</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>secure</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>httponly</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.2.0</entry> + <entry> + Den Parameter <parameter>httponly</parameter> hinzugefügt. + </entry> + </row> + <row> + <entry>4.0.4</entry> + <entry> + Den Parameter <parameter>secure</parameter> hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die Konfigurationsanweisungen - <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link>, - <link linkend="ini.session.cookie-path">session.cookie_path</link>, - <link linkend="ini.session.cookie-domain">session.cookie_domain</link>, - <link linkend="ini.session.cookie-secure">session.cookie_secure</link>, - <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> - und <function>session_get_cookie_params</function>. + <simplelist> + <member> + <link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link> + </member> + <member> + <link linkend="ini.session.cookie-domain">session.cookie_domain</link> + </member> + <member> + <link linkend="ini.session.cookie-secure">session.cookie_secure</link> + </member> + <member> + <link linkend="ini.session.cookie-httponly">session.cookie_httponly</link> + </member> + <member><function>session_get_cookie_params</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-set-save-handler.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-de/reference/session/functions/session-set-save-handler.xml diff -u phpdoc-de/reference/session/functions/session-set-save-handler.xml:1.17 phpdoc-de/reference/session/functions/session-set-save-handler.xml:1.18 --- phpdoc-de/reference/session/functions/session-set-save-handler.xml:1.17 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-set-save-handler.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-set-save-handler' in en/ tree in rev 1.23 --> -<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.23 --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.20 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-set-save-handler" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_set_save_handler</refname> <refpurpose>Setzt benutzerdefinierte Session-Speicherfunktionen</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_set_save_handler</methodname> <methodparam><type>callback</type><parameter>öffnen</parameter></methodparam> @@ -26,44 +24,93 @@ zur Session gehörigen Daten verwendet werden. Dies ist äußerst nützlich, wenn eine andere als die mit PHP-Sessions zur Verfügung stehende Art der Speicherung, z.B. die Speicherung der Session-Daten in einer lokalen - Datenbank, bevorzugt wird. &return.success; - </para> - <note> - <para> - Die "schreiben"-Routine wird nicht ausgeführt, bevor die Ausgabe - abgeschlossen ist. Deshalb werden auch niemals Fehlermeldungen der - "schreiben"-Routine im Browser erscheinen. Wenn die Ausgabe von - Fehlermeldungen nötig ist, sollte diese stattdessen in eine Datei - geschrieben werden. - </para> - </note> + Datenbank, bevorzugt wird. + </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; <para> - Das folgende Beispiel liefert eine dateibasierte Session-Speicherung, die - der Standard-Speicherroutine <parameter>files</parameter> der PHP-Sessions - ähnlich ist. Dieses Beispiel kann problemlos erweitert werden, dass es - Datenbank-Speicherung mittels ihrer bevorzugten PHP-gestützten Datenbank - beinhaltet. + <variablelist> + <varlistentry> + <term><parameter>öffnen</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>schließen</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>lesen</parameter></term> + <listitem> + <para> + Damit die Speicherroutine funktioniert wie erwartet, muss die + read-Funktion immer eine Zeichenkette zurückgeben. Wenn es keine Daten + zu lesen gibt, geben Sie eine leere Zeichenkette zurück. Rückgabewerte + anderer Routinen werden in boolesche Ausdrücke umgewandelt. &true; für + einen Erfolg, &false; für einen Fehler. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>schreiben</parameter></term> + <listitem> + <para> + <note> + <para> + Die "schreiben"-Routine wird nicht ausgeführt, bevor die Ausgabe + abgeschlossen ist. Deshalb werden auch niemals Fehlermeldungen der + "schreiben"-Routine im Browser erscheinen. Wenn die Ausgabe von + Fehlermeldungen nötig ist, sollte diese stattdessen in eine Datei + geschrieben werden. + </para> + </note> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>löschen</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>gc</parameter></term> + <listitem> + <para> + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Damit die Speicherroutine funktioniert wie erwartet, muss die read-Function - immer einen String-Wert zurückgeben. Wenn es keine Daten zu lesen gibt, - geben Sie eine leere Zeichenkette zurück. Rückgabewerte anderer Routinen - werden in boolesche Ausdrücke umgewandelt. &true; für einen Erfolg, &false; - für einen Fehler. + &return.success; </para> - <warning> - <para> - Ab PHP 5.0.5 werden die Routinen für das Speichern und Beenden nach dem - Zerstören von Objekten aufgerufen. Daher können Destruktoren Sessions - verwenden aber Session-Routinen keine Objekte. In vorherigen Versionen - wurden sie in der umgekehrten Reihenfolge aufgerufen. Es ist möglich, - <function>session_write_close</function> über den Destruktor aufzurufen, - um dieses Henne-Ei Problem zu lösen. - </para> - </warning> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>session_set_save_handler</function> Beispiel</title> + <para> + Das folgende Beispiel liefert eine dateibasierte Session-Speicherung, die + der Standard-Speicherroutine <parameter>files</parameter> der + PHP-Sessions ähnlich ist. Dieses Beispiel kann problemlos erweitert + werden, dass es Datenbank-Speicherung mittels ihrer bevorzugten + PHP-gestützten Datenbank beinhaltet. + </para> <programlisting role="php"> <![CDATA[ <?php @@ -100,7 +147,6 @@ } else { return(false); } - } function destroy($id) @@ -133,12 +179,37 @@ </programlisting> </example> </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <warning> + <para> + Ab PHP 5.0.5 werden die Routinen <parameter>schreiben</parameter> und + <parameter>schließen</parameter> nach dem Zerstören von Objekten + aufgerufen und können deshalb keine Objekte verwenden oder Exceptions + (Fehler-, Ausnahmesituationen) auslösen. Objekt-Destruktoren können + aber Sessions verwenden. + </para> + <para> + Es ist möglich, <function>session_write_close</function> über den + Destruktor aufzurufen, um dieses Henne-Ei Problem zu lösen. + </para> + </warning> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch die <link - linkend="ini.session.save-handler">session.save_handler</link> - Konfigurationsanweisung. + <simplelist> + <member> + Die <link linkend="ini.session.save-handler">session.save_handler</link> + Konfigurationsanweisung + </member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-start.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-start.xml diff -u phpdoc-de/reference/session/functions/session-start.xml:1.10 phpdoc-de/reference/session/functions/session-start.xml:1.11 --- phpdoc-de/reference/session/functions/session-start.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-start.xml Tue Jul 31 21:37:45 2007 @@ -1,35 +1,76 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-start' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-start" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_start</refname> <refpurpose>Initialisiert eine Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_start</methodname> <void/> </methodsynopsis> - <simpara> + <para> <function>session_start</function> erzeugt eine Session oder nimmt die aktuelle wieder auf, die auf der Session-ID basiert, die mit einer Anfrage, z.B. durch GET, POST oder ein Cookie, übermittelt wurde. - </simpara> - <simpara> + </para> + <para> + Wenn Sie eine benannte Session verwenden wollen, müssen Sie + <function>session_name</function> aufrufen, bevor Sie + <function>session_start</function> aufrufen. + </para> + <para> + Wenn <literal>trans-sid</literal> aktiviert ist, registriert + <function>session_start</function> die interne Ausgaberoutine für das + Umschreiben von URLs. Verwendet ein Benutzer + <literal>ob_gzhandler</literal> oder ähnliches mit + <function>ob_start</function>, ist die Reihenfolge der Augaberoutine + wichtig für eine korrekte Ausgabe. Zum Beispiel muss der Benutzer + <literal>ob_gzhandler</literal> vor Beginn der Session registrieren. + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> 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> + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.3</entry> + <entry> + Ab sofort resultiert der Aufruf von + <function>session_start</function>, nachdem die Session schon + gestartet wurde, in einem Fehler der Stufe + <constant>E_NOTICE</constant>. Der zweite Session-Start wird in diesem + Fall einfach ignoriert. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title> @@ -89,42 +130,42 @@ </programlisting> </example> </para> - <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> - Wenn <literal>trans-sid</literal> aktiviert ist, registriert - <function>session_start</function> die interne Ausgaberoutine für das - Umschreiben von URLs. Verwendet ein Benutzer - <literal>ob_gzhandler</literal> oder ähnliches mit - <function>ob_start</function>, ist die Reihenfolge der Augaberoutine - wichtig für eine korrekte Ausgabe. Zum Beispiel muss der Benutzer - <literal>ob_gzhandler</literal> vor Beginn der Session registrieren. - </simpara> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> - <simpara> - Die Verwendung von <link - linkend="ini.zlib.output-compression">zlib.output_compression</link> ist - <function>ob_gzhandler</function> vorzuziehen. - </simpara> + <para> + Bei Verwendung Cookie-basierter Sessions müssen Sie + <function>session_start</function> aufrufen, bevor irgend etwas an den + Browser geschickt wird. + </para> </note> <note> <para> - Ab PHP 4.3.3 resultiert der Aufruf von <function>session_start</function>, - nachdem die Session schon gestartet wurde, in einem Fehler der Stufe - <constant>E_NOTICE</constant>. Der zweite Session-Start wird in diesem - Fall einfach ignoriert. + Die Verwendung von <link + linkend="ini.zlib.output-compression">zlib.output_compression</link> ist + <function>ob_gzhandler</function> vorzuziehen. </para> </note> + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; <para> - Siehe auch: - <link linkend="reserved.variables.session">$_SESSION</link>, - <link linkend="ini.session.auto-start">session.auto_start</link> - und <function>session_id</function>. + <simplelist> + <member> + <link linkend="reserved.variables.session">$_SESSION</link> + </member> + <member> + Die <link linkend="ini.session.auto-start">session.auto_start</link> + Konfigurationsanweisung + </member> + <member><function>session_id</function></member> + </simplelist> </para> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-unregister.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/functions/session-unregister.xml diff -u phpdoc-de/reference/session/functions/session-unregister.xml:1.8 phpdoc-de/reference/session/functions/session-unregister.xml:1.9 --- phpdoc-de/reference/session/functions/session-unregister.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-unregister.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.2 --> -<!-- last change to 'session-unregister' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.2 --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.8 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-unregister" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_unregister</refname> <refpurpose>Hebt die Registrierung einer globalen Variablen in der aktuellen Session auf</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>bool</type><methodname>session_unregister</methodname> <methodparam><type>string</type><parameter>Name</parameter></methodparam> @@ -19,10 +17,33 @@ <function>session_unregister</function> hebt die Registrierung der globalen Variablen namens <parameter>Name</parameter> in der aktuellen Session auf. </para> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Name</parameter></term> + <listitem> + <para> + Der Variablenname + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - Diese Funktion gibt &true; zurück, wenn die Aufhebung der Registrierung der - Variablen in der Session erfolgt ist. + &return.success; </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Benutzen Sie bei Verwendung von <varname>$_SESSION</varname> (oder @@ -51,6 +72,7 @@ </para> </caution> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-unset.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/session/functions/session-unset.xml diff -u phpdoc-de/reference/session/functions/session-unset.xml:1.10 phpdoc-de/reference/session/functions/session-unset.xml:1.11 --- phpdoc-de/reference/session/functions/session-unset.xml:1.10 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-unset.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.11 --> -<!-- last change to 'session-unset' in en/ tree in rev 1.8 --> -<!-- EN-Revision: 1.9 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.8 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-unset" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_unset</refname> <refpurpose>Löscht alle Session-Variablen</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>session_unset</methodname> <void/> @@ -19,6 +17,17 @@ Die Funktion <function>session_unset</function> löscht alle Session-Variablen, die gegenwärtig registriert sind. </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; <note> <para> Benutzen Sie bei Verwendung von <varname>$_SESSION</varname> (oder @@ -27,17 +36,16 @@ aufzuheben, d.h. <literal>unset ($_SESSION['varname']);</literal>. </para> </note> - <para> - <caution> - <para> - Heben Sie NICHT die Registrierung der gesamten - <varname>$_SESSION</varname> mit <literal>unset($_SESSION)</literal> auf, - weil dies die Registrierung von Variablen durch die Superglobale - <varname>$_SESSION</varname> deaktivieren würde. - </para> - </caution> - </para> + <caution> + <para> + Heben Sie NICHT die Registrierung der gesamten + <varname>$_SESSION</varname> mit <literal>unset($_SESSION)</literal> auf, + weil dies die Registrierung von Variablen durch die Superglobale + <varname>$_SESSION</varname> deaktivieren würde. + </para> + </caution> </refsect1> + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/functions/session-write-close.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/session/functions/session-write-close.xml diff -u phpdoc-de/reference/session/functions/session-write-close.xml:1.5 phpdoc-de/reference/session/functions/session-write-close.xml:1.6 --- phpdoc-de/reference/session/functions/session-write-close.xml:1.5 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/functions/session-write-close.xml Tue Jul 31 21:37:45 2007 @@ -1,16 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- splitted from ./de/functions/session.xml, last change in rev 1.29 --> -<!-- last change to 'session-write-close' in en/ tree in rev 1.38 --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<!-- OLD-Revision: 1.81/EN.1.38 --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> <refentry xml:id="function.session-write-close" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>session_write_close</refname> <refpurpose>Speichert die Session-Daten und beendet die Session</refpurpose> </refnamediv> - <refsect1> - <title>Beschreibung</title> + + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>void</type><methodname>session_write_close</methodname> <void/> @@ -29,6 +27,14 @@ beenden, sobald alle Änderungen an den Session-Variablen durchgeführt sind. </para> </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + </refentry> <!-- Keep this comment at the end of the file