cvs: phpdoc-de /reference/misc/functions eval.xml highlight-file.xml /reference/session ini.xml
| From: | Martin Samesch | Date: | Sun, 02 Sep 2007 14:33:17 +0000 |
| Subject: | cvs: phpdoc-de /reference/misc/functions eval.xml highlight-file.xml /reference/session ini.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2229@lists.php.net to get a copy of this message | ||
samesch Sun Sep 2 14:33:17 2007 UTC
Modified files:
/phpdoc-de/reference/misc/functions eval.xml highlight-file.xml
/phpdoc-de/reference/session ini.xml
Log:
syncing with EN
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/eval.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/misc/functions/eval.xml diff -u phpdoc-de/reference/misc/functions/eval.xml:1.6 phpdoc-de/reference/misc/functions/eval.xml:1.7 --- phpdoc-de/reference/misc/functions/eval.xml:1.6 Sun Aug 12 21:44:33 2007 +++ phpdoc-de/reference/misc/functions/eval.xml Sun Sep 2 14:33:17 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.22 Maintainer: nobody Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.24 Maintainer: nobody Status: ready --> <refentry xml:id="function.eval" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eval</refname> @@ -65,7 +65,9 @@ ausgewerteten Code <literal>return</literal> aufgerufen wird, dann aber wird der an <literal>return</literal> übergebene Wert zurückgegeben. Falls im ausgewerteten Code ein Parse Error auftritt, gibt - <function>eval</function> &false; zurück. + <function>eval</function> &false; zurück und der weitere Code wird normal + ausgeführt. Es ist in <function>eval</function> nicht möglich, einen Parse + Error mittels <function>set_error_handler</function> abzufangen. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/highlight-file.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/misc/functions/highlight-file.xml diff -u phpdoc-de/reference/misc/functions/highlight-file.xml:1.5 phpdoc-de/reference/misc/functions/highlight-file.xml:1.6 --- phpdoc-de/reference/misc/functions/highlight-file.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/highlight-file.xml Sun Sep 2 14:33:17 2007 @@ -1,94 +1,128 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>highlight_file</refname> - <refpurpose>Syntax-Hervorhebung für eine Datei</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>void</type><methodname>highlight_file</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <simpara> - Die Funktion <function>highlight_file</function> erzeugt die - Ausgabe des Codes der Datei <parameter>filename</parameter> - mit hervorgehobener Syntax. Dabei werden die Farben des in PHP - eingebauten Syntax-Highlighter benutzt. - </simpara> - <para> - <example> - <title>Erzeugung einer hervorgehobenen URL</title> - <simpara> - Zur Erzeugung einer URL, die Code eines ihm übermittelten - Skripts hervorgehoben dargestellen kann, machen wir Gebrauch von - der "ForceType"-Anweisung des Apachen um eine richtige - URL zu erzeugen. Zusätzlich benutzen wir die Funktion - <function>highlight_file</function>, um das Code-Listing wie - gewünscht an zu zeigen. - </simpara> - <simpara> - In ihrer httpd.conf sollten sie folgendes hinzu fügen: - </simpara> - <para> - <informalexample><programlisting> -<Location /source> - ForceType application/x-httpd-php -</Location> - </programlisting></informalexample> - </para> - <simpara> - Jetzt erzeugen sie eine Datei namens "source" und - speichern es in dem Root-Verzeichnis ihrer Web-Seite. - </simpara> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.25 Maintainer: nobody Status: ready --> +<refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>highlight_file</refname> + <refpurpose>Syntax-Hervorhebung für eine Datei</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>highlight_file</methodname> + <methodparam><type>string</type><parameter>Dateiname</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>zurückgeben</parameter></methodparam> + </methodsynopsis> + <para> + Erzeugt die hervorgehobene Syntax des Codes der Datei + <parameter>Dateiname</parameter> als Ausgabe oder als Rückgabewert. Dabei + werden die Farben des in PHP eingebauten Syntax-Highlighters benutzt. + </para> + <para> + Viele Server sind so konfiguriert, dass sie den Code von Dateien mit der + <emphasis>phps</emphasis>-Erweiterung automatisch hervorheben. Wenn zum + Beispiel <filename>beispiel.phps</filename> aufgerufen wird, wird die + hervorgehobene Syntax des Quellcodes der Datei angezeigt. Mit der folgenden + Zeile in der &httpd.conf; wird dies aktiviert: + </para> + <screen> +<![CDATA[ +AddType application/x-httpd-php-source .phps +]]> + </screen> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Dateiname</parameter></term> + <listitem> <para> - <programlisting role="php"> -<HTML> -<HEAD> -<TITLE>Source Display</TITLE> -</HEAD> -<BODY BGCOLOR="white"> -<?php - $script = getenv ("PATH_TRANSLATED"); - if(!$script) { - echo "<BR><B>Fehler: Skript-Name nötig</B><BR>"; - } else { - if (ereg("(\.php|\.inc)$",$script)) { - echo "<H1>Source von: $PATH_INFO</H1>\n<HR>\n"; - highlight_file($script); - } else { - echo "<H1>ERROR: Nur PHP oder Include-Skripte sind erlaubt</H1>"; - } - } - echo "<HR>Erzeugt: ".date("Y/M/d H:i:s",time()); -?> -</BODY> -</HTML> - </programlisting> + Der Pfad zur PHP-Datei, deren Code hervorgehoben werden soll. </para> - <simpara> - Jetzt können sie die u.a. URL benutzen, um eine farblich - hervorgehobene Version des Skriptes - "/path/to/script.php" innerhalb ihrer Web-Seite zu - zeigen. - </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>zurückgeben</parameter></term> + <listitem> <para> - <informalexample> - <programlisting> -http://ihr.server.de/source/pfad/zu/script.php - </programlisting> - </informalexample> + Wenn dieser Parameter auf &true; gesetzt wird, gibt die Funktion den + hervorgehobenen Code zurück. </para> - </example> - </para> - <simpara> - Siehe auch <function>highlight_string</function> und - <function>show_source</function>. - </simpara> - </refsect1> - </refentry> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Falls <parameter>zurückgeben</parameter> auf &true; gesetzt ist, wird der + hervorgehobene Code nicht direkt ausgegeben, sondern als Zeichenkette + zurückgegeben. Andernfalls wird bei Erfolg &true; zurückgegeben und + &false;, falls ein Fehler auftritt. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.1</entry> + <entry> + Diese Funktion wird nun ebenfalls von <link + linkend="ini.safe-mode">safe_mode</link> und <link + linkend="ini.open-basedir">open_basedir</link> beeinflusst. + </entry> + </row> + <row> + <entry>4.2.0</entry> + <entry> + Den Parameter <parameter>zurückgeben</parameter> hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <caution> + <para> + Wenn <function>highlight_file</function> verwendet wird, sollte darauf + geachtet werden, dass nicht versehentlich vertrauliche Informationen wie + zum Beispiel Passwörter oder andere Informationen, die ein potentielles + Sicherheitsrisiko schaffen könnten, verraten werden. + </para> + </caution> + ¬e.uses-ob; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>highlight_string</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/ini.xml?r1=1.31&r2=1.32&diff_format=u Index: phpdoc-de/reference/session/ini.xml diff -u phpdoc-de/reference/session/ini.xml:1.31 phpdoc-de/reference/session/ini.xml:1.32 --- phpdoc-de/reference/session/ini.xml:1.31 Sat Aug 18 16:19:11 2007 +++ phpdoc-de/reference/session/ini.xml Sun Sep 2 14:33:17 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.31 $ --> -<!-- EN-Revision: 1.49 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.32 $ --> +<!-- EN-Revision: 1.50 Maintainer: samesch Status: ready --> <section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; @@ -19,7 +19,7 @@ <tbody> <row> <entry>session.save_path</entry> - <entry>""</entry> + <entry>"/tmp"</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row>
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/eval.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/reference/misc/functions/eval.xml diff -u phpdoc-de/reference/misc/functions/eval.xml:1.6 phpdoc-de/reference/misc/functions/eval.xml:1.7 --- phpdoc-de/reference/misc/functions/eval.xml:1.6 Sun Aug 12 21:44:33 2007 +++ phpdoc-de/reference/misc/functions/eval.xml Sun Sep 2 14:33:17 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.22 Maintainer: nobody Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.24 Maintainer: nobody Status: ready --> <refentry xml:id="function.eval" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>eval</refname> @@ -65,7 +65,9 @@ ausgewerteten Code <literal>return</literal> aufgerufen wird, dann aber wird der an <literal>return</literal> übergebene Wert zurückgegeben. Falls im ausgewerteten Code ein Parse Error auftritt, gibt - <function>eval</function> &false; zurück. + <function>eval</function> &false; zurück und der weitere Code wird normal + ausgeführt. Es ist in <function>eval</function> nicht möglich, einen Parse + Error mittels <function>set_error_handler</function> abzufangen. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/misc/functions/highlight-file.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/misc/functions/highlight-file.xml diff -u phpdoc-de/reference/misc/functions/highlight-file.xml:1.5 phpdoc-de/reference/misc/functions/highlight-file.xml:1.6 --- phpdoc-de/reference/misc/functions/highlight-file.xml:1.5 Sat Jun 23 13:21:40 2007 +++ phpdoc-de/reference/misc/functions/highlight-file.xml Sun Sep 2 14:33:17 2007 @@ -1,94 +1,128 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: ready --> - <refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>highlight_file</refname> - <refpurpose>Syntax-Hervorhebung für eine Datei</refpurpose> - </refnamediv> - <refsect1> - <title>Beschreibung:</title> - <methodsynopsis> - <type>void</type><methodname>highlight_file</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - </methodsynopsis> - <simpara> - Die Funktion <function>highlight_file</function> erzeugt die - Ausgabe des Codes der Datei <parameter>filename</parameter> - mit hervorgehobener Syntax. Dabei werden die Farben des in PHP - eingebauten Syntax-Highlighter benutzt. - </simpara> - <para> - <example> - <title>Erzeugung einer hervorgehobenen URL</title> - <simpara> - Zur Erzeugung einer URL, die Code eines ihm übermittelten - Skripts hervorgehoben dargestellen kann, machen wir Gebrauch von - der "ForceType"-Anweisung des Apachen um eine richtige - URL zu erzeugen. Zusätzlich benutzen wir die Funktion - <function>highlight_file</function>, um das Code-Listing wie - gewünscht an zu zeigen. - </simpara> - <simpara> - In ihrer httpd.conf sollten sie folgendes hinzu fügen: - </simpara> - <para> - <informalexample><programlisting> -<Location /source> - ForceType application/x-httpd-php -</Location> - </programlisting></informalexample> - </para> - <simpara> - Jetzt erzeugen sie eine Datei namens "source" und - speichern es in dem Root-Verzeichnis ihrer Web-Seite. - </simpara> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.25 Maintainer: nobody Status: ready --> +<refentry xml:id="function.highlight-file" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>highlight_file</refname> + <refpurpose>Syntax-Hervorhebung für eine Datei</refpurpose> + </refnamediv> + + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>highlight_file</methodname> + <methodparam><type>string</type><parameter>Dateiname</parameter></methodparam> + <methodparam choice="opt"><type>bool</type><parameter>zurückgeben</parameter></methodparam> + </methodsynopsis> + <para> + Erzeugt die hervorgehobene Syntax des Codes der Datei + <parameter>Dateiname</parameter> als Ausgabe oder als Rückgabewert. Dabei + werden die Farben des in PHP eingebauten Syntax-Highlighters benutzt. + </para> + <para> + Viele Server sind so konfiguriert, dass sie den Code von Dateien mit der + <emphasis>phps</emphasis>-Erweiterung automatisch hervorheben. Wenn zum + Beispiel <filename>beispiel.phps</filename> aufgerufen wird, wird die + hervorgehobene Syntax des Quellcodes der Datei angezeigt. Mit der folgenden + Zeile in der &httpd.conf; wird dies aktiviert: + </para> + <screen> +<![CDATA[ +AddType application/x-httpd-php-source .phps +]]> + </screen> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>Dateiname</parameter></term> + <listitem> <para> - <programlisting role="php"> -<HTML> -<HEAD> -<TITLE>Source Display</TITLE> -</HEAD> -<BODY BGCOLOR="white"> -<?php - $script = getenv ("PATH_TRANSLATED"); - if(!$script) { - echo "<BR><B>Fehler: Skript-Name nötig</B><BR>"; - } else { - if (ereg("(\.php|\.inc)$",$script)) { - echo "<H1>Source von: $PATH_INFO</H1>\n<HR>\n"; - highlight_file($script); - } else { - echo "<H1>ERROR: Nur PHP oder Include-Skripte sind erlaubt</H1>"; - } - } - echo "<HR>Erzeugt: ".date("Y/M/d H:i:s",time()); -?> -</BODY> -</HTML> - </programlisting> + Der Pfad zur PHP-Datei, deren Code hervorgehoben werden soll. </para> - <simpara> - Jetzt können sie die u.a. URL benutzen, um eine farblich - hervorgehobene Version des Skriptes - "/path/to/script.php" innerhalb ihrer Web-Seite zu - zeigen. - </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>zurückgeben</parameter></term> + <listitem> <para> - <informalexample> - <programlisting> -http://ihr.server.de/source/pfad/zu/script.php - </programlisting> - </informalexample> + Wenn dieser Parameter auf &true; gesetzt wird, gibt die Funktion den + hervorgehobenen Code zurück. </para> - </example> - </para> - <simpara> - Siehe auch <function>highlight_string</function> und - <function>show_source</function>. - </simpara> - </refsect1> - </refentry> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Falls <parameter>zurückgeben</parameter> auf &true; gesetzt ist, wird der + hervorgehobene Code nicht direkt ausgegeben, sondern als Zeichenkette + zurückgegeben. Andernfalls wird bei Erfolg &true; zurückgegeben und + &false;, falls ein Fehler auftritt. + </para> + </refsect1> + + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.2.1</entry> + <entry> + Diese Funktion wird nun ebenfalls von <link + linkend="ini.safe-mode">safe_mode</link> und <link + linkend="ini.open-basedir">open_basedir</link> beeinflusst. + </entry> + </row> + <row> + <entry>4.2.0</entry> + <entry> + Den Parameter <parameter>zurückgeben</parameter> hinzugefügt. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + + <refsect1 role="notes"> + &reftitle.notes; + <caution> + <para> + Wenn <function>highlight_file</function> verwendet wird, sollte darauf + geachtet werden, dass nicht versehentlich vertrauliche Informationen wie + zum Beispiel Passwörter oder andere Informationen, die ein potentielles + Sicherheitsrisiko schaffen könnten, verraten werden. + </para> + </caution> + ¬e.uses-ob; + </refsect1> + + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>highlight_string</function></member> + </simplelist> + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/session/ini.xml?r1=1.31&r2=1.32&diff_format=u Index: phpdoc-de/reference/session/ini.xml diff -u phpdoc-de/reference/session/ini.xml:1.31 phpdoc-de/reference/session/ini.xml:1.32 --- phpdoc-de/reference/session/ini.xml:1.31 Sat Aug 18 16:19:11 2007 +++ phpdoc-de/reference/session/ini.xml Sun Sep 2 14:33:17 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.31 $ --> -<!-- EN-Revision: 1.49 Maintainer: samesch Status: ready --> +<!-- $Revision: 1.32 $ --> +<!-- EN-Revision: 1.50 Maintainer: samesch Status: ready --> <section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; @@ -19,7 +19,7 @@ <tbody> <row> <entry>session.save_path</entry> - <entry>""</entry> + <entry>"/tmp"</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row>