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 @@ - + Funktionen zur Programmausführung Programmausführung - 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 - Backtick-Operator. + 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 Backtick-Operator. escapeshellarg - maskiert eine Zeichenkette (String), um sie als Shell-Argument - benutzen zu können + + Maskiert eine Zeichenkette (String), um sie als Shell-Argument + benutzen zu können + Beschreibung @@ -28,16 +31,19 @@ - escapeshellarg 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 exec, system und den - backtick operator. - Beispiel: + escapeshellarg 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 exec, + system und den backtick operator. + Beispiel: + @@ -47,17 +53,16 @@ Siehe auch:exec, popen, - system, und den system und den Backtick Operator. - escapeshellcmd - maskiert Shell-Metazeichen + Maskiert Shell-Metazeichen Beschreibung @@ -68,14 +73,15 @@ - escapeshellcmd 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 exec, system - oder dem Backtick Operator - übergeben werden. Beispiel: + escapeshellcmd 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 + exec, system oder dem + Backtick Operator + übergeben werden. Beispiel: @@ -87,18 +93,18 @@ - Siehe auch: escapeshellarg, exec, - popen, system, und den escapeshellarg, + exec, popen, + system und den Backtick Operator. - exec - führt ein externes Programm aus + Führt ein externes Programm aus Beschreibung @@ -116,42 +122,44 @@ - exec führt ein gegebenen Befehl - 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 passthru. - - - Ist der Parameter array angegeben, wird dieses - mit jeder Zeile des Befehlsausgabe gefüllt. Beachten Sie, dass wenn - das Array schon Elemente enthält, die Funktion exec - die Ausgabe an das Array anhängt. - Wenn Sie dieses nicht wünschen, rufen Sie die Funktion unset - für das Array auf, bevor Sie es als Parameter der Funktion - exec übergeben. - - - Ist der Parameter return_var angegeben, so wird - der Rückgabestatus des ausgeführten Befehls in diese Variable geschrieben. - - - Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion - übergeben, diese mit escapeshellcmd behandelt, um - sicherzustellen, dass niemand mit willkürlichen Befehlen Ihrem System - Schaden zufügen kann. + exec führt ein gegebenen + Befehl 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 passthru. + + + Ist der Parameter array angegeben, wird + dieses mit jeder Zeile des Befehlsausgabe gefüllt. Beachten Sie, + dass wenn das Array schon Elemente enthält, die Funktion + exec die Ausgabe an das Array anhängt. Wenn + Sie dieses nicht wünschen, rufen Sie die Funktion unset + für das Array auf, bevor Sie es als Parameter der + Funktion exec übergeben. + + + Ist der Parameter return_var angegeben, so + wird der Rückgabestatus des ausgeführten Befehls in diese + Variable geschrieben. + + + Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion + übergeben, diese mit escapeshellcmd + behandelt, um sicherzustellen, dass niemand mit willkürlichen + Befehlen Ihrem System Schaden zufügen kann. 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. Siehe auch: system, passthru, popen, - escapeshellcmd, und den escapeshellcmd und den Backtick Operator. @@ -161,7 +169,7 @@ passthru - führt ein externes Programm aus und zeigt dessen Ausgabe an + Führt ein externes Programm aus und zeigt dessen Ausgabe an @@ -176,32 +184,33 @@ - Die Funktion passthru ähnelt der Funktion - exec, da sie ebenfalls einen Befehl - ausführt. - Ist der Parameter return_var angegeben, wird - der Rückgabestatus des UNIX-Befehls hier abgelegt. Sie sollten diese - Funktion jedoch an Stelle von exec bzw. - system 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 - image/gif 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. + Die Funktion passthru ähnelt der Funktion + exec, da sie ebenfalls einen + Befehl ausführt. Ist der Parameter + return_var angegeben, wird der + Rückgabestatus des UNIX-Befehls hier abgelegt. Sie sollten diese + Funktion jedoch an Stelle von exec bzw. + system 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 + image/gif 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. + 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. - Siehe auch: exec, system, - popen, escapeshellcmd, - und den Backtick - Operator. + Siehe auch: exec, + system, popen, + escapeshellcmd und den Backtick Operator. @@ -210,8 +219,8 @@ system - führt ein externes Programm aus und zeigt dessen Ausgabe an. - + Führt ein externes Programm aus und zeigt dessen Ausgabe an. + Beschreibung @@ -225,42 +234,44 @@ - Die Funktion system ähnelt der C Version der Funktion - sehr, indem es einen übergebenen Befehl 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 system ähnelt der C Version der + Funktion sehr, indem es einen übergebenen + Befehl 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. - Beachten Sie, dass wenn Sie Benutzereingaben an diese Funktion - übergeben, diese mit escapeshellcmd 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 escapeshellcmd + behandelt, um sicherzustellen, dass niemand mit willkürlichen + Befehlen Ihrem System Schaden zufügen kann. 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. - Die system Funktionsaufrufe versuchen übrigens - automatisch nach jeder Ausgabezeile den Ausgabebuffer des Webservers - zu flushen, wenn PHP als Servermodul läuft. + Die system Funktionsaufrufe versuchen + übrigens automatisch nach jeder Ausgabezeile den Ausgabebuffer + des Webservers zu flushen, wenn PHP als Servermodul läuft. - Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls &false; - zurück. + Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls + &false; zurück. - Wenn Sie auf die direkte Rückgabe/ Ausgabe eines Befehls angewiesen sind, - dann benutzen Sie stattdessen die Funktion passthru. + Wenn Sie auf die direkte Rückgabe/ Ausgabe eines Befehls + angewiesen sind, dann benutzen Sie stattdessen die Funktion + passthru. Siehe auch: exec, passthru, popen, - escapeshellcmd, und den escapeshellcmd und den Backtick Operator.