archived-doc-de/reference/exec/functions/passthru.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b412bbd26214f7281ac7dd858710e09952a275f2 Maintainer: sammywg Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 7973fd533364af4dd6282ca9e7bee2dffec39b1c Reviewer: samesch -->
<refentry xml:id="function.passthru" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>passthru</refname>
  <refpurpose>Führt ein externes Programm aus und zeigt dessen Ausgabe an</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>false</type><type>null</type></type><methodname>passthru</methodname>
   <methodparam><type>string</type><parameter>command</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter role="reference">result_code</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Die Funktion <function>passthru</function> ähnelt der Funktion
   <function>exec</function>, da sie ebenfalls ein
   <parameter>command</parameter> ausführt. Diese Funktion sollte anstelle von
   <function>exec</function> bzw. <function>system</function> verwendet
   werden, wenn die Ausgabe des Unix-Befehls binäre Daten erzeugt, die direkt
   an den Browser zurückgegeben werden sollen. Ein praktisches Beispiel
   hierfür ist die Ausführung eines Programms wie pbmplus, welches einen
   Bildstream direkt ausgibt. Wenn der Content-Type auf
   <literal>image/gif</literal> gesetzt wird und dann das pbmplus-Programm
   aufgerufen wird, um ein GIF zu erzeugen, kann auf diesem Weg mittels PHP
   direkt ein Bild erzeugt und ausgegeben werden.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>command</parameter></term>
     <listitem>
      <para>
       Der auszuführende Befehl.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>result_code</parameter></term>
     <listitem>
      <para>
       Ist der Parameter <parameter>result_code</parameter> angegeben, wird der
       Rückgabestatus des UNIX-Befehls hier abgelegt.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.nullorfalse;
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Wenn <function>passthru</function> den Befehl
   <parameter>command</parameter> nicht ausführen kann, wird eine Meldung der
   Stufe <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para>
   Löst einen <classname>ValueError</classname> aus, wenn
   <parameter>command</parameter> leer ist oder Nullbytes enthält.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn <parameter>command</parameter> leer ist oder Nullbytes enthält,
       löst <function>passthru</function> nun einen
       <classname>ValueError</classname> aus. Zuvor gab die Funktion ein
       <constant>E_WARNING</constant> aus und gab &false; zurück.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  &warn.escapeshell;
  &note.exec-bg;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>exec</function></member>
    <member><function>system</function></member>
    <member><function>popen</function></member>
    <member><function>escapeshellcmd</function></member>
    <member><link linkend="language.operators.execution">Backtick-Operator</link></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
<!-- 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:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->