<?xml version="1.0" encoding="iso-8859-1"?>
 <reference id="ref.ftp">
  <title>FTP-Funktionen</title>
  <titleabbrev>FTP</titleabbrev>
  <!-- Anmerkung des bersetzers:
       Entspricht der en/functions/ftp.xml 1.9 -->

  <partintro>
   <para>
    FTP ist die Abkrzung fr File Transfer Protocol
    (Datei-bertragungs-Protokoll).
   </para>
   <para>
    Die folgenden Konstanten sind definiert, sobald das FTP-Modul
    benutzt wird: <constant>FTP_ASCII</constant> und 
    <constant>FTP_BINARY</constant>.
   </para>
   <para>
    <example>
     <title><function>ftp</function>-Beispiel:</title>
      <programlisting>
&lt;?php
// Herstellen der Basis-Verbindung
$conn_id = ftp_connect("$ftp_server"); 

// Einloggen mit Benutzername und Kennwort
$login_result = ftp_login($conn_id, "$ftp_user_name", "$ftp_user_pass"); 

// Verbindung berprfen
if ((!$conn_id) || (!$login_result)) { 
        echo "Ftp-Verbindung nicht hergestellt!";
        echo "Verbindung mit $ftp_server als Benutzer $user nicht mglich"; 
        die; 
    } else {
        echo "Verbunden mit $ftp_server als Benutzer $user";
    }

// Upload der Datei
$upload = ftp_put($conn_id, "$destination_file", "$source_file", FTP_BINARY); 

// Upload-Status berprfen
if (!$upload) { 
        echo "Ftp upload war fehlerhaft!";
    } else {
        echo "Datei $source_file auf $ftp_server als $destination_file geschrieben";
    }

