cvs: phpdoc-de /reference/session reference.xml
| From: | Martin Samesch | Date: | Sat, 01 Feb 2003 17:34:02 +0000 |
| Subject: | cvs: phpdoc-de /reference/session reference.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-494@lists.php.net to get a copy of this message | ||
samesch Sat Feb 1 12:34:02 2003 EDT
Modified files:
/phpdoc-de/reference/session reference.xml
Log:
syncing with EN Rev. 1.30
Index: phpdoc-de/reference/session/reference.xml diff -u phpdoc-de/reference/session/reference.xml:1.13 phpdoc-de/reference/session/reference.xml:1.14 --- phpdoc-de/reference/session/reference.xml:1.13 Fri Jan 31 13:10:10 2003 +++ phpdoc-de/reference/session/reference.xml Sat Feb 1 12:34:02 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.27 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.30 Maintainer: samesch Status: ready --> <reference id="ref.session"> <title>Session Funktionen</title> <titleabbrev>Sessions</titleabbrev> @@ -10,11 +10,10 @@ <section id="session.intro"> &reftitle.intro; <para> - Die Unterstützung von Sessions in PHP bietet die - Möglichkeit, bestimmte Daten während einer Folge - von Aufrufen Ihrer Website festzuhalten. Damit können Sie - persönlichere Applikationen erstellen und Ihre Website - ansprechender gestalten. + Die Unterstützung von Sessions in PHP bietet die Möglichkeit, + bestimmte Daten während einer Folge von Aufrufen Ihrer Website + festzuhalten. Damit können Sie persönlichere Applikationen + erstellen und Ihre Website ansprechender gestalten. </para> <para> Falls Sie mit dem Sessionmanagment von PHPLIB vertraut sind, @@ -31,8 +30,8 @@ Die Unterstützung von Sessions erlaubt Ihnen, eine beliebige Anzahl von Variablen zu registrieren und diese über Anfragen hinweg zu erhalten. Wenn ein Besucher Ihre Website aufruft, - überprüft PHP automatisch (falls session.auto_start auf - 1 gesetzt ist) oder auf Anfrage (explizit durch + überprüft PHP automatisch (falls session.auto_start auf 1 gesetzt + ist) oder auf Anfrage (explizit durch <function>session_start</function> oder implizit durch <function>session_register</function>), ob mit der Anfrage schon eine bestimmte Session-ID gesendet wurde. Wenn dies der Fall ist, @@ -64,7 +63,7 @@ </section> <section id="session.security"> - <title>Sessions and security</title> + <title>Sessions und Sicherheit</title> <para> Externe Links: <ulink url="&url.session-fixation;">Session fixation</ulink> @@ -74,16 +73,19 @@ Informationen, die Sie in einer Session speichern, nur vom Benutzer gesehen werden können, der die Session erzeugt hat. Sie müssen zusätzliche Maßnahmen ergreifen, um die Integrität der - Session ihrer Wichtigkeit angemessen aktiv zu schützen. + Session ihrer Wichtigkeit entsprechend angemessen aktiv zu + schützen. </para> <para> Schätzen Sie die Wichtigkeit der Daten ab, die in Ihren Sessions transportiert werden und treffen Sie zusätzliche Schutzmaßnahmen -- in der Regel bezahlen Sie dafür mit einer geringeren - Benutzerfreundlichkeit. - Wenn Sie z.B. Benutzer vor "simple social engineering tactics" - schützen wollen, müssen Sie session.use_only_cookies aktivieren. - Cookies müssen dann auf jeden Fall aktiviert sein. + Benutzerfreundlichkeit. Wenn Sie z.B. Benutzer vor einfachen + Social Engineering Tactics (Anm. des Übersetzers: Techniken der + Ausnutzung menschlicher Schwächen) schützen wollen, müssen Sie + <literal>session.use_only_cookies</literal> aktivieren. Cookies + müssen dann benutzerseitig auf jeden Fall aktiviert sein, weil + Sessions sonst nicht funktionieren. </para> <para> Es gibt mehrere Wege, über die eine Sessio-ID an Dritte gelangen @@ -105,15 +107,17 @@ &no.requirement; <note> <para> - Optionally you can use shared memory allocation (mm), developed - by Ralf S. Engelschall, for session storage. You have to - download <ulink url="&url.mm;">mm</ulink> and install it. This - option is not available for Windows platforms. Note that the - session storage module for mm does not guarantee that concurrent - accesses to the same session are properly locked. It might be - more appropiate to use a shared memory based filesystem (such as - tmpfs on Solaris/Linux, or /dev/md on BSD) to store sessions in - files, because they are properly locked. + Optional können Sie für die Speicherung von Sessions die von + Ralf S. Engelschall entwickelte Shared Memory Allocation (mm) + verwenden. Sie müssen dazu <ulink url="&url.mm;">mm</ulink> + herunterladen und installieren. Für Windows-Plattformen steht + diese Option nicht zur Verfügung. Beachten Sie, dass das + Sessionspeicherungs-Modul für mm nicht dafür garantiert, dass + gleichzeitige Zugriffe auf die selbe Session richtig gesperrt + sind. Die Verwendung eines auf Shared Memory basierenden + Dateisystems (wie z.B. tmpfs unter Solaris/Linux oder /dev/md + unter BSD) könnte für die Speicherung von Sessions in Dateien + geeigneter sein, weil sie entsprechend gesperrt sind. </para> </note> </section> @@ -145,7 +149,9 @@ nun überall <varname>$_SESSION</varname> verwendet wird. Sie können <varname>$_SESSION</varname> durch <varname>$HTTP_SESSION_VARS</varname> ersetzen, wenn Sie - Letzteres bevorzugen. + Letzteres bevorzugen. Beachten Sie auch, dass Sie Ihre Session + mit <function>session_start</function> starten müssen, bevor die + Verwendung von <varname>$_SESSION</varname> zur Verfügung steht. </para> <para> Für die Schlüssel des assoziativen @@ -179,7 +185,7 @@ zugegriffen werden. <example> <title> - Registrierung einer Variablen mit $_SESSION. + Registrierung einer Variablen mit <varname>$_SESSION</varname>. </title> <programlisting role="php"> <![CDATA[ @@ -197,8 +203,9 @@ </example> <example> <title> - Aufheben der Registrierung einer Variablen mit $_SESSION und - deaktiviertem register_globals. + Aufheben der Registrierung einer Variablen mit + <varname>$_SESSION</varname> und deaktiviertem <link + linkend="ini.register-globals"><literal>register_globals</literal></link>. </title> <programlisting role="php"> <![CDATA[ @@ -213,7 +220,9 @@ <example> <title> Aufheben der Registrierung einer Variablen mit aktiviertem - register_globals, nachdem sie unter Verwendung von $_SESSION + <link + linkend="ini.register-globals"><literal>register_globals</literal></link>, + nachdem sie unter Verwendung von <varname>$_SESSION</varname> registriert wurde. </title> <programlisting role="php"> @@ -229,7 +238,8 @@ </para> <para> Wenn - <link linkend="ini.register-globals"><literal>register_globals</literal></link> + <link + linkend="ini.register-globals"><literal>register_globals</literal></link> aktiviert ist, kann jede globalen Variable als Session-Variable registriert werden. Beim Neustart einer Session werden diese Variablen als entsprechende globale Variablen wiederhergestellt. @@ -255,11 +265,10 @@ aktivieren, sollten Sie <function>session_unregister</function> verwenden, weil beim Deserialisieren von Session-Daten die Session-Variablen als globale Variablen registriert werden. Die - Deaktivierung von - <link + Deaktivierung von <link linkend="ini.register-globals"><literal>register_globals</literal></link> - ist sowohl aus Sicherheitsgründen als auch wegen - der Performance empfehlenswert. + ist sowohl aus Sicherheitsgründen als auch wegen der + Performance empfehlenswert. </para> </caution> <example> @@ -332,8 +341,9 @@ Übersetzen von PHP manuell aktivieren. Unter UNIX müssen Sie dazu configure mit <link linkend="install.configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link> aufrufen. Wenn diese - Option und die Laufzeit-Option session.use_trans_sid aktiviert - sind, werden relative URIs automatisch so geändert, dass sie die + Option und die Laufzeit-Option + <literal>session.use_trans_sid</literal> aktiviert sind, werden + relative URIs automatisch so geändert, dass sie die Session-ID enthalten. <note> <para> @@ -345,12 +355,12 @@ </note> </para> <para> - Alternatively, you can use the constant <literal>SID</literal> - which is always defined. If the client did not send an - appropriate session cookie, it has the form - <literal>session_name=session_id</literal>. Otherwise, it - expands to an empty string. Thus, you can embed it - unconditionally into URLs. + Alternativ können Sie die Konstante <literal>SID</literal> + verwenden, die immer definiert ist. Falls der Client kein + geeignetes Session-Cookie gesendet hat, hat sie die Form + <literal>session_name=session_id</literal>. Andernfalls wird sie + zu einer leeren Zeichenkette erweitert. Aus diesem Grund können + Sie sie bedingungslos in URLs einbetten. </para> <para> Das folgende Beispiel demonstriert, wie eine Variable registriert @@ -385,17 +395,17 @@ <literal><?php echo SID?></literal> nötig, um die Session-ID zu erhalten (wenn <link linkend="ini.short-open-tag">short_open_tag</link> aktiviert ist, - kann <literal><?=SID?></literal> verwendet - werden). Das <literal><?=SID?></literal> ist nicht nötig, - wenn PHP mit <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link> kompiliert wurde. + kann <literal><?=SID?></literal> verwendet werden). Das + <literal><?=SID?></literal> ist nicht nötig, wenn PHP mit + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link> übersetzt wurde. </para> <note> <para> Bei nichtrelativen URLs wird davon ausgegangen, dass sie auf - externe Seiten zeigen und, weil es ein Sicherheitsrisiko wäre, - die SID an einen anderen Server zu übermitteln, von daher wird - keine SID angehängt. + externe Seiten zeigen und deshalb keine SID angehängt, weil es + ein Sicherheitsrisiko wäre, die SID an einen anderen Server zu + übermitteln. </para> </note> <para>
Index: phpdoc-de/reference/session/reference.xml diff -u phpdoc-de/reference/session/reference.xml:1.13 phpdoc-de/reference/session/reference.xml:1.14 --- phpdoc-de/reference/session/reference.xml:1.13 Fri Jan 31 13:10:10 2003 +++ phpdoc-de/reference/session/reference.xml Sat Feb 1 12:34:02 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.27 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.30 Maintainer: samesch Status: ready --> <reference id="ref.session"> <title>Session Funktionen</title> <titleabbrev>Sessions</titleabbrev> @@ -10,11 +10,10 @@ <section id="session.intro"> &reftitle.intro; <para> - Die Unterstützung von Sessions in PHP bietet die - Möglichkeit, bestimmte Daten während einer Folge - von Aufrufen Ihrer Website festzuhalten. Damit können Sie - persönlichere Applikationen erstellen und Ihre Website - ansprechender gestalten. + Die Unterstützung von Sessions in PHP bietet die Möglichkeit, + bestimmte Daten während einer Folge von Aufrufen Ihrer Website + festzuhalten. Damit können Sie persönlichere Applikationen + erstellen und Ihre Website ansprechender gestalten. </para> <para> Falls Sie mit dem Sessionmanagment von PHPLIB vertraut sind, @@ -31,8 +30,8 @@ Die Unterstützung von Sessions erlaubt Ihnen, eine beliebige Anzahl von Variablen zu registrieren und diese über Anfragen hinweg zu erhalten. Wenn ein Besucher Ihre Website aufruft, - überprüft PHP automatisch (falls session.auto_start auf - 1 gesetzt ist) oder auf Anfrage (explizit durch + überprüft PHP automatisch (falls session.auto_start auf 1 gesetzt + ist) oder auf Anfrage (explizit durch <function>session_start</function> oder implizit durch <function>session_register</function>), ob mit der Anfrage schon eine bestimmte Session-ID gesendet wurde. Wenn dies der Fall ist, @@ -64,7 +63,7 @@ </section> <section id="session.security"> - <title>Sessions and security</title> + <title>Sessions und Sicherheit</title> <para> Externe Links: <ulink url="&url.session-fixation;">Session fixation</ulink> @@ -74,16 +73,19 @@ Informationen, die Sie in einer Session speichern, nur vom Benutzer gesehen werden können, der die Session erzeugt hat. Sie müssen zusätzliche Maßnahmen ergreifen, um die Integrität der - Session ihrer Wichtigkeit angemessen aktiv zu schützen. + Session ihrer Wichtigkeit entsprechend angemessen aktiv zu + schützen. </para> <para> Schätzen Sie die Wichtigkeit der Daten ab, die in Ihren Sessions transportiert werden und treffen Sie zusätzliche Schutzmaßnahmen -- in der Regel bezahlen Sie dafür mit einer geringeren - Benutzerfreundlichkeit. - Wenn Sie z.B. Benutzer vor "simple social engineering tactics" - schützen wollen, müssen Sie session.use_only_cookies aktivieren. - Cookies müssen dann auf jeden Fall aktiviert sein. + Benutzerfreundlichkeit. Wenn Sie z.B. Benutzer vor einfachen + Social Engineering Tactics (Anm. des Übersetzers: Techniken der + Ausnutzung menschlicher Schwächen) schützen wollen, müssen Sie + <literal>session.use_only_cookies</literal> aktivieren. Cookies + müssen dann benutzerseitig auf jeden Fall aktiviert sein, weil + Sessions sonst nicht funktionieren. </para> <para> Es gibt mehrere Wege, über die eine Sessio-ID an Dritte gelangen @@ -105,15 +107,17 @@ &no.requirement; <note> <para> - Optionally you can use shared memory allocation (mm), developed - by Ralf S. Engelschall, for session storage. You have to - download <ulink url="&url.mm;">mm</ulink> and install it. This - option is not available for Windows platforms. Note that the - session storage module for mm does not guarantee that concurrent - accesses to the same session are properly locked. It might be - more appropiate to use a shared memory based filesystem (such as - tmpfs on Solaris/Linux, or /dev/md on BSD) to store sessions in - files, because they are properly locked. + Optional können Sie für die Speicherung von Sessions die von + Ralf S. Engelschall entwickelte Shared Memory Allocation (mm) + verwenden. Sie müssen dazu <ulink url="&url.mm;">mm</ulink> + herunterladen und installieren. Für Windows-Plattformen steht + diese Option nicht zur Verfügung. Beachten Sie, dass das + Sessionspeicherungs-Modul für mm nicht dafür garantiert, dass + gleichzeitige Zugriffe auf die selbe Session richtig gesperrt + sind. Die Verwendung eines auf Shared Memory basierenden + Dateisystems (wie z.B. tmpfs unter Solaris/Linux oder /dev/md + unter BSD) könnte für die Speicherung von Sessions in Dateien + geeigneter sein, weil sie entsprechend gesperrt sind. </para> </note> </section> @@ -145,7 +149,9 @@ nun überall <varname>$_SESSION</varname> verwendet wird. Sie können <varname>$_SESSION</varname> durch <varname>$HTTP_SESSION_VARS</varname> ersetzen, wenn Sie - Letzteres bevorzugen. + Letzteres bevorzugen. Beachten Sie auch, dass Sie Ihre Session + mit <function>session_start</function> starten müssen, bevor die + Verwendung von <varname>$_SESSION</varname> zur Verfügung steht. </para> <para> Für die Schlüssel des assoziativen @@ -179,7 +185,7 @@ zugegriffen werden. <example> <title> - Registrierung einer Variablen mit $_SESSION. + Registrierung einer Variablen mit <varname>$_SESSION</varname>. </title> <programlisting role="php"> <![CDATA[ @@ -197,8 +203,9 @@ </example> <example> <title> - Aufheben der Registrierung einer Variablen mit $_SESSION und - deaktiviertem register_globals. + Aufheben der Registrierung einer Variablen mit + <varname>$_SESSION</varname> und deaktiviertem <link + linkend="ini.register-globals"><literal>register_globals</literal></link>. </title> <programlisting role="php"> <![CDATA[ @@ -213,7 +220,9 @@ <example> <title> Aufheben der Registrierung einer Variablen mit aktiviertem - register_globals, nachdem sie unter Verwendung von $_SESSION + <link + linkend="ini.register-globals"><literal>register_globals</literal></link>, + nachdem sie unter Verwendung von <varname>$_SESSION</varname> registriert wurde. </title> <programlisting role="php"> @@ -229,7 +238,8 @@ </para> <para> Wenn - <link linkend="ini.register-globals"><literal>register_globals</literal></link> + <link + linkend="ini.register-globals"><literal>register_globals</literal></link> aktiviert ist, kann jede globalen Variable als Session-Variable registriert werden. Beim Neustart einer Session werden diese Variablen als entsprechende globale Variablen wiederhergestellt. @@ -255,11 +265,10 @@ aktivieren, sollten Sie <function>session_unregister</function> verwenden, weil beim Deserialisieren von Session-Daten die Session-Variablen als globale Variablen registriert werden. Die - Deaktivierung von - <link + Deaktivierung von <link linkend="ini.register-globals"><literal>register_globals</literal></link> - ist sowohl aus Sicherheitsgründen als auch wegen - der Performance empfehlenswert. + ist sowohl aus Sicherheitsgründen als auch wegen der + Performance empfehlenswert. </para> </caution> <example> @@ -332,8 +341,9 @@ Übersetzen von PHP manuell aktivieren. Unter UNIX müssen Sie dazu configure mit <link linkend="install.configure.enable-trans-sid"> <literal>--enable-trans-sid</literal></link> aufrufen. Wenn diese - Option und die Laufzeit-Option session.use_trans_sid aktiviert - sind, werden relative URIs automatisch so geändert, dass sie die + Option und die Laufzeit-Option + <literal>session.use_trans_sid</literal> aktiviert sind, werden + relative URIs automatisch so geändert, dass sie die Session-ID enthalten. <note> <para> @@ -345,12 +355,12 @@ </note> </para> <para> - Alternatively, you can use the constant <literal>SID</literal> - which is always defined. If the client did not send an - appropriate session cookie, it has the form - <literal>session_name=session_id</literal>. Otherwise, it - expands to an empty string. Thus, you can embed it - unconditionally into URLs. + Alternativ können Sie die Konstante <literal>SID</literal> + verwenden, die immer definiert ist. Falls der Client kein + geeignetes Session-Cookie gesendet hat, hat sie die Form + <literal>session_name=session_id</literal>. Andernfalls wird sie + zu einer leeren Zeichenkette erweitert. Aus diesem Grund können + Sie sie bedingungslos in URLs einbetten. </para> <para> Das folgende Beispiel demonstriert, wie eine Variable registriert @@ -385,17 +395,17 @@ <literal><?php echo SID?></literal> nötig, um die Session-ID zu erhalten (wenn <link linkend="ini.short-open-tag">short_open_tag</link> aktiviert ist, - kann <literal><?=SID?></literal> verwendet - werden). Das <literal><?=SID?></literal> ist nicht nötig, - wenn PHP mit <link linkend="install.configure.enable-trans-sid"> - <literal>--enable-trans-sid</literal></link> kompiliert wurde. + kann <literal><?=SID?></literal> verwendet werden). Das + <literal><?=SID?></literal> ist nicht nötig, wenn PHP mit + <link linkend="install.configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link> übersetzt wurde. </para> <note> <para> Bei nichtrelativen URLs wird davon ausgegangen, dass sie auf - externe Seiten zeigen und, weil es ein Sicherheitsrisiko wäre, - die SID an einen anderen Server zu übermitteln, von daher wird - keine SID angehängt. + externe Seiten zeigen und deshalb keine SID angehängt, weil es + ein Sicherheitsrisiko wäre, die SID an einen anderen Server zu + übermitteln. </para> </note> <para>