remote-files.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a0ae28d3bc85f927c22649ebd9a590b921534b7d Maintainer: samesch Status: ready -->
<!-- Reviewed: yes Maintainer: samesch -->
 <chapter xml:id="features.remote-files" xmlns="http://docbook.org/ns/docbook">
  <title>Zugriff auf entfernte Dateien</title>

  <para>
   Wenn <parameter>allow_url_fopen</parameter> in der &php.ini; aktiviert ist,
   können <acronym>HTTP</acronym>- und <acronym>FTP</acronym>-URLs bei den
   meisten Funktionen verwendet werden, die einen Dateinamen als Parameter
   benötigen. Darüber hinaus können URLs in <function>include</function>-,
   <function>include_once</function>-, <function>require</function>- und
   <function>require_once</function>-Anweisungen verwendet werden
   (<option>allow_url_include</option> muss dafür aktiviert sein). Weitere
   Informationen zu den Protokollen, die von PHP unterstützt werden, finden
   Sie im Abschnitt <xref linkend="wrappers"/>.
  </para>
  <para>
   Beispielsweise kann damit eine Datei auf einem anderen Webserver geöffnet
   und nach benötigten Daten analysiert werden. Diese Daten können zur Abfrage
   einer Datenbank verwendet werden oder passend zum Rest der eigenen Website
   ausgegeben werden.
  </para>
  <para>
   <example>
    <title>Den Titel einer entfernten Seite auslesen</title>
    <programlisting role="php">
<![CDATA[
<?php
$datei = fopen ("http://www.example.com/", "r");
if (!$datei) {
    echo "<p>Datei konnte nicht geöffnet werden.\n";
    exit;
}
while (!feof ($datei)) {
    $zeile = fgets ($datei, 1024);
    /* Funktioniert nur, wenn Titel und title-Tags in einer Zeile stehen */
    if (preg_match ("@\<title\>(.*)\</title\>@i", $zeile, $treffer)) {
        $title = $treffer[1];
        break;
    }
}
fclose($datei);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   Auch eine Datei auf einem FTP-Server kann geschrieben werden, vorausgesetzt
   man ist als Benutzer mit entsprechenden Zugriffsrechten angemeldet. Auf
   diesem Weg können nur neue Dateien angelegt werden. Falls Sie versuchen
   eine schon existierende Datei zu überschreiben, wird der
   <function>fopen</function>-Aufruf fehlschlagen.
  </para>
  <para>
   Um sich statt als 'anonymous' als anderer Benutzer anzumelden, muss ein
   Benutzername (und möglicherweise ein Passwort) innerhalb der URL angegeben
   werden, z. B.
   '<literal>ftp://benutzer:passwort@ftp.example.com/pfad/zur/datei</literal>'.
   Dieselbe Syntax kann verwendet werden, um auf Dateien via
   <acronym>HTTP</acronym> zuzugreifen, wenn diese eine
   Basic-Authentifizierung benötigen.
  </para>
  <para>
   <example>
    <title>Daten auf einen entfernten Server speichern</title>
    <programlisting role="php">
<![CDATA[
<?php
$datei = fopen ("ftp://ftp.example.com/incoming/outputfile", "w");
if (!$datei) {
    echo "<p>Datei konnte nicht zum schreiben geöffnet werden.\n";
    exit;
}
/* Schreibe die Daten hier hin. */
fputs ($datei, $_SERVER['HTTP_USER_AGENT'] . "\n");
fclose ($datei);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <note>
    <para>
     Obiges Beispiel könnte dazu verleiten, dieses Verfahren zu verwenden, um
     in eine entfernte Log-Datei zu schreiben. Das würde aber leider nicht
     funktionieren, weil der <function>fopen</function>-Aufruf fehlschlagen
     würde, wenn die entfernte Datei bereits existiert. Für eine
     dezentralisierte Protokollierung sollten Sie sich die Funktion
     <function>syslog</function> anschauen.
    </para>
   </note>
  </para>

 </chapter>

<!-- 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:
-->