cvs: phpdoc-de /reference/session ini.xml
| From: | Martin Samesch | Date: | Sat, 26 Oct 2002 10:36:42 +0000 |
| Subject: | cvs: phpdoc-de /reference/session ini.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-321@lists.php.net to get a copy of this message | ||
samesch Sat Oct 26 06:36:42 2002 EDT
Modified files:
/phpdoc-de/reference/session ini.xml
Log:
syncing with EN Rev. 1.7
Index: phpdoc-de/reference/session/ini.xml diff -u phpdoc-de/reference/session/ini.xml:1.3 phpdoc-de/reference/session/ini.xml:1.4 --- phpdoc-de/reference/session/ini.xml:1.3 Mon Oct 7 05:19:18 2002 +++ phpdoc-de/reference/session/ini.xml Sat Oct 26 06:36:41 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; @@ -131,234 +131,365 @@ Um weitere Details und die Definition der PHP_INI_*-Konstanten zu erhalten, siehe <function>ini_set</function>. </para> - <para> - Das Sessionmanagementsystem unterstützt eine Anzahl von - Konfigurationsoptionen, die Sie in Ihrer &php.ini; setzen können. - Wir geben Ihnen dazu einen kleinen Überblick. - <itemizedlist> - <listitem> - <simpara> - <literal>session.save_handler</literal> definiert den Namen - der Prozedur, die benutzt wird, um die Daten zu speichern und - zurückzuholen, die mit der Session in Verbindung stehen. - Grundeinstellung <literal>files</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.save_path</literal> definiert das Argument, - das an die Speicherprozedur übergeben wird. Wenn Sie die - standardmäßige files Prozedur wählen, ist das der Pfad, unter - dem die Dateien erzeugt werden. Grundeinstellung - <literal>/tmp</literal>. Wenn die Verzeichnistiefe von - <literal>session.save_path</literal> größer als zwei ist, wird - die Garbage-Collection nicht durchgeführt. - </simpara> - <warning> - <para> - Wenn Sie ein Verzeichnis gewählt haben, für das jeder - Leserechte hat, wie das z.B. bei /tmp (Grundeinstellung) der - Fall ist, könnten andere Serverbenutzer mit Hilfe der - Dateiliste dieses Verzeichnisses Ihre Sessions entführen. - </para> - </warning> - <note> - <simpara> - Benutzer von Windows müssen diese Variable ändern, um die - Session-Funktionen von PHP nutzen zu können. Stellen Sie - sicher, dass Sie einen gültigen Pfad, z.B. - <filename>c:/temp</filename>, angegeben haben. - </simpara> - </note> - </listitem> - <listitem> - <simpara> - <literal>session.name</literal> spezifiziert den Namen der - Session, der als Cookie-Name verwendet wird. Grundeinstellung - <literal>PHPSESSID</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.auto_start</literal> spezifiziert, ob das - Session-Modul zu Beginn einer Anfrage automatisch eine Session - startet. Grundeinstellung <literal>0</literal> (deaktiviert). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_lifetime</literal> spezifiziert die - Cookie-Lebensdauer, die an den Browser geschickt wird, in - Sekunden. Der Wert 0 bedeutet "bis der Browser geschlossen - wird." Grundeinstellung <literal>0</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.serialize_handler</literal> definiert den - Namen der Prozedur, die benutzt wird, um Daten zu - serialisieren/deserialisieren. Gegenwärtig wird ein internes - PHP-Format (Name <literal>php</literal>) und WDDX (name - <literal>wddx</literal>) unterstützt. WDDX steht nur zur - Verfügung, wenn PHP mit <link linkend="ref.wddx">WDDX - support</link> kompiliert wurde. Grundeinstellung - <literal>php</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_probability</literal> spezifiziert die - prozentuale Wahrscheinlichkeit, dass die gc (garbage - collection) Routine bei jeder Anfrage gestartet - wird. Grundeinstellung <literal>1</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_maxlifetime</literal> spezifiziert die - Anzahl der Sekunden, nach denen Daten als 'garbage' ('Müll') - betrachtet und entsorgt werden. - </simpara> - <note> - <simpara> - Falls Sie die standardmäßige dateibasierte Session-Prozedur - verwenden, muss Ihr Dateisystem die Zugriffszeiten (atime) - verfolgen. Windows FAT tut dies nicht. Sie müssen sich daher - einen anderen Weg einfallen lassen, um die 'Müllentsorgung' - Ihrer Session zu erledigen, wenn Sie an ein FAT-Dateisystem - gebunden sind oder an irgendein anderes Dateisystem, das - keine atime-Kontrolle bietet. - </simpara> - </note> - </listitem> - <listitem> - <simpara> - <literal>session.referer_check</literal> enthält die - Zeichenkette, auf die Sie jeden HTTP-Referer überprüfen - wollen. Wenn der Referer vom Client gesendet und die - Zeichenkette nicht gefunden wurde, wird die eingebettete - Session-ID als ungültig gekennzeichnet. Grundeinstellung ist - eine leere Zeichenkette. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_file</literal> gibt den Pfad zu einer - externen Quelle (Datei) an, die bei der Erzeugung einer - Session-ID als zusätzliche Entropiequelle verwendet - wird. Beispiele sind <literal>/dev/random</literal> oder - <literal>/dev/urandom</literal>, die auf vielen Unix-Systemen - zur Verfügung stehen. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_length</literal> spezifiziert die - Anzahl der Bytes, die von der oben spezifizierten Datei - gelesen werden. Grundeinstellung <literal>0</literal> - (deaktiviert). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_cookies</literal> spezifiziert, ob das - Modul Cookies verwendet, um die Session-ID clientseitig zu - speichern. Grundeinstellung <literal>1</literal> (aktiviert). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_only_cookies</literal> spezifiziert, ob - das Modul <emphasis role="strong">nur</emphasis> Cookies - verwendet, um die Session-ID clientseitig zu speichern. - Grundeinstellung <literal>0</literal> (deaktiviert, für - Rückwärts-Kompatibilität). Mit Aktivierung dieser Einstellung - wird möglichen Angriffen durch Übermittlung von Session-IDs in - URLs vorgebeugt. Diese Einstellung wurde in - <literal>PHP</literal> 4.3.0 hinzugefügt. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_path</literal> spezifiziert den Pfad, - in dem das Session-Cookie gesetzt wird. Grundeinstellung - <literal>/</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_domain</literal> spezifiziert die - Domain, unter der das Session-Cookie gesetzt wird. In der - Grundeinstellung überhaupt keine. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_limiter</literal> spezifiziert die - Methode der Cacheverwaltung, die bei Session-Seiten benutzt - wird (none/nocache/private/private_no_expire/public). - Grundeinstellung <literal>nocache</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_expire</literal> spezifiziert in - Minuten, wie lange Session-Seiten im Cache bleiben. Bei - nocache ist diese Angabe wirkungslos. Grundeinstellung - <literal>180</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_trans_sid</literal> bestimmt ob - transparente SID-Unterstützung aktiviert ist oder nicht. - Grundeinstellung <literal>0</literal> (deaktiviert). - </simpara> - <note> - <simpara> - In PHP 4.1.2 oder darunter wird sie durch compilieren mit - <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link> aktiviert. Ab - PHP 4.2.0 ist das Feature trans-sid immer eincompiliert. - </simpara> - <simpara> - URL-basiertes Session-Management hat im Vergleich zu - Cookie-basiertem Session-Management zusätzliche - Sicherheitsrisiken. Benutzer können zum Beispiel eine URL, - die eine aktive Session-ID enthält, per Email an Freunde - schicken oder in ihren Bookmarks speichern und immer mit der - selben Session-ID auf Ihre Seite zugreifen. - </simpara> - </note> - </listitem> - <listitem> - <simpara> - <literal>url_rewriter.tags</literal> bestimmt, wenn - Unterstützung für transparente SID aktiviert ist, welche - HTML-Tags so umgeschrieben werden, dass sie die Session-ID - beinhalten. Grundeinstellung - <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Die Konfigurationseinstellungen von - <link linkend="ini.track-vars"><literal>track_vars</literal></link> - und - <link - linkend="ini.register-globals"><literal>register_globals</literal></link> - beeinflussen, wie die Session-Variablen gespeichert und - wiederhergestellt werden. - </para> + <para> + Das Sessionmanagementsystem unterstützt eine Anzahl von + Konfigurationsoptionen, die Sie in Ihrer &php.ini; setzen können. + Wir geben Ihnen dazu einen kleinen Überblick. + <variablelist> + + <varlistentry id="ini.session.save-handler"> + <term> + <parameter>session.save_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_handler</literal> definiert den Namen der + Prozedur, die benutzt wird, um die Daten zu speichern und + zurückzuholen, die mit der Session in Verbindung stehen. + Grundeinstellung <literal>files</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.save-path"> + <term> + <parameter>session.save_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_path</literal> definiert das Argument, das + an die Speicherprozedur übergeben wird. Wenn Sie die + standardmäßige files Prozedur wählen, ist das der Pfad, unter + dem die Dateien erzeugt werden. Grundeinstellung + <literal>/tmp</literal>. Wenn die Verzeichnistiefe von + <literal>session.save_path</literal> größer als zwei ist, wird + die Garbage-Collection nicht durchgeführt. + </simpara> + <warning> + <para> + Wenn Sie ein Verzeichnis gewählt haben, für das jeder + Leserechte hat, wie das z.B. bei /tmp (Grundeinstellung) der + Fall ist, könnten andere Serverbenutzer mit Hilfe der + Dateiliste dieses Verzeichnisses Ihre Sessions entführen. + </para> + </warning> + <note> + <simpara> + Benutzer von Windows müssen diese Variable ändern, um die + Session-Funktionen von PHP nutzen zu können. Stellen Sie + sicher, dass Sie einen gültigen Pfad, z.B. + <filename>c:/temp</filename>, angegeben haben. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.name"> + <term> + <parameter>session.name</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.name</literal> spezifiziert den Namen der + Session, der als Cookie-Name verwendet wird. Grundeinstellung + <literal>PHPSESSID</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.auto-start"> + <term> + <parameter>session.auto_start</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.auto_start</literal> spezifiziert, ob das + Session-Modul zu Beginn einer Anfrage automatisch eine Session + startet. Grundeinstellung <literal>0</literal> (deaktiviert). + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cookie-lifetime"> + <term> + <parameter>session.cookie_lifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_lifetime</literal> spezifiziert die + Cookie-Lebensdauer, die an den Browser geschickt wird, in + Sekunden. Der Wert 0 bedeutet "bis der Browser geschlossen + wird." Grundeinstellung <literal>0</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.serialize-handler"> + <term> + <parameter>session.serialize_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.serialize_handler</literal> definiert den Namen + der Prozedur, die benutzt wird, um Daten zu + serialisieren/deserialisieren. Gegenwärtig wird ein internes + PHP-Format (Name <literal>php</literal>) und WDDX (name + <literal>wddx</literal>) unterstützt. WDDX steht nur zur + Verfügung, wenn PHP mit <link linkend="ref.wddx">WDDX + support</link> kompiliert wurde. Grundeinstellung + <literal>php</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.gc-probability"> + <term> + <parameter>session.gc_probability</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_probability</literal> spezifiziert die + prozentuale Wahrscheinlichkeit, dass die gc (garbage collection) + Routine bei jeder Anfrage gestartet wird. Grundeinstellung + <literal>1</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.gc-maxlifetime"> + <term> + <parameter>session.gc_maxlifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_maxlifetime</literal> spezifiziert die + Anzahl der Sekunden, nach denen Daten als 'garbage' ('Müll') + betrachtet und entsorgt werden. + </simpara> + <note> + <simpara> + Falls Sie die standardmäßige dateibasierte Session-Prozedur + verwenden, muss Ihr Dateisystem die Zugriffszeiten (atime) + verfolgen. Windows FAT tut dies nicht. Sie müssen sich daher + einen anderen Weg einfallen lassen, um die 'Müllentsorgung' + Ihrer Session zu erledigen, wenn Sie an ein FAT-Dateisystem + gebunden sind oder an irgendein anderes Dateisystem, das keine + atime-Kontrolle bietet. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.referer-check"> + <term> + <parameter>session.referer_check</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.referer_check</literal> enthält die + Zeichenkette, auf die Sie jeden HTTP-Referer überprüfen wollen. + Wenn der Referer vom Client gesendet und die Zeichenkette nicht + gefunden wurde, wird die eingebettete Session-ID als ungültig + gekennzeichnet. Grundeinstellung ist eine leere Zeichenkette. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.entropy-file"> + <term> + <parameter>session.entropy_file</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_file</literal> gibt den Pfad zu einer + externen Quelle (Datei) an, die bei der Erzeugung einer + Session-ID als zusätzliche Entropiequelle verwendet wird. + Beispiele sind <literal>/dev/random</literal> oder + <literal>/dev/urandom</literal>, die auf vielen Unix-Systemen + zur Verfügung stehen. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.entropy-length"> + <term> + <parameter>session.entropy_length</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_length</literal> spezifiziert die + Anzahl der Bytes, die von der oben spezifizierten Datei gelesen + werden. Grundeinstellung <literal>0</literal> (deaktiviert). + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.use-cookies"> + <term> + <parameter>session.use_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_cookies</literal> spezifiziert, ob das + Modul Cookies verwendet, um die Session-ID clientseitig zu + speichern. Grundeinstellung <literal>1</literal> (aktiviert). + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.use-only_cookies"> + <term> + <parameter>session.use_only_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_only_cookies</literal> spezifiziert, ob das + Modul <emphasis role="strong">nur</emphasis> Cookies verwendet, + um die Session-ID clientseitig zu speichern. Grundeinstellung + <literal>0</literal> (deaktiviert, für + Rückwärts-Kompatibilität). Mit Aktivierung dieser Einstellung + wird möglichen Angriffen durch Übermittlung von Session-IDs in + URLs vorgebeugt. Diese Einstellung wurde in + <literal>PHP</literal> 4.3.0 hinzugefügt. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cookie-path"> + <term> + <parameter>session.cookie_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_path</literal> spezifiziert den Pfad, in + dem das Session-Cookie gesetzt wird. Grundeinstellung + <literal>/</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cookie-domain"> + <term> + <parameter>session.cookie_domain</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_domain</literal> spezifiziert die + Domain, unter der das Session-Cookie gesetzt wird. In der + Grundeinstellung überhaupt keine. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cache-limiter"> + <term> + <parameter>session.cache_limiter</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cache_limiter</literal> spezifiziert die + Methode der Cacheverwaltung, die bei Session-Seiten benutzt wird + (none/nocache/private/private_no_expire/public). + Grundeinstellung <literal>nocache</literal>. + </simpara> + </listitem> + </varlistentry> + + + <varlistentry id="ini.session.cache-expire"> + <term> + <parameter>session.cache_expire</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cache_expire</literal> spezifiziert in Minuten, + wie lange Session-Seiten im Cache bleiben. Bei nocache ist diese + Angabe wirkungslos. Grundeinstellung <literal>180</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.use-trans_sid"> + <term> + <parameter>session.use_trans_sid</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_trans_sid</literal> bestimmt ob + transparente SID-Unterstützung aktiviert ist oder nicht. + Grundeinstellung <literal>0</literal> (deaktiviert). + </simpara> + <note> + <simpara> + In PHP 4.1.2 oder darunter wird sie durch compilieren mit + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link> aktiviert. Ab PHP + 4.2.0 ist das Feature trans-sid immer eincompiliert. + </simpara> + <simpara> + URL-basiertes Session-Management hat im Vergleich zu + Cookie-basiertem Session-Management zusätzliche + Sicherheitsrisiken. Benutzer können zum Beispiel eine URL, die + eine aktive Session-ID enthält, per Email an Freunde schicken + oder in ihren Bookmarks speichern und immer mit der selben + Session-ID auf Ihre Seite zugreifen. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.url-rewriter.tags"> + <term> + <parameter>url_rewriter.tags</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>url_rewriter.tags</literal> bestimmt, wenn + Unterstützung für transparente SID aktiviert ist, welche + HTML-Tags so umgeschrieben werden, dass sie die Session-ID + beinhalten. Grundeinstellung + <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + + <para> + Die Konfigurationseinstellungen von <link + linkend="ini.track-vars"><literal>track_vars</literal></link> und + <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + beeinflussen, wie die Session-Variablen gespeichert und + wiederhergestellt werden. + </para> - <note> - <para> - Seit PHP 4.0.3 ist - <link linkend="ini.track-vars"><literal>track_vars</literal></link> - immer aktiviert. - </para> - </note> + <note> + <para> + Seit PHP 4.0.3 ist <link + linkend="ini.track-vars"><literal>track_vars</literal></link> immer + aktiviert. + </para> + </note> </section>
Index: phpdoc-de/reference/session/ini.xml diff -u phpdoc-de/reference/session/ini.xml:1.3 phpdoc-de/reference/session/ini.xml:1.4 --- phpdoc-de/reference/session/ini.xml:1.3 Mon Oct 7 05:19:18 2002 +++ phpdoc-de/reference/session/ini.xml Sat Oct 26 06:36:41 2002 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: samesch Status: ready --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; @@ -131,234 +131,365 @@ Um weitere Details und die Definition der PHP_INI_*-Konstanten zu erhalten, siehe <function>ini_set</function>. </para> - <para> - Das Sessionmanagementsystem unterstützt eine Anzahl von - Konfigurationsoptionen, die Sie in Ihrer &php.ini; setzen können. - Wir geben Ihnen dazu einen kleinen Überblick. - <itemizedlist> - <listitem> - <simpara> - <literal>session.save_handler</literal> definiert den Namen - der Prozedur, die benutzt wird, um die Daten zu speichern und - zurückzuholen, die mit der Session in Verbindung stehen. - Grundeinstellung <literal>files</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.save_path</literal> definiert das Argument, - das an die Speicherprozedur übergeben wird. Wenn Sie die - standardmäßige files Prozedur wählen, ist das der Pfad, unter - dem die Dateien erzeugt werden. Grundeinstellung - <literal>/tmp</literal>. Wenn die Verzeichnistiefe von - <literal>session.save_path</literal> größer als zwei ist, wird - die Garbage-Collection nicht durchgeführt. - </simpara> - <warning> - <para> - Wenn Sie ein Verzeichnis gewählt haben, für das jeder - Leserechte hat, wie das z.B. bei /tmp (Grundeinstellung) der - Fall ist, könnten andere Serverbenutzer mit Hilfe der - Dateiliste dieses Verzeichnisses Ihre Sessions entführen. - </para> - </warning> - <note> - <simpara> - Benutzer von Windows müssen diese Variable ändern, um die - Session-Funktionen von PHP nutzen zu können. Stellen Sie - sicher, dass Sie einen gültigen Pfad, z.B. - <filename>c:/temp</filename>, angegeben haben. - </simpara> - </note> - </listitem> - <listitem> - <simpara> - <literal>session.name</literal> spezifiziert den Namen der - Session, der als Cookie-Name verwendet wird. Grundeinstellung - <literal>PHPSESSID</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.auto_start</literal> spezifiziert, ob das - Session-Modul zu Beginn einer Anfrage automatisch eine Session - startet. Grundeinstellung <literal>0</literal> (deaktiviert). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_lifetime</literal> spezifiziert die - Cookie-Lebensdauer, die an den Browser geschickt wird, in - Sekunden. Der Wert 0 bedeutet "bis der Browser geschlossen - wird." Grundeinstellung <literal>0</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.serialize_handler</literal> definiert den - Namen der Prozedur, die benutzt wird, um Daten zu - serialisieren/deserialisieren. Gegenwärtig wird ein internes - PHP-Format (Name <literal>php</literal>) und WDDX (name - <literal>wddx</literal>) unterstützt. WDDX steht nur zur - Verfügung, wenn PHP mit <link linkend="ref.wddx">WDDX - support</link> kompiliert wurde. Grundeinstellung - <literal>php</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_probability</literal> spezifiziert die - prozentuale Wahrscheinlichkeit, dass die gc (garbage - collection) Routine bei jeder Anfrage gestartet - wird. Grundeinstellung <literal>1</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.gc_maxlifetime</literal> spezifiziert die - Anzahl der Sekunden, nach denen Daten als 'garbage' ('Müll') - betrachtet und entsorgt werden. - </simpara> - <note> - <simpara> - Falls Sie die standardmäßige dateibasierte Session-Prozedur - verwenden, muss Ihr Dateisystem die Zugriffszeiten (atime) - verfolgen. Windows FAT tut dies nicht. Sie müssen sich daher - einen anderen Weg einfallen lassen, um die 'Müllentsorgung' - Ihrer Session zu erledigen, wenn Sie an ein FAT-Dateisystem - gebunden sind oder an irgendein anderes Dateisystem, das - keine atime-Kontrolle bietet. - </simpara> - </note> - </listitem> - <listitem> - <simpara> - <literal>session.referer_check</literal> enthält die - Zeichenkette, auf die Sie jeden HTTP-Referer überprüfen - wollen. Wenn der Referer vom Client gesendet und die - Zeichenkette nicht gefunden wurde, wird die eingebettete - Session-ID als ungültig gekennzeichnet. Grundeinstellung ist - eine leere Zeichenkette. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_file</literal> gibt den Pfad zu einer - externen Quelle (Datei) an, die bei der Erzeugung einer - Session-ID als zusätzliche Entropiequelle verwendet - wird. Beispiele sind <literal>/dev/random</literal> oder - <literal>/dev/urandom</literal>, die auf vielen Unix-Systemen - zur Verfügung stehen. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.entropy_length</literal> spezifiziert die - Anzahl der Bytes, die von der oben spezifizierten Datei - gelesen werden. Grundeinstellung <literal>0</literal> - (deaktiviert). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_cookies</literal> spezifiziert, ob das - Modul Cookies verwendet, um die Session-ID clientseitig zu - speichern. Grundeinstellung <literal>1</literal> (aktiviert). - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_only_cookies</literal> spezifiziert, ob - das Modul <emphasis role="strong">nur</emphasis> Cookies - verwendet, um die Session-ID clientseitig zu speichern. - Grundeinstellung <literal>0</literal> (deaktiviert, für - Rückwärts-Kompatibilität). Mit Aktivierung dieser Einstellung - wird möglichen Angriffen durch Übermittlung von Session-IDs in - URLs vorgebeugt. Diese Einstellung wurde in - <literal>PHP</literal> 4.3.0 hinzugefügt. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_path</literal> spezifiziert den Pfad, - in dem das Session-Cookie gesetzt wird. Grundeinstellung - <literal>/</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cookie_domain</literal> spezifiziert die - Domain, unter der das Session-Cookie gesetzt wird. In der - Grundeinstellung überhaupt keine. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_limiter</literal> spezifiziert die - Methode der Cacheverwaltung, die bei Session-Seiten benutzt - wird (none/nocache/private/private_no_expire/public). - Grundeinstellung <literal>nocache</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.cache_expire</literal> spezifiziert in - Minuten, wie lange Session-Seiten im Cache bleiben. Bei - nocache ist diese Angabe wirkungslos. Grundeinstellung - <literal>180</literal>. - </simpara> - </listitem> - <listitem> - <simpara> - <literal>session.use_trans_sid</literal> bestimmt ob - transparente SID-Unterstützung aktiviert ist oder nicht. - Grundeinstellung <literal>0</literal> (deaktiviert). - </simpara> - <note> - <simpara> - In PHP 4.1.2 oder darunter wird sie durch compilieren mit - <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link> aktiviert. Ab - PHP 4.2.0 ist das Feature trans-sid immer eincompiliert. - </simpara> - <simpara> - URL-basiertes Session-Management hat im Vergleich zu - Cookie-basiertem Session-Management zusätzliche - Sicherheitsrisiken. Benutzer können zum Beispiel eine URL, - die eine aktive Session-ID enthält, per Email an Freunde - schicken oder in ihren Bookmarks speichern und immer mit der - selben Session-ID auf Ihre Seite zugreifen. - </simpara> - </note> - </listitem> - <listitem> - <simpara> - <literal>url_rewriter.tags</literal> bestimmt, wenn - Unterstützung für transparente SID aktiviert ist, welche - HTML-Tags so umgeschrieben werden, dass sie die Session-ID - beinhalten. Grundeinstellung - <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Die Konfigurationseinstellungen von - <link linkend="ini.track-vars"><literal>track_vars</literal></link> - und - <link - linkend="ini.register-globals"><literal>register_globals</literal></link> - beeinflussen, wie die Session-Variablen gespeichert und - wiederhergestellt werden. - </para> + <para> + Das Sessionmanagementsystem unterstützt eine Anzahl von + Konfigurationsoptionen, die Sie in Ihrer &php.ini; setzen können. + Wir geben Ihnen dazu einen kleinen Überblick. + <variablelist> + + <varlistentry id="ini.session.save-handler"> + <term> + <parameter>session.save_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_handler</literal> definiert den Namen der + Prozedur, die benutzt wird, um die Daten zu speichern und + zurückzuholen, die mit der Session in Verbindung stehen. + Grundeinstellung <literal>files</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.save-path"> + <term> + <parameter>session.save_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_path</literal> definiert das Argument, das + an die Speicherprozedur übergeben wird. Wenn Sie die + standardmäßige files Prozedur wählen, ist das der Pfad, unter + dem die Dateien erzeugt werden. Grundeinstellung + <literal>/tmp</literal>. Wenn die Verzeichnistiefe von + <literal>session.save_path</literal> größer als zwei ist, wird + die Garbage-Collection nicht durchgeführt. + </simpara> + <warning> + <para> + Wenn Sie ein Verzeichnis gewählt haben, für das jeder + Leserechte hat, wie das z.B. bei /tmp (Grundeinstellung) der + Fall ist, könnten andere Serverbenutzer mit Hilfe der + Dateiliste dieses Verzeichnisses Ihre Sessions entführen. + </para> + </warning> + <note> + <simpara> + Benutzer von Windows müssen diese Variable ändern, um die + Session-Funktionen von PHP nutzen zu können. Stellen Sie + sicher, dass Sie einen gültigen Pfad, z.B. + <filename>c:/temp</filename>, angegeben haben. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.name"> + <term> + <parameter>session.name</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.name</literal> spezifiziert den Namen der + Session, der als Cookie-Name verwendet wird. Grundeinstellung + <literal>PHPSESSID</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.auto-start"> + <term> + <parameter>session.auto_start</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.auto_start</literal> spezifiziert, ob das + Session-Modul zu Beginn einer Anfrage automatisch eine Session + startet. Grundeinstellung <literal>0</literal> (deaktiviert). + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cookie-lifetime"> + <term> + <parameter>session.cookie_lifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_lifetime</literal> spezifiziert die + Cookie-Lebensdauer, die an den Browser geschickt wird, in + Sekunden. Der Wert 0 bedeutet "bis der Browser geschlossen + wird." Grundeinstellung <literal>0</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.serialize-handler"> + <term> + <parameter>session.serialize_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.serialize_handler</literal> definiert den Namen + der Prozedur, die benutzt wird, um Daten zu + serialisieren/deserialisieren. Gegenwärtig wird ein internes + PHP-Format (Name <literal>php</literal>) und WDDX (name + <literal>wddx</literal>) unterstützt. WDDX steht nur zur + Verfügung, wenn PHP mit <link linkend="ref.wddx">WDDX + support</link> kompiliert wurde. Grundeinstellung + <literal>php</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.gc-probability"> + <term> + <parameter>session.gc_probability</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_probability</literal> spezifiziert die + prozentuale Wahrscheinlichkeit, dass die gc (garbage collection) + Routine bei jeder Anfrage gestartet wird. Grundeinstellung + <literal>1</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.gc-maxlifetime"> + <term> + <parameter>session.gc_maxlifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_maxlifetime</literal> spezifiziert die + Anzahl der Sekunden, nach denen Daten als 'garbage' ('Müll') + betrachtet und entsorgt werden. + </simpara> + <note> + <simpara> + Falls Sie die standardmäßige dateibasierte Session-Prozedur + verwenden, muss Ihr Dateisystem die Zugriffszeiten (atime) + verfolgen. Windows FAT tut dies nicht. Sie müssen sich daher + einen anderen Weg einfallen lassen, um die 'Müllentsorgung' + Ihrer Session zu erledigen, wenn Sie an ein FAT-Dateisystem + gebunden sind oder an irgendein anderes Dateisystem, das keine + atime-Kontrolle bietet. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.referer-check"> + <term> + <parameter>session.referer_check</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.referer_check</literal> enthält die + Zeichenkette, auf die Sie jeden HTTP-Referer überprüfen wollen. + Wenn der Referer vom Client gesendet und die Zeichenkette nicht + gefunden wurde, wird die eingebettete Session-ID als ungültig + gekennzeichnet. Grundeinstellung ist eine leere Zeichenkette. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.entropy-file"> + <term> + <parameter>session.entropy_file</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_file</literal> gibt den Pfad zu einer + externen Quelle (Datei) an, die bei der Erzeugung einer + Session-ID als zusätzliche Entropiequelle verwendet wird. + Beispiele sind <literal>/dev/random</literal> oder + <literal>/dev/urandom</literal>, die auf vielen Unix-Systemen + zur Verfügung stehen. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.entropy-length"> + <term> + <parameter>session.entropy_length</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_length</literal> spezifiziert die + Anzahl der Bytes, die von der oben spezifizierten Datei gelesen + werden. Grundeinstellung <literal>0</literal> (deaktiviert). + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.use-cookies"> + <term> + <parameter>session.use_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_cookies</literal> spezifiziert, ob das + Modul Cookies verwendet, um die Session-ID clientseitig zu + speichern. Grundeinstellung <literal>1</literal> (aktiviert). + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.use-only_cookies"> + <term> + <parameter>session.use_only_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_only_cookies</literal> spezifiziert, ob das + Modul <emphasis role="strong">nur</emphasis> Cookies verwendet, + um die Session-ID clientseitig zu speichern. Grundeinstellung + <literal>0</literal> (deaktiviert, für + Rückwärts-Kompatibilität). Mit Aktivierung dieser Einstellung + wird möglichen Angriffen durch Übermittlung von Session-IDs in + URLs vorgebeugt. Diese Einstellung wurde in + <literal>PHP</literal> 4.3.0 hinzugefügt. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cookie-path"> + <term> + <parameter>session.cookie_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_path</literal> spezifiziert den Pfad, in + dem das Session-Cookie gesetzt wird. Grundeinstellung + <literal>/</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cookie-domain"> + <term> + <parameter>session.cookie_domain</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_domain</literal> spezifiziert die + Domain, unter der das Session-Cookie gesetzt wird. In der + Grundeinstellung überhaupt keine. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.cache-limiter"> + <term> + <parameter>session.cache_limiter</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cache_limiter</literal> spezifiziert die + Methode der Cacheverwaltung, die bei Session-Seiten benutzt wird + (none/nocache/private/private_no_expire/public). + Grundeinstellung <literal>nocache</literal>. + </simpara> + </listitem> + </varlistentry> + + + <varlistentry id="ini.session.cache-expire"> + <term> + <parameter>session.cache_expire</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cache_expire</literal> spezifiziert in Minuten, + wie lange Session-Seiten im Cache bleiben. Bei nocache ist diese + Angabe wirkungslos. Grundeinstellung <literal>180</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry id="ini.session.use-trans_sid"> + <term> + <parameter>session.use_trans_sid</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_trans_sid</literal> bestimmt ob + transparente SID-Unterstützung aktiviert ist oder nicht. + Grundeinstellung <literal>0</literal> (deaktiviert). + </simpara> + <note> + <simpara> + In PHP 4.1.2 oder darunter wird sie durch compilieren mit + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link> aktiviert. Ab PHP + 4.2.0 ist das Feature trans-sid immer eincompiliert. + </simpara> + <simpara> + URL-basiertes Session-Management hat im Vergleich zu + Cookie-basiertem Session-Management zusätzliche + Sicherheitsrisiken. Benutzer können zum Beispiel eine URL, die + eine aktive Session-ID enthält, per Email an Freunde schicken + oder in ihren Bookmarks speichern und immer mit der selben + Session-ID auf Ihre Seite zugreifen. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry id="ini.url-rewriter.tags"> + <term> + <parameter>url_rewriter.tags</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>url_rewriter.tags</literal> bestimmt, wenn + Unterstützung für transparente SID aktiviert ist, welche + HTML-Tags so umgeschrieben werden, dass sie die Session-ID + beinhalten. Grundeinstellung + <literal>a=href,area=href,frame=src,input=src,form=fakeentry</literal> + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + + <para> + Die Konfigurationseinstellungen von <link + linkend="ini.track-vars"><literal>track_vars</literal></link> und + <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + beeinflussen, wie die Session-Variablen gespeichert und + wiederhergestellt werden. + </para> - <note> - <para> - Seit PHP 4.0.3 ist - <link linkend="ini.track-vars"><literal>track_vars</literal></link> - immer aktiviert. - </para> - </note> + <note> + <para> + Seit PHP 4.0.3 ist <link + linkend="ini.track-vars"><literal>track_vars</literal></link> immer + aktiviert. + </para> + </note> </section>