eschmid Wed Sep 5 21:21:47 2001 EDT
Modified files:
/phpdoc/de/functions exec.xml
Log:
Only whitespace and to confuse my revision ...
Index: phpdoc/de/functions/exec.xml
diff -u phpdoc/de/functions/exec.xml:1.7 phpdoc/de/functions/exec.xml:1.8
--- phpdoc/de/functions/exec.xml:1.7 Wed Sep 5 06:31:12 2001
+++ phpdoc/de/functions/exec.xml Wed Sep 5 21:21:41 2001
@@ -1,23 +1,26 @@
<?xml encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
<reference id="ref.exec">
<title>Funktionen zur Programmausführung</title>
<titleabbrev>Programmausführung</titleabbrev>
<partintro>
<simpara>
- Diese Funktionen stellen Mittel und Wege zur Verfügung, Befehle und externe
- Programme auf dem System selbst auszuführen und diese Ausführung sicher
- durchzuführen. Diese Funktionen stehen in enger Beziehung zum
- <link linkend="language.operators.execution">Backtick-Operator</link>.
+ Diese Funktionen stellen Mittel und Wege zur Verfügung, Befehle
+ und externe Programme auf dem System selbst auszuführen und diese
+ Ausführung sicher durchzuführen. Diese Funktionen stehen in enger
+ Beziehung zum <link
+ linkend="language.operators.execution">Backtick-Operator</link>.
</simpara>
</partintro>
<refentry id="function.escapeshellarg">
<refnamediv>
<refname>escapeshellarg</refname>
- <refpurpose>maskiert eine Zeichenkette (String), um sie als Shell-Argument
- benutzen zu können</refpurpose>
+ <refpurpose>
+ Maskiert eine Zeichenkette (String), um sie als Shell-Argument
+ benutzen zu können
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -28,16 +31,19 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>escapeshellarg</function> fügt einfache Anführungszeichen um
- eine Zeichenkette herum ein und maskiert alle existierenden einfachen
- Anführungszeichen innerhalb der Zeichenkette. Dieses erlaubt es Ihnen,
- eine Zeichenkette direkt an eine Shell-Funktion zu übergeben, so dass
- diese als eine einzige, sichere Anweisung ausgeführt werden kann.
- Die Funktion sollte verwendet werden, um Parameter, die aus Benutzereingaben
- resultieren, an Shell-Funktionen zu übergeben. Die Shell-Funktionen
- umfassen <function>exec</function>, <function>system</function> und den
- <link linkend="language.operators.execution">backtick operator</link>.
- Beispiel:</para>
+ <function>escapeshellarg</function> fügt einfache
+ Anführungszeichen um eine Zeichenkette herum ein und maskiert
+ alle existierenden einfachen Anführungszeichen innerhalb der
+ Zeichenkette. Dieses erlaubt es Ihnen, eine Zeichenkette direkt
+ an eine Shell-Funktion zu übergeben, so dass diese als eine
+ einzige, sichere Anweisung ausgeführt werden kann. Die Funktion
+ sollte verwendet werden, um Parameter, die aus Benutzereingaben
+ resultieren, an Shell-Funktionen zu übergeben. Die
+ Shell-Funktionen umfassen <function>exec</function>,
+ <function>system</function> und den <link
+ linkend="language.operators.execution">backtick operator</link>.
+ Beispiel:
+ </para>
<para>
<informalexample>
<programlisting role="php">
@@ -47,17 +53,16 @@
</para>
<para>
Siehe auch:<function>exec</function>, <function>popen</function>,
- <function>system</function>, und den <link
+ <function>system</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
-
</refsect1>
</refentry>
<refentry id="function.escapeshellcmd">
<refnamediv>
<refname>escapeshellcmd</refname>
- <refpurpose>maskiert Shell-Metazeichen</refpurpose>
+ <refpurpose>Maskiert Shell-Metazeichen</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -68,14 +73,15 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>escapeshellcmd</function> maskiert alle möglichen Zeichen in
- einer Zeichenkette, die dazu benutzt werden könnten, um einen Shellbefehl
- zur Durchführung von willkürlichen Befehlen zu veranlassen. Diese
- Funktion sollte verwendet werden um sicherzustellen, dass alle Daten
- aus einer Benutzereingabe maskiert werden bevor dieses Daten zu einer
- der Funktionen <function>exec</function>, <function>system</function>
- oder dem <link linkend="language.operators.execution">Backtick Operator
- </link> übergeben werden. Beispiel:</para>
+ <function>escapeshellcmd</function> maskiert alle möglichen
+ Zeichen in einer Zeichenkette, die dazu benutzt werden könnten,
+ um einen Shellbefehl zur Durchführung von willkürlichen Befehlen
+ zu veranlassen. Diese Funktion sollte verwendet werden um
+ sicherzustellen, dass alle Daten aus einer Benutzereingabe
+ maskiert werden bevor dieses Daten zu einer der Funktionen
+ <function>exec</function>, <function>system</function> oder dem
+ <link linkend="language.operators.execution">Backtick Operator
+ </link> übergeben werden. Beispiel:</para>
<para>
<informalexample>
<programlisting role="php">
@@ -87,18 +93,18 @@
</informalexample>
</para>
<para>
- Siehe auch: <function>escapeshellarg</function>, <function>exec</function>,
- <function>popen</function>, <function>system</function>, und den <link
+ Siehe auch: <function>escapeshellarg</function>,
+ <function>exec</function>, <function>popen</function>,
+ <function>system</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
-
</refsect1>
</refentry>
<refentry id="function.exec">
<refnamediv>
<refname>exec</refname>
- <refpurpose>führt ein externes Programm aus</refpurpose>
+ <refpurpose>Führt ein externes Programm aus</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -116,42 +122,44 @@
</funcprototype>
</funcsynopsis>
<para>
- <function>exec</function> führt ein gegebenen <parameter>Befehl</parameter>
- aus, ohne eine Ausgabe zu erzeugen. Die Funktion gibt lediglich die
- letzte Zeile aus dem Befehlsergebnis zurück. Wenn Sie auf die direkte
- Rückgabe/ Ausgabe eines Befehls angewiesen sind, dann benutzen Sie
- stattdessen die Funktion <function>passthru</function>.
- </para>
- <para>
- Ist der Parameter <parameter>array</parameter> angegeben, wird dieses
- mit jeder Zeile des Befehlsausgabe gefüllt. Beachten Sie, dass wenn
- das Array schon Elemente enthält, die Funktion <function>exec</function>
- die Ausgabe an das Array anhängt.
- Wenn Sie dieses nicht wünschen, rufen Sie die Funktion <function>unset
- </function> für das Array auf, bevor Sie es als Parameter der Funktion
- <function>exec</function> übergeben.
- </para>
- <para>
- Ist der Parameter <parameter>return_var</parameter> angegeben, so wird
- der Rückgabestatus des ausgeführten Befehls in diese Variable geschrieben.
- </para>
- <para>
- Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
- übergeben, diese mit <function>escapeshellcmd</function> behandelt, um
- sicherzustellen, dass niemand mit willkürlichen Befehlen Ihrem System
- Schaden zufügen kann.
+ <function>exec</function> führt ein gegebenen
+ <parameter>Befehl</parameter> aus, ohne eine Ausgabe zu
+ erzeugen. Die Funktion gibt lediglich die letzte Zeile aus dem
+ Befehlsergebnis zurück. Wenn Sie auf die direkte Rückgabe/
+ Ausgabe eines Befehls angewiesen sind, dann benutzen Sie
+ stattdessen die Funktion <function>passthru</function>.
+ </para>
+ <para>
+ Ist der Parameter <parameter>array</parameter> angegeben, wird
+ dieses mit jeder Zeile des Befehlsausgabe gefüllt. Beachten Sie,
+ dass wenn das Array schon Elemente enthält, die Funktion
+ <function>exec</function> die Ausgabe an das Array anhängt. Wenn
+ Sie dieses nicht wünschen, rufen Sie die Funktion <function>unset
+ </function> für das Array auf, bevor Sie es als Parameter der
+ Funktion <function>exec</function> übergeben.
+ </para>
+ <para>
+ Ist der Parameter <parameter>return_var</parameter> angegeben, so
+ wird der Rückgabestatus des ausgeführten Befehls in diese
+ Variable geschrieben.
+ </para>
+ <para>
+ Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
+ übergeben, diese mit <function>escapeshellcmd</function>
+ behandelt, um sicherzustellen, dass niemand mit willkürlichen
+ Befehlen Ihrem System Schaden zufügen kann.
</para>
<para>
Beachten Sie auch, dass wenn Sie ein Programm mit dieser Funktion
- starten und Sie es im Hintergrund laufen lassen möchten, Sie
- sicherstellen müssen, dass die Ausgabe des Programms in eine Datei
- oder anderenen Ausgabestream umgeleitet wird. Andernfalls wird PHP
- solange laufen, bis das Programm beendet ist.
+ starten und Sie es im Hintergrund laufen lassen möchten, Sie
+ sicherstellen müssen, dass die Ausgabe des Programms in eine
+ Datei oder anderenen Ausgabestream umgeleitet wird. Andernfalls
+ wird PHP solange laufen, bis das Programm beendet ist.
</para>
<para>
Siehe auch: <function>system</function>,
<function>passthru</function>, <function>popen</function>,
- <function>escapeshellcmd</function>, und den <link
+ <function>escapeshellcmd</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
</refsect1>
@@ -161,7 +169,7 @@
<refnamediv>
<refname>passthru</refname>
<refpurpose>
- führt ein externes Programm aus und zeigt dessen Ausgabe an
+ Führt ein externes Programm aus und zeigt dessen Ausgabe an
</refpurpose>
</refnamediv>
<refsect1>
@@ -176,32 +184,33 @@
</funcprototype>
</funcsynopsis>
<para>
- Die Funktion <function>passthru</function> ähnelt der Funktion
- <function>exec</function>, da sie ebenfalls einen <parameter>Befehl
- </parameter> ausführt.
- Ist der Parameter <parameter>return_var</parameter> angegeben, wird
- der Rückgabestatus des UNIX-Befehls hier abgelegt. Sie sollten diese
- Funktion jedoch an Stelle von <function>exec</function> bzw.
- <function>system</function> benutzen, wenn es sich bei der Ausgabe
- des Unix-Befehls um binäre Daten handelt, welche direkt zum Browser
- zurückgeschickt werden müssen.
- Ein praktisches Beispiel hierfür ist die Ausführung des pbmplus Utility,
- welches direkt einen Bildstream ausgibt. Wenn Sie den Content-Type auf
- <emphasis>image/gif</emphasis> setzen, und dann das pbmplus Program
- aufrufen um ein GIF zu erzeugen, können Sie auf diesem Weg mittels PHP
- direkt ein Bild erzeugen und es ausgeben.</para>
+ Die Funktion <function>passthru</function> ähnelt der Funktion
+ <function>exec</function>, da sie ebenfalls einen
+ <parameter>Befehl </parameter> ausführt. Ist der Parameter
+ <parameter>return_var</parameter> angegeben, wird der
+ Rückgabestatus des UNIX-Befehls hier abgelegt. Sie sollten diese
+ Funktion jedoch an Stelle von <function>exec</function> bzw.
+ <function>system</function> benutzen, wenn es sich bei der
+ Ausgabe des Unix-Befehls um binäre Daten handelt, welche direkt
+ zum Browser zurückgeschickt werden müssen. Ein praktisches
+ Beispiel hierfür ist die Ausführung des pbmplus Utility, welches
+ direkt einen Bildstream ausgibt. Wenn Sie den Content-Type auf
+ <emphasis>image/gif</emphasis> setzen, und dann das pbmplus
+ Program aufrufen um ein GIF zu erzeugen, können Sie auf diesem
+ Weg mittels PHP direkt ein Bild erzeugen und es ausgeben.
+ </para>
<para>
Beachten Sie, dass wenn Sie ein Programm mit dieser Funktion
- starten und Sie es im Hintergrund laufen lassen möchten, Sie
- sicherstellen müssen, dass die Ausgabe des Programms in eine Datei
- oder anderenen Ausgabestream umgeleitet wird. Andernfalls wird PHP
- solange laufen, bis das Programm beendet ist.
+ starten und Sie es im Hintergrund laufen lassen möchten, Sie
+ sicherstellen müssen, dass die Ausgabe des Programms in eine
+ Datei oder anderenen Ausgabestream umgeleitet wird. Andernfalls
+ wird PHP solange laufen, bis das Programm beendet ist.
</para>
<para>
- Siehe auch: <function>exec</function>, <function>system</function>,
- <function>popen</function>, <function>escapeshellcmd</function>,
- und den <link linkend="language.operators.execution">Backtick
- Operator</link>.
+ Siehe auch: <function>exec</function>,
+ <function>system</function>, <function>popen</function>,
+ <function>escapeshellcmd</function> und den <link
+ linkend="language.operators.execution">Backtick Operator</link>.
</para>
</refsect1>
</refentry>
@@ -210,8 +219,8 @@
<refnamediv>
<refname>system</refname>
<refpurpose>
- führt ein externes Programm aus und zeigt dessen Ausgabe an.
- </refpurpose>
+ Führt ein externes Programm aus und zeigt dessen Ausgabe an.
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
@@ -225,42 +234,44 @@
</funcprototype>
</funcsynopsis>
<para>
- Die Funktion <function>system</function> ähnelt der C Version der Funktion
- sehr, indem es einen übergebenen <parameter>Befehl</parameter> ausführt
- und dessen Ausgabe anzeigt. Wir als zweiter Parameter der Funktion eine
- Variable übergeben, so wird der Rückgabestatus des Befehls in diese
- geschrieben.
+ Die Funktion <function>system</function> ähnelt der C Version der
+ Funktion sehr, indem es einen übergebenen
+ <parameter>Befehl</parameter> ausführt und dessen Ausgabe
+ anzeigt. Wir als zweiter Parameter der Funktion eine Variable
+ übergeben, so wird der Rückgabestatus des Befehls in diese
+ geschrieben.
</para>
<para>
- Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
- übergeben, diese mit <function>escapeshellcmd</function> behandelt, um
- sicherzustellen, dass niemand mit willkürlichen Befehlen Ihrem System
- Schaden zufügen kann.
+ Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion
+ übergeben, diese mit <function>escapeshellcmd</function>
+ behandelt, um sicherzustellen, dass niemand mit willkürlichen
+ Befehlen Ihrem System Schaden zufügen kann.
</para>
<para>
Beachten Sie auch, dass wenn Sie ein Programm mit dieser Funktion
- starten und Sie es im Hintergrund laufen lassen möchten, Sie
- sicherstellen müssen, dass die Ausgabe des Programms in eine Datei
- oder anderenen Ausgabestream umgeleitet wird. Andernfalls wird PHP
- solange laufen, bis das Programm beendet ist.
+ starten und Sie es im Hintergrund laufen lassen möchten, Sie
+ sicherstellen müssen, dass die Ausgabe des Programms in eine
+ Datei oder anderenen Ausgabestream umgeleitet wird. Andernfalls
+ wird PHP solange laufen, bis das Programm beendet ist.
</para>
<para>
- Die <function>system</function> Funktionsaufrufe versuchen übrigens
- automatisch nach jeder Ausgabezeile den Ausgabebuffer des Webservers
- zu flushen, wenn PHP als Servermodul läuft.
+ Die <function>system</function> Funktionsaufrufe versuchen
+ übrigens automatisch nach jeder Ausgabezeile den Ausgabebuffer
+ des Webservers zu flushen, wenn PHP als Servermodul läuft.
</para>
<para>
- Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls &false;
- zurück.
+ Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls
+ &false; zurück.
</para>
<para>
- Wenn Sie auf die direkte Rückgabe/ Ausgabe eines Befehls angewiesen sind,
- dann benutzen Sie stattdessen die Funktion <function>passthru</function>.
+ Wenn Sie auf die direkte Rückgabe/ Ausgabe eines Befehls
+ angewiesen sind, dann benutzen Sie stattdessen die Funktion
+ <function>passthru</function>.
</para>
<para>
Siehe auch: <function>exec</function>,
<function>passthru</function>, <function>popen</function>,
- <function>escapeshellcmd</function>, und den <link
+ <function>escapeshellcmd</function> und den <link
linkend="language.operators.execution">Backtick Operator</link>.
</para>
</refsect1>
