cvs: phpdoc-de /features commandline.xml

hholzgra Fri Mar 21 14:23:00 2008 UTC Modified files: /phpdoc-de/features commandline.xml Log: translation update (intermediate step)

http://cvs.php.net/viewvc.cgi/phpdoc-de/features/commandline.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/features/commandline.xml diff -u phpdoc-de/features/commandline.xml:1.5 phpdoc-de/features/commandline.xml:1.6 --- phpdoc-de/features/commandline.xml:1.5 Sat Jun 23 13:21:28 2007 +++ phpdoc-de/features/commandline.xml Fri Mar 21 14:22:58 2008 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.41 Maintainer: fa Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.48 Maintainer: hholzgra Status: ready --> +<!-- Credits: fa --> <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PHP auf der Kommandozeile</title> <para> @@ -324,8 +325,10 @@ <emphasis role="strong">nicht</emphasis> auf das Verzeichnis des ausgeführten Skriptes! </para> - <para> - Ein Beispiel, das den Unterschied zum <literal>CGI SAPI</literal> zeigt: + <informalexample> + <para> + Ein Beispiel, das den Unterschied zum <literal>CGI SAPI</literal> zeigt: + </para> <programlisting role="php"> <![CDATA[ <?php @@ -334,9 +337,9 @@ ?> ]]> </programlisting> - </para> <para> Bei der <literal>CGI</literal>-Version ist die Ausgabe folgende: + </para> <screen> <![CDATA[ $ pwd @@ -346,11 +349,13 @@ /tmp/another_directory ]]> </screen> + <para> Dies zeigt deutlich, dass PHP das aktuelle Verzeichnis auf das des ausgeführten Skriptes ändert. </para> <para> Benutzen der <literal>CLI SAPI</literal>-Version ergibt: + </para> <screen> <![CDATA[ $ pwd @@ -360,9 +365,11 @@ /tmp ]]> </screen> + <para> Dies erlaubt eine größere Anpassungsfähigkeit beim Schreiben von Kommandozeilenanwendungen in PHP. </para> + </informalexample> <note> <para> Das <literal>CGI SAPI</literal> unterstützt das Verhalten des @@ -377,6 +384,8 @@ Die Liste der Kommandozeilenoptionen, die das PHP-Binary bereitstellt, können jederzeit abgerufen werden, wenn man PHP mit der Option <option>-h</option> startet: + </para> + <informalexample> <screen> <![CDATA[ Usage: php [options] [-f] <file> [--] [args...] @@ -391,7 +400,7 @@ -n No php.ini file will be used -d foo[=bar] Define INI entry foo with value 'bar' -e Generate extended information for debugger/profiler - -f <file> Parse <file>. + -f <file> Parse and execute <file>. -h This help -i PHP information -l Syntax check only (lint) @@ -409,9 +418,16 @@ args... Arguments passed to script. Use -- args when first argument starts with - or script is read from stdin + + --ini Show configuration file names + + --rf <name> Show information about function <name>. + --rc <name> Show information about class <name>. + --re <name> Show information about extension <name>. + --ri <name> Show configuration for extension <name>. ]]> </screen> - </para> + </informalexample> <para> Beim <literal>CLI SAPI</literal> gibt es drei verschiedene Möglichkeiten, den zur Ausführung bestimmten @@ -421,7 +437,7 @@ <para> PHP mitteilen, eine bestimmte Datei auszuführen. </para> - <para> + <informalexample> <screen> <![CDATA[ php my_script.php @@ -429,6 +445,8 @@ php -f my_script.php ]]> </screen> + </informalexample> + <para> Beide Arten (ob sie die Option <option>-f</option> benutzen oder nicht) führen die Datei <filename>my_script.php</filename> aus. Sie können eine beliebige Datei ausführen - Ihr PHP-Skript @@ -507,7 +525,7 @@ wurde, wird jedes folgende Argument unangetastet an das Skript weitergereicht. </para> - <para> + <informalexample> <screen> <![CDATA[ # Dies führt nicht den angegebenen Code aus, sondern die Optionen von PHP anzeigen @@ -525,7 +543,7 @@ } ]]> </screen> - </para> + </informalexample> <para> Dennoch gibt es einen anderen Weg, um <literal>PHP</literal> für Kommandozeilenskripte zu benutzen. Sie können ein Skript erstellen, @@ -535,6 +553,9 @@ die Datei ausführbar gemacht haben (beispielsweise <command>chmod +x test</command>), kann Ihr Skript wie ein normales Kommandozeilen- oder Perl-Skript gestartet werden. + </para> + <example> + <title>PHP als Shellskript ausführen</title> <programlisting role="php"> <![CDATA[ #!/usr/bin/php @@ -543,8 +564,10 @@ ?> ]]> </programlisting> + <para> Angenommen, die Datei heißt <filename>test</filename> und befindet sich im aktuellen Verzeichnis, dann können wir nun folgendes tun: + </para> <screen> <![CDATA[ $ chmod 755 test @@ -561,6 +584,8 @@ } ]]> </screen> + </example> + <para> Wie Sie sehen können, müssen Sie sich in diesem Fall um nichts weiter kümmern, wenn Sie Ihrem Skript Paramater, die mit <literal>-</literal> beginnen, übergeben. @@ -601,6 +626,12 @@ müssen etwa vor dem Aufruf definiert werden. </para> </note> + <note> + <para> + <link linkend="language.oop5.autoload">Automatisches Laden (autoload)</link> + ist im interaktiven PHP CLI Modus nicht verfügbar. + </para> + </note> </entry> </row> <row> @@ -612,6 +643,8 @@ wo nach &php.ini; gesucht werden soll, oder man kann eine eigene <literal>INI</literal>-Datei direkt angeben (diese muss nicht &php.ini; heissen). Zum Beispiel: + </para> + <informalexample> <screen> <![CDATA[ $ php -c /custom/directory/ my_script.php @@ -619,6 +652,8 @@ $ php -c /custom/directory/custom-file.ini my_script.php ]]> </screen> + </informalexample> + <para> Wenn Sie diese Option nicht angeben, wird die Datei an den <link linkend="configuration.file">vorgegebenen Orten</link> gesucht. </para> @@ -646,8 +681,10 @@ ]]> </screen> </para> + <informalexample> <para> Beispiele (die Zeilen sind aus layouttechnischen Gründen umgebrochen): + </para> <screen> <![CDATA[ # Auslassen des Wertes setzt die Direktive auf "1" @@ -669,7 +706,7 @@ string(15) "doesntmakesense" ]]> </screen> - </para> + </informalexample> </entry> </row> <row> @@ -748,9 +785,11 @@ <entry>-m</entry> <entry>--modules</entry> <entry> + <informalexample> <para> Wird diese Option benutzt, gibt PHP die eingebauten (und geladenen) PHP- und Zend-Module aus: + </para> <screen> <![CDATA[ $ php -m @@ -769,7 +808,7 @@ [Zend Modules] ]]> </screen> - </para> + </informalexample> </entry> </row> <row> @@ -790,27 +829,35 @@ aufpassen, dass es zu keinen Kollisionen mit Kommandozeilenvariablen kommt. </para> + <informalexample> <para> Dieses Beispiel zeigt einen Parserfehler: + </para> <screen> <![CDATA[ $ php -r "$foo = get_defined_constants();" Command line code(1) : Parse error - parse error, unexpected '=' ]]> </screen> + </informalexample> + <para> Das Problem hier ist, dass die sh/bash Variablen auch ersetzt, wenn doppelte Anführungszeichen benutzt werden (<literal>"</literal>). Weil die Variable <varname>$foo</varname> wahrscheinlich nicht definiert ist, passiert nichts. Der tatsächliche Code, der an PHP übergeben wird, sieht so aus: + </para> + <informalexample> <screen> <![CDATA[ $ php -r " = get_defined_constants();" ]]> </screen> + <para> Der korrekte Weg wäre, einfache Anführungszeichen zu benutzen (<literal>'</literal>). Variablen in einfachen Anführungszeichen werden von sh/bash nicht ersetzt. + </para> <screen> <![CDATA[ $ php -r '$foo = get_defined_constants(); var_dump($foo);' @@ -827,6 +874,8 @@ [...] ]]> </screen> + </informalexample> + <para> Wenn Sie eine andere Kommandozeilenumgebung als sh/bash benutzen, könnten Sie auf weitere Probleme stoßen. Sie können gerne einen Bugreport unter <link xlink:href="&url.php.bugs;">&url.php.bugs;</link> eintragen. @@ -896,13 +945,15 @@ <para> Ein Beispiel, wie man die Optionen <option>-B</option>, <option>-R</option> und <option>-E</option> benutzt, um die Anzahl der Zeilen in einem Projekt zu zählen. + </para> + <informalexample> <screen> <![CDATA[ $ find my_proj | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Total Lines: $l\n";' Total Lines: 37328 ]]> </screen> - </para> + </informalexample> </entry> </row> <row> @@ -931,9 +982,11 @@ <entry>-v</entry> <entry>--version</entry> <entry> + <informalexample> <para> Schreibt die Version von PHP, PHP SAPI und Zend auf die Standardausgabe. Zum Beispiel: + </para> <screen> <![CDATA[ $ php -v @@ -941,7 +994,7 @@ Zend Engine v1.3.0, Copyright (c) 1998-2002 Zend Technologies ]]> </screen> - </para> + </informalexample> </entry> </row> <row> @@ -976,6 +1029,103 @@ </para> </entry> </row> + <row> + <entry></entry> + <entry>--ini</entry> + <entry> + <para> + Zeigt die Namen der Konfigurationsdateien und die durchsuchten + Verzeichnisse. Verfügbar seit PHP 5.2.3. + <example> + <title><literal>--ini</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --ini +Configuration File (php.ini) Path: /usr/dev/php/5.2/lib +Loaded Configuration File: /usr/dev/php/5.2/lib/php.ini +Scan for additional .ini files in: (none) +additional .ini files parsed: (none) +]]> + </programlisting> + </example> + </para> + </entry> + </row> + <row> + <entry>--rf</entry> + <entry>--rfunction</entry> + <entry> + <para> + Zeigt Informationen über die gegebene Funktion oder + Klassenmethode (z.B. Anzahl und Name der Parameter). + Verfügbar seit PHP 5.1.2. + </para> + <para> + Diese Option ist nur verfügbar wenn PHP mit + <link linkend="language.oop5.reflection">Reflection</link> Unterstützung + kompiliert wurde. + </para> + <para> + <example> + <title>Einfache <literal>--rf</literal> Nutzung</title> + <programlisting role="shell"> +<![CDATA[ +$ php --rf var_dump +Function [ <internal> public function var_dump ] { + + - Parameters [2] { + Parameter #0 [ <required> $var ] + Parameter #1 [ <optional> $... ] + } +} +]]> + </programlisting> + </example> + </para> + </entry> + </row> + <row> + <entry>--rc</entry> + <entry>--rclass</entry> + <entry> + <para> + Zeigt Inforationen über die gegebene Klasse (Liste der Konstanten, + Eigenschaften und Methoden). Verfügbar seit PHP 5.1.2. + </para> + <para> + Diese Option ist nur verfügbar wenn PHP mit + <link linkend="language.oop5.reflection">Reflection</link> Unterstützung + kompiliert wurde. + </para> + </entry> + </row> + <row> + <entry>--re</entry> + <entry>--rextension</entry> + <entry> + <para> + Zeigt Informationen über die gegebene Extension (Liste der &php.ini; + Optionen, definierte Funktionen, Konstanten und Klassen. + Verfügbar seit PHP 5.1.2. + </para> + <para> + Diese Option ist nur verfügbar wenn PHP mit + <link linkend="language.oop5.reflection">Reflection</link> Unterstützung + kompiliert wurde. + </para> + </entry> + </row> + <row> + <entry>-ri</entry> + <entry>--rextinfo</entry> + <entry> + <para> + Zeigt die Konfiguration der gegebenen Extension (entspricht der von + <function>phpinfo</function> zurückgegebenen Information). + Verfügbar seit PHP 5.2.2. + </para> + </entry> + </row> <!-- new, not in PHP 4.3.4, but are in php_cli.c 1.102 or cgi_main.c 1.243 -b <address:port>|<port> bindpath Bind Path for external FASTCGI Server mode, only CGI, no Windows