// Schlieen des FTP-Streams
ftp_quit($conn_id); 
?>
     </programlisting>
    </example>
   </para>
  </partintro>

  <refentry id="function.ftp-connect">
   <refnamediv>
    <refname>ftp_connect</refname>
    <refpurpose>Stellt eine FTP-Verbindung her</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_connect</methodname>
      <methodparam><type>string</type><parameter>Host</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>Port
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt bei Erfolg einen Stream zurck, sonst &false;.
    </para>  
    <para>
     <function>ftp_connect</function> stellt eine FTP-Verbindung zum
     angegebenen <parameter>Host</parameter> her. Der
     <parameter>Port</parameter>-Parameter enthlt optional einen
     alternativer Port fr die Verbindung. Fehlt er oder ist er &null;,
     wird der Standard-FTP-Port 21 benutzt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-login">
   <refnamediv>
    <refname>ftp_login</refname>
    <refpurpose>Anmelden einer FTP-Verbindung (Login)</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_login</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>Benutzername</parameter></methodparam>
      <methodparam><type>string</type><parameter>Passwort</parameter></methodparam>
     </methodsynopsis>
    <para>
     Wenn die Anmeldung erfolgreich war, wird &true;, anderenfalls &false;
     zurck gegeben.
    </para>
    <para> 
     Anmeldung beim angegebenen FTP-Stream.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-pwd">
   <refnamediv>
    <refname>ftp_pwd</refname>
    <refpurpose>Gibt den aktuellen Verzeichnis-Namen zurck</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ftp_pwd</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt das aktuelle Verzeichnis oder - im Fehlerfall - &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-cdup">
   <refnamediv>
    <refname>ftp_cdup</refname>
    <refpurpose>Wechselt in das um eine Ebene hhere Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_cdup</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
     </methodsynopsis>
    <para>     
     Bei Erfolg wird &true;, ansonsten &false; zurck gegeben.
    </para>
    <para> 
     Geht eine Verzeichnisebene hher.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-chdir">
   <refnamediv>
    <refname>ftp_chdir</refname>
    <refpurpose>Verzeichnis-Wechsel auf einem FTP-Server</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_chdir</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>Verzeichnis</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird &true;, ansonsten &false; zurck gegeben.
    </para>
    <para> 
     Wechselt in den durch <parameter>Verzeichnis</parameter> angegebenen
     Datei-Ordner.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-mkdir">
   <refnamediv>
    <refname>ftp_mkdir</refname>
    <refpurpose>Erzeugt ein Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ftp_mkdir</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>Verzeichnis</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird der Name des erzeugten Ordners, ansonsten &false;
     zurck gegeben.
    </para>
    <para> 
     Erzeugt das angegebene <parameter>Verzeichnis</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-rmdir">
   <refnamediv>
    <refname>ftp_rmdir</refname>
    <refpurpose>Lscht ein Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_rmdir</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>Verzeichnis</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird &true;, ansonsten &false; zurck gegeben.
    </para>
    <para> 
     Lscht das angegebene <parameter>Verzeichnis</parameter>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-nlist">
   <refnamediv>
    <refname>ftp_nlist</refname>
    <refpurpose>
     Gibt eine Liste der im angegebenen Verzeichnis enthaltenen
     Dateien zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>array</type><methodname>ftp_nlist</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>Verzeichnis</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt ein Array aus Dateinamen oder - bei Fehler - &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-rawlist">
   <refnamediv>
    <refname>ftp_rawlist</refname>
    <refpurpose>
     Gibt eine detaillierte Liste der Dateien in einem angegebenen
     Verzeichnis zurck
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_rawlist</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>Verzeichnis</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_rawlist</function> fhrt den FTP LIST-Befehl aus
     und gibt das Ergebnis in einem Array zurck. Jedes Array-Element
     entspricht einer Textzeile. Die Ausgabe wird von PHP in keinster
     Weise ausgewertet. Das System-Art-Merkmal, welches per
     <function>ftp_systype</function>-Funktion zurck gegeben wird,
     kann benutzt werden um die Auswertungsart der Ergebnisrckgabe
     zu ermitteln.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-systype">
   <refnamediv>
    <refname>ftp_systype</refname>
    <refpurpose>
     Ermittelt den Systemtyp des entfernten FTP-Servers
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>string</type><methodname>ftp_systype</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den entfernten Systemtyp an bzw. &false; bei einem Fehler.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-pasv">
   <refnamediv>
    <refname>ftp_pasv</refname>
    <refpurpose>Schaltet den passiven Modus ein oder aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_pasv</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>int</type><parameter>pasv</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird &true;, ansonsten &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_pasv</function> schaltet in den passiven Modus,
     wenn der <parameter>pasv</parameter>-Parameter &true; ist (ausschalten
     per <parameter>pasv</parameter>-Parameter gleich &false;). Im passiven
     Modus werden Datenverbindungen durch den Client statt durch den
     Server initiiert.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-get">
   <refnamediv>
    <refname>ftp_get</refname>
    <refpurpose>
     Liest eine Datei des FTP-Servers und speichert sie lokal (download)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_get</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>local_file</parameter></methodparam>
      <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird &true;, sonst &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_get</function> ldt das
     <parameter>remote_file</parameter> vom FTP-Server und speichert
     es unter <parameter>local_file</parameter> auf ihren lokalen
     Arbeitsplatz. Der anzugebende Transfer-Parameter
     <parameter>mode</parameter> muss entweder
     <constant>FTP_ASCII</constant> oder
     <constant>FTP_BINARY</constant> sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-fget">
   <refnamediv>
    <refname>ftp_fget</refname>
    <refpurpose>
     Ldt eine Datei vom FTP-Server und speichert sie in eine
     geffnete, lokale Datei (download)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_fget</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Sofern erfolgreich wird &true;, ansonsten &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_fget</function> ldt das
     <parameter>remote_file</parameter> vom FTP-Server und schreibt 
     es in die per Datei-Pointer angegebene Datei
     <parameter>fp</parameter>. Der Transfer-Modus-Parameter
     <parameter>mode</parameter> muss entweder FTP_ASCII oder
     FTP_BINARY sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-put">
   <refnamediv>
    <refname>ftp_put</refname>
    <refpurpose>
     bertrgt eine Datei auf einen FTP-Server (upload)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_put</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
      <methodparam><type>string</type><parameter>local_file</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird &true;, sonst &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_put</function> speichert die per
     <parameter>local_file</parameter> bestimmte Datei auf den
     FTP-Server als Datei namens <parameter>remote_file</parameter>.
     Der bertragungs-Modus-Parameter <parameter>mode</parameter>
     muss entweder <constant>FTP_ASCII</constant> oder 
     <constant>FTP_BINARY</constant> lauten.
     <example>
      <title><function>ftp_put</function>-Beispiel:</title>
      <programlisting role="php">
