shell-exec.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 7973fd533364af4dd6282ca9e7bee2dffec39b1c Maintainer: sammywg Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 1.0 Reviewer: samesch -->
<refentry xml:id="function.shell-exec" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>shell_exec</refname>
  <refpurpose>
   Führt einen Befehl auf der Shell aus und liefert die komplette Ausgabe als String
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type><type>null</type></type><methodname>shell_exec</methodname>
   <methodparam><type>string</type><parameter>command</parameter></methodparam>
  </methodsynopsis>
  <para>
   Diese Funktion ist identisch zum
   <link linkend="language.operators.execution">Backtick-Operator</link>.
  </para>
  <note>
   <para>
    Unter Windows wird die darunterliegende Pipe im Textmodus geöffnet, was
    bewirken kann, dass die Funktion für binäre Ausgaben fehlschlägt. Es ist
    zu erwägen, für solche Fälle stattdessen <function>popen</function> zu
    verwenden.
   </para>
  </note>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>command</parameter></term>
     <listitem>
      <para>
       Der auszuführende Befehl.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Ein &string;, der die Ausgabe des ausgeführten Befehls enthält, &false;,
   wenn die Pipe nicht angelegt werden kann, oder &null;, wenn ein Fehler
   auftrat oder der Befehl keine Ausgabe erzeugt.
  </para>
  <note>
   <para>
    Diese Funktion kann &null; zurückgeben, sowohl wenn ein Fehler auftritt als
    auch wenn das Programm keine Ausgabe erzeugt. Es ist nicht möglich, mit
    dieser Funktion das Scheitern der Ausführung festzustellen. Wenn Zugriff
    auf den Exitcode des Programms erforderlich ist, sollte
    <function>exec</function> verwendet werden.
   </para>
  </note>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Ein Fehler der Stufe <constant>E_WARNING</constant> wird erzeugt, wenn die
   Pipe nicht angelegt werden kann.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ein <function>shell_exec</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
$output = shell_exec('ls -lart');
echo "<pre>$output</pre>";
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>exec</function></member>
    <member><function>escapeshellcmd</function></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
-->