cvs: phpdoc-de /reference/cpdf book.xml examples.xml setup.xml /reference/mssql book.xml setup.xml /reference/oracle book.xml setup.xml
/reference/pcre book.xml examples.xml ini.xml pattern.xml /reference/posix book.xml setup.xml /reference/pspell book.xml setup.xml /reference/regex
book.xml constants.xml examples.xml setup.xml /reference/session book.xml examples.xml security.xml setup.xml
| From: | Martin Samesch | Date: | Fri, 28 Dec 2007 08:39:52 +0000 |
| Subject: | cvs: phpdoc-de /reference/cpdf book.xml examples.xml setup.xml /reference/mssql book.xml setup.xml /reference/oracle book.xml setup.xml /reference/pcre book.xml examples.xml ini.xml pattern.xml /reference/posix book.xml setup.xml /reference/pspell book.xml setup.xml /reference/regex book.xml constants.xml examples.xml setup.xml /reference/session book.xml examples.xml security.xml setup.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2340@lists.php.net to get a copy of this message | ||
samesch Fri Dec 28 08:39:52 2007 UTC
Added files:
/phpdoc-de/reference/cpdf book.xml examples.xml setup.xml
/phpdoc-de/reference/mssql book.xml setup.xml
/phpdoc-de/reference/oracle book.xml setup.xml
/phpdoc-de/reference/pcre book.xml examples.xml ini.xml pattern.xml
/phpdoc-de/reference/posix book.xml setup.xml
/phpdoc-de/reference/pspell book.xml setup.xml
/phpdoc-de/reference/regex book.xml constants.xml examples.xml
setup.xml
/phpdoc-de/reference/session book.xml examples.xml security.xml
setup.xml
Log:
added
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/cpdf/book.xml +++ phpdoc-de/reference/cpdf/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: pecl, external --> <!-- State: deprecated --> <book xml:id="book.cpdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>ClibPDF</title> <!-- {{{ preface --> <preface xml:id="intro.cpdf"> &reftitle.intro; <warning> <para> Da es für ClibPDF keinen Support mehr gibt, wird dringend empfohlen, eine Alternative wie <link linkend="book.haru">Haru</link>, <link linkend="book.pdf">PDFlib</link> oder eine der verfügbaren <link linkend="faq.using.freepdf">PHP-Alternativen</link> zu verwenden. </para> </warning> <para> Mit der ClibPDF können Sie PDF-Dokumente mit PHP erstellen. Funktionalität und API der ClibPDF sind der <link linkend="book.pdf">PDFlib</link> ähnlich. Diese Dokumentation sollten Sie zusammen mit dem ClibPDF-Handbuch lesen, weil letzteres diese Bibliothek viel ausführlicher erklärt. </para> <para> Die Namen vieler Funktionen in der ClibPDF, im PHP-Modul und in der <link linkend="book.pdf">PDFlib</link> sind gleich. Außer <function>cpdf_open</function> nehmen alle Funktionen die Bezeichnung des Dokuments als ihren ersten Parameter. </para> <para> Diese Bezeichnung wird gegenwärtig nicht intern verwendet, weil ClibPDF die gleichzeitige Erzeugung mehrerer PDF-Dokumente nicht unterstützt. Da das Ergebnis nicht vorhersehbar ist, sollten Sie es am besten nicht einmal testen. Die Folgen, die das in einer multi-threaded Umgebung hätte, kann ich nicht abschätzen. Laut ClibPDF-Autor wird sich das in einer der nächsten Versionen ändern (als dieses geschrieben wurde, war Version 1.10 aktuell). Verwenden Sie das pdflib-Modul, wenn Sie diese Funktionalität benötigen. </para> <para> Eine nette Eigenschaft der ClibPDF (und der <link linkend="book.pdf">PDFlib</link>) ist die Möglichkeit, das PDF-Dokument vollständig im Speicher zu erzeugen, ohne temporäre Dateien zu verwenden. Sie bietet auch die Möglichkeit, Koordinaten in einer vordefinierten Längeneinheit zu übergeben. Diese Fähigkeit kann bei Verwendung der <link linkend="book.pdf">PDFlib</link>-Funktionen auch mit <function>pdf_translate</function> simuliert werden kann. </para> <para> Eine weitere nette Eigenschaft von ClibPDF ist die Tatsache, dass jede Seite jederzeit geändert werden kann, selbst wenn schon eine neue Seite geöffnet wurde. Die Funktion <function>cpdf_set_current_page</function> erlaubt es, die aktuelle Seite zu verlassen und mit den Änderungen einer anderen Seite fortzufahren. </para> <para> Die meisten Funktionen sind ziemlich einfach zu benutzen. Der schwierigste Teil ist wahrscheinlich die Erzeugung eines sehr einfachen PDF-Dokuments überhaupt. Das folgende Beispiel sollte für Sie eine gute Starthilfe sein. Es erzeugt ein Dokument mit einer Seite. Die Seite enthält den Umriss des Textes "Times-Roman" in 30-Punkt-Schrift. Der Text ist unterstrichen. </para> <note> <para> &pecl.moved-ver;5.1.0. </para> </note> <note> <simpara> Falls Sie an alternativen freien PDF-Generatoren interessiert sind, die keine externen PDF-Bibliotheken benutzen, schauen Sie sich <link linkend="faq.using.freepdf">die diesbezügliche FAQ</link> an. </simpara> </note> </preface> <!-- }}} --> &reference.cpdf.setup; &reference.cpdf.constants; &reference.cpdf.examples; &reference.cpdf.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/cpdf/examples.xml +++ phpdoc-de/reference/cpdf/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="cpdf.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <example> <title>Ein einfaches ClibPDF-Beispiel</title> <programlisting role="php"> <![CDATA[ <?php $cpdf = cpdf_open(0); cpdf_page_init($cpdf, 1, 0, 595, 842, 1.0); cpdf_add_outline($cpdf, 0, 0, 0, 1, "Seite 1"); cpdf_begin_text($cpdf); cpdf_set_font($cpdf, "Times-Roman", 30, "WinAnsiEncoding"); cpdf_set_text_rendering($cpdf, 1); cpdf_text($cpdf, "Times Roman outlined", 50, 50); cpdf_end_text($cpdf); cpdf_moveto($cpdf, 50, 50); cpdf_lineto($cpdf, 740, 330); cpdf_stroke($cpdf); cpdf_finalize_page($cpdf, 1); cpdf_finalize($cpdf); Header("Content-type: application/pdf"); cpdf_output_buffer($cpdf); cpdf_close($cpdf); ?> ]]> </programlisting> </example> <para> Die pdflib-Distribution enthält ein komplexeres Beispiel, das eine Reihe von Seiten mit einer Analoguhr erzeugt. Hier ist dieses Beispiel, das unter Verwendung der ClibPDF-Erweiterung in PHP konvertiert wurde: </para> <example> <title>pdfclock-Beispiel der pdflib 2.0 Distribution</title> <programlisting role="php"> <![CDATA[ <?php $radius = 200; $rand = 20; $seitenzaehler = 40; $pdf = cpdf_open(0); cpdf_set_creator($pdf, "pdf_uhr.php"); cpdf_set_title($pdf, "Analoguhr"); while ($seitenzaehler-- > 0) { cpdf_page_init($pdf, $seitenzaehler+1, 0, 2 * ($radius + $rand), 2 * ($radius + $rand), 1.0); cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0); /* Seitenübergang */ cpdf_translate($pdf, $radius + $rand, $radius + $rand); cpdf_save($pdf); cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); /* Minutenstriche */ cpdf_setlinewidth($pdf, 2.0); for ($alpha = 0; $alpha < 360; $alpha += 6) { cpdf_rotate($pdf, 6.0); cpdf_moveto($pdf, $radius, 0.0); cpdf_lineto($pdf, $radius-$rand/3, 0.0); cpdf_stroke($pdf); } cpdf_restore($pdf); cpdf_save($pdf); /* 5-Minuten-Striche */ cpdf_setlinewidth($pdf, 3.0); for ($alpha = 0; $alpha < 360; $alpha += 30) { cpdf_rotate($pdf, 30.0); cpdf_moveto($pdf, $radius, 0.0); cpdf_lineto($pdf, $radius-$rand, 0.0); cpdf_stroke($pdf); } $ortszeit = getdate(); /* Stundenzeiger zeichnen */ cpdf_save($pdf); cpdf_rotate($pdf, -(($ortszeit['minutes']/60.0) + $ortszeit['hours'] - 3.0) * 30.0); cpdf_moveto($pdf, -$radius/10, -$radius/20); cpdf_lineto($pdf, $radius/2, 0.0); cpdf_lineto($pdf, -$radius/10, $radius/20); cpdf_closepath($pdf); cpdf_fill($pdf); cpdf_restore($pdf); /* Minutenzeiger zeichnen */ cpdf_save($pdf); cpdf_rotate($pdf, -(($ortszeit['seconds']/60.0) + $ortszeit['minutes'] - 15.0) * 6.0); cpdf_moveto($pdf, -$radius/10, -$radius/20); cpdf_lineto($pdf, $radius * 0.8, 0.0); cpdf_lineto($pdf, -$radius/10, $radius/20); cpdf_closepath($pdf); cpdf_fill($pdf); cpdf_restore($pdf); /* Sekundenzeiger zeichnen */ cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); cpdf_setlinewidth($pdf, 2); cpdf_save($pdf); cpdf_rotate($pdf, -(($ortszeit['seconds'] - 15.0) * 6.0)); cpdf_moveto($pdf, -$radius/5, 0.0); cpdf_lineto($pdf, $radius, 0.0); cpdf_stroke($pdf); cpdf_restore($pdf); /* Kleinen Mittelkreis zeichnen */ cpdf_circle($pdf, 0, 0, $radius/30); cpdf_fill($pdf); cpdf_restore($pdf); cpdf_finalize_page($pdf, $seitenzaehler+1); } cpdf_finalize($pdf); Header("Content-type: application/pdf"); cpdf_output_buffer($pdf); cpdf_close($pdf); ?> ]]> </programlisting> </example> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/cpdf/setup.xml +++ phpdoc-de/reference/cpdf/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="cpdf.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="cpdf.requirements"> &reftitle.required; <para> Um die ClibPDF-Funktionen benutzen zu können, müssen Sie das ClibPDF-Paket installieren. Es ist zum Herunterladen erhältlich von <link xlink:href="&url.fastio;">FastIO</link>. Für dessen kommerzielle Verwendung ist es erforderlich, dass Sie eine Lizenz erwerben. Für PHP wird cpdflib >= 2 benötigt. Die Entwicklung der ClibPDF-Bibliothek wurde eingestellt und die FastIO-Website ist höchstwahrscheinlich nicht erreichbar. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.cpdf.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="cpdf.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="cpdf.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/mssql/book.xml +++ phpdoc-de/reference/mssql/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: bundled, external --> <book xml:id="book.mssql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>MS SQL Server</title> <!-- {{{ preface --> <preface xml:id="intro.mssql"> &reftitle.intro; <para> Diese Funktionen ermöglichen Ihnen den Zugriff auf den MS SQL-Datenbankserver. </para> </preface> <!-- }}} --> &reference.mssql.setup; &reference.mssql.constants; &reference.mssql.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/mssql/setup.xml +++ phpdoc-de/reference/mssql/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="mssql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="mssql.requirements"> &reftitle.required; <para> Voraussetzungen für Win32-Plattformen. </para> <para> Für die Erweiterung müssen die MS SQL Client Tools auf dem System installiert sein, auf dem PHP installiert ist. Die Client Tools können entweder von der MS SQL Server-CD oder durch kopieren der <filename>ntwdblib.dll</filename> von <filename>\winnt\system32</filename> auf dem Server nach <filename>\winnt\system32</filename> auf dem PHP-Rechner installiert werden. Mit dem Kopieren der <filename>ntwdblib.dll</filename> wird nur der Zugriff durch benannte Pipes (named pipes) unterstützt. Für die Konfiguration des Clients ist eine Installation aller Tools nötig. </para> <para> Voraussetzungen für Unix/Linux-Plattformen. </para> <para> Um die MSSQL-Erweiterung unter Unix/Linux nutzen zu können, müssen Sie zuerst die FreeTDS-Bibliothek übersetzen und installieren. Quellcode und Installationsanleitung stehen auf der FreeTDS-Homepage zur Verfügung: <link xlink:href="&url.freetds;">&url.freetds;</link> </para> <note> <para> Unter Windows wird die DBLIB von Microsoft verwendet. Funktionen, die einen Feldnamen zurückgeben, basieren auf der DBLIB-Funktion <literal>dbcolname()</literal>. DBLIB wurde für den SQL Server 6.x entwickelt, bei dem die maximale Länge der Bezeichner bei 30 liegt. Aus diesem Grund ist die Länge von Feldern auf maximal 30 Zeichen begrenzt. Auf Plattformen, auf denen FreeTDS verwendet wird (Linux) gibt es dieses Problem nicht. </para> </note> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.mssql.configure; <!-- }}} --> <!-- {{{ Configuration --> &reference.mssql.ini; <!-- }}} --> <!-- {{{ Resources --> <section xml:id="mssql.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/oracle/book.xml +++ phpdoc-de/reference/oracle/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: pecl, external --> <!-- State: deprecated --> <book xml:id="book.oracle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Oracle</title> <!-- {{{ preface --> <preface xml:id="intro.oracle"> &reftitle.intro; <warning> <para> Diese Erweiterung sollte nicht mehr verwendet werden. Verwenden Sie stattdessen die verbesserte <link linkend="book.oci8">oci8</link>-Erweiterung. Die hier dokumentierten Funktionen listen die empfohlenen oci8-Alternativen auf. </para> </warning> <para> Diese Erweiterung fügt die Unterstützung für Oracle Datenbanken hinzu. </para> <note> <para> &pecl.moved-ver;5.1.0. </para> </note> </preface> <!-- }}} --> &reference.oracle.setup; &reference.oracle.constants; &reference.oracle.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/oracle/setup.xml +++ phpdoc-de/reference/oracle/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="oracle.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="oracle.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.oracle.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="oracle.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="oracle.resources"> &reftitle.resources; <para> Diese Erweiterung definiert zwei Resource-Typen: eine Oracle-Verbindungskennung und einen Oracle-Cursor-Index. </para> </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/book.xml +++ phpdoc-de/reference/pcre/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- Purpose: basic.text --> <!-- Membership: bundled --> <book xml:id="book.pcre" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Reguläre Ausdrücke &Functions; (Perl-kompatibel)</title> <titleabbrev>PCRE</titleabbrev> <preface xml:id="intro.pcre"> &reftitle.intro; <para> Die Syntax für Suchmuster, die in diesen Funktionen verwendet werden, ist Perl sehr ähnlich. Der Ausdruck muss zwischen Begrenzungszeichen, z.B. Schrägstrichen (/), stehen. Jedes Zeichen kann als Begrenzungszeichen verwendet werden, solange es kein alphanumerisches Zeichen oder der Backslash (\) ist. Falls das Begrenzungszeichen im Ausdruck selbst verwendet wird, muss es mit dem Backslash als Escape-Zeichen maskiert werden. Ab PHP 4.0.4 können Sie auch dem Perl-Stil entsprechend (), {}, [] und <> als Begrenzung für Suchmuster verwenden. Für eine ausführliche Erklärung siehe <link linkend="reference.pcre.pattern.syntax">Suchmuster-Syntax</link>. </para> <para> An die Schlussbegrenzung können verschiedene Modifikatoren angehängt werden, die das Suchergebnis beeinflussen. Siehe <link linkend="reference.pcre.pattern.modifiers">Modifikatoren für Suchmuster</link>. </para> <para> Bei Verwendung der <link linkend="book.regex">POSIX-erweiterten Reguläre Ausdrücke Funktionen</link> unterstützt PHP auch reguläre Ausdrücke mit POSIX-erweiterter Syntax. </para> <note> <para> Diese Erweiterung unterhält pro Thread einen globalen Cache mit compilierten regulären Ausdrücken (bis zu 4096). </para> </note> <warning> <para> Sie sollten sich über ein paar Einschränkungen von PCRE bewusst sein. Lesen Sie bitte <link xlink:href="&url.pcre.man;">&url.pcre.man;</link> für weitere Informationen. </para> </warning> </preface> &reference.pcre.setup; &reference.pcre.constants; &reference.pcre.examples; &reference.pcre.pattern; &reference.pcre.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/examples.xml +++ phpdoc-de/reference/pcre/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="pcre.examples"> &reftitle.examples; <para> <example> <title>Beispiele gültiger Suchmuster</title> <itemizedlist> <listitem><simpara><literal>/<\/\w+>/</literal></simpara></listitem> <listitem><simpara><literal>|(\d{3})-\d+|Sm</literal></simpara></listitem> <listitem><simpara><literal>/^(?i)php[34]/</literal></simpara></listitem> <listitem><simpara><literal>{^\s+(\s+)?$}</literal></simpara></listitem> </itemizedlist> </example> </para> <para> <example> <title>Beispiele ungültiger Suchmuster</title> <itemizedlist> <listitem> <simpara> <literal>/href='(.*)'</literal> - fehlender Begrenzer am Ende </simpara> </listitem> <listitem> <simpara> <literal>/\w+\s*\w+/J</literal> - ungültiger Modifikator 'J' </simpara> </listitem> <listitem> <simpara> <literal>1-\d3-\d3-\d4|</literal> - fehlender Begrenzer am Anfang </simpara> </listitem> </itemizedlist> </example> </para> </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/ini.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/ini.xml +++ phpdoc-de/reference/pcre/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> <section xml:id="pcre.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; <para> <table> <title>PCRE-Konfigurationsoptionen</title> <tgroup cols="4"> <thead> <row> <entry>Name</entry> <entry>Standardwert</entry> <entry>Änderbar</entry> <entry>Änderungen</entry> </row> </thead> <tbody> <row> <entry>pcre.backtrack_limit</entry> <entry>"100000"</entry> <entry>PHP_INI_ALL</entry> <entry>Steht ab PHP 5.2.0 zur Verfügung</entry> </row> <row> <entry>pcre.recursion_limit</entry> <entry>"100000"</entry> <entry>PHP_INI_ALL</entry> <entry>Steht ab PHP 5.2.0 zur Verfügung</entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> &ini.descriptions.title; <para> <variablelist> <varlistentry xml:id="ini.pcre.backtrack-limit"> <term> <parameter>pcre.backtrack_limit</parameter> <type>integer</type> </term> <listitem> <para> PCREs Zurückverfolgungs- (Backtracking-) Limit. </para> </listitem> </varlistentry> <varlistentry xml:id="ini.pcre.recursion-limit"> <term> <parameter>pcre.recursion_limit</parameter> <type>integer</type> </term> <listitem> <para> PCREs Rekursionslimit. Bitte beachten Sie, dass bei einem hohen Wert der gesamte verfügbare Prozess-Stack verwendet werden könnte und PHP schließlich (wenn es das vom Betriebssystem vorgegebene Limit für die Stackgröße erreicht) abstürzen könnte. </para> </listitem> </varlistentry> </variablelist> </para> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/pattern.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/pattern.xml +++ phpdoc-de/reference/pcre/pattern.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <part xml:id="pcre.pattern"> <title>PCRE-Suchmuster</title> &reference.pcre.pattern.modifiers; &reference.pcre.pattern.syntax; </part> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/posix/book.xml +++ phpdoc-de/reference/posix/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: fileprocess.process --> <!-- Membership: bundled --> <book xml:id="book.posix" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>POSIX</title> <!-- {{{ preface --> <preface xml:id="intro.posix"> &reftitle.intro; <para> Dieses Modul enthält eine Schnittstelle zu den im IEEE 1003.1 (POSIX.1) Standards Dokument definierten Funktionen, die auf einem anderen Weg nicht erreichbar sind. POSIX.1 definierte zum Beispiel auch die open(), read(), write() und close() Funktionen, die seit langer Zeit Bestandteil von PHP 3 sind. Trotzdem standen einige andere systemspezifische Funktionen bisher nicht zur Verfügung. Dieses Modul versucht hier Abhilfe zu schaffen, indem es einen einfachen Zugang zu diesen Funktionen bereitstellt. </para> <warning> <para> Sensible Daten können mit den POSIX-Funktionen, z.B. <function>posix_getpwnam</function> und Freunde, abgefragt werden. Die POSIX-Funktionen führen keinerlei Zugriffsüberprüfungen durch, wenn <link linkend="ini.safe-mode">safe mode</link> aktiviert ist. Es wird daher <emphasis role="strong">dringend</emphasis> empfohlen, die POSIX-Erweiterung komplett zu deaktivieren (verwenden Sie dazu bei der Konfiguration <literal>--disable-posix</literal>), wenn Sie in einer solchen Umgebung arbeiten. </para> </warning> ¬e.no-windows.extension; </preface> <!-- }}} --> &reference.posix.setup; &reference.posix.constants; &reference.posix.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/posix/setup.xml +++ phpdoc-de/reference/posix/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="posix.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="posix.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.posix.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="posix.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="posix.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pspell/book.xml +++ phpdoc-de/reference/pspell/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: international --> <!-- Membership: bundled, external --> <book xml:id="book.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Pspell</title> <!-- {{{ preface --> <preface xml:id="intro.pspell"> &reftitle.intro; <para> Diese Funktionen ermöglichen Ihnen, die Rechtschreibung eines Wortes zu prüfen und bieten Änderungsvorschläge an. </para> </preface> <!-- }}} --> &reference.pspell.setup; &reference.pspell.constants; &reference.pspell.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pspell/setup.xml +++ phpdoc-de/reference/pspell/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="pspell.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="pspell.requirements"> &reftitle.required; <para> Um PHP mit pspell-Unterstützung zu kompilieren, brauchen Sie die aspell-Bibliothek, die Sie unter <link xlink:href="&url.aspell;">&url.aspell;</link> bekommen. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.pspell.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="pspell.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="pspell.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/book.xml +++ phpdoc-de/reference/regex/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: basic.text --> <!-- Membership: core --> <book xml:id="book.regex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Reguläre Ausdrücke &Functions; (POSIX-erweitert)</title> <titleabbrev>POSIX Regex</titleabbrev> <preface xml:id="intro.regex"> &reftitle.intro; <tip> <para> Bei Verwendung der <link linkend="book.pcre">PCRE Funktionen</link> unterstützt PHP auch Reguläre Ausdrücke mit einer zu Perl kompatiblen Syntax. Diese Funktionen unterstützen nicht-gieriges (non-greedy) Matching, Assertions, bedingte Teilsuchmuster und viele andere Merkmale, die von der POSIX-erweiterten Syntax regulärer Ausdrücke nicht unterstützt werden. </para> </tip> <warning> <para> Diese Funktionen regulärer Ausdrücke sind im Gegensatz zu den <link linkend="book.pcre">PCRE Funktionen</link> nicht binärsicher. </para> </warning> <para> Reguläre Ausdrücke werden für komplexe Manipulationen an Zeichenketten verwendet. PHP verwendet durch POSIX 1003.2 definierte POSIX erweiterte reguläre Ausdrücke. Eine vollständige Beschreibung der POSIX regulären Ausdrücke finden Sie im Regex-Verzeichnis der PHP-Distribution in den <link xlink:href="&url.regex.man;">Regex man pages</link>. Da sie im manpage-Fomat vorliegt, sollten Sie einen Befehl der Art <command>man /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. </para> </preface> &reference.regex.setup; &reference.regex.constants; &reference.regex.examples; &reference.regex.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/constants.xml +++ phpdoc-de/reference/regex/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="regex.constants"> &reftitle.constants; &no.constants; </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/examples.xml +++ phpdoc-de/reference/regex/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="regex.examples"> &reftitle.examples; <para> <example> <title>Beispiele regulärer Ausdrücke</title> <programlisting role="php"> <![CDATA[ <?php // Gibt true zurück, falls "abc" irgendwo in $zeichenkette gefunden wird. ereg("abc", $zeichenkette); // Gibt true zurück, falls "abc" am Anfang von $zeichenkette gefunden wird. ereg("^abc", $zeichenkette); // Gibt true zurück, falls "abc" am Ende von $zeichenkette gefunden wird. ereg("abc$", $zeichenkette); // Gibt true zurück, falls es sich beim Client Browser um Netscape 2, 3 oder // MSIE 3 handelt. eregi("(ozilla.[23]|MSIE.3)", $_SERVER["HTTP_USER_AGENT"]); // Setzt drei Wörter, die durch Leerzeichen getrennt sind, in $regs[1], // $regs[2] und $regs[3] ein. ereg("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $zeichenkette, $regs); // Setzt ein <br /> Tag vor $zeichenkette. $zeichenkette = ereg_replace("^", "<br />", $zeichenkette); // Setzt ein <br /> Tag hinter $zeichenkette. $zeichenkette = ereg_replace("$", "<br />", $zeichenkette); // Entfernt alle Zeilenumbrüche aus $zeichenkette. $zeichenkette = ereg_replace("\n", "", $zeichenkette); ?> ]]> </programlisting> </example> </para> </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/setup.xml +++ phpdoc-de/reference/regex/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="regex.setup"> &reftitle.setup; <section xml:id="regex.requirements"> &reftitle.required; &no.requirement; </section> &reference.regex.configure; <section xml:id="regex.configuration"> &reftitle.runtime; &no.config; </section> <section xml:id="regex.resources"> &reftitle.resources; &no.resource; </section> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/book.xml +++ phpdoc-de/reference/session/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: basic.session --> <!-- Membership: core --> <book xml:id="book.session" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Session &Functions;</title> <titleabbrev>Sessions</titleabbrev> <!-- {{{ preface --> <preface xml:id="intro.session"> &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 Anwendungen erstellen und Ihre Website ansprechender gestalten. </para> <para> Einem Besucher wird beim Aufruf Ihrer Website eine eindeutige ID, die sogenannte Session-ID, zugeordnet. Diese wird entweder benutzerseitig in einem Cookie abgelegt oder in der URL übermittelt. </para> <para> 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 <link linkend="ini.session.auto-start">session.auto_start</link> 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, wird die zuvor gespeicherte Umgebung wiederhergestellt. </para> <caution> <para> Falls Sie <link linkend="ini.session.auto-start">session.auto_start</link> aktivieren, können Sie keine Objekte in Ihre Session aufnehmen, weil die Definition der Klasse vor dem Start der Session geladen werden muss, damit die Objekte in Ihrer Session wiederhergestellt werden. </para> </caution> <para> Alle registrierten Variablen werden serialisiert, nachdem die Anfrage beendet ist. Registrierte Variablen, die nicht definiert sind, werden als nicht definiert gekennzeichnet. Auch bei darauf folgenden Zugriffen werden sie nicht vom Session-Modul definiert, außer der Benutzer definiert sie später. </para> <warning> <para> Einige Datentypen können nicht serialisiert werden, um in Sessions gespeichert zu werden. Dazu gehören <type>resource</type>-Variablen oder Objekte mit Ringreferenzen (d.h. Objekte, die eine Referenz auf sich selbst an andere Objekte übergeben). </para> </warning> <note> <para> Die Behandlung von Sessions wurde in PHP 4.0.0 eingeführt. </para> </note> <note> <para> Bitte beachten Sie beim Arbeiten mit Sessions, dass der Datensatz einer Session nicht angelegt wird, bevor eine Variable mit der Funktion <function>session_register</function> registriert oder dem superglobalen Array <varname>$_SESSION</varname> ein neuer Schlüssel hinzugefügt wird. Das gilt auch dann, wenn eine Session mit der Funktion <function>session_start</function> gestartet wurde. </para> </note> </preface> <!-- }}} --> &reference.session.setup; &reference.session.examples; &reference.session.security; &reference.session.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/examples.xml +++ phpdoc-de/reference/session/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="session.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <section xml:id="session.examples.basic"> <note> <para> Ab PHP 4.1.0 steht <varname>$_SESSION</varname> genau wie <varname>$_POST</varname>, <varname>$_GET</varname>, <varname>$_REQUEST</varname> und so weiter, als globale Variable zur Verfügung. Im Gegensatz zu <varname>$HTTP_SESSION_VARS</varname> ist <varname>$_SESSION</varname> immer global. Deshalb brauchen Sie für <varname>$_SESSION</varname> nicht das Schlüsselwort <link linkend="language.variables.scope"><command>global</command></link> zu verwenden. Bitte beachten Sie, dass in dieser Dokumentation nun überall <varname>$_SESSION</varname> verwendet wird. Sie können <varname>$_SESSION</varname> durch <varname>$HTTP_SESSION_VARS</varname> ersetzen, wenn Sie Letzteres bevorzugen. Beachten Sie auch, dass Sie Ihre Session mit <function>session_start</function> starten müssen, bevor <varname>$_SESSION</varname> zur Verfügung steht. </para> <para> Für die Schlüssel des assoziativen <varname>$_SESSION</varname>-Arrays gelten die selben Beschränkungen, wie für die Bezeichnungen von regulären Variablen in PHP, d.h. sie dürfen nicht mit einer Zahl, sondern müssen mit einem Buchstaben oder Unterstrich beginnen. Um weitere Deteils zu erhalten, siehe Abschnitt <link linkend='language.variables'>Variablen</link>. </para> </note> <para> Falls <link linkend="ini.register-globals">register_globals</link> deaktiviert ist, können nur Bestandteile des globalen assoziativen Arrays <varname>$_SESSION</varname> als Session-Variablen registriert werden. Wiederhergestellte Session-Variablen stehen nur im Array <varname>$_SESSION</varname> zur Verfügung. </para> <para> Aus Gründen der Verbesserung der Sicherheit und der Lesbarkeit des Codes wird die Verwendung von <varname>$_SESSION</varname> (oder <varname>$HTTP_SESSION_VARS</varname> bei PHP 4.0.6 oder niedriger) empfohlen. Mit <varname>$_SESSION</varname> werden die Funktionen <function>session_register</function>, <function>session_unregister</function> und <function>session_is_registered</function> nicht benötigt. Auf die Session-Variablen kann wie auf jede normale Variable zugegriffen werden. <example> <title> Registrierung einer Variablen mit <varname>$_SESSION</varname>. </title> <programlisting role="php"> <![CDATA[ <?php session_start(); // Verwenden Sie bei PHP 4.0.6 oder niedriger $HTTP_SESSION_VARS if (!isset($_SESSION['zaehler'])) { $_SESSION['zaehler'] = 0; } else { $_SESSION['zaehler']++; } ?> ]]> </programlisting> </example> <example> <title> Aufheben der Registrierung einer Variablen mit <varname>$_SESSION</varname> und deaktiviertem <link linkend="ini.register-globals">register_globals</link>. </title> <programlisting role="php"> <![CDATA[ <?php session_start(); // Verwenden Sie bei PHP 4.0.6 oder niedriger $HTTP_SESSION_VARS unset($_SESSION['zaehler']); ?> ]]> </programlisting> </example> </para> <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> <warning> <para> Sie können in Session-Variablen keine Referenzen verwenden, weil es keine praktikable Möglichkeit gibt, eine Referenz in eine andere Variable zurückzuführen. </para> </warning> <para> Wenn <link linkend="ini.register-globals">register_globals</link> aktiviert ist, kann jede globalen Variable als Session-Variable registriert werden. Beim Neustart einer Session werden diese Variablen als entsprechende globale Variablen wiederhergestellt. Da PHP wissen muss, welche globalen Variablen als Session-Variablen registriert sind, muss der Benutzer Variablen mit der Funktion <function>session_register</function> registrieren. Sie können das vermeiden, indem Sie einfach Einträge in <varname>$_SESSION</varname> setzen. <caution> <para> Verwenden Sie nicht <function>session_register</function>, <function>session_is_registered</function> und <function>session_unregister</function>, wenn Sie <varname>$_SESSION</varname> vor PHP 4.3.0 verwenden und <link linkend="ini.register-globals">register_globals</link> deaktiviert ist. Es ist sowohl aus Sicherheitsgründen als auch wegen der Performance empfehlenswert, <link linkend="ini.register-globals">register_globals</link> zu deaktivieren. </para> </caution> </para> <para> Wenn <link linkend="ini.register-globals">register_globals</link> aktiviert ist, dann referenzieren die globalen Variablen und die Einträge von <varname>$_SESSION</varname> automatisch die selben Werte, die in der vorherigen Instanz der Session registriert wurden. Falls die Variable mittels <varname>$_SESSION</varname> registriert wird, steht die globale Variable allerdings erst ab der nächsten Anfrage zur Verfügung. </para> <para> Es gibt einen Fehler in PHP 4.2.3 und früheren Versionen. Wenn Sie eine neue Session-Variable mittels <function>session_register</function> registrieren, referenzieren der Eintrag im globalen Bereich und der <varname>$_SESSION</varname>-Eintrag bis zum nächsten <function>session_start</function> nicht den selben Wert. D.h. eine Änderung an der neu registrierten globalen Variablen wird nicht vom <varname>$_SESSION</varname>-Eintrag widergespiegelt. Dies wurde in PHP 4.3.0 korrigiert. </para> </section> <section xml:id="session.idpassing"> <title>Übermittlung der Session-ID</title> <para> Es gibt zwei Methoden, eine Session-ID zu übermitteln: <itemizedlist> <listitem> <simpara> Cookies </simpara> </listitem> <listitem> <simpara> URL-Parameter </simpara> </listitem> </itemizedlist> </para> <para> Das Session-Modul unterstützt beide Methoden. Cookies sind optimal, aber da sie nicht immer zur Verfügung stehen, bieten wir auch noch eine Alternative an. Die zweite Methode hängt die Session-ID direkt an die URLs. </para> <para> PHP ist in der Lage, Links transparent umzuwandeln. Falls Sie nicht PHP 4.2.0 oder höher verwenden, müssen Sie das beim Übersetzen von PHP manuell aktivieren. Unter Unix müssen Sie dazu configure mit <link linkend="ini.session.use-trans-sid"> --enable-trans-sid</link> aufrufen. Wenn diese 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> Die &php.ini;-Anweisung <link linkend="ini.arg-separator.output">arg_separator.output</link> ermöglicht es, die Trennung von Argumenten anzupassen. Geben Sie dort für volle XHTML-Konformität &amp; an. </para> </note> </para> <para> Alternativ können Sie die Konstante <literal>SID</literal> verwenden, die definiert ist, nachdem die Session gestartet wurde. 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 wird und wie unter Verwendung einer SID korrekt auf eine andere Seite verwiesen wird. <example> <title>Zählen der Seitenaufrufe eines einzelnen Benutzers</title> <programlisting role="php"> <![CDATA[ <?php session_start(); if (empty($_SESSION['zaehler'])) { $_SESSION['zaehler'] = 1; } else { $_SESSION['zaehler']++; } ?> <p> Hallo Besucher, Sie haben diese Seite <?php echo $_SESSION['zaehler']; ?> mal aufgerufen. </p> <p> Hier gehts <a href="nextpage.php?<?php echo htmlspecialchars(SID); ?>">weiter</a>. </p> ]]> </programlisting> </example> </para> <para> Die Funktion <function>htmlspecialchars</function> kann dazu verwendet werden, um bei der Ausgabe der SID XSS-ähnliche Angriffe zu verhindern. </para> <para> Die oben gezeigte Ausgabe der SID ist nicht nötig, wenn PHP mit <link linkend="ini.session.use-trans-sid"> --enable-trans-sid</link> übersetzt wurde. </para> <note> <para> Bei nichtrelativen URLs wird davon ausgegangen, dass sie auf 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> </section> <section xml:id="session.customhandler"> <title>Individuelle Session-Routinen</title> <para> Wenn Sie die Speicherung in einer Datenbank oder irgendeine andere Art der Speicherung realisieren wollen, können Sie <function>session_set_save_handler</function> verwenden, um eine Reihe von benutzerdefinierten Speicherfunktionen zu erzeugen. </para> </section> </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/security.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/security.xml +++ phpdoc-de/reference/session/security.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="session.security" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Sessions und Sicherheit</title> <para> Externe Links: <link xlink:href="&url.session-fixation;">Session fixation</link> </para> <para> Das Session-Modul bietet keine Garantie dafür, dass 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 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 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 Session-ID an Dritte gelangen kann. Eine entführte Session-ID ermöglicht diesen, auf alle Daten zuzugreifen, die mit dieser Session-ID verbunden sind. Zum einen sind das URLs, die Session-IDs enthalten. Wenn Sie auf eine externe Site verweisen, könnte die URL inklusive Session-ID in den Referrer-Logs der externen Site gespeichert werden. Zum anderen kann ein aktiverer Angreifer Ihren Netzwerkverkehr abhören. Falls Ihr Netzwerkverkehr nicht verschlüsselt ist, werden Session-IDs im Klartext über das Netzwerk übertragen. Hier ist die Lösung, auf Ihrem Server SSL zu implementieren und die Verwendung für Ihre Benutzer obligatorisch zu machen. </para> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/setup.xml +++ phpdoc-de/reference/session/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="session.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <section xml:id="session.requirements"> &reftitle.required; &no.requirement; <note> <para> 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 <link xlink:href="&url.mm;">mm</link> 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. Die Session-Daten werden im Hauptspeicher gespeichert und folglich bei einem Neustart des Webservers gelöscht. </para> </note> </section> &reference.session.configure; &reference.session.ini; <section xml:id="session.resources"> &reftitle.resources; &no.resource; </section> </chapter> <!-- 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 -->
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/cpdf/book.xml +++ phpdoc-de/reference/cpdf/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: utilspec.nontext --> <!-- Membership: pecl, external --> <!-- State: deprecated --> <book xml:id="book.cpdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>ClibPDF</title> <!-- {{{ preface --> <preface xml:id="intro.cpdf"> &reftitle.intro; <warning> <para> Da es für ClibPDF keinen Support mehr gibt, wird dringend empfohlen, eine Alternative wie <link linkend="book.haru">Haru</link>, <link linkend="book.pdf">PDFlib</link> oder eine der verfügbaren <link linkend="faq.using.freepdf">PHP-Alternativen</link> zu verwenden. </para> </warning> <para> Mit der ClibPDF können Sie PDF-Dokumente mit PHP erstellen. Funktionalität und API der ClibPDF sind der <link linkend="book.pdf">PDFlib</link> ähnlich. Diese Dokumentation sollten Sie zusammen mit dem ClibPDF-Handbuch lesen, weil letzteres diese Bibliothek viel ausführlicher erklärt. </para> <para> Die Namen vieler Funktionen in der ClibPDF, im PHP-Modul und in der <link linkend="book.pdf">PDFlib</link> sind gleich. Außer <function>cpdf_open</function> nehmen alle Funktionen die Bezeichnung des Dokuments als ihren ersten Parameter. </para> <para> Diese Bezeichnung wird gegenwärtig nicht intern verwendet, weil ClibPDF die gleichzeitige Erzeugung mehrerer PDF-Dokumente nicht unterstützt. Da das Ergebnis nicht vorhersehbar ist, sollten Sie es am besten nicht einmal testen. Die Folgen, die das in einer multi-threaded Umgebung hätte, kann ich nicht abschätzen. Laut ClibPDF-Autor wird sich das in einer der nächsten Versionen ändern (als dieses geschrieben wurde, war Version 1.10 aktuell). Verwenden Sie das pdflib-Modul, wenn Sie diese Funktionalität benötigen. </para> <para> Eine nette Eigenschaft der ClibPDF (und der <link linkend="book.pdf">PDFlib</link>) ist die Möglichkeit, das PDF-Dokument vollständig im Speicher zu erzeugen, ohne temporäre Dateien zu verwenden. Sie bietet auch die Möglichkeit, Koordinaten in einer vordefinierten Längeneinheit zu übergeben. Diese Fähigkeit kann bei Verwendung der <link linkend="book.pdf">PDFlib</link>-Funktionen auch mit <function>pdf_translate</function> simuliert werden kann. </para> <para> Eine weitere nette Eigenschaft von ClibPDF ist die Tatsache, dass jede Seite jederzeit geändert werden kann, selbst wenn schon eine neue Seite geöffnet wurde. Die Funktion <function>cpdf_set_current_page</function> erlaubt es, die aktuelle Seite zu verlassen und mit den Änderungen einer anderen Seite fortzufahren. </para> <para> Die meisten Funktionen sind ziemlich einfach zu benutzen. Der schwierigste Teil ist wahrscheinlich die Erzeugung eines sehr einfachen PDF-Dokuments überhaupt. Das folgende Beispiel sollte für Sie eine gute Starthilfe sein. Es erzeugt ein Dokument mit einer Seite. Die Seite enthält den Umriss des Textes "Times-Roman" in 30-Punkt-Schrift. Der Text ist unterstrichen. </para> <note> <para> &pecl.moved-ver;5.1.0. </para> </note> <note> <simpara> Falls Sie an alternativen freien PDF-Generatoren interessiert sind, die keine externen PDF-Bibliotheken benutzen, schauen Sie sich <link linkend="faq.using.freepdf">die diesbezügliche FAQ</link> an. </simpara> </note> </preface> <!-- }}} --> &reference.cpdf.setup; &reference.cpdf.constants; &reference.cpdf.examples; &reference.cpdf.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/cpdf/examples.xml +++ phpdoc-de/reference/cpdf/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="cpdf.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <example> <title>Ein einfaches ClibPDF-Beispiel</title> <programlisting role="php"> <![CDATA[ <?php $cpdf = cpdf_open(0); cpdf_page_init($cpdf, 1, 0, 595, 842, 1.0); cpdf_add_outline($cpdf, 0, 0, 0, 1, "Seite 1"); cpdf_begin_text($cpdf); cpdf_set_font($cpdf, "Times-Roman", 30, "WinAnsiEncoding"); cpdf_set_text_rendering($cpdf, 1); cpdf_text($cpdf, "Times Roman outlined", 50, 50); cpdf_end_text($cpdf); cpdf_moveto($cpdf, 50, 50); cpdf_lineto($cpdf, 740, 330); cpdf_stroke($cpdf); cpdf_finalize_page($cpdf, 1); cpdf_finalize($cpdf); Header("Content-type: application/pdf"); cpdf_output_buffer($cpdf); cpdf_close($cpdf); ?> ]]> </programlisting> </example> <para> Die pdflib-Distribution enthält ein komplexeres Beispiel, das eine Reihe von Seiten mit einer Analoguhr erzeugt. Hier ist dieses Beispiel, das unter Verwendung der ClibPDF-Erweiterung in PHP konvertiert wurde: </para> <example> <title>pdfclock-Beispiel der pdflib 2.0 Distribution</title> <programlisting role="php"> <![CDATA[ <?php $radius = 200; $rand = 20; $seitenzaehler = 40; $pdf = cpdf_open(0); cpdf_set_creator($pdf, "pdf_uhr.php"); cpdf_set_title($pdf, "Analoguhr"); while ($seitenzaehler-- > 0) { cpdf_page_init($pdf, $seitenzaehler+1, 0, 2 * ($radius + $rand), 2 * ($radius + $rand), 1.0); cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0); /* Seitenübergang */ cpdf_translate($pdf, $radius + $rand, $radius + $rand); cpdf_save($pdf); cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); /* Minutenstriche */ cpdf_setlinewidth($pdf, 2.0); for ($alpha = 0; $alpha < 360; $alpha += 6) { cpdf_rotate($pdf, 6.0); cpdf_moveto($pdf, $radius, 0.0); cpdf_lineto($pdf, $radius-$rand/3, 0.0); cpdf_stroke($pdf); } cpdf_restore($pdf); cpdf_save($pdf); /* 5-Minuten-Striche */ cpdf_setlinewidth($pdf, 3.0); for ($alpha = 0; $alpha < 360; $alpha += 30) { cpdf_rotate($pdf, 30.0); cpdf_moveto($pdf, $radius, 0.0); cpdf_lineto($pdf, $radius-$rand, 0.0); cpdf_stroke($pdf); } $ortszeit = getdate(); /* Stundenzeiger zeichnen */ cpdf_save($pdf); cpdf_rotate($pdf, -(($ortszeit['minutes']/60.0) + $ortszeit['hours'] - 3.0) * 30.0); cpdf_moveto($pdf, -$radius/10, -$radius/20); cpdf_lineto($pdf, $radius/2, 0.0); cpdf_lineto($pdf, -$radius/10, $radius/20); cpdf_closepath($pdf); cpdf_fill($pdf); cpdf_restore($pdf); /* Minutenzeiger zeichnen */ cpdf_save($pdf); cpdf_rotate($pdf, -(($ortszeit['seconds']/60.0) + $ortszeit['minutes'] - 15.0) * 6.0); cpdf_moveto($pdf, -$radius/10, -$radius/20); cpdf_lineto($pdf, $radius * 0.8, 0.0); cpdf_lineto($pdf, -$radius/10, $radius/20); cpdf_closepath($pdf); cpdf_fill($pdf); cpdf_restore($pdf); /* Sekundenzeiger zeichnen */ cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); cpdf_setlinewidth($pdf, 2); cpdf_save($pdf); cpdf_rotate($pdf, -(($ortszeit['seconds'] - 15.0) * 6.0)); cpdf_moveto($pdf, -$radius/5, 0.0); cpdf_lineto($pdf, $radius, 0.0); cpdf_stroke($pdf); cpdf_restore($pdf); /* Kleinen Mittelkreis zeichnen */ cpdf_circle($pdf, 0, 0, $radius/30); cpdf_fill($pdf); cpdf_restore($pdf); cpdf_finalize_page($pdf, $seitenzaehler+1); } cpdf_finalize($pdf); Header("Content-type: application/pdf"); cpdf_output_buffer($pdf); cpdf_close($pdf); ?> ]]> </programlisting> </example> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/cpdf/setup.xml +++ phpdoc-de/reference/cpdf/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="cpdf.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="cpdf.requirements"> &reftitle.required; <para> Um die ClibPDF-Funktionen benutzen zu können, müssen Sie das ClibPDF-Paket installieren. Es ist zum Herunterladen erhältlich von <link xlink:href="&url.fastio;">FastIO</link>. Für dessen kommerzielle Verwendung ist es erforderlich, dass Sie eine Lizenz erwerben. Für PHP wird cpdflib >= 2 benötigt. Die Entwicklung der ClibPDF-Bibliothek wurde eingestellt und die FastIO-Website ist höchstwahrscheinlich nicht erreichbar. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.cpdf.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="cpdf.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="cpdf.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/mssql/book.xml +++ phpdoc-de/reference/mssql/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: bundled, external --> <book xml:id="book.mssql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>MS SQL Server</title> <!-- {{{ preface --> <preface xml:id="intro.mssql"> &reftitle.intro; <para> Diese Funktionen ermöglichen Ihnen den Zugriff auf den MS SQL-Datenbankserver. </para> </preface> <!-- }}} --> &reference.mssql.setup; &reference.mssql.constants; &reference.mssql.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/mssql/setup.xml +++ phpdoc-de/reference/mssql/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="mssql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="mssql.requirements"> &reftitle.required; <para> Voraussetzungen für Win32-Plattformen. </para> <para> Für die Erweiterung müssen die MS SQL Client Tools auf dem System installiert sein, auf dem PHP installiert ist. Die Client Tools können entweder von der MS SQL Server-CD oder durch kopieren der <filename>ntwdblib.dll</filename> von <filename>\winnt\system32</filename> auf dem Server nach <filename>\winnt\system32</filename> auf dem PHP-Rechner installiert werden. Mit dem Kopieren der <filename>ntwdblib.dll</filename> wird nur der Zugriff durch benannte Pipes (named pipes) unterstützt. Für die Konfiguration des Clients ist eine Installation aller Tools nötig. </para> <para> Voraussetzungen für Unix/Linux-Plattformen. </para> <para> Um die MSSQL-Erweiterung unter Unix/Linux nutzen zu können, müssen Sie zuerst die FreeTDS-Bibliothek übersetzen und installieren. Quellcode und Installationsanleitung stehen auf der FreeTDS-Homepage zur Verfügung: <link xlink:href="&url.freetds;">&url.freetds;</link> </para> <note> <para> Unter Windows wird die DBLIB von Microsoft verwendet. Funktionen, die einen Feldnamen zurückgeben, basieren auf der DBLIB-Funktion <literal>dbcolname()</literal>. DBLIB wurde für den SQL Server 6.x entwickelt, bei dem die maximale Länge der Bezeichner bei 30 liegt. Aus diesem Grund ist die Länge von Feldern auf maximal 30 Zeichen begrenzt. Auf Plattformen, auf denen FreeTDS verwendet wird (Linux) gibt es dieses Problem nicht. </para> </note> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.mssql.configure; <!-- }}} --> <!-- {{{ Configuration --> &reference.mssql.ini; <!-- }}} --> <!-- {{{ Resources --> <section xml:id="mssql.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/oracle/book.xml +++ phpdoc-de/reference/oracle/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- Purpose: database.vendors --> <!-- Membership: pecl, external --> <!-- State: deprecated --> <book xml:id="book.oracle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Oracle</title> <!-- {{{ preface --> <preface xml:id="intro.oracle"> &reftitle.intro; <warning> <para> Diese Erweiterung sollte nicht mehr verwendet werden. Verwenden Sie stattdessen die verbesserte <link linkend="book.oci8">oci8</link>-Erweiterung. Die hier dokumentierten Funktionen listen die empfohlenen oci8-Alternativen auf. </para> </warning> <para> Diese Erweiterung fügt die Unterstützung für Oracle Datenbanken hinzu. </para> <note> <para> &pecl.moved-ver;5.1.0. </para> </note> </preface> <!-- }}} --> &reference.oracle.setup; &reference.oracle.constants; &reference.oracle.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/oracle/setup.xml +++ phpdoc-de/reference/oracle/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="oracle.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="oracle.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.oracle.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="oracle.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="oracle.resources"> &reftitle.resources; <para> Diese Erweiterung definiert zwei Resource-Typen: eine Oracle-Verbindungskennung und einen Oracle-Cursor-Index. </para> </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/book.xml +++ phpdoc-de/reference/pcre/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> <!-- Purpose: basic.text --> <!-- Membership: bundled --> <book xml:id="book.pcre" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Reguläre Ausdrücke &Functions; (Perl-kompatibel)</title> <titleabbrev>PCRE</titleabbrev> <preface xml:id="intro.pcre"> &reftitle.intro; <para> Die Syntax für Suchmuster, die in diesen Funktionen verwendet werden, ist Perl sehr ähnlich. Der Ausdruck muss zwischen Begrenzungszeichen, z.B. Schrägstrichen (/), stehen. Jedes Zeichen kann als Begrenzungszeichen verwendet werden, solange es kein alphanumerisches Zeichen oder der Backslash (\) ist. Falls das Begrenzungszeichen im Ausdruck selbst verwendet wird, muss es mit dem Backslash als Escape-Zeichen maskiert werden. Ab PHP 4.0.4 können Sie auch dem Perl-Stil entsprechend (), {}, [] und <> als Begrenzung für Suchmuster verwenden. Für eine ausführliche Erklärung siehe <link linkend="reference.pcre.pattern.syntax">Suchmuster-Syntax</link>. </para> <para> An die Schlussbegrenzung können verschiedene Modifikatoren angehängt werden, die das Suchergebnis beeinflussen. Siehe <link linkend="reference.pcre.pattern.modifiers">Modifikatoren für Suchmuster</link>. </para> <para> Bei Verwendung der <link linkend="book.regex">POSIX-erweiterten Reguläre Ausdrücke Funktionen</link> unterstützt PHP auch reguläre Ausdrücke mit POSIX-erweiterter Syntax. </para> <note> <para> Diese Erweiterung unterhält pro Thread einen globalen Cache mit compilierten regulären Ausdrücken (bis zu 4096). </para> </note> <warning> <para> Sie sollten sich über ein paar Einschränkungen von PCRE bewusst sein. Lesen Sie bitte <link xlink:href="&url.pcre.man;">&url.pcre.man;</link> für weitere Informationen. </para> </warning> </preface> &reference.pcre.setup; &reference.pcre.constants; &reference.pcre.examples; &reference.pcre.pattern; &reference.pcre.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/examples.xml +++ phpdoc-de/reference/pcre/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="pcre.examples"> &reftitle.examples; <para> <example> <title>Beispiele gültiger Suchmuster</title> <itemizedlist> <listitem><simpara><literal>/<\/\w+>/</literal></simpara></listitem> <listitem><simpara><literal>|(\d{3})-\d+|Sm</literal></simpara></listitem> <listitem><simpara><literal>/^(?i)php[34]/</literal></simpara></listitem> <listitem><simpara><literal>{^\s+(\s+)?$}</literal></simpara></listitem> </itemizedlist> </example> </para> <para> <example> <title>Beispiele ungültiger Suchmuster</title> <itemizedlist> <listitem> <simpara> <literal>/href='(.*)'</literal> - fehlender Begrenzer am Ende </simpara> </listitem> <listitem> <simpara> <literal>/\w+\s*\w+/J</literal> - ungültiger Modifikator 'J' </simpara> </listitem> <listitem> <simpara> <literal>1-\d3-\d3-\d4|</literal> - fehlender Begrenzer am Anfang </simpara> </listitem> </itemizedlist> </example> </para> </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/ini.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/ini.xml +++ phpdoc-de/reference/pcre/ini.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> <section xml:id="pcre.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; <para> <table> <title>PCRE-Konfigurationsoptionen</title> <tgroup cols="4"> <thead> <row> <entry>Name</entry> <entry>Standardwert</entry> <entry>Änderbar</entry> <entry>Änderungen</entry> </row> </thead> <tbody> <row> <entry>pcre.backtrack_limit</entry> <entry>"100000"</entry> <entry>PHP_INI_ALL</entry> <entry>Steht ab PHP 5.2.0 zur Verfügung</entry> </row> <row> <entry>pcre.recursion_limit</entry> <entry>"100000"</entry> <entry>PHP_INI_ALL</entry> <entry>Steht ab PHP 5.2.0 zur Verfügung</entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> &ini.descriptions.title; <para> <variablelist> <varlistentry xml:id="ini.pcre.backtrack-limit"> <term> <parameter>pcre.backtrack_limit</parameter> <type>integer</type> </term> <listitem> <para> PCREs Zurückverfolgungs- (Backtracking-) Limit. </para> </listitem> </varlistentry> <varlistentry xml:id="ini.pcre.recursion-limit"> <term> <parameter>pcre.recursion_limit</parameter> <type>integer</type> </term> <listitem> <para> PCREs Rekursionslimit. Bitte beachten Sie, dass bei einem hohen Wert der gesamte verfügbare Prozess-Stack verwendet werden könnte und PHP schließlich (wenn es das vom Betriebssystem vorgegebene Limit für die Stackgröße erreicht) abstürzen könnte. </para> </listitem> </varlistentry> </variablelist> </para> </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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/pattern.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pcre/pattern.xml +++ phpdoc-de/reference/pcre/pattern.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <part xml:id="pcre.pattern"> <title>PCRE-Suchmuster</title> &reference.pcre.pattern.modifiers; &reference.pcre.pattern.syntax; </part> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/posix/book.xml +++ phpdoc-de/reference/posix/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: fileprocess.process --> <!-- Membership: bundled --> <book xml:id="book.posix" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>POSIX</title> <!-- {{{ preface --> <preface xml:id="intro.posix"> &reftitle.intro; <para> Dieses Modul enthält eine Schnittstelle zu den im IEEE 1003.1 (POSIX.1) Standards Dokument definierten Funktionen, die auf einem anderen Weg nicht erreichbar sind. POSIX.1 definierte zum Beispiel auch die open(), read(), write() und close() Funktionen, die seit langer Zeit Bestandteil von PHP 3 sind. Trotzdem standen einige andere systemspezifische Funktionen bisher nicht zur Verfügung. Dieses Modul versucht hier Abhilfe zu schaffen, indem es einen einfachen Zugang zu diesen Funktionen bereitstellt. </para> <warning> <para> Sensible Daten können mit den POSIX-Funktionen, z.B. <function>posix_getpwnam</function> und Freunde, abgefragt werden. Die POSIX-Funktionen führen keinerlei Zugriffsüberprüfungen durch, wenn <link linkend="ini.safe-mode">safe mode</link> aktiviert ist. Es wird daher <emphasis role="strong">dringend</emphasis> empfohlen, die POSIX-Erweiterung komplett zu deaktivieren (verwenden Sie dazu bei der Konfiguration <literal>--disable-posix</literal>), wenn Sie in einer solchen Umgebung arbeiten. </para> </warning> ¬e.no-windows.extension; </preface> <!-- }}} --> &reference.posix.setup; &reference.posix.constants; &reference.posix.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/posix/setup.xml +++ phpdoc-de/reference/posix/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="posix.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="posix.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.posix.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="posix.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="posix.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pspell/book.xml +++ phpdoc-de/reference/pspell/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: international --> <!-- Membership: bundled, external --> <book xml:id="book.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Pspell</title> <!-- {{{ preface --> <preface xml:id="intro.pspell"> &reftitle.intro; <para> Diese Funktionen ermöglichen Ihnen, die Rechtschreibung eines Wortes zu prüfen und bieten Änderungsvorschläge an. </para> </preface> <!-- }}} --> &reference.pspell.setup; &reference.pspell.constants; &reference.pspell.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/pspell/setup.xml +++ phpdoc-de/reference/pspell/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="pspell.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="pspell.requirements"> &reftitle.required; <para> Um PHP mit pspell-Unterstützung zu kompilieren, brauchen Sie die aspell-Bibliothek, die Sie unter <link xlink:href="&url.aspell;">&url.aspell;</link> bekommen. </para> </section> <!-- }}} --> <!-- {{{ Installation --> &reference.pspell.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="pspell.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="pspell.resources"> &reftitle.resources; &no.resource; </section> <!-- }}} --> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/book.xml +++ phpdoc-de/reference/regex/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: basic.text --> <!-- Membership: core --> <book xml:id="book.regex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Reguläre Ausdrücke &Functions; (POSIX-erweitert)</title> <titleabbrev>POSIX Regex</titleabbrev> <preface xml:id="intro.regex"> &reftitle.intro; <tip> <para> Bei Verwendung der <link linkend="book.pcre">PCRE Funktionen</link> unterstützt PHP auch Reguläre Ausdrücke mit einer zu Perl kompatiblen Syntax. Diese Funktionen unterstützen nicht-gieriges (non-greedy) Matching, Assertions, bedingte Teilsuchmuster und viele andere Merkmale, die von der POSIX-erweiterten Syntax regulärer Ausdrücke nicht unterstützt werden. </para> </tip> <warning> <para> Diese Funktionen regulärer Ausdrücke sind im Gegensatz zu den <link linkend="book.pcre">PCRE Funktionen</link> nicht binärsicher. </para> </warning> <para> Reguläre Ausdrücke werden für komplexe Manipulationen an Zeichenketten verwendet. PHP verwendet durch POSIX 1003.2 definierte POSIX erweiterte reguläre Ausdrücke. Eine vollständige Beschreibung der POSIX regulären Ausdrücke finden Sie im Regex-Verzeichnis der PHP-Distribution in den <link xlink:href="&url.regex.man;">Regex man pages</link>. Da sie im manpage-Fomat vorliegt, sollten Sie einen Befehl der Art <command>man /usr/local/src/regex/regex.7</command> verwenden, um sie zu lesen. </para> </preface> &reference.regex.setup; &reference.regex.constants; &reference.regex.examples; &reference.regex.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/constants.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/constants.xml +++ phpdoc-de/reference/regex/constants.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="regex.constants"> &reftitle.constants; &no.constants; </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/examples.xml +++ phpdoc-de/reference/regex/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="regex.examples"> &reftitle.examples; <para> <example> <title>Beispiele regulärer Ausdrücke</title> <programlisting role="php"> <![CDATA[ <?php // Gibt true zurück, falls "abc" irgendwo in $zeichenkette gefunden wird. ereg("abc", $zeichenkette); // Gibt true zurück, falls "abc" am Anfang von $zeichenkette gefunden wird. ereg("^abc", $zeichenkette); // Gibt true zurück, falls "abc" am Ende von $zeichenkette gefunden wird. ereg("abc$", $zeichenkette); // Gibt true zurück, falls es sich beim Client Browser um Netscape 2, 3 oder // MSIE 3 handelt. eregi("(ozilla.[23]|MSIE.3)", $_SERVER["HTTP_USER_AGENT"]); // Setzt drei Wörter, die durch Leerzeichen getrennt sind, in $regs[1], // $regs[2] und $regs[3] ein. ereg("([[:alnum:]]+) ([[:alnum:]]+) ([[:alnum:]]+)", $zeichenkette, $regs); // Setzt ein <br /> Tag vor $zeichenkette. $zeichenkette = ereg_replace("^", "<br />", $zeichenkette); // Setzt ein <br /> Tag hinter $zeichenkette. $zeichenkette = ereg_replace("$", "<br />", $zeichenkette); // Entfernt alle Zeilenumbrüche aus $zeichenkette. $zeichenkette = ereg_replace("\n", "", $zeichenkette); ?> ]]> </programlisting> </example> </para> </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/regex/setup.xml +++ phpdoc-de/reference/regex/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="regex.setup"> &reftitle.setup; <section xml:id="regex.requirements"> &reftitle.required; &no.requirement; </section> &reference.regex.configure; <section xml:id="regex.configuration"> &reftitle.runtime; &no.config; </section> <section xml:id="regex.resources"> &reftitle.resources; &no.resource; </section> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/book.xml +++ phpdoc-de/reference/session/book.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <!-- Purpose: basic.session --> <!-- Membership: core --> <book xml:id="book.session" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Session &Functions;</title> <titleabbrev>Sessions</titleabbrev> <!-- {{{ preface --> <preface xml:id="intro.session"> &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 Anwendungen erstellen und Ihre Website ansprechender gestalten. </para> <para> Einem Besucher wird beim Aufruf Ihrer Website eine eindeutige ID, die sogenannte Session-ID, zugeordnet. Diese wird entweder benutzerseitig in einem Cookie abgelegt oder in der URL übermittelt. </para> <para> 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 <link linkend="ini.session.auto-start">session.auto_start</link> 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, wird die zuvor gespeicherte Umgebung wiederhergestellt. </para> <caution> <para> Falls Sie <link linkend="ini.session.auto-start">session.auto_start</link> aktivieren, können Sie keine Objekte in Ihre Session aufnehmen, weil die Definition der Klasse vor dem Start der Session geladen werden muss, damit die Objekte in Ihrer Session wiederhergestellt werden. </para> </caution> <para> Alle registrierten Variablen werden serialisiert, nachdem die Anfrage beendet ist. Registrierte Variablen, die nicht definiert sind, werden als nicht definiert gekennzeichnet. Auch bei darauf folgenden Zugriffen werden sie nicht vom Session-Modul definiert, außer der Benutzer definiert sie später. </para> <warning> <para> Einige Datentypen können nicht serialisiert werden, um in Sessions gespeichert zu werden. Dazu gehören <type>resource</type>-Variablen oder Objekte mit Ringreferenzen (d.h. Objekte, die eine Referenz auf sich selbst an andere Objekte übergeben). </para> </warning> <note> <para> Die Behandlung von Sessions wurde in PHP 4.0.0 eingeführt. </para> </note> <note> <para> Bitte beachten Sie beim Arbeiten mit Sessions, dass der Datensatz einer Session nicht angelegt wird, bevor eine Variable mit der Funktion <function>session_register</function> registriert oder dem superglobalen Array <varname>$_SESSION</varname> ein neuer Schlüssel hinzugefügt wird. Das gilt auch dann, wenn eine Session mit der Funktion <function>session_start</function> gestartet wurde. </para> </note> </preface> <!-- }}} --> &reference.session.setup; &reference.session.examples; &reference.session.security; &reference.session.reference; </book> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/examples.xml +++ phpdoc-de/reference/session/examples.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <appendix xml:id="session.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.examples; <section xml:id="session.examples.basic"> <note> <para> Ab PHP 4.1.0 steht <varname>$_SESSION</varname> genau wie <varname>$_POST</varname>, <varname>$_GET</varname>, <varname>$_REQUEST</varname> und so weiter, als globale Variable zur Verfügung. Im Gegensatz zu <varname>$HTTP_SESSION_VARS</varname> ist <varname>$_SESSION</varname> immer global. Deshalb brauchen Sie für <varname>$_SESSION</varname> nicht das Schlüsselwort <link linkend="language.variables.scope"><command>global</command></link> zu verwenden. Bitte beachten Sie, dass in dieser Dokumentation nun überall <varname>$_SESSION</varname> verwendet wird. Sie können <varname>$_SESSION</varname> durch <varname>$HTTP_SESSION_VARS</varname> ersetzen, wenn Sie Letzteres bevorzugen. Beachten Sie auch, dass Sie Ihre Session mit <function>session_start</function> starten müssen, bevor <varname>$_SESSION</varname> zur Verfügung steht. </para> <para> Für die Schlüssel des assoziativen <varname>$_SESSION</varname>-Arrays gelten die selben Beschränkungen, wie für die Bezeichnungen von regulären Variablen in PHP, d.h. sie dürfen nicht mit einer Zahl, sondern müssen mit einem Buchstaben oder Unterstrich beginnen. Um weitere Deteils zu erhalten, siehe Abschnitt <link linkend='language.variables'>Variablen</link>. </para> </note> <para> Falls <link linkend="ini.register-globals">register_globals</link> deaktiviert ist, können nur Bestandteile des globalen assoziativen Arrays <varname>$_SESSION</varname> als Session-Variablen registriert werden. Wiederhergestellte Session-Variablen stehen nur im Array <varname>$_SESSION</varname> zur Verfügung. </para> <para> Aus Gründen der Verbesserung der Sicherheit und der Lesbarkeit des Codes wird die Verwendung von <varname>$_SESSION</varname> (oder <varname>$HTTP_SESSION_VARS</varname> bei PHP 4.0.6 oder niedriger) empfohlen. Mit <varname>$_SESSION</varname> werden die Funktionen <function>session_register</function>, <function>session_unregister</function> und <function>session_is_registered</function> nicht benötigt. Auf die Session-Variablen kann wie auf jede normale Variable zugegriffen werden. <example> <title> Registrierung einer Variablen mit <varname>$_SESSION</varname>. </title> <programlisting role="php"> <![CDATA[ <?php session_start(); // Verwenden Sie bei PHP 4.0.6 oder niedriger $HTTP_SESSION_VARS if (!isset($_SESSION['zaehler'])) { $_SESSION['zaehler'] = 0; } else { $_SESSION['zaehler']++; } ?> ]]> </programlisting> </example> <example> <title> Aufheben der Registrierung einer Variablen mit <varname>$_SESSION</varname> und deaktiviertem <link linkend="ini.register-globals">register_globals</link>. </title> <programlisting role="php"> <![CDATA[ <?php session_start(); // Verwenden Sie bei PHP 4.0.6 oder niedriger $HTTP_SESSION_VARS unset($_SESSION['zaehler']); ?> ]]> </programlisting> </example> </para> <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> <warning> <para> Sie können in Session-Variablen keine Referenzen verwenden, weil es keine praktikable Möglichkeit gibt, eine Referenz in eine andere Variable zurückzuführen. </para> </warning> <para> Wenn <link linkend="ini.register-globals">register_globals</link> aktiviert ist, kann jede globalen Variable als Session-Variable registriert werden. Beim Neustart einer Session werden diese Variablen als entsprechende globale Variablen wiederhergestellt. Da PHP wissen muss, welche globalen Variablen als Session-Variablen registriert sind, muss der Benutzer Variablen mit der Funktion <function>session_register</function> registrieren. Sie können das vermeiden, indem Sie einfach Einträge in <varname>$_SESSION</varname> setzen. <caution> <para> Verwenden Sie nicht <function>session_register</function>, <function>session_is_registered</function> und <function>session_unregister</function>, wenn Sie <varname>$_SESSION</varname> vor PHP 4.3.0 verwenden und <link linkend="ini.register-globals">register_globals</link> deaktiviert ist. Es ist sowohl aus Sicherheitsgründen als auch wegen der Performance empfehlenswert, <link linkend="ini.register-globals">register_globals</link> zu deaktivieren. </para> </caution> </para> <para> Wenn <link linkend="ini.register-globals">register_globals</link> aktiviert ist, dann referenzieren die globalen Variablen und die Einträge von <varname>$_SESSION</varname> automatisch die selben Werte, die in der vorherigen Instanz der Session registriert wurden. Falls die Variable mittels <varname>$_SESSION</varname> registriert wird, steht die globale Variable allerdings erst ab der nächsten Anfrage zur Verfügung. </para> <para> Es gibt einen Fehler in PHP 4.2.3 und früheren Versionen. Wenn Sie eine neue Session-Variable mittels <function>session_register</function> registrieren, referenzieren der Eintrag im globalen Bereich und der <varname>$_SESSION</varname>-Eintrag bis zum nächsten <function>session_start</function> nicht den selben Wert. D.h. eine Änderung an der neu registrierten globalen Variablen wird nicht vom <varname>$_SESSION</varname>-Eintrag widergespiegelt. Dies wurde in PHP 4.3.0 korrigiert. </para> </section> <section xml:id="session.idpassing"> <title>Übermittlung der Session-ID</title> <para> Es gibt zwei Methoden, eine Session-ID zu übermitteln: <itemizedlist> <listitem> <simpara> Cookies </simpara> </listitem> <listitem> <simpara> URL-Parameter </simpara> </listitem> </itemizedlist> </para> <para> Das Session-Modul unterstützt beide Methoden. Cookies sind optimal, aber da sie nicht immer zur Verfügung stehen, bieten wir auch noch eine Alternative an. Die zweite Methode hängt die Session-ID direkt an die URLs. </para> <para> PHP ist in der Lage, Links transparent umzuwandeln. Falls Sie nicht PHP 4.2.0 oder höher verwenden, müssen Sie das beim Übersetzen von PHP manuell aktivieren. Unter Unix müssen Sie dazu configure mit <link linkend="ini.session.use-trans-sid"> --enable-trans-sid</link> aufrufen. Wenn diese 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> Die &php.ini;-Anweisung <link linkend="ini.arg-separator.output">arg_separator.output</link> ermöglicht es, die Trennung von Argumenten anzupassen. Geben Sie dort für volle XHTML-Konformität &amp; an. </para> </note> </para> <para> Alternativ können Sie die Konstante <literal>SID</literal> verwenden, die definiert ist, nachdem die Session gestartet wurde. 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 wird und wie unter Verwendung einer SID korrekt auf eine andere Seite verwiesen wird. <example> <title>Zählen der Seitenaufrufe eines einzelnen Benutzers</title> <programlisting role="php"> <![CDATA[ <?php session_start(); if (empty($_SESSION['zaehler'])) { $_SESSION['zaehler'] = 1; } else { $_SESSION['zaehler']++; } ?> <p> Hallo Besucher, Sie haben diese Seite <?php echo $_SESSION['zaehler']; ?> mal aufgerufen. </p> <p> Hier gehts <a href="nextpage.php?<?php echo htmlspecialchars(SID); ?>">weiter</a>. </p> ]]> </programlisting> </example> </para> <para> Die Funktion <function>htmlspecialchars</function> kann dazu verwendet werden, um bei der Ausgabe der SID XSS-ähnliche Angriffe zu verhindern. </para> <para> Die oben gezeigte Ausgabe der SID ist nicht nötig, wenn PHP mit <link linkend="ini.session.use-trans-sid"> --enable-trans-sid</link> übersetzt wurde. </para> <note> <para> Bei nichtrelativen URLs wird davon ausgegangen, dass sie auf 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> </section> <section xml:id="session.customhandler"> <title>Individuelle Session-Routinen</title> <para> Wenn Sie die Speicherung in einer Datenbank oder irgendeine andere Art der Speicherung realisieren wollen, können Sie <function>session_set_save_handler</function> verwenden, um eine Reihe von benutzerdefinierten Speicherfunktionen zu erzeugen. </para> </section> </appendix> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/security.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/security.xml +++ phpdoc-de/reference/session/security.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="session.security" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Sessions und Sicherheit</title> <para> Externe Links: <link xlink:href="&url.session-fixation;">Session fixation</link> </para> <para> Das Session-Modul bietet keine Garantie dafür, dass 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 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 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 Session-ID an Dritte gelangen kann. Eine entführte Session-ID ermöglicht diesen, auf alle Daten zuzugreifen, die mit dieser Session-ID verbunden sind. Zum einen sind das URLs, die Session-IDs enthalten. Wenn Sie auf eine externe Site verweisen, könnte die URL inklusive Session-ID in den Referrer-Logs der externen Site gespeichert werden. Zum anderen kann ein aktiverer Angreifer Ihren Netzwerkverkehr abhören. Falls Ihr Netzwerkverkehr nicht verschlüsselt ist, werden Session-IDs im Klartext über das Netzwerk übertragen. Hier ist die Lösung, auf Ihrem Server SSL zu implementieren und die Verwendung für Ihre Benutzer obligatorisch zu machen. </para> </chapter> <!-- 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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/session/setup.xml +++ phpdoc-de/reference/session/setup.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: samesch Status: ready --> <chapter xml:id="session.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <section xml:id="session.requirements"> &reftitle.required; &no.requirement; <note> <para> 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 <link xlink:href="&url.mm;">mm</link> 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. Die Session-Daten werden im Hauptspeicher gespeichert und folglich bei einem Neustart des Webservers gelöscht. </para> </note> </section> &reference.session.configure; &reference.session.ini; <section xml:id="session.resources"> &reftitle.resources; &no.resource; </section> </chapter> <!-- 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 -->