samesch Tue Dec 18 19:21:27 2001 EDT Modified files: /phpdoc/de/functions session.xml Log: hope it's fixed again...
Index: phpdoc/de/functions/session.xml diff -u phpdoc/de/functions/session.xml:1.35 phpdoc/de/functions/session.xml:1.36 --- phpdoc/de/functions/session.xml:1.35 Tue Dec 18 17:15:38 2001 +++ phpdoc/de/functions/session.xml Tue Dec 18 19:21:26 2001 @@ -70,19 +70,16 @@ <link linkend="ini.track-vars"><literal>track_vars</literal></link> </title> <programlisting role="php"> -<![CDATA[ -<?php +<?php session_register("count"); $HTTP_SESSION_VARS["count"]++; -?> -]]> +?> </programlisting> </example> </para> <para> Wenn - <link linkend="ini.register-globals"><literal>register_globals</literal></link> - aktiviert ist, können alle globalen Variablen als + <link linkend="ini.register-globals"><literal>register_globals</lite aktiviert +ist, können alle globalen Variablen als Session-Variablen registriert werden und die Session-Variablen werden als entsprechende globale Variablen wiederhergestellt. <example> @@ -91,12 +88,10 @@ <link linkend="ini.register-globals"><literal>register_globals</literal></link> </title> <programlisting role="php"> -<![CDATA[ -<?php +<?php session_register("count"); $count++; -?> -]]> +?> </programlisting> </example> </para> @@ -149,22 +144,20 @@ <example> <title>Zählen der Seitenaufrufe eines einzelnen Benutzers</title> <programlisting role="php"> -<![CDATA[ -<?php +<?php session_register ("count"); $count++; -?> +?> -Hallo Besucher, Sie haben diese Seite <?php echo $count; ?> Mal -aufgerufen.<p> +Hallo Besucher, Sie haben diese Seite <?php echo $count; ?> Mal +aufgerufen.<p> -<?php +<?php # für den Fall, dass der Benutzer Cookies deaktiviert hat, -# ist das <?=SID?> nötig, um die Session-ID zu erhalten -?> +# ist das <?=SID?> nötig, um die Session-ID zu erhalten +?> -Hier gehts <A HREF="nextpage.php?<?=SID?>">weiter</A> -]]> +Hier gehts <A HREF="nextpage.php?<?=SID?>">weiter</A> </programlisting> </example> </para> @@ -318,8 +311,8 @@ <simpara> <literal>session.cache_limiter</literal> spezifiziert die Methode der Cacheverwaltung, die bei Session-Seiten benutzt - wird (nocache/private/private_no_expire/public). - Grundeinstellung <literal>nocache</literal>. + wird (nocache/private/public). Grundeinstellung + <literal>nocache</literal>. </simpara> </listitem> <listitem> @@ -365,12 +358,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>bool</type><methodname>session_start</methodname> - <void/> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>session_start</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> <simpara> <function>session_start</function> erzeugt eine Session (oder nimmt die aktuelle, basierend auf der Session-ID, die über eine @@ -403,12 +396,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>bool</type><methodname>session_destroy</methodname> - <void/> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>session_destroy</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> <simpara> <function>session_destroy</function> löscht alle in Verbindung mit der aktuellen Session stehenden Daten. Mit der Session @@ -423,8 +416,7 @@ <example> <title>Löschen einer Session</title> <programlisting role="php"> -<![CDATA[ -<?php +<?php # Initialisierung der Session. # Wenn Sie session_name("something") verwenden, vergessen Sie es jetzt # nicht! @@ -433,8 +425,7 @@ session_unset(); # Zum Schluß, löschen der Session. session_destroy(); -?> -]]> +?> </programlisting> </example> </para> @@ -450,14 +441,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>string</type><methodname>session_name</methodname> - <methodparam choice="opt"> - <type>string</type><parameter>Name</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>string <function>session_name</function></funcdef> + <paramdef>string + <parameter><optional>Name</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_name</function> gibt den Namen der aktuellen Session zurück. Wenn <parameter>Name</parameter> angegeben wird, @@ -477,13 +468,14 @@ <example> <title><function>session_name</function> Beispiele</title> <programlisting role="php"> -<![CDATA[ -<?php +<?php + # den Session-Namen auf WebsiteID setzen + $previous_name = session_name ("WebsiteID"); -echo "Der vorhergehende Session-Name war $previous_name<p>"; -?> -]]> + +echo "Der vorhergehende Session-Name war $previous_name<p>"; +?> </programlisting> </example> </refsect1> @@ -498,14 +490,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>string</type><methodname>session_module_name</methodname> - <methodparam choice="opt"> - <type>string</type><parameter>module</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>string <function>session_module_name</function></funcdef> + <paramdef>string + <parameter><optional>module</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_module_name</function> gibt den Namen des aktuellen Session-Moduls zurück. Wenn @@ -524,14 +516,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>string</type><methodname>session_save_path</methodname> - <methodparam choice="opt"> - <type>string</type><parameter>Pfad</parameter> - </paramdef> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>string <function>session_save_path</function></funcdef> + <paramdef>string + <parameter><optional>Pfad</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_save_path</function> gibt den Pfad des aktuellen Verzeichnisses zurück, das zum Speichern der @@ -559,14 +551,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>string</type><methodname>session_id</methodname> - <methodparam choice="opt"> - <type>string</type><parameter>ID</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>string <function>session_id</function></funcdef> + <paramdef>string + <parameter><optional>ID</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_id</function> gibt die Session-ID der aktuellen Session zurück. Wenn <parameter>ID</parameter> angegeben wird, @@ -589,17 +581,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>bool</type><methodname>session_register</methodname> - <methodparam> - <type>mixed</type><parameter>Name</parameter> - </methodparam> - <methodparam> - <type>mixed</type><parameter>...</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>session_register</function></funcdef> + <paramdef>mixed <parameter>Name</parameter></paramdef> + <paramdef>mixed + <parameter><optional>...</optional></parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_register</function> variable Anzahl von Argumenten die jeweils entweder eine Zeichenkette sein können, @@ -626,6 +615,11 @@ <link linkend="resource">Liste von PHP Ressourcen</link>. </para> </note> + <note> + <para> + This function was added in PHP 4.0. + </para> + </note> </refsect1> </refentry> @@ -638,14 +632,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>bool</type><methodname>session_unregister</methodname> - <methodparam> - <type>string</type><parameter>Name</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>session_unregister</function></funcdef> + <paramdef>string <parameter>Name</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_unregister</function> hebt die Registrierung der globalen Variablen namens <parameter>Name</parameter> in der @@ -676,12 +668,13 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>void</type><methodname>session_unset</methodname> - <void/> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>void <function>session_unset</function> + </funcdef> + <void/> + </funcprototype> + </funcsynopsis> <para> Die Funktion <function>session_unset</function> befreit alle Session-Variablen, die gegenwärtig registriert sind. @@ -698,14 +691,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>bool</type><methodname>session_is_registered</methodname> - <methodparam> - <type>string</type><parameter>Name</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>bool + <function>session_is_registered</function> + </funcdef> + <paramdef>string <parameter>Name</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_is_registered</function> gibt &true; zurück, wenn in der aktuellen Session eine Variable mit dem Namen @@ -723,12 +716,14 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>array</type><methodname>session_get_cookie_params</methodname> - <void/> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef> + array <function>session_get_cookie_params</function> + </funcdef> + <void/> + </funcprototype> + </funcsynopsis> <para> Die Funktion <function>session_get_cookie_params</function> gibt ein Array mit der Information des aktuellen Session-Cookies @@ -770,20 +765,22 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>void</type><methodname>session_set_cookie_params</methodname> - <methodparam> - <type>int</type><parameter>lifetime</parameter> - </methodparam> - <methodparam choice="opt"> - <type>string</type><parameter>Pfad</parameter> - </methodparam> - <methodparam choice="opt"> - <type>string</type><parameter>Domain</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>void + <function>session_set_cookie_params</function> + </funcdef> + <paramdef> + int <parameter>lifetime</parameter> + </paramdef> + <paramdef> + string <parameter><optional>Pfad</optional></parameter> + </paramdef> + <paramdef> + string <parameter><optional>Domain</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> Setzen der Cookie-Parameter, die in der php.ini definiert sind. Diese Funktion wirkt sich nur für die Dauer des Scripts @@ -796,19 +793,17 @@ <refnamediv> <refname>session_decode</refname> <refpurpose> - Decodiert die Daten einer Session aus einer Zeichenkette + Dekodiert die Daten einer Session aus einer Zeichenkette </refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>bool</type><methodname>session_decode</methodname> - <methodparam> - <type>string</type><parameter>data</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>session_decode</function></funcdef> + <paramdef>string <parameter>data</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_decode</function> dekodiert die Daten der Session in <parameter>data</parameter> und setzt die Variablen, @@ -826,12 +821,12 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>>string</type><methodname>session_encode</methodname> - <void/> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>string <function>session_encode</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> <para> <function>session_encode</function> gibt eine Zeichenkette mit dem kodierten Inhalt der aktuellen Session zurück. @@ -848,29 +843,20 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>void</type><methodname>session_set_save_handler</methodname> - <methodparam> - <type>string</type><parameter>öffnen</parameter> - </methodparam> - <methodparam> - <type>string</type><parameter>schließen</parameter> - </methodparam> - <methodparam> - <type>string</type><parameter>lesen</parameter> - </methodparam> - <methodparam> - <type>string</type><parameter>schreiben</parameter> - </methodparam> - <methodparam> - <type>string</type><parameter>löschen</parameter> - </methodparam> - <methodparam> - <type>string</type><parameter>gc</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef> + void <function>session_set_save_handler</function> + </funcdef> + <paramdef>string + <parameter>öffnen</parameter></paramdef><paramdef>string + <parameter>schließen</parameter></paramdef><paramdef>string + <parameter>lesen</parameter></paramdef><paramdef>string + <parameter>schreiben</parameter></paramdef><paramdef>string + <parameter>löschen</parameter></paramdef><paramdef>string + <parameter>gc</parameter></paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_set_save_handler</function> setzt die benutzerdefinierten Session-Speicherfunktionen, die zur @@ -911,8 +897,8 @@ <function>session_set_save_handler</function> Beispiel </title> <programlisting role="php"> -<![CDATA[ -<?php +<?php + function open ($save_path, $session_name) { global $sess_save_path, $sess_session_name; @@ -965,13 +951,14 @@ return true; } -session_set_save_handler ("open", "close", "read", "write", "destroy", "gc"); +session_set_save_handler ("open", "close", "read", "write", "destroy", +"gc"); session_start(); // verfahren Sie mit Sessions wie gewohnt -?> -]]> + +?> </programlisting> </example> </para> @@ -987,14 +974,16 @@ </refnamediv> <refsect1> <title>Beschreibung</title> - - <methodsynopsis> - <type>string</type><methodname>session_cache_limiter</methodname> - <methodparam choice="opt"> - <type>string</type><parameter>Cacheverwaltung</parameter> - </methodparam> - </methodsynopsis> - + <funcsynopsis> + <funcprototype> + <funcdef>string + <function>session_cache_limiter</function> + </funcdef> + <paramdef>string + <parameter><optional>Cacheverwaltung</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> <function>session_cache_limiter</function> gibt die Bezeichnung der aktuellen Cacheverwaltung zurück. Wenn @@ -1036,14 +1025,13 @@ <example> <title><function>session_cache_limiter</function> Beispiel</title> <programlisting role="php"> -<![CDATA[ -<?php +<?php + # setzen der Cacheverwaltung auf 'private' session_cache_limiter('private'); $cacheverwaltung = session_cache_limiter(); -echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<p>"; -?> -]]> +echo "Die Cacheverwaltung ist jetzt auf $cacheverwaltung gesetzt<p>"; +?> </programlisting> </example> </refsect1> @@ -1059,15 +1047,15 @@ </refpurpose> </refnamediv> <refsect1> - <title>Description</title> - - <methodsynopsis> - <type>int</type><methodname>session_cache_expire</methodname> - <methodparam choice="opt"> - <type>int</type><parameter>new_cache_expire</parameter> - </methodparam> - </methodsynopsis> - + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>session_cache_expire</function> + <paramdef>int + <parameter><optional>new_cache_expire<optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <para> &warn.undocumented.func; </para> @@ -1082,13 +1070,13 @@ </refpurpose> </refnamediv> <refsect1> - <title>Description</title> - - <methodsynopsis> - <type>void</type><methodname>session_write_close</methodname> - <void/> - </methodsynopsis> - + <title>Beschreibung</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>session_write_close</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> <para> Beendet die aktuelle Session und speichert die Session-Daten. </para> @@ -1110,7 +1098,6 @@ See also: <function>session_readonly</function>. </para> --> - </refsect1> </refentry> @@ -1118,17 +1105,17 @@ <refentry id="function.session-readonly"> <refnamediv> <refname>session_readonly</refname> - <refpurpose>Begin session - reinitializes freezed variables, but - no writeback on request end</refpurpose> + <refpurpose>Begin session - reinitializes freezed variables, but no +writeback on request end</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> + <funcsynopsis> <funcprototype> <funcdef>void <function>session_readonly</function></funcdef> <void/> </funcprototype> - </methodsynopsis> + </funcsynopsis> <para> Read in session data without locking the session data. Changing session data is not possible, but frameset performance will be