<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.exec">
  <title>Funktionen zur Programmausfhrung</title>
  <titleabbrev>Programmausfhrung</titleabbrev>

  <partintro>
   <simpara>
    Diese Funktionen stellen Mittel und Wege zur Verfgung, Befehle
    und externe Programme auf dem System selbst auszufhren und diese
    Ausfhrung sicher durchzufhren. 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 knnen
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>escapeshellarg</methodname>
      <methodparam><type>string</type><parameter>arg</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>escapeshellarg</function> fgt einfache
     Anfhrungszeichen um eine Zeichenkette herum ein und maskiert
     alle existierenden einfachen Anfhrungszeichen innerhalb der
     Zeichenkette. Dieses erlaubt es Ihnen, eine Zeichenkette direkt
     an eine Shell-Funktion zu bergeben, so dass diese als eine
     einzige, sichere Anweisung ausgefhrt 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">
      system("ls ".escapeshellarg($dir));
      </programlisting>
     </informalexample>
    </para>
    <para>
     Siehe auch:<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.escapeshellcmd">
   <refnamediv>
    <refname>escapeshellcmd</refname>
    <refpurpose>Maskiert Shell-Metazeichen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>escapeshellcmd</methodname>
      <methodparam><type>string</type><parameter>befehl</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>escapeshellcmd</function> maskiert alle mglichen
     Zeichen in einer Zeichenkette, die dazu benutzt werden knnten,
     um einen Shellbefehl zur Durchfhrung von willkrlichen 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">
$e = escapeshellcmd($userinput);
system("echo $e"); // hier ist es egal, ob $e Leerstellen hat
$f = escapeshellcmd($filename);
system("touch \"/tmp/$f\"; ls -l \"/tmp/$f\""); // hier ist es nicht egal
      </programlisting>
     </informalexample>
    </para>
    <para>
     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>Fhrt ein externes Programm aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>exec</methodname>
      <methodparam><type>string</type><parameter>befehl</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>array
       </parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>exec</function> fhrt ein gegebenen
     <parameter>Befehl</parameter> aus, ohne eine Ausgabe zu
     erzeugen. Die Funktion gibt lediglich die letzte Zeile aus dem
     Befehlsergebnis zurck. Wenn Sie auf die direkte Rckgabe/
     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 gefllt. Beachten Sie,
     dass wenn das Array schon Elemente enthlt, die Funktion
     <function>exec</function> die Ausgabe an das Array anhngt.  Wenn
     Sie dieses nicht wnschen, rufen Sie die Funktion <function>unset
     </function> fr 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 Rckgabestatus des ausgefhrten 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 willkrlichen
     Befehlen Ihrem System Schaden zufgen kann.
    </para>
    <para>
     Beachten Sie auch, dass wenn Sie ein Programm mit dieser Funktion
     starten und Sie es im Hintergrund laufen lassen mchten, Sie
     sicherstellen mssen, 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
     linkend="language.operators.execution">Backtick Operator</link>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.passthru">
   <refnamediv>
    <refname>passthru</refname>
    <refpurpose>
     Fhrt ein externes Programm aus und zeigt dessen Ausgabe an
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>passthru</methodname>
      <methodparam><type>string</type><parameter>befehl</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>passthru</function> hnelt der Funktion
     <function>exec</function>, da sie ebenfalls einen
     <parameter>Befehl </parameter> ausfhrt.  Ist der Parameter
     <parameter>return_var</parameter> angegeben, wird der
     Rckgabestatus 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 binre Daten handelt, welche direkt
     zum Browser zurckgeschickt werden mssen.  Ein praktisches
     Beispiel hierfr ist die Ausfhrung 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, knnen 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 mchten, Sie
     sicherstellen mssen, 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>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.system">
   <refnamediv>
    <refname>system</refname>
    <refpurpose>
     Fhrt ein externes Programm aus und zeigt dessen Ausgabe an.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>system</methodname>
      <methodparam><type>string</type><parameter>befehl</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>return_var</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>system</function> hnelt der C Version der
     Funktion sehr, indem es einen bergebenen
     <parameter>Befehl</parameter> ausfhrt und dessen Ausgabe
     anzeigt. Wir als zweiter Parameter der Funktion eine Variable
     bergeben, so wird der Rckgabestatus 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 willkrlichen
     Befehlen Ihrem System Schaden zufgen kann.
    </para>
    <para>
     Beachten Sie auch, dass wenn Sie ein Programm mit dieser Funktion
     starten und Sie es im Hintergrund laufen lassen mchten, Sie
     sicherstellen mssen, 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 luft.
    </para>
    <para>
     Gibt die letzte Zeile der Befehlsausgabe bei Erfolg, andernfalls
     &false; zurck.
    </para>
    <para>
     Wenn Sie auf die direkte Rckgabe/ 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
     linkend="language.operators.execution">Backtick Operator</link>.
    </para>
   </refsect1>
  </refentry>

 </reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->