cvs: phpdoc-de /reference/cpdf constants.xml reference.xml /reference/mssql constants.xml reference.xml /reference/oracle constants.xml
reference.xml /reference/pcre constants.xml reference.xml /reference/posix constants.xml reference.xml /reference/pspell constants.xml
reference.xml /reference/regex reference.xml /reference/session constants.xml reference.xml
| From: | Martin Samesch | Date: | Fri, 28 Dec 2007 08:51:39 +0000 |
| Subject: | cvs: phpdoc-de /reference/cpdf constants.xml reference.xml /reference/mssql constants.xml reference.xml /reference/oracle constants.xml reference.xml /reference/pcre constants.xml reference.xml /reference/posix constants.xml reference.xml /reference/pspell constants.xml reference.xml /reference/regex reference.xml /reference/session constants.xml reference.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2341@lists.php.net to get a copy of this message | ||
samesch Fri Dec 28 08:51:39 2007 UTC
Modified files:
/phpdoc-de/reference/cpdf constants.xml reference.xml
/phpdoc-de/reference/mssql constants.xml reference.xml
/phpdoc-de/reference/oracle constants.xml reference.xml
/phpdoc-de/reference/pcre constants.xml reference.xml
/phpdoc-de/reference/posix constants.xml reference.xml
/phpdoc-de/reference/pspell constants.xml reference.xml
/phpdoc-de/reference/regex reference.xml
/phpdoc-de/reference/session constants.xml reference.xml
Log:
syncing with EN
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/cpdf/constants.xml diff -u phpdoc-de/reference/cpdf/constants.xml:1.4 phpdoc-de/reference/cpdf/constants.xml:1.5 --- phpdoc-de/reference/cpdf/constants.xml:1.4 Sat Jun 23 13:21:30 2007 +++ phpdoc-de/reference/cpdf/constants.xml Fri Dec 28 08:51:38 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="cpdf.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="cpdf.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -12,89 +12,89 @@ </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PM_OUTLINES</constant> + <constant>CPDF_PM_OUTLINES</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PM_THUMBS</constant> + <constant>CPDF_PM_THUMBS</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PM_FULLSCREEN</constant> + <constant>CPDF_PM_FULLSCREEN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_SINGLE</constant> + <constant>CPDF_PL_SINGLE</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_1COLUMN</constant> + <constant>CPDF_PL_1COLUMN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_2LCOLUMN</constant> + <constant>CPDF_PL_2LCOLUMN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_2RCOLUMN</constant> + <constant>CPDF_PL_2RCOLUMN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/reference.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-de/reference/cpdf/reference.xml diff -u phpdoc-de/reference/cpdf/reference.xml:1.18 phpdoc-de/reference/cpdf/reference.xml:1.19 --- phpdoc-de/reference/cpdf/reference.xml:1.18 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/cpdf/reference.xml Fri Dec 28 08:51:38 2007 @@ -1,247 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.19 Maintainer: samesch Status: ready --> -<!-- Purpose: utilspec.nontext --> -<!-- Membership: pecl, external --> -<!-- State: deprecated --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.20 Maintainer: samesch Status: ready --> <reference xml:id="ref.cpdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>ClibPDF Funktionen [veraltet]</title> - <titleabbrev>ClibPDF</titleabbrev> - - <partintro> - - <section xml:id="cpdf.intro"> - &reftitle.intro; - <warning> - <para> - Da es für ClibPDF keinen Support mehr gibt, wird dringend empfohlen, eine - Alternative wie <link linkend="ref.haru">Haru</link>, <link - linkend="ref.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="ref.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="ref.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="ref.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. - Dies ist eine praktische Fähigkeit, die bei Verwendung der <link - linkend="ref.pdf">PDFlib</link> aber 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, siehe - <link linkend="faq.using.freepdf">die diesbezügliche FAQ</link>. - </simpara> - </note> - </section> - - <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>, aber 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> - - &reference.cpdf.configure; - - <section xml:id="cpdf.configuration"> - &reftitle.runtime; - &no.config; - </section> - - &reference.cpdf.constants; - - <section xml:id="cpdf.examples"> - &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; -$margin = 20; -$pagecount = 40; - -$pdf = cpdf_open(0); -cpdf_set_creator($pdf, "pdf_clock.php"); -cpdf_set_title($pdf, "Analog Clock"); - -while ($pagecount-- > 0) { - cpdf_page_init($pdf, $pagecount+1, 0, 2 * ($radius + $margin), 2 * ($radius + $margin), 1.0); - - cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0); /* wipe */ - - cpdf_translate($pdf, $radius + $margin, $radius + $margin); - cpdf_save($pdf); - cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - - /* minute strokes */ - 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-$margin/3, 0.0); - cpdf_stroke($pdf); - } - - cpdf_restore($pdf); - cpdf_save($pdf); - - /* 5 minute strokes */ - 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-$margin, 0.0); - cpdf_stroke($pdf); - } - - $ltime = getdate(); - - /* draw hour hand */ - cpdf_save($pdf); - cpdf_rotate($pdf, -(($ltime['minutes']/60.0) + $ltime['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); - - /* draw minute hand */ - cpdf_save($pdf); - cpdf_rotate($pdf, -(($ltime['seconds']/60.0) + $ltime['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); - - /* draw second hand */ - cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); - cpdf_setlinewidth($pdf, 2); - cpdf_save($pdf); - cpdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); - cpdf_moveto($pdf, -$radius/5, 0.0); - cpdf_lineto($pdf, $radius, 0.0); - cpdf_stroke($pdf); - cpdf_restore($pdf); - - /* draw little circle at center */ - cpdf_circle($pdf, 0, 0, $radius/30); - cpdf_fill($pdf); - - cpdf_restore($pdf); - - cpdf_finalize_page($pdf, $pagecount+1); -} - -cpdf_finalize($pdf); -Header("Content-type: application/pdf"); -cpdf_output_buffer($pdf); -cpdf_close($pdf); -?> -]]> - </programlisting> - </example> - </section> - - <section xml:id="cpdf.seealso"> - &reftitle.seealso; - <para> - Siehe auch die Dokumentation der <link - linkend="ref.pdf">PDFlib</link>-Erweiterung. - </para> - </section> + <title>ClibPDF &Functions; [veraltet]</title> + <partintro xml:id="cpdf.seealso"> + &reftitle.seealso; + <para> + Siehe auch die Dokumentation der <link + linkend="ref.pdf">PDFlib</link>-Erweiterung. + </para> </partintro> &reference.cpdf.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/mssql/constants.xml diff -u phpdoc-de/reference/mssql/constants.xml:1.4 phpdoc-de/reference/mssql/constants.xml:1.5 --- phpdoc-de/reference/mssql/constants.xml:1.4 Sat Jun 23 13:21:41 2007 +++ phpdoc-de/reference/mssql/constants.xml Fri Dec 28 08:51:38 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="mssql.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="mssql.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -127,7 +127,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/reference.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-de/reference/mssql/reference.xml diff -u phpdoc-de/reference/mssql/reference.xml:1.15 phpdoc-de/reference/mssql/reference.xml:1.16 --- phpdoc-de/reference/mssql/reference.xml:1.15 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/mssql/reference.xml Fri Dec 28 08:51:38 2007 @@ -1,76 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> -<!-- Purpose: database.vendors --> -<!-- Membership: bundled, external --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.16 Maintainer: samesch Status: ready --> <reference xml:id="ref.mssql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Microsoft SQL Server Funktionen</title> - <titleabbrev>MS SQL Server</titleabbrev> - <partintro> - - <section xml:id="mssql.intro"> - &reftitle.intro; - <para> - Diese Funktionen ermöglichen Ihnen den Zugriff auf den MS - SQL-Datenbankserver. - </para> - </section> - - <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 - class="directory">\winnt\system32</filename> auf dem Server nach <filename - class="directory">\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> - - &reference.mssql.configure; - - &reference.mssql.ini; - - <section xml:id="mssql.resources"> - &reftitle.resources; - <para> - </para> - </section> - - &reference.mssql.constants; - - </partintro> &reference.mssql.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/oracle/constants.xml diff -u phpdoc-de/reference/oracle/constants.xml:1.4 phpdoc-de/reference/oracle/constants.xml:1.5 --- phpdoc-de/reference/oracle/constants.xml:1.4 Sat Jun 23 13:21:43 2007 +++ phpdoc-de/reference/oracle/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="oracle.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="oracle.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -61,7 +61,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/reference.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/oracle/reference.xml diff -u phpdoc-de/reference/oracle/reference.xml:1.11 phpdoc-de/reference/oracle/reference.xml:1.12 --- phpdoc-de/reference/oracle/reference.xml:1.11 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/oracle/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,49 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> -<!-- Purpose: database.vendors --> -<!-- Membership: pecl, external --> -<!-- State: deprecated --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.14 Maintainer: samesch Status: ready --> <reference xml:id="ref.oracle" xmlns="http://docbook.org/ns/docbook"> - <title>Oracle Funktionen [veraltet]</title> + <title>Oracle &Functions; [veraltet]</title> <titleabbrev>Oracle</titleabbrev> - <partintro> - <section xml:id="oracle.intro"> - &reftitle.intro; - <warning> - <para> - Diese Erweiterung sollte nicht mehr verwendet werden. Verwenden Sie - stattdessen die verbesserte <link - linkend="ref.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> - </section> - - &reference.oracle.configure; - - <section xml:id="oracle.resources"> - &reftitle.resources; - <para> - Diese Erweiterung definiert zwei Resource-Typen: eine - Oracle-Verbindungskennung und einen Oracle-Cursor-Index. - </para> - </section> - - &reference.oracle.constants; - - </partintro> - &reference.oracle.entities.functions; </reference> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/constants.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/pcre/constants.xml diff -u phpdoc-de/reference/pcre/constants.xml:1.7 phpdoc-de/reference/pcre/constants.xml:1.8 --- phpdoc-de/reference/pcre/constants.xml:1.7 Sun Jul 29 20:14:50 2007 +++ phpdoc-de/reference/pcre/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> -<section xml:id="pcre.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.14 Maintainer: samesch Status: ready --> +<appendix xml:id="pcre.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <table> @@ -19,7 +19,7 @@ <entry> Sortiert die Ergebnisse so, dass $matches[0] ein Array von Übereinstimmungen mit dem ganzen Suchmuster ist, $matches[1] ein Array - von Zeichenketten, die mit dem ersten geklammerten Teil-Suchmuster + von Zeichenketten, die mit dem ersten geklammerten Teilsuchmuster übereinstimmen und so weiter. Dieses Flag wird nur bei <function>preg_match_all</function> verwendet. </entry> @@ -37,7 +37,7 @@ <entry><constant>PREG_OFFSET_CAPTURE</constant></entry> <entry> Siehe Beschreibung von <constant>PREG_SPLIT_OFFSET_CAPTURE</constant>. - Dieses Flag steht seit PHP 4.3.0 zur Verfügung. + Dieses Flag steht ab PHP 4.3.0 zur Verfügung. </entry> </row> <row> @@ -52,7 +52,7 @@ <entry> Dieses Flag teilt der Funktion <function>preg_split</function> mit, dass sie auch die eingeklammerten Ausdrücke des Trennsymbol-Musters - zurückgeben soll. Dieses Flag steht seit PHP 4.0.5 zur Verfügung. + zurückgeben soll. Dieses Flag steht ab PHP 4.0.5 zur Verfügung. </entry> </row> <row> @@ -63,7 +63,7 @@ Rückgabewerte in einem Array dahingehend ändert, dass jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als erstem und deren Stelle im durchsuchten Text als zweitem Element besteht. Dieses - Flag steht seit PHP 4.3.0 zur Verfügung und wird nur bei + Flag steht ab PHP 4.3.0 zur Verfügung und wird nur bei <function>preg_split</function> verwendet. </entry> </row> @@ -71,15 +71,14 @@ <entry><constant>PREG_NO_ERROR</constant></entry> <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, - falls kein Fehler aufgetreten ist. Es steht seit PHP 5.2.0 zur - Verfügung. + falls kein Fehler aufgetreten ist. Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> <row> <entry><constant>PREG_INTERNAL_ERROR</constant></entry> <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, - falls ein interner PCRE-Fehler aufgetreten ist. Es steht seit PHP 5.2.0 + falls ein interner PCRE-Fehler aufgetreten ist. Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> @@ -88,8 +87,8 @@ <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, falls das <link linkend="ini.pcre.backtrack-limit">Limit der - Zurückverfolgung (Backtracking)</link> überschritten wurde. Es steht - seit PHP 5.2.0 zur Verfügung. + Zurückverfolgung (Backtracking)</link> überschritten wurde. Es steht ab + PHP 5.2.0 zur Verfügung. </entry> </row> <row> @@ -98,30 +97,30 @@ Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, falls das <link linkend="ini.pcre.recursion-limit">Rekursionslimit</link> überschritten - wurde. Es steht seit PHP 5.2.0 zur Verfügung. + wurde. Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> <row> <entry><constant>PREG_BAD_UTF8_ERROR</constant></entry> <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, - falls der letzte Fehler durch fehlerhafte UTF8-Daten verursacht wurde + falls der letzte Fehler durch fehlerhafte UTF-8-Daten verursacht wurde (nur bei RegEx, die im <link linkend="reference.pcre.pattern.modifiers">UTF-8-Modus</link> laufen). - Es steht seit PHP 5.2.0 zur Verfügung. + Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> <row> <entry><constant>PCRE_VERSION</constant></entry> <entry> Die PCRE-Version und das Freigabedatum (z.B. "7.0 18-Dec-2006"). Dieses - Flag steht seit PHP 5.2.4 zur Verfügung. + Flag steht ab PHP 5.2.4 zur Verfügung. </entry> </row> </tbody> </tgroup> </table> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/reference.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/pcre/reference.xml diff -u phpdoc-de/reference/pcre/reference.xml:1.10 phpdoc-de/reference/pcre/reference.xml:1.11 --- phpdoc-de/reference/pcre/reference.xml:1.10 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/pcre/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,118 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.19 Maintainer: samesch Status: ready --> -<!-- Purpose: basic.text --> -<!-- Membership: bundled --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.20 Maintainer: samesch Status: ready --> <reference xml:id="ref.pcre" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Reguläre Ausdrücke Funktionen (Perl-kompatibel)</title> - <titleabbrev>PCRE</titleabbrev> + <title>PCRE &Functions;</title> - <partintro> - <section xml:id="pcre.intro"> - &reftitle.intro; - <para> - Die Syntax für Suchmuster, die in diesen Funktionen verwendet werden, ist - Perl sehr ähnlich. Der Ausdruck muss von Begrenzungszeichen, z.B. von - Schrägstrichen (/), umgeben sein. 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. Seit 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="ref.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> - </section> - - <section xml:id="pcre.requirements"> - &reftitle.required; - &no.requirement; - </section> - - &reference.pcre.configure; - &reference.pcre.ini; - - <section xml:id="pcre.resources"> - &reftitle.resources; - &no.resource; - </section> - - &reference.pcre.constants; - - <section 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> - </section> - </partintro> - - &reference.pcre.pattern.modifiers; - &reference.pcre.pattern.syntax; &reference.pcre.entities.functions; </reference> @@ -137,3 +29,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/posix/constants.xml diff -u phpdoc-de/reference/posix/constants.xml:1.4 phpdoc-de/reference/posix/constants.xml:1.5 --- phpdoc-de/reference/posix/constants.xml:1.4 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="posix.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="posix.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -112,7 +112,7 @@ könnten. </para> </note> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/reference.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/posix/reference.xml diff -u phpdoc-de/reference/posix/reference.xml:1.11 phpdoc-de/reference/posix/reference.xml:1.12 --- phpdoc-de/reference/posix/reference.xml:1.11 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/posix/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,55 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> -<!-- Purpose: fileprocess.process --> -<!-- Membership: bundled --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> <reference xml:id="ref.posix" xmlns="http://docbook.org/ns/docbook"> - <title>POSIX Funktionen</title> - <titleabbrev>POSIX</titleabbrev> + <title>POSIX &Functions;</title> - <partintro> - <section xml:id="posix.intro"> - &reftitle.intro; - <para> - Dieses Modul enthält eine Schnittstelle zu den im IEEE 1003.1 - (POSIX.1) Standards Dokument definierten Funktionen, die durch - andere Mittel 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 - <link linkend="ref.posix">POSIX</link>-Funktionen, z.B. - <function>posix_getpwnam</function> und Freunde, abgefragt - werden. Die <link linkend="ref.posix">POSIX</link>-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 - <link linkend="ref.posix">POSIX</link>-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; - </section> - - &reference.posix.configure; - &reference.posix.constants; - - <section xml:id="posix.seealso"> - &reftitle.seealso; - <para> - Der Abschnitt über <link - linkend="ref.pcntl">Prozesskontroll-Funktionen</link> könnte für - Sie von Interesse sein. - </para> - </section> + <partintro xml:id="posix.seealso"> + &reftitle.seealso; + <para> + Der Abschnitt über <link + linkend="book.pcntl">Prozesskontroll-Funktionen</link> könnte für Sie von + Interesse sein. + </para> </partintro> &reference.posix.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/pspell/constants.xml diff -u phpdoc-de/reference/pspell/constants.xml:1.4 phpdoc-de/reference/pspell/constants.xml:1.5 --- phpdoc-de/reference/pspell/constants.xml:1.4 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pspell/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="pspell.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="pspell.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -50,7 +50,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/reference.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/pspell/reference.xml diff -u phpdoc-de/reference/pspell/reference.xml:1.9 phpdoc-de/reference/pspell/reference.xml:1.10 --- phpdoc-de/reference/pspell/reference.xml:1.9 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/pspell/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,47 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> -<!-- Purpose: international --> -<!-- Membership: bundled, external --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <reference xml:id="ref.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Pspell Funktionen</title> - <titleabbrev>Pspell</titleabbrev> - - <partintro> - - <section xml:id="pspell.intro"> - &reftitle.intro; - <para> - Diese Funktionen ermöglichen Ihnen, die Rechtschreibung eines - Wortes zu prüfen und bieten Änderungsvorschläge an. - </para> - </section> - - <section xml:id="pspell.requirements"> - &reftitle.required; - <para> - Um PHP mit pspell-Unterstützung zu compilieren, brauchen Sie die - aspell-Bibliothek, die Sie unter <link - xlink:href="&url.aspell;">&url.aspell;</link> bekommen. - </para> - </section> - - &reference.pspell.configure; - - <section xml:id="pspell.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="pspell.resources"> - &reftitle.resources; - &no.resource; - </section> - - &reference.pspell.constants; - - </partintro> + <title>Pspell &Functions;</title> &reference.pspell.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/reference.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-de/reference/regex/reference.xml diff -u phpdoc-de/reference/regex/reference.xml:1.16 phpdoc-de/reference/regex/reference.xml:1.17 --- phpdoc-de/reference/regex/reference.xml:1.16 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/regex/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,117 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> -<!-- Purpose: basic.text --> -<!-- Membership: core --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.17 Maintainer: samesch Status: ready --> <reference xml:id="ref.regex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Reguläre Ausdrücke Funktionen (POSIX erweitert)</title> - <titleabbrev>POSIX Regex</titleabbrev> + <title>Regex &Functions;</title> - <partintro> - <section xml:id="regex.intro"> - &reftitle.intro; - <tip> - <para> - Bei Verwendung der <link linkend="ref.pcre">PCRE - Funktionen</link> unterstützt PHP auch Reguläre Ausdrücke mit - einer zu Perl kompatiblen Syntax. Diese Funktionen unterstützen - non-greedy Matching, Assertions, bedingte Subpatterns 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="ref.pcre">PCRE Funktionen</link> nicht - binary-safe. - </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> - </section> - - <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> - - <section xml:id="regex.constants"> - &reftitle.constants; - &no.constants; - </section> - - <section 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 $string gefunden wird. -ereg("abc", $string); - -// Gibt true zurück, falls "abc" am Anfang von $string gefunden wird. -ereg("^abc", $string); - -// Gibt true zurück, falls "abc" am Ende von $string gefunden wird. -ereg("abc$", $string); - -// 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:]]+)", $string, $regs); - -// Setzt ein <br /> Tag vor $string. -$string = ereg_replace("^", "<br />", $string); - -// Setzt ein <br /> Tag hinter $string. -$string = ereg_replace("$", "<br />", $string); - -// Entfernt alle Zeilenumbrüche aus $string. -$string = ereg_replace("\n", "", $string); -?> -]]> - </programlisting> - </example> - </para> - </section> - - <section xml:id="regex.seealso"> - &reftitle.seealso; - <para> - Schauen Sie sich bezüglich regulärer Ausdrücke mit einer zu Perl - kompatiblen Syntax die <link - linkend="ref.pcre">PCRE Funktionen</link> an. - <function>fnmatch</function> bietet die Möglichkeit der Suche - nach Übereinstimmungen mit Wildcard-Suchmustern im einfacheren - Shell-Stil. - </para> - </section> + <partintro xml:id="regex.seealso"> + &reftitle.seealso; + <para> + Schauen Sie sich bezüglich regulärer Ausdrücke mit einer zu Perl + kompatiblen Syntax die <link linkend="book.pcre">PCRE Funktionen</link> an. + <function>fnmatch</function> bietet die Möglichkeit der Suche nach + Übereinstimmungen mit Wildcard-Suchmustern im einfacheren Shell-Stil. + </para> </partintro> &reference.regex.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/constants.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/constants.xml diff -u phpdoc-de/reference/session/constants.xml:1.8 phpdoc-de/reference/session/constants.xml:1.9 --- phpdoc-de/reference/session/constants.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<section xml:id="session.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> +<appendix xml:id="session.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants; &extension.constants; <variablelist> @@ -12,15 +12,14 @@ </term> <listitem> <simpara> - Konstante, die entweder den Namen und die ID der Session in der - Form <literal>"name=ID"</literal> enthält oder eine leere - Zeichenkette, falls die Session-ID in einem entsprechenden - Cookie gesetzt wurde. + Konstante, die entweder den Namen und die ID der Session in der Form + <literal>"name=ID"</literal> enthält oder eine leere Zeichenkette, falls + die Session-ID in einem entsprechenden Cookie gesetzt wurde. </simpara> </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/reference.xml?r1=1.36&r2=1.37&diff_format=u Index: phpdoc-de/reference/session/reference.xml diff -u phpdoc-de/reference/session/reference.xml:1.36 phpdoc-de/reference/session/reference.xml:1.37 --- phpdoc-de/reference/session/reference.xml:1.36 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/session/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,392 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.36 $ --> -<!-- EN-Revision: 1.61 Maintainer: samesch Status: ready --> -<!-- Purpose: basic.session --> -<!-- Membership: core --> +<!-- $Revision: 1.37 $ --> +<!-- EN-Revision: 1.62 Maintainer: samesch Status: ready --> <reference xml:id="ref.session" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Session Funktionen</title> - <titleabbrev>Sessions</titleabbrev> - - <partintro> - - <section xml:id="session.intro"> - &reftitle.intro; - <para> - Die Unterstützung von Sessions in PHP bietet die Möglichkeit, bestimmte - Daten während einer Folge von Aufrufen Ihrer Website festzuhalten. Damit - können Sie persönlichere Applikationen erstellen und Ihre Website - ansprechender gestalten. - </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 darauffolgenden 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> - </section> - - <section xml:id="session.security"> - <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 Sessio-ID an Dritte gelangen kann. - Eine entführte Session-ID ermöglicht diesen, auf alle Daten zuzugreifen, - die mit dieser Session-ID verbunden sind. Erstens 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. Zweitens 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> - </section> - - <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> - - &reference.session.constants; - - <section xml:id="session.examples"> - &reftitle.examples; - <note> - <para> - Seit 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 die - Verwendung von <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> - <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> - </partintro> + <title>Session &Functions;</title> &reference.session.entities.functions; @@ -412,3 +29,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> +
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/cpdf/constants.xml diff -u phpdoc-de/reference/cpdf/constants.xml:1.4 phpdoc-de/reference/cpdf/constants.xml:1.5 --- phpdoc-de/reference/cpdf/constants.xml:1.4 Sat Jun 23 13:21:30 2007 +++ phpdoc-de/reference/cpdf/constants.xml Fri Dec 28 08:51:38 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="cpdf.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="cpdf.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -12,89 +12,89 @@ </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PM_OUTLINES</constant> + <constant>CPDF_PM_OUTLINES</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PM_THUMBS</constant> + <constant>CPDF_PM_THUMBS</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PM_FULLSCREEN</constant> + <constant>CPDF_PM_FULLSCREEN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_SINGLE</constant> + <constant>CPDF_PL_SINGLE</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_1COLUMN</constant> + <constant>CPDF_PL_1COLUMN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_2LCOLUMN</constant> + <constant>CPDF_PL_2LCOLUMN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> <varlistentry> <term> - <constant>CPDF_PL_2RCOLUMN</constant> + <constant>CPDF_PL_2RCOLUMN</constant> (<type>integer</type>) </term> <listitem> <simpara> - + </simpara> </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/cpdf/reference.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-de/reference/cpdf/reference.xml diff -u phpdoc-de/reference/cpdf/reference.xml:1.18 phpdoc-de/reference/cpdf/reference.xml:1.19 --- phpdoc-de/reference/cpdf/reference.xml:1.18 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/cpdf/reference.xml Fri Dec 28 08:51:38 2007 @@ -1,247 +1,16 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.19 Maintainer: samesch Status: ready --> -<!-- Purpose: utilspec.nontext --> -<!-- Membership: pecl, external --> -<!-- State: deprecated --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.20 Maintainer: samesch Status: ready --> <reference xml:id="ref.cpdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>ClibPDF Funktionen [veraltet]</title> - <titleabbrev>ClibPDF</titleabbrev> - - <partintro> - - <section xml:id="cpdf.intro"> - &reftitle.intro; - <warning> - <para> - Da es für ClibPDF keinen Support mehr gibt, wird dringend empfohlen, eine - Alternative wie <link linkend="ref.haru">Haru</link>, <link - linkend="ref.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="ref.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="ref.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="ref.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. - Dies ist eine praktische Fähigkeit, die bei Verwendung der <link - linkend="ref.pdf">PDFlib</link> aber 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, siehe - <link linkend="faq.using.freepdf">die diesbezügliche FAQ</link>. - </simpara> - </note> - </section> - - <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>, aber 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> - - &reference.cpdf.configure; - - <section xml:id="cpdf.configuration"> - &reftitle.runtime; - &no.config; - </section> - - &reference.cpdf.constants; - - <section xml:id="cpdf.examples"> - &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; -$margin = 20; -$pagecount = 40; - -$pdf = cpdf_open(0); -cpdf_set_creator($pdf, "pdf_clock.php"); -cpdf_set_title($pdf, "Analog Clock"); - -while ($pagecount-- > 0) { - cpdf_page_init($pdf, $pagecount+1, 0, 2 * ($radius + $margin), 2 * ($radius + $margin), 1.0); - - cpdf_set_page_animation($pdf, 4, 0.5, 0, 0, 0); /* wipe */ - - cpdf_translate($pdf, $radius + $margin, $radius + $margin); - cpdf_save($pdf); - cpdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); - - /* minute strokes */ - 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-$margin/3, 0.0); - cpdf_stroke($pdf); - } - - cpdf_restore($pdf); - cpdf_save($pdf); - - /* 5 minute strokes */ - 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-$margin, 0.0); - cpdf_stroke($pdf); - } - - $ltime = getdate(); - - /* draw hour hand */ - cpdf_save($pdf); - cpdf_rotate($pdf, -(($ltime['minutes']/60.0) + $ltime['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); - - /* draw minute hand */ - cpdf_save($pdf); - cpdf_rotate($pdf, -(($ltime['seconds']/60.0) + $ltime['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); - - /* draw second hand */ - cpdf_setrgbcolor($pdf, 1.0, 0.0, 0.0); - cpdf_setlinewidth($pdf, 2); - cpdf_save($pdf); - cpdf_rotate($pdf, -(($ltime['seconds'] - 15.0) * 6.0)); - cpdf_moveto($pdf, -$radius/5, 0.0); - cpdf_lineto($pdf, $radius, 0.0); - cpdf_stroke($pdf); - cpdf_restore($pdf); - - /* draw little circle at center */ - cpdf_circle($pdf, 0, 0, $radius/30); - cpdf_fill($pdf); - - cpdf_restore($pdf); - - cpdf_finalize_page($pdf, $pagecount+1); -} - -cpdf_finalize($pdf); -Header("Content-type: application/pdf"); -cpdf_output_buffer($pdf); -cpdf_close($pdf); -?> -]]> - </programlisting> - </example> - </section> - - <section xml:id="cpdf.seealso"> - &reftitle.seealso; - <para> - Siehe auch die Dokumentation der <link - linkend="ref.pdf">PDFlib</link>-Erweiterung. - </para> - </section> + <title>ClibPDF &Functions; [veraltet]</title> + <partintro xml:id="cpdf.seealso"> + &reftitle.seealso; + <para> + Siehe auch die Dokumentation der <link + linkend="ref.pdf">PDFlib</link>-Erweiterung. + </para> </partintro> &reference.cpdf.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/mssql/constants.xml diff -u phpdoc-de/reference/mssql/constants.xml:1.4 phpdoc-de/reference/mssql/constants.xml:1.5 --- phpdoc-de/reference/mssql/constants.xml:1.4 Sat Jun 23 13:21:41 2007 +++ phpdoc-de/reference/mssql/constants.xml Fri Dec 28 08:51:38 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="mssql.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="mssql.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -127,7 +127,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/mssql/reference.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-de/reference/mssql/reference.xml diff -u phpdoc-de/reference/mssql/reference.xml:1.15 phpdoc-de/reference/mssql/reference.xml:1.16 --- phpdoc-de/reference/mssql/reference.xml:1.15 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/mssql/reference.xml Fri Dec 28 08:51:38 2007 @@ -1,76 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> -<!-- Purpose: database.vendors --> -<!-- Membership: bundled, external --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.16 Maintainer: samesch Status: ready --> <reference xml:id="ref.mssql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Microsoft SQL Server Funktionen</title> - <titleabbrev>MS SQL Server</titleabbrev> - <partintro> - - <section xml:id="mssql.intro"> - &reftitle.intro; - <para> - Diese Funktionen ermöglichen Ihnen den Zugriff auf den MS - SQL-Datenbankserver. - </para> - </section> - - <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 - class="directory">\winnt\system32</filename> auf dem Server nach <filename - class="directory">\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> - - &reference.mssql.configure; - - &reference.mssql.ini; - - <section xml:id="mssql.resources"> - &reftitle.resources; - <para> - </para> - </section> - - &reference.mssql.constants; - - </partintro> &reference.mssql.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/oracle/constants.xml diff -u phpdoc-de/reference/oracle/constants.xml:1.4 phpdoc-de/reference/oracle/constants.xml:1.5 --- phpdoc-de/reference/oracle/constants.xml:1.4 Sat Jun 23 13:21:43 2007 +++ phpdoc-de/reference/oracle/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="oracle.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="oracle.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -61,7 +61,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/oracle/reference.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/oracle/reference.xml diff -u phpdoc-de/reference/oracle/reference.xml:1.11 phpdoc-de/reference/oracle/reference.xml:1.12 --- phpdoc-de/reference/oracle/reference.xml:1.11 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/oracle/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,49 +1,11 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> -<!-- Purpose: database.vendors --> -<!-- Membership: pecl, external --> -<!-- State: deprecated --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.14 Maintainer: samesch Status: ready --> <reference xml:id="ref.oracle" xmlns="http://docbook.org/ns/docbook"> - <title>Oracle Funktionen [veraltet]</title> + <title>Oracle &Functions; [veraltet]</title> <titleabbrev>Oracle</titleabbrev> - <partintro> - <section xml:id="oracle.intro"> - &reftitle.intro; - <warning> - <para> - Diese Erweiterung sollte nicht mehr verwendet werden. Verwenden Sie - stattdessen die verbesserte <link - linkend="ref.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> - </section> - - &reference.oracle.configure; - - <section xml:id="oracle.resources"> - &reftitle.resources; - <para> - Diese Erweiterung definiert zwei Resource-Typen: eine - Oracle-Verbindungskennung und einen Oracle-Cursor-Index. - </para> - </section> - - &reference.oracle.constants; - - </partintro> - &reference.oracle.entities.functions; </reference> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/constants.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-de/reference/pcre/constants.xml diff -u phpdoc-de/reference/pcre/constants.xml:1.7 phpdoc-de/reference/pcre/constants.xml:1.8 --- phpdoc-de/reference/pcre/constants.xml:1.7 Sun Jul 29 20:14:50 2007 +++ phpdoc-de/reference/pcre/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> -<section xml:id="pcre.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.14 Maintainer: samesch Status: ready --> +<appendix xml:id="pcre.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <table> @@ -19,7 +19,7 @@ <entry> Sortiert die Ergebnisse so, dass $matches[0] ein Array von Übereinstimmungen mit dem ganzen Suchmuster ist, $matches[1] ein Array - von Zeichenketten, die mit dem ersten geklammerten Teil-Suchmuster + von Zeichenketten, die mit dem ersten geklammerten Teilsuchmuster übereinstimmen und so weiter. Dieses Flag wird nur bei <function>preg_match_all</function> verwendet. </entry> @@ -37,7 +37,7 @@ <entry><constant>PREG_OFFSET_CAPTURE</constant></entry> <entry> Siehe Beschreibung von <constant>PREG_SPLIT_OFFSET_CAPTURE</constant>. - Dieses Flag steht seit PHP 4.3.0 zur Verfügung. + Dieses Flag steht ab PHP 4.3.0 zur Verfügung. </entry> </row> <row> @@ -52,7 +52,7 @@ <entry> Dieses Flag teilt der Funktion <function>preg_split</function> mit, dass sie auch die eingeklammerten Ausdrücke des Trennsymbol-Musters - zurückgeben soll. Dieses Flag steht seit PHP 4.0.5 zur Verfügung. + zurückgeben soll. Dieses Flag steht ab PHP 4.0.5 zur Verfügung. </entry> </row> <row> @@ -63,7 +63,7 @@ Rückgabewerte in einem Array dahingehend ändert, dass jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als erstem und deren Stelle im durchsuchten Text als zweitem Element besteht. Dieses - Flag steht seit PHP 4.3.0 zur Verfügung und wird nur bei + Flag steht ab PHP 4.3.0 zur Verfügung und wird nur bei <function>preg_split</function> verwendet. </entry> </row> @@ -71,15 +71,14 @@ <entry><constant>PREG_NO_ERROR</constant></entry> <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, - falls kein Fehler aufgetreten ist. Es steht seit PHP 5.2.0 zur - Verfügung. + falls kein Fehler aufgetreten ist. Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> <row> <entry><constant>PREG_INTERNAL_ERROR</constant></entry> <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, - falls ein interner PCRE-Fehler aufgetreten ist. Es steht seit PHP 5.2.0 + falls ein interner PCRE-Fehler aufgetreten ist. Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> @@ -88,8 +87,8 @@ <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, falls das <link linkend="ini.pcre.backtrack-limit">Limit der - Zurückverfolgung (Backtracking)</link> überschritten wurde. Es steht - seit PHP 5.2.0 zur Verfügung. + Zurückverfolgung (Backtracking)</link> überschritten wurde. Es steht ab + PHP 5.2.0 zur Verfügung. </entry> </row> <row> @@ -98,30 +97,30 @@ Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, falls das <link linkend="ini.pcre.recursion-limit">Rekursionslimit</link> überschritten - wurde. Es steht seit PHP 5.2.0 zur Verfügung. + wurde. Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> <row> <entry><constant>PREG_BAD_UTF8_ERROR</constant></entry> <entry> Dieses Flag wird von <function>preg_last_error</function> zurückgegeben, - falls der letzte Fehler durch fehlerhafte UTF8-Daten verursacht wurde + falls der letzte Fehler durch fehlerhafte UTF-8-Daten verursacht wurde (nur bei RegEx, die im <link linkend="reference.pcre.pattern.modifiers">UTF-8-Modus</link> laufen). - Es steht seit PHP 5.2.0 zur Verfügung. + Es steht ab PHP 5.2.0 zur Verfügung. </entry> </row> <row> <entry><constant>PCRE_VERSION</constant></entry> <entry> Die PCRE-Version und das Freigabedatum (z.B. "7.0 18-Dec-2006"). Dieses - Flag steht seit PHP 5.2.4 zur Verfügung. + Flag steht ab PHP 5.2.4 zur Verfügung. </entry> </row> </tbody> </tgroup> </table> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pcre/reference.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/reference/pcre/reference.xml diff -u phpdoc-de/reference/pcre/reference.xml:1.10 phpdoc-de/reference/pcre/reference.xml:1.11 --- phpdoc-de/reference/pcre/reference.xml:1.10 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/pcre/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,118 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.19 Maintainer: samesch Status: ready --> -<!-- Purpose: basic.text --> -<!-- Membership: bundled --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.20 Maintainer: samesch Status: ready --> <reference xml:id="ref.pcre" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Reguläre Ausdrücke Funktionen (Perl-kompatibel)</title> - <titleabbrev>PCRE</titleabbrev> + <title>PCRE &Functions;</title> - <partintro> - <section xml:id="pcre.intro"> - &reftitle.intro; - <para> - Die Syntax für Suchmuster, die in diesen Funktionen verwendet werden, ist - Perl sehr ähnlich. Der Ausdruck muss von Begrenzungszeichen, z.B. von - Schrägstrichen (/), umgeben sein. 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. Seit 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="ref.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> - </section> - - <section xml:id="pcre.requirements"> - &reftitle.required; - &no.requirement; - </section> - - &reference.pcre.configure; - &reference.pcre.ini; - - <section xml:id="pcre.resources"> - &reftitle.resources; - &no.resource; - </section> - - &reference.pcre.constants; - - <section 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> - </section> - </partintro> - - &reference.pcre.pattern.modifiers; - &reference.pcre.pattern.syntax; &reference.pcre.entities.functions; </reference> @@ -137,3 +29,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> + http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/posix/constants.xml diff -u phpdoc-de/reference/posix/constants.xml:1.4 phpdoc-de/reference/posix/constants.xml:1.5 --- phpdoc-de/reference/posix/constants.xml:1.4 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/posix/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="posix.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="posix.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -112,7 +112,7 @@ könnten. </para> </note> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/posix/reference.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-de/reference/posix/reference.xml diff -u phpdoc-de/reference/posix/reference.xml:1.11 phpdoc-de/reference/posix/reference.xml:1.12 --- phpdoc-de/reference/posix/reference.xml:1.11 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/posix/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,55 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.10 Maintainer: samesch Status: ready --> -<!-- Purpose: fileprocess.process --> -<!-- Membership: bundled --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.13 Maintainer: samesch Status: ready --> <reference xml:id="ref.posix" xmlns="http://docbook.org/ns/docbook"> - <title>POSIX Funktionen</title> - <titleabbrev>POSIX</titleabbrev> + <title>POSIX &Functions;</title> - <partintro> - <section xml:id="posix.intro"> - &reftitle.intro; - <para> - Dieses Modul enthält eine Schnittstelle zu den im IEEE 1003.1 - (POSIX.1) Standards Dokument definierten Funktionen, die durch - andere Mittel 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 - <link linkend="ref.posix">POSIX</link>-Funktionen, z.B. - <function>posix_getpwnam</function> und Freunde, abgefragt - werden. Die <link linkend="ref.posix">POSIX</link>-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 - <link linkend="ref.posix">POSIX</link>-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; - </section> - - &reference.posix.configure; - &reference.posix.constants; - - <section xml:id="posix.seealso"> - &reftitle.seealso; - <para> - Der Abschnitt über <link - linkend="ref.pcntl">Prozesskontroll-Funktionen</link> könnte für - Sie von Interesse sein. - </para> - </section> + <partintro xml:id="posix.seealso"> + &reftitle.seealso; + <para> + Der Abschnitt über <link + linkend="book.pcntl">Prozesskontroll-Funktionen</link> könnte für Sie von + Interesse sein. + </para> </partintro> &reference.posix.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/constants.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-de/reference/pspell/constants.xml diff -u phpdoc-de/reference/pspell/constants.xml:1.4 phpdoc-de/reference/pspell/constants.xml:1.5 --- phpdoc-de/reference/pspell/constants.xml:1.4 Sat Jun 23 13:21:46 2007 +++ phpdoc-de/reference/pspell/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: samesch Status: ready --> -<section xml:id="pspell.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.4 Maintainer: samesch Status: ready --> +<appendix xml:id="pspell.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -50,7 +50,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/pspell/reference.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/pspell/reference.xml diff -u phpdoc-de/reference/pspell/reference.xml:1.9 phpdoc-de/reference/pspell/reference.xml:1.10 --- phpdoc-de/reference/pspell/reference.xml:1.9 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/pspell/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,47 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.11 Maintainer: samesch Status: ready --> -<!-- Purpose: international --> -<!-- Membership: bundled, external --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.12 Maintainer: samesch Status: ready --> <reference xml:id="ref.pspell" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Pspell Funktionen</title> - <titleabbrev>Pspell</titleabbrev> - - <partintro> - - <section xml:id="pspell.intro"> - &reftitle.intro; - <para> - Diese Funktionen ermöglichen Ihnen, die Rechtschreibung eines - Wortes zu prüfen und bieten Änderungsvorschläge an. - </para> - </section> - - <section xml:id="pspell.requirements"> - &reftitle.required; - <para> - Um PHP mit pspell-Unterstützung zu compilieren, brauchen Sie die - aspell-Bibliothek, die Sie unter <link - xlink:href="&url.aspell;">&url.aspell;</link> bekommen. - </para> - </section> - - &reference.pspell.configure; - - <section xml:id="pspell.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="pspell.resources"> - &reftitle.resources; - &no.resource; - </section> - - &reference.pspell.constants; - - </partintro> + <title>Pspell &Functions;</title> &reference.pspell.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/regex/reference.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-de/reference/regex/reference.xml diff -u phpdoc-de/reference/regex/reference.xml:1.16 phpdoc-de/reference/regex/reference.xml:1.17 --- phpdoc-de/reference/regex/reference.xml:1.16 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/regex/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,117 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.15 Maintainer: samesch Status: ready --> -<!-- Purpose: basic.text --> -<!-- Membership: core --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.17 Maintainer: samesch Status: ready --> <reference xml:id="ref.regex" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Reguläre Ausdrücke Funktionen (POSIX erweitert)</title> - <titleabbrev>POSIX Regex</titleabbrev> + <title>Regex &Functions;</title> - <partintro> - <section xml:id="regex.intro"> - &reftitle.intro; - <tip> - <para> - Bei Verwendung der <link linkend="ref.pcre">PCRE - Funktionen</link> unterstützt PHP auch Reguläre Ausdrücke mit - einer zu Perl kompatiblen Syntax. Diese Funktionen unterstützen - non-greedy Matching, Assertions, bedingte Subpatterns 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="ref.pcre">PCRE Funktionen</link> nicht - binary-safe. - </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> - </section> - - <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> - - <section xml:id="regex.constants"> - &reftitle.constants; - &no.constants; - </section> - - <section 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 $string gefunden wird. -ereg("abc", $string); - -// Gibt true zurück, falls "abc" am Anfang von $string gefunden wird. -ereg("^abc", $string); - -// Gibt true zurück, falls "abc" am Ende von $string gefunden wird. -ereg("abc$", $string); - -// 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:]]+)", $string, $regs); - -// Setzt ein <br /> Tag vor $string. -$string = ereg_replace("^", "<br />", $string); - -// Setzt ein <br /> Tag hinter $string. -$string = ereg_replace("$", "<br />", $string); - -// Entfernt alle Zeilenumbrüche aus $string. -$string = ereg_replace("\n", "", $string); -?> -]]> - </programlisting> - </example> - </para> - </section> - - <section xml:id="regex.seealso"> - &reftitle.seealso; - <para> - Schauen Sie sich bezüglich regulärer Ausdrücke mit einer zu Perl - kompatiblen Syntax die <link - linkend="ref.pcre">PCRE Funktionen</link> an. - <function>fnmatch</function> bietet die Möglichkeit der Suche - nach Übereinstimmungen mit Wildcard-Suchmustern im einfacheren - Shell-Stil. - </para> - </section> + <partintro xml:id="regex.seealso"> + &reftitle.seealso; + <para> + Schauen Sie sich bezüglich regulärer Ausdrücke mit einer zu Perl + kompatiblen Syntax die <link linkend="book.pcre">PCRE Funktionen</link> an. + <function>fnmatch</function> bietet die Möglichkeit der Suche nach + Übereinstimmungen mit Wildcard-Suchmustern im einfacheren Shell-Stil. + </para> </partintro> &reference.regex.entities.functions; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/constants.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/reference/session/constants.xml diff -u phpdoc-de/reference/session/constants.xml:1.8 phpdoc-de/reference/session/constants.xml:1.9 --- phpdoc-de/reference/session/constants.xml:1.8 Sat Jun 23 13:21:48 2007 +++ phpdoc-de/reference/session/constants.xml Fri Dec 28 08:51:39 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.5 Maintainer: samesch Status: ready --> -<section xml:id="session.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: samesch Status: ready --> +<appendix xml:id="session.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.constants; &extension.constants; <variablelist> @@ -12,15 +12,14 @@ </term> <listitem> <simpara> - Konstante, die entweder den Namen und die ID der Session in der - Form <literal>"name=ID"</literal> enthält oder eine leere - Zeichenkette, falls die Session-ID in einem entsprechenden - Cookie gesetzt wurde. + Konstante, die entweder den Namen und die ID der Session in der Form + <literal>"name=ID"</literal> enthält oder eine leere Zeichenkette, falls + die Session-ID in einem entsprechenden Cookie gesetzt wurde. </simpara> </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/reference.xml?r1=1.36&r2=1.37&diff_format=u Index: phpdoc-de/reference/session/reference.xml diff -u phpdoc-de/reference/session/reference.xml:1.36 phpdoc-de/reference/session/reference.xml:1.37 --- phpdoc-de/reference/session/reference.xml:1.36 Thu Dec 13 13:28:21 2007 +++ phpdoc-de/reference/session/reference.xml Fri Dec 28 08:51:39 2007 @@ -1,392 +1,9 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.36 $ --> -<!-- EN-Revision: 1.61 Maintainer: samesch Status: ready --> -<!-- Purpose: basic.session --> -<!-- Membership: core --> +<!-- $Revision: 1.37 $ --> +<!-- EN-Revision: 1.62 Maintainer: samesch Status: ready --> <reference xml:id="ref.session" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Session Funktionen</title> - <titleabbrev>Sessions</titleabbrev> - - <partintro> - - <section xml:id="session.intro"> - &reftitle.intro; - <para> - Die Unterstützung von Sessions in PHP bietet die Möglichkeit, bestimmte - Daten während einer Folge von Aufrufen Ihrer Website festzuhalten. Damit - können Sie persönlichere Applikationen erstellen und Ihre Website - ansprechender gestalten. - </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 darauffolgenden 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> - </section> - - <section xml:id="session.security"> - <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 Sessio-ID an Dritte gelangen kann. - Eine entführte Session-ID ermöglicht diesen, auf alle Daten zuzugreifen, - die mit dieser Session-ID verbunden sind. Erstens 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. Zweitens 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> - </section> - - <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> - - &reference.session.constants; - - <section xml:id="session.examples"> - &reftitle.examples; - <note> - <para> - Seit 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 die - Verwendung von <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> - <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> - </partintro> + <title>Session &Functions;</title> &reference.session.entities.functions; @@ -412,3 +29,4 @@ vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> +