cvs: phpdoc-de /reference/session ini.xml

samesch Fri Oct 4 07:31:57 2002 EDT Added files: /phpdoc-de/reference/session ini.xml Log: adding; in sync with EN-Rev. 1.5

Index: phpdoc-de/reference/session/ini.xml +++ phpdoc-de/reference/session/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> <section id="session.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Session-Konfigurationsoptionen</title> <tgroup cols="3"> <thead> <row> <entry>Bezeichnung</entry> <entry>Grundeinstellung</entry> <entry>Änderbar</entry> </row> </thead> <tbody> <row> <entry>session.save_path</entry> <entry>"/tmp"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.name</entry> <entry>"PHPSESSID"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.save_handler</entry> <entry>"files"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.auto_start</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_probability</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.gc_maxlifetime</entry> <entry>"1440"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.serialize_handler</entry> <entry>"php"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_lifetime</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_path</entry> <entry>"/"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_domain</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cookie_secure</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_cookies</entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_only_cookies</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.referer_check</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_file</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.entropy_length</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_limiter</entry> <entry>"nocache"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.cache_expire</entry> <entry>"180"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>session.use_trans_sid</entry> <entry>"0"</entry> <entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry> </row> <row> <entry>url_rewriter.tags</entry> <entry>"a=href,area=href,frame=src,input=src,form=fakeentry"</entry> <entry>PHP_INI_ALL</entry> </row> <!-- Not yet <row> <entry>session.encode_sources</entry> <entry>"globals</entry> <entry>track"</entry> </row> --> </tbody> </tgroup> </table> 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> 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> <note> <para> Seit PHP 4.0.3 ist <link linkend="ini.track-vars"><literal>track_vars</literal></link> immer aktiviert. </para> </note> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->