$upload = ftp_put ($conn_id, "$destination_file", "$source_file", FTP_ASCII); 
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-fput">
   <refnamediv>
    <refname>ftp_fput</refname>
    <refpurpose>
     bertragt eine geffnete Datei auf einen FTP-Server (upload)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_fput</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird &true;, sonst &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_fput</function> bertragt das per Datei-Zeiger
     <parameter>fp</parameter> benannte und geffnete File zum
     FTP-Server. Die bertragenen Daten werden in der ber
     <parameter>remote_file</parameter> bestimmten Datei auf dem
     FTP-Server gespeichert. Der 
     <parameter>mode</parameter>-bertragungs-Parameter muss
     entweder <constant>FTP_ASCII</constant> oder 
     <constant>FTP_BINARY</constant> sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-size">
   <refnamediv>
    <refname>ftp_size</refname>
    <refpurpose>
     Ermittelt die Dateigrsse einer angegebenen Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_size</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Dateigrsse oder -1 bei Fehlern zurck.
    </para>
    <para>
     <function>ftp_size</function> ermittelt die Grsse einer Datei.
     Wenn ein Fehler vorliegt, so z.B. wenn die Datei nicht existiert,
     wird -1 zurck gegeben. Nicht alle FTP-Server untersttzen diese
     Funktionalitt.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-mdtm">
   <refnamediv>
    <refname>ftp_mdtm</refname>
    <refpurpose>
     Ermittelt die letzte nderungszeit der angegebenen Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_mdtm</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei Erfolg wird ein UNIX-Timestamp zurck gegeben, sonst -1.
    </para>
    <para>
     <function>ftp_mdtm</function> prft den Zeitpunkt der letzten
     Dateinderung und liefert diesen als UNIX-Timestamp zurck. Beim
     Auftreten eines Fehlers wird -1 zurck gegeben. Nicht alle
     FTP-Server untersttzen diese Funktionalitt.
    </para>
    <note>
     <para>
      <function>ftp_mdtm</function> funktioniert nicht mit
      Verzeichnissen.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-rename">
   <refnamediv>
    <refname>ftp_rename</refname>
    <refpurpose>Benennt eine Datei auf dem FTP-Server um</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_rename</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>from</parameter></methodparam>
      <methodparam><type>string</type><parameter>to</parameter></methodparam>
     </methodsynopsis>
    <para>
     Falls erfolgreich wird &true;, sonst &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_rename</function> benennt die mit
     <parameter>from</parameter> angegebene Datei in
     <parameter>to</parameter>um.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-delete">
   <refnamediv>
    <refname>ftp_delete</refname>
    <refpurpose>Lscht eine Datei auf dem FTP-Server</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_delete</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Falls erfolgreich wird &true;, sonst &false; zurck gegeben.
    </para>
    <para>
     <function>ftp_delete</function> lscht die per
     <parameter>path</parameter> angegebene Datei auf dem FTP-Server.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-site"> 
   <refnamediv> 
    <refname>ftp_site</refname> 
    <refpurpose>Sendet ein SITE-Kommando zum Server</refpurpose> 
   </refnamediv> 
   <refsect1> 
    <title>Beschreibung:</title> 
     <methodsynopsis>
      <type>int</type><methodname>ftp_site</methodname> 
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam> 
      <methodparam><type>string</type><parameter>cmd</parameter></methodparam> 
     </methodsynopsis>
    <para> 
     Bei erfolgreicher Ausfhrung wird &true;, sonst &false; zurck
     gegeben
    </para> 
    <para> 
     <function>ftp_site</function> sendet das in
     <parameter>cmd</parameter> stehende Kommando zum FTP-Server.
     SITE-Kommandos sind nicht standardisiert und von Server zu Server
     verschieden. Sie sind ntzlich, um Sachen wie Datei-Zugriffsrechte
     und Gruppen-Mitgliedschaften zu handhaben.
    </para> 
   </refsect1> 
  </refentry> 

  <refentry id="function.ftp-quit">
   <refnamediv>
    <refname>ftp_quit</refname>
    <refpurpose>Schliet / beendet eine FTP-Verbindung</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung:</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_quit</methodname>
      <methodparam><type>int</type><parameter>ftp_stream</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_connect</function> schliet die per
     <parameter>ftp_stream</parameter> bezeichnete FTP-Sitzung.
    </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:
-->