File: filesystem.xml

package info (click to toggle)
phpdoc 20020310-1
links: PTS
area: main
in suites: woody
size: 35,272 kB
ctags: 354
sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (3136 lines) | stat: -rw-r--r-- 106,627 bytes
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.126 Maintainer: tom Status: ready -->
<reference id="ref.filesystem">
  <title>Funktionen des Dateisystems</title>
  <titleabbrev>Filesystem</titleabbrev>

  <refentry id="function.basename">
   <refnamediv>
    <refname>basename</refname>
    <refpurpose>
     Extrahiert den Namen einer Datei aus einer vollstndigen Pfadangabe
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>basename</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>suffix</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion extrahiert aus einer vollstndigen Pfadangabe den
     Namen der Datei und gibt diesen zurck. Endet der Dateiname mit
     <parameter>suffix</parameter>, wird dieses Ende ebenfalls 
     abgeschnitten.
    </para>
    <para>
     Unter Windows wird sowohl der Slash (<literal>/</literal>) als
     auch der Backslash (<literal>\</literal>) als Trennzeichen bei
     Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur
     der Slash (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title><function>basename</function></title>
      <programlisting role="php">
<![CDATA[
$path = "/home/httpd/html/index.php";
$file = basename($path);         // $file enthlt den Wert "index.php"
$file = basename ($path,".php"); // $file enthlt den Wert "index"
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      Der Parameter <parameter>suffix</parameter> wurde in PHP 4.1.0.
      eingefhrt.
     </para>
    </note>
    <para>
     Siehe auch <function>dirname</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.chgrp">
   <refnamediv>
    <refname>chgrp</refname>
    <refpurpose>Wechselt die Gruppenzugehrigkeit einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>chgrp</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>group</parameter></methodparam>
     </methodsynopsis>
    <para>
     Weist der Datei <parameter>filename</parameter> die Benutzergruppe
     <parameter>group</parameter> zu (spezifiziert durch Name oder Nummer). Um
     diese Funktion ausfhren zu knnen, mssen Sie Superuser sein. Andere
     Benutzer knnen die Gruppenzugehrigkeit einer Datei in jede Gruppe
     ndern, derer sie angehren.
    </para>
    <para>
     Gibt bei Erfolg &true; zurck, andernfalls &false;.
    </para>
    <para>
     Siehe auch <function>chown</function> und
     <function>chmod</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.chmod">
   <refnamediv>
    <refname>chmod</refname>
    <refpurpose>ndert die Zugriffsrechte einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>chmod</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion ndert die Zugriffsrechte der Datei spezifiziert
     in <parameter>filename</parameter> in die Zugriffsrechte um, die
     in <parameter>mode</parameter> spezifiziert sind.
    </para>
    <para>
     Bedenken Sie, das <parameter>mode</parameter> nicht automatisch
     fr einen Oktalwert gehalten wird. Um sicher zu gehen, dass die
     Operation wie erwartet verluft sollten Sie
     <parameter>mode</parameter> mit dem Prefix &null; (0) versehen:
     <informalexample>
      <programlisting role="php">
<![CDATA[
chmod ("/somedir/somefile", 755);   // dezimal; mglicherweise falsch
chmod ("/somedir/somefile", "u+rwx,go+rx"); // String; falsch       
chmod ("/somedir/somefile", 0755);  // oktal; richtiger Wert von mode
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     Gibt &true; bei Erfolg zurck, andernfalls &false;.
    </para>
    <para>
     Siehe auch <function>chown</function> und
     <function>chgrp</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.chown">
   <refnamediv>
    <refname>chown</refname>
    <refpurpose>ndert den Eigentmer einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>chown</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>mixed</type><parameter>user</parameter></methodparam>
     </methodsynopsis>
    <para>
     ndert den Eigentmer der Datei <parameter>filename</parameter>
     in Benutzer <parameter>user</parameter>.  Nur der Superuser kann
     den Eigentmer einer Datei ndern.
    </para>
    <para>
     Gibt bei Erfolg &true; zurck, andernfalls &false;.
    </para>
    <para>
     Siehe auch <function>chown</function> und
     <function>chmod</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.clearstatcache">
   <refnamediv>
    <refname>clearstatcache</refname>
    <refpurpose>Lscht den Status Cache</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>clearstatcache</methodname>
      <void/>
     </methodsynopsis>
    <para>
     <function>clearstatcache</function> lscht den Zwischenspeicher
     mit den Dateistatuswerten. Die Systemaufrufe
     <systemitem>stat</systemitem> oder <systemitem>lstat</systemitem>
     sind auf den meisten Systemen sehr "teure" Aufrufe. Daher wird
     das Ergebnis des letzten Aufrufs von einer der unten aufgefhrten
     Funktionen fr die nchste Benutzung eines hnlichen Aufrufs mit
     dem gleichen Dateinamen gespeichert. Wenn Sie einen neuen
     Status-Check erzwingen wollen, z.B. wenn die Datei in der
     Zwischenzeit oftmals aufgerufen wurde, verndert oder
     verschwunden ist, knnen Sie diese Funktion dazu benutzen, das
     Ergebnis des letzten Aufrufes aus dem Speicher zu leeren.
    </para>
    <para>
     Dieser Wert wird nur fr die Zeit eines einzelnen Requests
     zwischengespeichert.
    </para>
    <para>
     Folgende Funktionen betreffen den Dateistatus:
     <function>stat</function>, <function>lstat</function>,
     <function>file_exists</function>,
     <function>is_writeable</function>,
     <function>is_readable</function>,
     <function>is_executable</function>, <function>is_file</function>,
     <function>is_dir</function>, <function>is_link</function>,
     <function>filectime</function>, <function>fileatime</function>,
     <function>filemtime</function>, <function>fileinode</function>,
     <function>filegroup</function>, <function>fileowner</function>,
     <function>filesize</function>, <function>filetype</function>, and
     <function>fileperms</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.copy">
   <refnamediv>
    <refname>copy</refname>
    <refpurpose>Kopiert eine Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>copy</methodname>
      <methodparam><type>string</type><parameter>source</parameter></methodparam>
      <methodparam><type>string</type><parameter>dest</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>copy</function> kopiert eine Datei.  Sie
     gibt &true; zurck, wenn der Kopiervorgang erfolgreich war,
     andernfalls &false;.
     <example>
      <title><function>copy</function></title>
      <programlisting role="php">
<![CDATA[
if (!copy($file, $file.'.bak')) {
    print ("failed to copy $file...<br>\n");
}
]]>
      </programlisting>
     </example>
    </para>
    <warning>
     <para>
      Sollte die Zieldatei bereits existieren, wird sie berschrieben.
     </para>
    </warning>
    <para>
     Siehe auch <function>move_uploaded_file</function>,
     <function>rename</function>, und den Abschnitt ber
     <link linkend="features.file-upload">Steuerung von
     Dateiuploads</link>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.delete">
   <refnamediv>
    <refname>delete</refname>
    <refpurpose>"Dummy Handbuch Eintrag"</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>void</type><methodname>delete</methodname>
      <methodparam><type>string</type><parameter>file</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dieses ist ein "Dummy Handbuch Eintrag" fr diejenigen, die nach
     einer Funktion wie <function>unlink</function> oder
     <function>unset</function> an der falschen Stelle suchen.
    </para>
    <para>
     Siehe auch <function>unlink</function> um Dateien zu lschen,
     <function>unset</function> um Variablen zu lschen.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.dirname">
   <refnamediv>
    <refname>dirname</refname>
    <refpurpose>
     Extrahiert den Verzeichnis-Namen aus einer vollstndigen
     Pfadangabe
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>dirname</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Bei einer vollstndigen Pfadangabe gibt diese Funktion den
     Verzeichnispfad zurck.
    </para>
    <para>
     Unter Windows wird sowohl der Slash (<literal>/</literal>) als
     auch der Backslash (<literal>\</literal>) als Trennzeichen bei
     Pfadangaben benutzt. Unter anderen Betriebssystemen hingegen nur
     der Slash (<literal>/</literal>).
    </para>
    <para>
     <example>
      <title><function>dirname</function></title>
      <programlisting role="php">
<![CDATA[
$path = "/etc/passwd";
$file = dirname ($path); // $file enthlt den Wert "/etc"
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      Seit PHP 4.0.3 entspricht <function>dirname</function> dem
      POSIX-Standard. Im Grunde heit das, dass wenn keine Slashes
      in <parameter>path</parameter> vorhanden sind, wird ein Punkt
      ('<literal>.</literal>') zurckgegeben, womit das aktuelle
      Verzeichnis gemeint ist. Andernfalls enthlt der zurckgegebene
      String <parameter>path</parameter>, jedoch ohne den hinteren
      <literal>/component</literal>. Beachten Sie, dass Sie von
      <function>dirname</function> oft einen Slash oder Punkt
      zurckbekommen, wo die alte Funktionalitt einen leeren String
      lieferte.
     </para>
    </note>
    <para>
     Siehe auch <function>basename</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.disk-free-space">
   <refnamediv>
    <refname>disk_free_space</refname>
    <refpurpose>
     Liefert den freien Speicherplatz in einem Verzeichnis
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>disk_free_space</methodname>
      <methodparam><type>string</type><parameter>directory</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion gibt den freien Speicherplatz eines Verzeichnisses
     in Byte zurck.
    </para>
    <para>
     <example>
      <title><function>disk_free_space</function></title>
      <programlisting role="php">
<![CDATA[
$df = disk_free_space("/"); // $df hlt die Anzahl an freien Bytes 
                            // im Verzeichnis  "/"
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.diskfreespace">
   <refnamediv>
    <refname>diskfreespace</refname>
    <refpurpose>Ist ein Alias fr <function>disk_free_space</function></refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>diskfreespace</methodname>
      <methodparam><type>string</type><parameter>directory</parameter></methodparam>
     </methodsynopsis>
    <para>
     Von diesem Alias wird abgeraten, benutzen Sie stattdessen
     <function>disk_free_space</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.disk-total-space">
   <refnamediv>
    <refname>disk_total_space</refname>
    <refpurpose>Liefert die Gesamtgre eines Verzeichnisses</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>float</type><methodname>disk_total_space</methodname>
      <methodparam><type>string</type><parameter>directory</parameter></methodparam>
     </methodsynopsis>
    <para>
     Anhand des bergebenen Strings mit dem Verzeichnisnamen gibt diese 
     Funktion die Anzahl Bytes auf dem korrespondierenden Dateisystem oder 
     der Disk Partition zurck.
    </para>
    <para>
     <example>
      <title><function>disk_total_space</function></title>
      <programlisting role="php">
<![CDATA[
$df = disk_total_space("/"); // $df enthlt die Gesamtanzahl 
                             // verfgbarer Bytes in "/"
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fclose">
   <refnamediv>
    <refname>fclose</refname>
    <refpurpose>Schliet einen offenen Dateizeiger</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>fclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Datei, auf die der Dateizeiger <parameter>fp</parameter>
     zeigt wird geschlossen.
    </para>
    <para>
     Gibt bei erfolgreichem Schlieen der Datei &true;, andernfalls
     &false; zurck.
    </para>
    <para>
     Der Datei-Zeiger muss gltig sein, d.h. die Datei, auf die
     gezeigt wird muss zuvor mit <function>fopen</function>
     oder <function>fsockopen</function> geffnet worden sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.feof">
   <refnamediv>
    <refname>feof</refname>
    <refpurpose>
     Prft, ob der Dateizeiger am Ende der Datei steht
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>feof</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, falls der Dateizeiger am Ende der Datei steht
     oder ein Fehler aufgetreten ist, andernfalls &false;.
    </para>
    <para>
     Der Dateizeiger muss gltig sein, d.h. die Datei, auf die gezeigt
     wird, muss zuvor mit <function>fopen</function>,
     <function>popen</function> oder <function>fsockopen</function>
     geffnet worden sein.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fflush">
   <refnamediv>
    <refname>fflush</refname>
    <refpurpose>Schreibt den Ausgabepuffer in eine Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fflush</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion erzwingt das Schreiben des gesamten Ausgabepuffers 
     in die von dem Dateizeiger <parameter>fp</parameter> angegebenen 
     Datei. Gibt bei Erfolg &true;, andernfalls &false; zurck.
    </para>
    <para>
     Der Dateizeiger muss gltig sein, und auf eine mittels 
     <function>fopen</function>, <function>popen</function>, oder 
     <function>fsockopen</function> erfolgreich geffnete Datei zeigen.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetc">
   <refnamediv>
    <refname>fgetc</refname>
    <refpurpose>
     Liest das Zeichen, auf welches der Dateizeiger zeigt
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetc</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt einen String zurck, der ein einzelnes Zeichen von der
     aktuellen Position des Dateizeigers <parameter>fp</parameter>
     enthlt.  Gibt &false; zurck, wenn der Dateizeiger am Ende der
     Datei steht (wie die Funktion <function>feof</function>).
    </para>
    <para>
     Der Dateizeiger muss gltig sein, d.h. die Datei, auf die gezeigt
     wird, muss zuvor mit <function>fopen</function>,
     <function>popen</function> oder <function>fsockopen</function>
     geffnet worden sein.
    </para>
    <para>
     Siehe auch <function>fread</function>,
     <function>fopen</function>, <function>popen</function>,
     <function>fsockopen</function> und <function>fgets</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetcsv">
   <refnamediv>
    <refname>fgetcsv</refname>
    <refpurpose>
     Liest eine Zeile von der Position des Dateizeigers und 
     prft diese auf Komma-Separierte-Werte (CSV)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>fgetcsv</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        delimiter
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Die Funktion <function>fgetcsv</function> handelt hnlich der
     Funktion <function>fgets</function>, bis auf den Umstand, das
     <function>fgetcsv</function> die eingelesene Zeile auf
     Kommaseparierte Felder hin berprft. Das Ergebnis wird als Array
     zurckgegeben.  Als Trennzeichen (Delimiter) wird - wenn kein
     anderes Trennzeichen im dritten optionalen Parameter angegeben
     wird - das Komma benutzt.
    </simpara>
    <simpara>
     Der Dateizeiger <parameter>fp</parameter> muss gltig sein,
     d.h. die Datei, auf die gezeigt wird, muss zuvor mit
     <function>fopen</function>, <function>popen</function> oder
     <function>fsockopen</function> geffnet worden sein.
    </simpara>
    <simpara>
     'length' muss grer sein als die lngste in der CSV-Datei
     vorhandene Zeile (um das Erkennen von EndOfLine(Ende der Zeile)
     Zeichen zu ermglichen).
    </simpara>
    <simpara>
     <function>fgetcsv</function> gibt &false; am Dateiende und bei
     Lesefehlern zurck.
    </simpara>
    <simpara>
     Eine leere Zeile der CSV-Datei wird als Array mit einem Feld das
     den Wert &null; hlt zurckgegeben. Sie wird nicht als Fehler
     behandelt.
    </simpara>
    <example>
     <title>
      <function>fgetcsv</function> Beispiel - Lesen und Ausgabe des
      Inhalts einer CSV-Datei
     </title>
     <programlisting role="php">
<![CDATA[
$row = 1;                                  // Anzahl der Arrays
$fp = fopen ("test.csv","r");              // Datei wird zum Lesen 
                                           // geffnet
while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei
                                           // in einen Array $data gelesen
    $num = count ($data);                  // Felder im Array $data 
                                           // werden gezhlt
    print "<p> $num fields in line $row: <br>";
    $row++;                                // Anzahl der Arrays wird 
                                           // inkrementiert
    for ($c=0; $c < $num; $c++) {          // FOR-Schleife, um Felder 
        print $data[$c] . "<br>";          // des Arrays auszugeben
    }
}
fclose ($fp);
]]>
     </programlisting>
    </example>
   </refsect1>
  </refentry>

  <refentry id="function.fgets">
   <refnamediv>
    <refname>fgets</refname>
    <refpurpose>
     Liest eine Zeile von der Position des Dateizeigers
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>fgets</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt eine Zeile bis zu <parameter>length</parameter> -1 Bytes 
     Lnge zurck, welche aus der Datei von der aktuellen Position des 
     Dateizeigers <parameter>fp</parameter> aus ausgelesen wird. Die 
     Zeile endet an einem Zeilenumbruch (welcher im Rckgabewert enthalten 
     ist), EOF (Ende der Datei) oder bei <parameter>length</parameter>
     - 1 Bytes (Je nachdem, was eher auftritt). Ist keine Lnge angegeben,
     wird diese auf 1k bzw. 1024 Bytes gesetzt.
    </para>
    <para>
     Wenn ein Fehler auftritt, wird &false; zurckgegeben.
    </para>
    <para>
     Hufig auftretende Fehler:
    </para>
    <simpara>
     Wenn Sie an die C-Semantik von <function>fgets</function> gewhnt sind,
     sollten Sie auf die unterschiedliche Behandlung von <literal>EOF</literal>
     (genauer: wie EOF zurckgegeben wird) achten.
    </simpara>
    <simpara>
     Der Datei-Zeiger <parameter>fp</parameter> muss gltig sein,
     d.h. die Datei, auf die gezeigt wird, muss zuvor mit
     <function>fopen</function>, <function>popen</function>, oder
     <function>fsockopen</function> geffnet worden sein.
    </simpara>
    <para>
     Ein einfaches Beispiel:
     <example>
      <title>Eine Datei Zeile fr Zeile einlesen</title>
      <programlisting role="php">
<![CDATA[
$fd = fopen ("/tmp/inputfile.txt", "r");
while (!feof($fd)) {
    $buffer = fgets($fd, 4096);
    echo $buffer;
}
fclose ($fd);
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
      Der Parameter <parameter>length</parameter> wurde erst ab PHP 4.2.0 optional.
     </simpara>
    </note>
    <para>
     Siehe auch <function>fread</function>, <function>fopen</function>,
     <function>popen</function>, <function>fgetc</function>,
     <function>fsockopen</function>, und 
     <function>socket_set_timeout</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fgetss">
   <refnamediv>
    <refname>fgetss</refname>
    <refpurpose>
     Liest eine Zeile von der Position des Dateizeigers und entfernt 
     HTML und PHP-Tags.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>fgetss</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>
        allowable_tags
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion ist identisch mit der Funktion
     <function>fgets</function>, auer dass
     <function>fgetss</function> versucht, vorhandene HTML und
     PHP-Tags aus dem gelesenen Text zu entfernen.
    </para>
    <para>
     Optional knnen mit dem dritten Parameter
     <parameter>allowable_tags</parameter> Tags spezifiziert werden,
     die nicht entfernt werden sollen.
     <note>
      <para>
       <parameter>allowable_tags</parameter> wurden in PHP 3.0.13 bzw.
       PHP 4.0.0 hinzugefgt.
      </para>
     </note>
    </para>
    <para>
     Siehe auch <function>fgets</function>,
     <function>fopen</function>, <function>fsockopen</function>,
     <function>popen</function> und <function>strip_tags</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.file">
   <refnamediv>
    <refname>file</refname>
    <refpurpose>
     Liest eine Datei komplett in einen Array
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>file</function> ist identisch mit
     <function>readfile</function>, auer dass die eingelesene Datei
     als Array zurckgegeben wird. Jedes Feld des Arrays korrespondiert
     mit einer Zeile der Datei. Der Zeilenumbruch bleibt erhalten.
    </para>
    <note>
     <para>
      Jede Zeile in dem resultierenden Array enthlt das Zeilenende ('\0'),
      weshalb Sie <function>trim</function> verwenden mssen, falls Sie
      dieses Zeichen nicht vorhanden sein soll.
     </para>
    </note>
    <para>
     Optional kann der zweite Parameter benutzt und auf '1' gesetzt
     werden, wenn in dem <link
     linkend="ini.include-path">include_path</link> ebenfalls nach der
     Datei gesucht werden soll.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
<?php
// liest eine Webseite in einen Array und gibt das Ergebnis aus
$fcontents = file ('http://www.php.net/');
while (list ($line_num, $line) = each ($fcontents)) {
    echo "<b>Line $line_num:</b>; ", htmlspecialchars ($line), "<br>\n";
}

// liefert eine Webseite in einen String
$fcontents = implode ('', file ('http://www.php.net/'));
?>
]]>
      </programlisting>
     </informalexample>
    </para>
    &note.not-bin-safe;
    &tip.fopen-wrapper;
    <para>
     Siehe auch <function>readfile</function>,
     <function>fopen</function>, <function>fsockopen</function>, und 
     <function>popen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.file-exists">
   <refnamediv>
    <refname>file_exists</refname>
    <refpurpose>berprft, ob eine Datei existiert</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>file_exists</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Gibt &true; zurck, wenn die mit <parameter>filename</parameter>
     spezifizierte Datei existiert, andernfalls &false;.
    </simpara>
    <simpara>
     <function>file_exists</function> funktioniert nur mit lokalen
     Dateien.  Die Datei, deren Existenz berprft werden soll muss
     ber das Dateisystem des Servers erreichbar sein.
    </simpara>
    <simpara>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fileatime">
   <refnamediv>
    <refname>fileatime</refname>
    <refpurpose>
     Liefert Datum und Uhrzeit des letzten Zugriffs auf eine Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fileatime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Gibt Datum und Uhrzeit des letzten Zugriffs auf eine Datei
     zurck, oder &false; wenn ein Fehler auftrat. Das Datum wird als
     UNIX-Timestamp zurckgegeben.
    </simpara>
    <simpara>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </simpara>
    <simpara>
     Anmerkung: Die atime einer Datei vorgesehen sich immer zu ndern,
     sobald Datenblcke einer Datei gendert werden. Das kann sich 
     folgenschwer auf die Performance auswirken, wenn eine Anwendung 
     regelmig auf eine groe Anzahl Dateien oder Verzeichnisse zugreift.
     Manche Unix Dateisysteme knnen mit deaktivierter atime-Aktualisierung 
     gemountet werden, um die Performance solcher Applikationen zu erhhen;
     USENET news spools sind ein hufiges Beispiel. Auf solchen 
     Dateisystemen wird diese Funktion nutzlos.
    </simpara>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filectime">
   <refnamediv>
    <refname>filectime</refname>
    <refpurpose>
     Liefert Datum und Uhrzeit der letzten nderung des Dateizeigers
     Inode
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>filectime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt Zeit der letzten nderung des Dateizeigers Inode zurck,
     oder &false; wenn ein Fehler auftrat. Die Zeit wird als
     UNIX-Timestamp zurckgegeben.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <para>
     Anmerkung: Bei den meisten Unix Dateisystemen gilt eine Datei als
     gendert, sobald ihre Inode-Daten gendert wurden; d.h. wenn die
     Rechte, Eigentmer, Gruppe, oder andere Metadaten des Inodes 
     aktualisiert werden. Siehe auch <function>filemtime</function> (das 
     ist was Sie suchen, wenn Sie Fuzeilen mit "Zuletzt Aktualisiert"
     fr Webseiten erstellen mchten) und <function>fileatime</function>.
    </para>
    <para>Beachten Sie auch, dass in einigen Unix-Texten ctime als die Zeit 
     der Erstellung der Datei beschrieben wird. Das ist falsch. Bei den 
     meisten Unix Dateisystemen gibt es keine Zeitangabe fr die Erstellung
     von Unix Dateien.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filegroup">
   <refnamediv>
    <refname>filegroup</refname>
    <refpurpose>
     Liefert die Gruppenzugehrigkeit einer Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>filegroup</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Gruppen ID des Besitzers einer Datei zurck, oder &false;
     wenn ein Fehler auftrat. Die Gruppen ID wird im numerischen
     Format zurckgegeben. Mit der Funktion
     <function>posix_getgrgid</function> knnen Sie diese zu ihrem
     Gruppennamen auflsen.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    &note.no-windows;
    <note>
     <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
     </simpara>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.fileinode">
   <refnamediv>
    <refname>fileinode</refname>
    <refpurpose>Liefert die Inode-Nummer einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fileinode</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Inode-Nummer einer Datei zurck, oder &false; wenn ein
     Fehler auftrat.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.filemtime">
   <refnamediv>
    <refname>filemtime</refname>
    <refpurpose>
     Liefert Datum und Uhrzeit der letzten Dateinderung
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>filemtime</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt Datum und Uhrzeit zurck, wann die Datei das letzte mal
     modifiziert wurde, oder &false; wenn ein Fehler auftrat. Das Datum
     wird als UNIX-Timestamp zurckgegeben.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    <para>Anmerkung: Diese Funktion gibt den Zeitpunkt zurck, an dem in 
     die Datenblcke einer Datei geschrieben wurde; d.h. den Zeitpunkt der 
     nderung des Inhalts der Datei. Verwenden Sie <function>date</function>,
     um das Ergebnis dieser Funktion in ein ausgabefhiges nderungsdatum 
     fr z.B. Fuzeilen in Webseiten zu erhalten.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fileowner">
   <refnamediv>
    <refname>fileowner</refname>
    <refpurpose>Liefert den Dateieigentmer</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fileowner</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Benutzer ID des Eigentmers einer Datei zurck, oder
     &false; wenn ein Fehler auftrat. Die Benutzer ID wird in
     numerischem Format zurckgegeben und kann mit der Funktion
     <function>posix_getpwuid</function> zum Benutzernamen aufgelst
     werden.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.fileperms">
   <refnamediv>
    <refname>fileperms</refname>
    <refpurpose>Liefert die Zugriffsrechte einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fileperms</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Zugriffsrechte einer Datei zurck, oder &false; wenn ein
     Fehler auftrat.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.filesize">
   <refnamediv>
    <refname>filesize</refname>
    <refpurpose>Liefert die Gre einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>filesize</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die Gre einer Datei in Bytes zurck, oder &false; wenn ein Fehler
     auftrat.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.filetype">
   <refnamediv>
    <refname>filetype</refname>
    <refpurpose>Liefert den Typ einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>filetype</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt den Typ einer Datei zurck. Mgliche Werte sind fifo, char,
     dir, block, link, file und unknown.
    </para>
    <para>
     Gibt &false; zurck, wenn ein Fehler auftrat.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.flock">
   <refnamediv>
    <refname>flock</refname>
    <refpurpose>Portables Datei-Verriegelungs-Verfahren</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>flock</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>operation</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        wouldblock
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     PHP liefert einen portablen Weg, Dateien in einer "beratenden"
     Art und Weise zu verriegeln. D.h. alle zugreifende Programme
     mssen die gleiche Art und Weise der Verriegelung benutzen, oder
     es funktioniert nicht.
    </simpara>
    <simpara>
     <function>flock</function> arbeitet mit <parameter>fp</parameter>
     welcher ein existierender Dateizeiger sein muss. Der Parameter
     <parameter>operation</parameter> bestimmt die Art der
     Verriegelung und kann einen der folgenden Werte annehmen:
    </simpara>
    <para>
     <itemizedlist>
      <listitem>
       <simpara>
        Um eine verteilte, nur lesende Verriegelung zu erhalten,
        setzten Sie <parameter>operation</parameter> auf LOCK_SH (bzw.
        1 vor PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Um eine exklusive, nur schreibende Verriegelung zu erhalten,
        setzen Sie <parameter>operation</parameter> auf LOCK_EX (bzw.
        2 vor PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Um eine Verriegelung freizugeben (lesend oder schreibend),
        setzten Sie <parameter>operation</parameter> auf LOCK_UN (bzw.
        3 vor PHP 4.0.1).
       </simpara>
      </listitem>
      <listitem>
       <simpara>
        Wenn Sie Zugriffe whrend der Verriegelung durch
        <function>flock</function> erlauben wollen, fgen Sie LOCK_NB 
        (bzw. 4 vor PHP 4.0.1) zu <parameter>operation</parameter> hinzu.
       </simpara>
      </listitem>
     </itemizedlist>
    </para>
    <simpara>
     <function>flock</function> erlaubt es Ihnen ein einfaches
     Leser/Schreiber Modell zu erstellen, welches auf fast jeder Plattform
     benutzt werden kann (inkl. den meisten UNIX-Derivaten und auch Windows).
     Das optionale dritte Argument ist auf &true; gesetzt, wenn die 
     Verriegelung sperren sollte (EWOULDBLOCK errno Bedingung).
    </simpara>
    <simpara>
     <function>flock</function> gibt &true; bei Erfolg, &false; wenn ein
     Fehler auftrat (z.B. wenn eine Verriegelung nicht erstellt werden
     konnte) zurck.
    </simpara>
    <note>
     <para>
      Da <function>flock</function> einen Dateizeiger bentigt, knnten Sie
      eine spezielle Sperrdatei benutzen, um den Zugriff auf eine Datei zu
      schtzen, welche Sie mittels ffnen im Schreibmodus (mit dem Argument
      "w" or "w+" von <function>fopen</function>) krzen wollen.
     </para>
    </note>
    <warning>
     <para>
      <function>flock</function> funktioniert nicht auf NFS und verschiedenen
      anderen vernetzten Dateisystemen. Fr weitere Detail konsultieren Sie
      bitte Ihre Betriebssystemdokumentation.
     </para>
     <para>
      Bei einigen Betriebssystemen ist <function>flock</function> auf dem
      Prozesslevel implementiert. Wenn Sie ein multithreaded Server API wie
      ISAPI benutzen knnen Sie sich nicht auf <function>flock</function>
      verlassen, um Dateien vor anderen PHP-Skripten zu schtzen, welche in
      parallelen Threads der gleichen Server-Instanz laufen!
     </para>
    </warning>
   </refsect1>
  </refentry>

  <refentry id="function.fopen">
   <refnamediv>
    <refname>fopen</refname>
    <refpurpose>ffnet eine Datei oder URL</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fopen</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>string</type><parameter>mode</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        use_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Wenn <parameter>filename</parameter> mit "http://" (nicht case
     sensitive) beginnt, wird zu dem spezifiziertem Server eine HTTP
     1.0 Connection geffnet, die Seite mittels der HTTP GET Methode
     angefordert, und ein Dateizeiger auf den Anfang des Textes der 
     Antwort zurckgegeben. Ein 'Host:' header wird mit der Anfrage 
	 geschickt, um namens-basierte Virtual Hosts zu verarbeiten.
    </simpara>
    <simpara>
     Beachten Sie, dass Ihnen der Dateizeiger nur den Empfang des 
     <emphasis>body</emphasis> aus der Antwort erlaubt; mit dieser 
     Funktion knnen Sie auf den HTTP response header nicht zugreifen.
     Weiters sind HTTP Verbindungen nur zum Lesen.
    </simpara>
    <simpara>
     In lteren Versionen als PHP 4.0.5 werden Weiterleitungen (HTTP 
     Redirects) nicht untersttzt, hier muss die Datei daher vollstndig 
     und mit abschlieendem "/" beschrieben werden.
    </simpara>
    <simpara>
     Wenn <parameter>filename</parameter> mit "ftp://" (nicht case
     sensitive) beginnt, wird eine ftp-Connection zu dem
     spezifizierten Server geffnet und ein Zeiger auf die
     angeforderte Datei zurckgegeben.  Wenn der Server keinen
     passiven FTP-Modus untersttzt, wird diese Methode
     fehlschlagen. Sie knnen Dateien entweder zum Schreiben oder zum
     Lesen ffnen, jedoch nicht fr beides gleichzeitig.
    </simpara>
    <simpara>
     Wenn <parameter>filename</parameter> "php://stdin",
     "php://stdout", oder "php://stderr" ist, wird der
     korrespondierende stdio stream geffnet (Feature wurde in Version
     3.0.13 eingefhrt, in frheren Versionen muss der Dateiname wie
     z.B. "/dev/stdin" oder "/dev/fd/0" benutzt werden, um auf die
     stdio streams zuzugreifen).
    </simpara>
    <simpara>
     Wenn <parameter>filename</parameter> mit irgendetwas anderem
     beginnt, wird die Datei vom lokalen Dateisystem geffnet und ein
     Dateizeiger auf die geffnete Datei zurckgegeben.
    </simpara>
    <simpara>
     Wenn das ffnen scheitert, gibt die Funktion &false; zurck.
    </simpara>
    <para>
     <parameter>mode</parameter> kann einen der folgenden Werte
     einnehmen:
     <itemizedlist>
      <listitem>
       <simpara>
	'r' - ffnet die Datei nur zum Lesen und positioniert den
	Dateizeiger auf den Anfang der Datei.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
       	'r+' - ffnet die Datei zum Lesen und Schreiben und setzt den
       	Dateizeiger auf den Anfang der Datei.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	'w' - ffnet die Datei nur zum Schreiben und setzt den
	Dateizeiger auf den Anfang der Datei sowie die Lnge der Datei
	auf 0 Byte. Wenn die Datei nicht existiert wird versucht sie
	anzulegen.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	'w+' - ffnet die Datei zum Lesen und Schreiben und setzt den
	Dateizeiger auf den Anfang der Datei sowie die Lnge der Datei
	auf 0 Byte. Wenn die Datei nicht existiert, wird versucht sie
	anzulegen.
      </simpara>
      </listitem>
      <listitem>
       <simpara>
	'a' - ffnet die Datei nur zum Schreiben. Positioniert den
	Dateizeiger auf das Ende der Datei. Wenn die Datei nicht
	existiert, wird versucht sie anzulegen.
       </simpara>
      </listitem>
      <listitem>
       <simpara>
	'a+' - ffnet die Datei zum Lesen und Schreiben. Positioniert
	den Dateizeiger auf das Ende der Datei. Wenn die Datei nicht
	existiert, wird versucht sie anzulegen.
       </simpara>
      </listitem>
     </itemizedlist>
     Zustzlich kann <parameter>mode</parameter> der Buchstabe 'b'
     hinzugefgt werden, der die Behandlung von Binr-Dateien
     erlaubt. Dies ist nur auf Systemen sinnvoll, welche zwischen Binr-
     und Text-Dateien unterscheiden (z.B. Windows. Ist bei Unix sinnlos).
     Wenn das Feature nicht gebraucht wird, wird es einfach ignoriert.
    </para>
    <para>
     Sie knnen optional ein dritten Parameter benutzen und diesen auf
     '1' setzten, wenn Sie auch im <link
     linkend="ini.include-path">include_path</link> nach der Datei
     suchen mchten.
    </para>
    <para>
     <example>
      <title>fopen()</title>
      <programlisting role="php">
<![CDATA[
$fp = fopen ("/home/simi/simi.txt", "r");
$fp = fopen ("/home/simi/simi.gif", "wb");
$fp = fopen ("http://www.php.net/", "r");
$fp = fopen ("ftp://user:password@example.com/", "w");
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Wenn Sie Probleme mit dem Lesen oder Schreiben von Dateien haben 
     und PHP als Servermodul benutzen, stellen Sie zunchst
     sicher, dass die Dateien und Verzeichnisse die Sie benutzen
     wollen auch fr den Server-Prozess zugnglich sind
     (Rechtevergabe).
    </simpara>
    <para>
     Achten Sie auf Windows-Systemen darauf, dass Sie als
     Verzeichnistrenner normale Schrgstriche '/' benutzen um
     plattformunabhngig programmieren zu knnen. Sollten Sie dennoch
     Backslashes verwenden, vergessen Sie nicht diese zu escapen '\\'
     <informalexample>
      <programlisting role="php">
<![CDATA[
$fp = fopen ("c:\\data\\info.txt", "r");
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Siehe auch <function>fclose</function>,
     <function>fsockopen</function>,
     <function>socket_set_timeout</function>, und 
     <function>popen</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fpassthru">
   <refnamediv>
    <refname>fpassthru</refname>
    <refpurpose>
     Gibt alle verbleibenden Daten eines Dateizeigers direkt aus.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fpassthru</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Die Funktion liest alle Daten von der aktuellen Position des Dateizeigers
     bis EOF aus und gibt die Daten auf der Standartausgabe (Browser) aus.
    </simpara>
    <simpara>
     Wenn ein Fehler auftritt, gibt <function>fpassthru</function>
     &false; zurck.
    </simpara>
    <simpara>
     Der Dateizeiger muss gltig sein und auf eine erfolgreich durch
     <function>fopen</function>, <function>popen</function> oder
     <function>fsockopen</function> geffnete Datei zeigen. Vielleicht
     mssen Sie <function>rewind</function> aufrufen um den Dateizeiger
     auf den Beginn der Datei zurckzusetzen, wenn Sie bereits Daten in
     die Datei geschrieben haben. Die Datei wird geschlossen, wenn 
     <function>fpassthru</function> die Datei komplett gelesen hat
     (hinterlsst nutzlosen <parameter>fp</parameter>-Dateizeiger).
    </simpara>
    <simpara>
     Wenn Sie den Inhalt einer Datei nur auf der Standartausgabe
     (Browser) ausgeben wollen, sollten Sie besser
     <function>readfile</function> benutzen, bei der Sie nicht zuvor
     die Datei mittels <function>fopen</function> geffnet haben
     mssen.
    </simpara>
    <note>
     <para>
      Wenn Sie <function>fpassthru</function> an einer Binrdatei unter
      Windows benutzen sollten Sie sich vergewissern, dass Sie die Datei
      im Binrmodus ffnen, indem Sie ein <literal>b</literal> an den
      Mode-Parameter von <function>fopen</function> anhngen.
     </para>
    </note>
    <simpara>
     Siehe auch <function>readfile</function>,
     <function>fopen</function>, <function>popen</function> und
     <function>fsockopen</function>
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fputs">
   <refnamediv>
    <refname>fputs</refname>
    <refpurpose>
     Schreibt Daten an die Position des Dateizeigers
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fputs</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>string</type><parameter>str</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        length
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>fputs</function> ist ein Alias fr die Funktion
     <function>fwrite</function>, und ist in jeder Hinsicht identisch
     mit ihr. Beachten Sie, dass der Parameter
     <parameter>length</parameter> optional ist, und dass, wenn er
     nicht benutzt wird, die gesamte Zeichenkette geschrieben wird.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fread">
   <refnamediv>
    <refname>fread</refname>
    <refpurpose>Liest Binrdaten aus einer Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>fread</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>length</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fread</function> liest <parameter>length</parameter>
     Bytes vom Dateizeiger, maximal jedoch bis zum Dateiende.
     </simpara>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
// liest den Inhalt einer Datei in einen String
$filename = "/usr/local/simi.txt";
$fd = fopen ($filename, "r");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
]]>
      </programlisting>
     </informalexample>
    </para>
    <note>
     <para>
      Auf Systemen, welche zwischen Binr- und Textdateien (z.B. Windows)
      unterscheiden, muss die Datei mit 'b' im <function>fopen</function>
      Mode-Parameter geffnet werden.
     </para>
    </note>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
$filename = "c:\\files\\somepic.gif";
$fd = fopen ($filename, "rb");
$contents = fread ($fd, filesize ($filename));
fclose ($fd);
]]>
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Siehe auch <function>fwrite</function>, <function>fopen</function>,
     <function>fsockopen</function>, <function>popen</function>,
     <function>fgets</function>, <function>fgetss</function>,
     <function>fscanf</function>, <function>file</function> und
     <function>fpassthru</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.fscanf">
   <refnamediv>
    <refname>fscanf</refname>
    <refpurpose>Interpretiert den Input einer Datei entsprechend einem 
    angegebenen Format </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>mixed</type><methodname>fscanf</methodname>
      <methodparam><type>int</type><parameter>handle</parameter></methodparam>
      <methodparam><type>string</type><parameter>format</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>var1</parameter></methodparam>
     </methodsynopsis>
    <para>
     Die Funktion <function>fscanf</function> ist 
     <function>sscanf</function> hnlich, wobei sie ihren Input aus 
     der mit <parameter>handle</parameter> angegebenen Datei nimmt, und
     entsprechend dem angegebenen <parameter>format</parameter>
     interpretiert. Sind nur 2 Parameter angegeben, werden die analysierten 
     Werte als Array zurckgegeben. Werden auch optionale Parameter 
     bergeben, gibt die Funktion die Anzahl der ermittelten Werte zurck.
     Die optionalen Parameter mssen referenziert bergeben werden.
     <example>
      <title><function>fscanf</function></title>
      <programlisting role="php">
<![CDATA[
$fp = fopen ("users.txt","r");
while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
    list ($name, $profession, $countrycode) = $userinfo;
    //... Tue etwas mit den Werten
}
fclose($fp);
]]>
      </programlisting>
     </example>
     <example>
      <title>users.txt</title>
      <programlisting>
<![CDATA[
javier  argonaut        pe
hiroshi sculptor        jp
robert  slacker us
luigi   florist it
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Siehe auch <function>fread</function>, <function>fgets</function>,
     <function>fgetss</function>, <function>sscanf</function>,
     <function>printf</function>, und <function>sprintf</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fseek">
   <refnamediv>
    <refname>fseek</refname>
    <refpurpose>
     Positioniert den Dateizeiger
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fseek</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>offset</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>whence</parameter></methodparam>
     </methodsynopsis>
	<para>
     Setzt den Dateizeiger einer mit <parameter>fp</parameter> angegebenen
	 Datei auf eine neue Position. Diese neue Position, angegeben in Bytes
	 vom Begin der Datei an, wird definiert durch Hinzufgen von
     <parameter>offset</parameter> zu der Position spezifiziert durch
     <parameter>whence</parameter>, deren Werte wie folgt definiert sind:
    <simplelist>
      <member>SEEK_SET - Setzt Position gleich
      <parameter>offset</parameter> bytes.</member>
	  <member>SEEK_CUR - Setzt Position auf die aktuelle Stelle plus
      <parameter>offset</parameter>.</member>
	  <member>SEEK_END - Setzt die Position ans Ende der Datei plus
      <parameter>offset</parameter>. (Um zu einer Position vor EOF zu
      gelangen, bergeben Sie in <parameter>offset</parameter> einen
      negativen Wert.)</member>
     </simplelist>
    </para>
	<para>Wenn <parameter>whence</parameter> nicht angegeben wurde, wird
    SEEK_SET angenommen.
    </para>
	<para>
     Bei Erfolg wird '0' zurckgegeben, andernfalls '-1'. Beachten
     Sie, dass die berschreitung des Dateiendes (EOF) nicht als
     Fehler bewertet wird.
    </para>
    <para>
     Diese Funktion sollte nicht auf Dateizeiger angewandt werden, die
     durch die Verwendung von "http://" oder "ftp://" bei der Funktion
     <function>fopen</function> erhalten wurden.
    </para>
    <note>
     <para>
      Das <parameter>whence</parameter>-Argument wurde nach PHP 4.0.0 
      eingefhrt.
     </para>
    </note>
    <para>
     Siehe auch <function>ftell</function> und
     <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fstat">
   <refnamediv>
    <refname>fstat</refname>
    <refpurpose>
     Liefert Informationen ber eine Datei mit offenem Dateizeiger
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>fstat</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Trgt die Statistiken der mittel des Dateizeigers fp geffneten 
     Datei zusammen. Diese Funktion ist hnlich der Funktion 
     <function>stat</function>, auer dass sie mit einem offenen
     Dateizeiger anstatt eines Dateinamens arbeitet.
    </para>
    <para>
     Gibt die Statistiken einer Datei in Form eines Arrays mit den 
     folgenden Elementen zurck:
     <orderedlist>
      <listitem><simpara>Gert</simpara></listitem>
      <listitem><simpara>Inode</simpara></listitem>
      <listitem><simpara>Anzahl Links</simpara></listitem>
      <listitem><simpara>User id des Eigentmers</simpara></listitem>
      <listitem><simpara>Gruppen id Eigentmer</simpara></listitem>
      <listitem><simpara>Gertetype wenn ein Inode-Gert *</simpara></listitem>
      <listitem><simpara>Gre in Bytes</simpara></listitem>
      <listitem><simpara>Zeit des letzten Zugriffs</simpara></listitem>
      <listitem><simpara>Zeit der letzten Modifikation</simpara></listitem>
      <listitem><simpara>Zeit der letzten nderung</simpara></listitem>
      <listitem><simpara>Blockgre fr Dateisystem I/O *</simpara></listitem>
      <listitem><simpara>Anzahl der Blcke</simpara></listitem>
     </orderedlist>
     * - nur gltig bei Systemen, welche den st_blksize Typ untersttzen, andere 
     Systeme (z.B. Windows) geben -1 zurck</para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. Siehe
     <function>clearstatcache</function> fr weitere Einzelheiten.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftell">
   <refnamediv>
    <refname>ftell</refname>
    <refpurpose>
     Ermittelt die aktuelle Position des Dateizeigers
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ftell</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt die aktuelle Position des Dateizeigers
     <parameter>fp</parameter> zurck, z.B. seinen Offset im
     Dateistream.
    </para>
    <para>
     Wenn ein Fehler auftritt, wird &false; zurckgegeben.
    </para>
    <para>
     Der Dateizeiger muss gltig sein und auf eine erfolgreich durch
     <function>fopen</function> oder <function>popen</function>
     geffnete Datei zeigen.
    </para>
    <para>
     Siehe auch <function>fopen</function>,
     <function>popen</function>, <function>fseek</function> und
     <function>rewind</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftruncate">
   <refnamediv>
    <refname>ftruncate</refname>
    <refpurpose>
     Krzt eine Datei auf die angegebene Lnge
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>ftruncate</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>size</parameter></methodparam>
     </methodsynopsis>
    <para>
     Nimmt den Dateizeiger <parameter>fp</parameter>, und verkrzt die 
     Datei auf die Lnge <parameter>size</parameter>.
     Diese Funktion gibt bei Erfolg &true;, ansonsten &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.fwrite">
   <refnamediv>
    <refname>fwrite</refname>
    <refpurpose>Schreibt Binrdaten in eine Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>fwrite</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>string</type><parameter>string</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        length
       </parameter></methodparam>
     </methodsynopsis>
    <simpara>
     <function>fwrite</function> schreibt den Inhalt einer
     Zeichenkette <parameter>string</parameter> in die Datei, auf
     welche der <parameter>fp</parameter> Dateizeiger zeigt. Wenn der
     <parameter>length</parameter> Parameter gegeben ist, wird das
     Schreiben nach <parameter>length</parameter> Bytes beendet, oder
     wenn das Dateiende (EOF) erreicht ist, je nachdem, was eher
     eintritt.
    </simpara>
    <simpara>
     <function>fwrite</function> gibt bei Erfolg die Anzahl der
     geschriebenen Bytes zurck, andernfalls -1.
    </simpara>
    <simpara>
     Bedenken Sie, dass wenn der <parameter>length</parameter>
     Parameter gesetzt ist, die <link
     linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>
     Konfigurations-Option ignoriert wird und somit keine Slashes mehr
     von der Zeichenkette <parameter>string</parameter> entfernt
     werden.
    </simpara>
    <note>
     <para>
      Auf Systemen, welche zwischen Binr- und Textdateien (z.B. Windows)
      unterscheiden, muss die Datei mit 'b' im <function>fopen</function>
      Mode-Parameter geffnet werden.
     </para>
    </note>
    <simpara>
     Siehe auch <function>fread</function>,
     <function>fopen</function>, <function>fsockopen</function>,
     <function>popen</function> und <function>fputs</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.set-file-buffer">
   <refnamediv>
    <refname>set_file_buffer</refname>
    <refpurpose>
     Setzt die Dateipufferung fr einen gegebenen Dateizeiger
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>set_file_buffer</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>buffer</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Eine Ausgabe mittels <function>fwrite</function> wird normalerweise 
     mit 8k gepuffert. Das heit, dass wenn zwei Prozesse in den gleichen
     Output Stream (eine Datei) schreiben wollen, jeder nach 8k Daten
     unterbrochen wird, um den anderen schreiben zu lassen.
     <function>set_file_buffer</function> setzt die Pufferung fr
     Schreiboperationen des gegebenen Dateizeigers
     <parameter>fp</parameter> auf <parameter>buffer</parameter>
     Bytes. Wenn <parameter>buffer</parameter> 0 ist, erfolgen die 
     Schreiboperationen ungepuffert. Dies stellt sicher, dass alle 
     Schreiboperationen mit <function>fwrite</function> abgeschlossen 
     werden, bevor andere Prozesse in diesen Output Stream schreiben knnen.
    </simpara>
    <simpara>
     Die Funktion gibt bei Erfolg 0, oder EOF wenn die Anfrage nicht
     erfolgreich war, zurck.
    </simpara>
    <para>
     Das folgende Beispiel zeigt, wie man mittels
     <function>set_file_buffer</function> einen ungepufferten Stream
     generiert.
     <example>
      <title><function>set_file_buffer</function></title>
      <programlisting role="php">
<![CDATA[
$fp=fopen($file, "w");
if($fp){
  set_file_buffer($fp, 0);
  fputs($fp, $output);
  fclose($fp);
}
]]>
      </programlisting>
     </example>
    </para>
    <simpara>
     Siehe auch <function>fopen</function>, <function>fwrite</function>.
    </simpara>
   </refsect1>
  </refentry>

  <refentry id="function.is-dir">
   <refnamediv>
    <refname>is_dir</refname>
    <refpurpose>
     Prft, ob der gegebene Dateiname ein Verzeichnis ist
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_dir</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, wenn der Dateiname existiert und es sich
     hierbei um ein Verzeichnis handelt.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <para>
     Siehe auch <function>is_file</function> und
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-executable">
   <refnamediv>
    <refname>is_executable</refname>
    <refpurpose>
     Prft, ob eine Datei ausfhrbar ist
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_executable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, wenn die Datei existiert und ausfhrbar ist.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    <para>
     Siehe auch <function>is_file</function> und
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-file">
   <refnamediv>
    <refname>is_file</refname>
    <refpurpose>
     Prft, ob der Dateiname eine regulre Datei ist 
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, wenn die Datei existiert und eine regulre
     Datei ist.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <para>
     Siehe auch <function>is_dir</function> und
     <function>is_link</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-link">
   <refnamediv>
    <refname>is_link</refname>
    <refpurpose>
     Prft, ob der Dateiname ein symbolischer Link ist
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_link</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, wenn der Dateiname existiert und es sich um
     einen symbolischen Link handelt.
    </para>
     <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <para>
     Siehe auch <function>is_dir</function>,
     <function>is_file</function> und <function>readlink</function>.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.is-readable">
   <refnamediv>
    <refname>is_readable</refname>
    <refpurpose>
     Prft, ob eine Datei lesbar ist
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_readable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck wenn die Datei existiert und sie lesbar ist.
    </para>
    <para>
     Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
     zugreift, unter welcher der Webserver luft (oftmals ist dieses
     'nobody').  Beschrnkungen durch safe_mode werden nicht
     bercksichtigt.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    <para>
     Siehe auch <function>is_writable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writable">
   <refnamediv>
    <refname>is_writable</refname>
    <refpurpose>
     Prft, ob in eine Datei geschrieben werden kann
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, wenn die Datei existiert und nicht
     schreibgeschtzt ist. Das Dateinamen-Argument 
     <parameter>filename</parameter> kann ein Verzeichnisname
     sein. So knnen Sie berprfen, ob in ein Verzeichnis
     geschrieben werden kann.
    </para>
    <para>
     Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
     zugreift, unter welcher der Webserver luft (oftmals ist dieses
     'nobody').  Beschrnkungen durch safe_mode werden nicht
     bercksichtigt.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
    <simpara>
     Diese Funktion ist nicht fr <link 
     linkend="features.remote-files">remote Dateien</link> geeignet, die zu 
     prfende Datei muss ber das Dateisystem des Servers verfgbar sein.
    </simpara>
    <para>
     Siehe auch <function>is_readable</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-writeable">
   <refnamediv>
    <refname>is_writeable</refname>
    <refpurpose>Prft, ob in eine Datei geschrieben werden kann</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_writeable</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Dies ist ein Alias fr <function>is_writable</function>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.is-uploaded-file">
   <refnamediv>
    <refname>is_uploaded_file</refname>
    <refpurpose>Prft, ob die Datei mittels HTTP POST upgeloaded wurde.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>is_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Gibt &true; zurck, wenn die Datei <varname>filename</varname> mittels
     HTTP POST upgeloaded wurde. Das ist hilfreich sicherzustellen, dass 
     kein bswilliger User versucht hat das Script zu berlisten, indem 
     er es Dateien bearbeiten lsst, die es gar nicht bearbeiten sollte.
     Zum Beispiel <filename>/etc/passwd</filename>.
    </para>
    <para>
     Diese Prfung ist speziell dort interessant, wo irgendeine Aktion mit 
     upgeloadeten Dateien deren Inhalt dem User zugnglich machen knnte 
     (oder auch anderen Usern auf dem selben System).
    </para>
    <para>
     <function>is_uploaded_file</function> ist in PHP 3 nur nach Version
     3.0.16, und in PHP 4 nur nach Version 4.0.2 verfgbar. Sollten Sie
     eine frhere Version benutzen, knnen Sie sich mit der folgenden
     Funktion weiterhelfen:
     <note>
      <para>
       Dies funktioniert <emphasis>nicht</emphasis> in Versionen nach
       PHP 4.0.2. Das liegt an der internen Funktionalitt von PHP,
       welche sich nach dieser Version gendert hat.
      </para>
     </note>
     <programlisting role="php">
<![CDATA[
<?php
/* Userland Test fr hochgeladene Datei. */
function is_uploaded_file($filename) {
    if (!$tmp_file = get_cfg_var('upload_tmp_dir')) {
        $tmp_file = dirname(tempnam('', ''));
    }
    $tmp_file .= '/' . basename($filename);
    /* Der Benutzer knnte einen fhrenden Slash in php.ini haben... */
    return (ereg_replace('/+', '/', $tmp_file) == $filename);
}

/* So verwenden Sie sie, nachdem Sie in diesen lteren
 * Versionen auch keine move_uploaded_file() haben: */
if (is_uploaded_file($HTTP_POST_FILES['userfile'])) {
    copy($HTTP_POST_FILES['userfile'], "/place/to/put/uploaded/file");
} else {
    echo "Mgliche Dateiupload-Attacke: Dateiname '$HTTP_POST_FILES[userfile]'.";
}
?>
]]>
     </programlisting>
    </para>
    <para>
     Siehe auch <function>move_uploaded_file</function>, und das Kapitel
     <link linkend="features.file-upload">Steuerung von Dateiuploads</link>
     fr ein einfaches Anwendungsbeispiel.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.link">
   <refnamediv>
    <refname>link</refname>
    <refpurpose>Erzeugt einen absoluten Link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>link</methodname>
      <methodparam><type>string</type><parameter>target</parameter></methodparam>
      <methodparam><type>string</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>link</function> erzeugt einen absoluten Link mit dem
     Ziel <parameter>target</parameter>.
    </para>
    <para>
     Siehe auch <function>symlink</function> um symbolische Links zu
     erstellen und <function>readlink</function> zusammen mit
     <function>linkinfo</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.linkinfo">
   <refnamediv>
    <refname>linkinfo</refname>
    <refpurpose>Liefert Informationen ber einen Link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>linkinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>linkinfo</function> gibt das st_dev Feld des UNIX C
     stat structure resultierend aus dem lstat System Call
     zurck. Diese Funktion wird benutzt, um zu verifizieren ob ein
     Link (auf den mit <parameter>path</parameter> gezeigt wird)
     wirklich existiert (Hierbei wird die gleiche Methode benutzt,
     die in dem S_ISLNK Makro in stat.h definiert ist).  Gibt 0 oder
     &false; zurck wenn ein Fehler auftrat.
    </para>
    <para>
     Siehe auch <function>symlink</function>,
     <function>link</function>, und <function>readlink</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.mkdir">
   <refnamediv>
    <refname>mkdir</refname>
    <refpurpose>Erstellt ein Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>mkdir</methodname>
      <methodparam><type>string</type><parameter>pathname</parameter></methodparam>
      <methodparam><type>int</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     Versucht ein Verzeichnis mit dem spezifiziertem Namen zu
     erstellen.
    </para>
    <para>
     Bedenken Sie, dass sie wahrscheinlich den Mode als oktalen
     Wert spezifizieren wollen, was bedeutet, dass er eine
     voranstehende Null haben sollte. Der Mode wird ebenfalls mit
     der aktuellen umask modifiziert, welchen Sie mittels 
     <function>umask</function> ndern knnen.
     <informalexample>
      <programlisting role="php">
<![CDATA[
mkdir ("/path/to/my/dir", 0700);
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     Gibt &true; bei Erfolg, andernfalls &false; zurck.
    </para>
    <para>
     Siehe auch <function>rmdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.move-uploaded-file">
   <refnamediv>
    <refname>move_uploaded_file</refname>
    <refpurpose>Verschiebt eine upgeloadete Datei an einen neuen Ort.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>bool</type><methodname>move_uploaded_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam><type>string</type><parameter>destination</parameter></methodparam>
     </methodsynopsis>
    <para>
     Diese Funktion prft, ob die mit <parameter>filename</parameter>
     bezeichnete Datei eine gltige Upload-Datei ist (d.h., dass sie
     mittels PHP's HTTP POST Upload-Mechanismus upgeloaded wurde).
     Ist die Datei gltig, wird sie zum in 
     <parameter>destination</parameter> bezeichneten Dateinamen 
     verschoben.
    </para>

    <para>
     Wenn <parameter>filename</parameter> keine gltige Datei ist, wird
     keine Aktion ausgefhrt, und 
     <function>move_uploaded_file</function> gibt
     &false; zurck.
    </para>

    <para>
     Wenn <parameter>filename</parameter> eine gltige Datei ist, jedoch
     aus irgendeinem Grund nicht verschoben werden kann, wird keine 
     Aktion ausgefhrt, und <function>move_uploaded_file</function>
     gibt &false; zurck. Zustzlich wird eine Warnung 
     ausgegeben.
    </para>

    <para>
     Diese Prfung ist speziell dort interessant, wo irgendeine Aktion mit 
     upgeloadeten Dateien deren Inhalt dem User zugnglich machen knnte 
     (oder auch anderen Usern auf dem selben System).
    </para>

    <note>
     <para>
      <function>move_uploaded_file</function> ist von den normalen safe-mode 
      UID-Einschrnkungen nicht betroffen. Dies ist nicht unsicher, da
      <function>move_uploaded_file</function> nur mit via PHP hochgeladenen
      Dateien arbeitet.
     </para>
    </note>

    <warning>
     <para>
      Sollte die Zieldatei bereits existieren, wird sie berschrieben.
     </para>
    </warning>

    <para>
     Siehe auch <function>is_uploaded_file</function>, und das Kapitel
     <link linkend="features.file-upload">Steuerung von Dateiuploads</link>
     fr ein einfaches Anwendungsbeispiel.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.parse-ini-file">
   <refnamediv>
    <refname>parse_ini_file</refname>
    <refpurpose>Analysiert eine Konfiguratiionsdatei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>parse_ini_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>
        process_sections
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>parse_ini_file</function> ldt die in
     <parameter>filename</parameter> angegebene Datei, und gibt
     die darin enthaltenen Einstellungen in einem assoziativen
     Array zurck. Setzen Sie den letzten Parameter
     <parameter>process_sections</parameter> auf &true;, erhalten
     Sie ein mehrdimensionales Array mit den Gruppennamen und
     Einstellungen. Ist <parameter>process_sections</parameter>
     nicht angegeben, wird &false; angenommen.
    </para>
    <note>
     <para>
      Diese Funktion hat nichts mit der <filename>php.ini</filename>
      zu tun, denn diese ist bereits abgearbeitet, wenn Sie Ihr Skript
      ausfhren. Diese Funktion ist vorgesehen, um Konfigurationsdateien
      fr Ihre eigenen Applikationen einzulesen.
     </para>
    </note>
    <para>
     Die Struktur der ini Datei ist der von
     <filename>php.ini</filename> hnlich.
    </para>
    <para>
     <example>
      <title>Inhalt der sample.ini</title>
      <programlisting>
<![CDATA[
; Dies ist ein Beispiel fr eine Konfigurationsdatei
; Kommentare beginnen wie in der php.ini mit ';'

[erste_gruppe]
eins = 1
fnf = 5

[zweite_gruppe]
pfad = /usr/local/bin
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title><function>parse_ini_file</function></title>
      <programlisting>
<![CDATA[
<?php

// Ohne Gruppen analysieren
$ini_array = parse_ini_file("sample.ini");
print_r($ini_array);

// Mit Gruppen analysieren
$ini_array = parse_ini_file("sample.ini", TRUE);
print_r($ini_array);

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Wrde wie folgt ausgeben:
     <informalexample>
      <programlisting>
<![CDATA[
Array
(
    [eins] => 1
    [fnf] => 5
    [pfad] => /usr/local/bin
)
Array
(
    [erste_gruppe] => Array
        (
            [eins] => 1
            [fnf] => 5
        )

    [zweite_gruppe] => Array
        (
            [pfad] => /usr/local/bin
        )

)
]]>
      </programlisting>
     </informalexample>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pathinfo">
   <refnamediv>
    <refname>pathinfo</refname>
    <refpurpose>Liefert Informationen ber den Dateipfad</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>pathinfo</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>pathinfo</function> gibt ein assoziatives Array
     mit Informationen ber den Pfad <parameter>path</parameter>
     zurck. Die folgenden Arrayelemente werden zurckgegeben:
     den Verzeichnisnamen <parameter>dirname</parameter>, den Dateinamen 
     <parameter>basename</parameter>, und die Dateinamenserweiterung 
     <parameter>extension</parameter>.
    </para>
    <para>
     <example>
      <title><function>pathinfo</function></title>
      <programlisting role="php">
<![CDATA[
<?php

$path_parts = pathinfo("/www/htdocs/index.html");

echo $path_parts["dirname"] . "\n";
echo $path_parts["basename"] . "\n";
echo $path_parts["extension"] . "\n";

?>
]]>
      </programlisting>
     </example>
    </para>
    <para>
     Wrde ausgeben:
     <informalexample>
      <programlisting>
<![CDATA[
/www/htdocs
index.html
html
]]>
      </programlisting>
     </informalexample>
    </para>
    <para>
     Siehe auch <function>dirname</function>,
     <function>basename</function>, <function>parse_url</function>
     und <function>realpath</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.pclose">
   <refnamediv>
    <refname>pclose</refname>
    <refpurpose>Schliet einen Prozess-Dateizeiger</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>pclose</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Schliet einen Prozess-Dateizeiger, der durch einen Aufruf von
     <function>popen</function> geffnet wurde.
    </para>
    <para>
     Der Dateizeiger muss gltig sein und durch einen erfolgreichen
     Funktionsaufruf von <function>popen</function> zurckgegeben
     worden sein.
    </para>
    <para>
     Gibt den End-Status eines laufenden Prozesses zurck.
    </para>
    <para>
     Siehe auch <function>popen</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.popen">
   <refnamediv>
    <refname>popen</refname>
    <refpurpose>ffnet einen Prozesszeiger</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>popen</methodname>
      <methodparam><type>string</type><parameter>command</parameter></methodparam>
      <methodparam><type>string</type><parameter>mode</parameter></methodparam>
     </methodsynopsis>
    <para>
     ffnet eine Verbindung zu einem Prozess, der durch die Anweisung
     <parameter>command</parameter> ausgefhrt wurde.
    </para>
    <para>
     Gibt einen Dateizeiger zurck, der identisch ist mit dem, der bei
     der Funktion <function>fopen</function> zurckgegeben wird,
     auer dass dieser nur in eine Richtung funktioniert (entweder
     lesend oder schreibend) und mit der Funktion
     <function>pclose</function> geschlossen werden muss.  Dieser
     Zeiger kann mit den Funktionen <function>fgets</function>,
     <function>fgetss</function> und <function>fputs</function>
     benutzt werden.
    </para>
    <para>
     Wenn ein Fehler auftritt, gibt diese Funktion &false; zurck.
    </para>
    <para>
     <informalexample>
      <programlisting role="php">
<![CDATA[
$fp = popen ("/bin/ls", "r");
]]>
      </programlisting>
     </informalexample>
    </para>
    <note>
     <para>
      Wenn das auszufhrende Kommando nicht gefunden werden konnte,
      wird eine gltige Ressource zurckgegeben. Das mag seltsam
      erscheinen, macht aber Sinn. Es ermglicht Ihnen, auf von der
      Shell zurckgegebene Fehlermeldungen zuzugreifen:
      <informalexample>
       <programlisting role="php">
<![CDATA[
<?php
error_reporting(E_ALL);

/* Umleitung hinzufgen, dass wir stderr erhalten knnen */
$fp = popen('/path/to/spooge 2>&1', 'r');
echo "'$fp'; " . gettype($fp) . "\n";
$read = fread($fp, 2096);
echo $read;
pclose($fp);
?>
]]>
       </programlisting>
      </informalexample>
     </para>
    </note>
    <para>
     Siehe auch <function>pclose</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readfile">
   <refnamediv>
    <refname>readfile</refname>
    <refpurpose>Gibt eine Datei aus</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>readfile</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
        use_include_path
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Liest den Inhalt einer Datei und gibt ihn an der Standartausgabe
     (Browser) aus.
    </para>
    <para>
     Gibt die Anzahl der Bytes einer Datei zurck. Wenn ein Fehler
     auftritt wird &false; zurckgegeben und eine Fehlermeldung wird auf
     der Standartausgabe ausgegeben. Die Ausgabe einer Fehlermeldung
     kann durch Voranstellen eines '@' verhindert werden (@readfile).
    </para>
    <para>
     Wenn <parameter>filename</parameter> mit "http://" (nicht case
     sensitive) beginnt, wird eine HTTP 1.0 Verbindung zu dem
     spezifiziertem Server hergestellt und der Text der Antwort wird auf
     die Standartausgabe geschrieben.
    </para>
    <para>
     In lteren Versionen als PHP 4.0.5 werden Weiterleitungen (HTTP 
     Redirects) nicht untersttzt, hier muss die Datei daher vollstndig 
     und mit abschlieendem "/" beschrieben werden.
    </para>
    <para>
     Wenn <parameter>filename</parameter> mit "ftp://" (nicht case
     sensitive) beginnt, wird eine FTP Verindung zu dem
     spezifiziertem Server hergestellt und die angeforderte Datei wird
     auf der Standartausgabe ausgegeben. Wenn der Server keinen
     passiven Mode untersttzt, wird diese Funktion fehlschlagen.
    </para>
    <para>
     Wenn <parameter>filename</parameter> mit keinem dieser
     Zeichenketten beginnt, wird die Datei vom lokalen Dateisystem
     geffnet und ihr Inhalt auf der Standartausgabe ausgegeben.
    </para>
    <para>
     Sie knnen optional den zweiten Parameter benutzen und diesen
     auf '1' setzen, wenn Sie auch im <link
     linkend="ini.include-path"> include_path</link> nach der Datei
     suchen mchten.
    </para>
    <para>
     Siehe auch <function>fpassthru</function>,
     <function>file</function>, <function>fopen</function>,
     <function>include</function>, <function>require</function> und
     <function>virtual</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.readlink">
   <refnamediv>
    <refname>readlink</refname>
    <refpurpose>
     Liefert das Ziel eines symbolischen Links
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>readlink</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>readlink</function> ist von der Funktionalitt her
     identisch mit der 'readlink C Funktion' und gibt den Inhalt des
     Pfades des symbolischen Links zurck oder 0, wenn der Aufruf
     fehlschlug.
    </para>
    <para>
     Siehe auch <function>is_link</function>,
     <function>symlink</function> und <function>linkinfo</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.rename">
   <refnamediv>
    <refname>rename</refname>
    <refpurpose>Benennt eine Datei um</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>rename</methodname>
      <methodparam><type>string</type><parameter>oldname</parameter></methodparam>
      <methodparam><type>string</type><parameter>newname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Versucht eine Datei <parameter>oldname</parameter> in
     <parameter>newname</parameter> umzubenennen.
    </para>
    <para>
     Gibt &true; bei Erfolg, andernfalls &false; zurck.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rewind">
   <refnamediv>
    <refname>rewind</refname>
    <refpurpose>
     Setzt den Dateizeiger auf das erste Byte der Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>rewind</methodname>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt den Dateizeiger (Datei-Positions-Indikator) fr
     <parameter>fp</parameter> an den Anfang des Dateistreams.
    </para>
    <para>
     Wenn ein Fehler auftritt, gibt die Funktion 0 zurck.
    </para>
    <para>
     Der Dateizeiger muss gltig sein und auf eine Datei zeigen, die
     zuvor erfolgreich durch <function>fopen</function> geffnet
     wurde.
    </para>
    <note>
     <para>
      Haben Sie eine Datei im Append-Modus ("a") geffnet, werden
      unabhngig von der Dateiposition alle zu schreibenden Daten
      angehngt.
     </para>
    </note>
    <para>
     Siehe auch <function>fseek</function> und
     <function>ftell</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.rmdir">
   <refnamediv>
    <refname>rmdir</refname>
    <refpurpose>Lscht ein Verzeichnis</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>rmdir</methodname>
      <methodparam><type>string</type><parameter>dirname</parameter></methodparam>
     </methodsynopsis>
    <para>
     Versucht ein Verzeichnis spezifiziert durch die Pfadangabe zu
     lschen. Das Verzeichnis muss leer sein und die relevanten Rechte
     mssen erteilt sein.
    </para>
    <para>
     Wenn ein Fehler auftritt wird 0 zurckgegeben.
    </para>
    <para>
     Siehe auch <function>mkdir</function>.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.stat">
   <refnamediv>
    <refname>stat</refname>
    <refpurpose>
     Liefert diverse Informationen ber eine Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>stat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Sammelt Informationen ber eine Datei spezifiziert in
     <parameter>filename</parameter>.
    </para>
    <para>
     Gibt einen Array mit folgenden statistischen Informationen als
     Array- Elemente zurck:
     <orderedlist>
      <listitem>
       <simpara>Laufwerk</simpara>
      </listitem>
      <listitem>
       <simpara>inode</simpara>
      </listitem>
      <listitem>
       <simpara>inode protection mode</simpara>
      </listitem>
      <listitem>
       <simpara>Anzahl der Links</simpara>
      </listitem>
      <listitem>
       <simpara>Benutzer ID des Inhabers</simpara>
      </listitem>
      <listitem>
       <simpara>Gruppen ID des Inhabers</simpara>
      </listitem>
      <listitem>
       <simpara>Laufwerkstyp wenn Inode-Laufwerk *</simpara>
      </listitem>
      <listitem>
       <simpara>Gre in Bytes</simpara>
      </listitem>
      <listitem>
       <simpara>Zeitpunkt des letzten Zugriffs</simpara>
      </listitem>
      <listitem>
       <simpara>Zeitpunkt der letzten Modifizierung</simpara>
      </listitem>
      <listitem>
       <simpara>Zeitpunkt der letzten nderung</simpara>
      </listitem>
      <listitem>
       <simpara>Blockgre fr das Dateisystem I/O *</simpara>
      </listitem>
      <listitem>
       <simpara>Anzahl der zugewiesenen Blcke</simpara>
      </listitem>
     </orderedlist>
     * - nur gltig auf Systemen, die st_blksize untersttzen. Andere
     Systeme (z.B. Windows) geben '-1' zurck.
    </para>
    <para>
     Gibt &false; zurck, wenn ein Fehler auftrat.
    </para>
    <para>
     <function>stat</function> ist nicht fr <link
     linkend="features.remote-files">remote Dateien</link> geeignet.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.lstat">
   <refnamediv>
    <refname>lstat</refname>
    <refpurpose>
     Liefert Informationen ber eine Datei oder einen symbolischen Link.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>array</type><methodname>lstat</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Ermittelt statistische Informationen ber eine Datei oder
     symbolischen Link, spezifiziert in <parameter>filename</parameter>.
     Diese Funktion ist identisch mit der Funktion 
     <function>stat</function>, auer dass wenn der Parameter 
     <parameter>filename</parameter> ein symbolischer Link ist, dessen 
     Status zurckgegeben wird und nicht der Status der Datei, auf die 
     der symbolische Link zeigt.
    </para>
    <para>
     Gibt einen Array mit statistischen Informationen ber die Datei
     als Array-Elemente zurck:
     <orderedlist>
      <listitem>
       <simpara>Laufwerk</simpara>
      </listitem>
      <listitem>
       <simpara>inode</simpara>
      </listitem>
      <listitem>
       <simpara>Anzahl der Links</simpara>
      </listitem>
      <listitem>
       <simpara>Benutzer ID des Inhabers</simpara>
      </listitem>
      <listitem>
       <simpara>Gruppen ID des Inhabers</simpara>
      </listitem>
      <listitem>
       <simpara>Laufwerkstyp wenn inode Laufwerk *</simpara>
      </listitem>
      <listitem>
       <simpara>Gre in Bytes</simpara>
      </listitem>
      <listitem>
       <simpara>Zeitpunkt des letzten Zugriffs</simpara>
      </listitem>
      <listitem>
       <simpara>Zeitpunkt der letzten Modifikation</simpara>
      </listitem>
      <listitem>
       <simpara>Zeitpunkt der letzen nderung</simpara>
      </listitem>
      <listitem>
       <simpara>Blockgre fr das Dateisystem I/O *</simpara>
      </listitem>
      <listitem>
       <simpara>Anzahl der zugewiesenen Blcke</simpara>
      </listitem>
     </orderedlist>
     * - nur gltig auf Systemen, die st_blksize untersttzen. Andere
     Systeme (z.B. Windows) geben '-1' zurck.
    </para>
    <para>
     <function>lstat</function> ist nicht fr <link
     linkend="features.remote-files">remote Dateien</link> geeignet.
    </para>
    <para>
     Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
     Siehe auch <function>clearstatcache</function> fr weitere
     Einzelheiten.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.realpath">
   <refnamediv>
    <refname>realpath</refname>
    <refpurpose>Erzeugt einen kanonisch absoluten Pfadnamen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>realpath</methodname>
      <methodparam><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>realpath</function> expandiert alle symbolischen Links, und 
     beseitigt Verweise zu '/./', '/../' und extra '/' Zeichen im Input 
     <parameter>path</parameter>, und gibt den absoluten Pfadnamen 
     kanonisch zurck. Der Pfad im Ergebnis enthlt keine Komponenten 
     eines symbolischen Links mehr, wie '/./' or '/../'.
    </para>
    <para>
     <example>
      <title><function>realpath</function></title>
      <programlisting role="php">
<![CDATA[
$real_path = realpath("../../index.php");
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.symlink">
   <refnamediv>
    <refname>symlink</refname>
    <refpurpose>Erzeugt einen symbolischen Link</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>symlink</methodname>
      <methodparam><type>string</type><parameter>target</parameter></methodparam>
      <methodparam><type>string</type><parameter>link</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>symlink</function> erzeugt einen symbolischen Link von
     dem gegebenen Parameter <parameter>target</parameter> mit dem
     spezifiziertem Namen <parameter>link</parameter>.
    </para>
    <para>
     Siehe auch <function>link</function> um absolute Links zu
     erstellen, und <function>readlink</function> zusammen mit
     <function>linkinfo</function>.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.tempnam">
   <refnamediv>
    <refname>tempnam</refname>
    <refpurpose>Erzeugt eine Datei mit eindeutigem Dateinamen</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>string</type><methodname>tempnam</methodname>
      <methodparam><type>string</type><parameter>dir</parameter></methodparam>
      <methodparam><type>string</type><parameter>prefix</parameter></methodparam>
     </methodsynopsis>
    <para>
     Erzeugt eine Datei mit einem eindeutigen Dateinamen in dem
     spezifizierten Verzeichnis. Wenn das Verzeichnis nicht existiert,
     erstellt <function>tempnam</function> eine Datei im temporren
     Verzeichnis des Systems, und gibt den Dateinamen zurck.
    </para>
    <para>
     Vor PHP 4.0.6 war das Verhalten von <function>tempnam</function>
     systemabhngig. Unter Windows wird die TMP-Umgebungsvariable den
     <parameter>dir</parameter> Parameter berschreiben, unter
     Linux-Systemen hat die TMPDIR Umgebungsvariable Vorrang, whrend
     SVR4 immer den spezifizierten Verzeichnisnamen benutzen wird,
     wenn dieses existiert. Wenn Sie nicht genau wissen, wie Ihr
     System <function>tempnam</function> behandelt, dann konsultieren
     Sie bitte Ihre System-Dokumentation.
    </para>
    <para>
     Gibt den neuen temporren Dateinamen bei Erfolg, oder eine
     &false; Zeichenkette wenn ein Fehler auftritt zurck.
     <example>
      <title><function>tempnam</function></title>
      <programlisting role="php">
<![CDATA[
$tmpfname = tempnam ("/tmp", "FOO");

$fp = fopen($tmpfname, "w");
fwrite($fp, "schreibe in Tmporrdatei");
fclose($fp);

// tue hier etwas

unlink($tmpfname);
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <simpara>
      Diese Funktion hat ihr Verhalten seit PHP 4.0.3 gendert.
      Die temporre Datei wird ebenfalls angelegt um eine 
      "Hetzsituation" zu vermeiden, wo in der Zeit nach dem Generieren
      des Strings, und bevor das Script dazukommt die Datei anzulegen,
      die Datei im Dateisystem erscheinen knnte. Beachten Sie, dass
      falls Sie die Datei nicht mehr bentigen, Sie diese wieder entfernen
      mssen (dies geschieht nicht automatisch).
     </simpara>
    </note>
	<para>
     Siehe auch <function>tmpfile</function> und <function>unlink</function>.
	</para>
   </refsect1>
  </refentry>

  <refentry id="function.tmpfile">
   <refnamediv>
    <refname>tmpfile</refname>
    <refpurpose>Legt eine temporre Datei an</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>tmpfile</methodname>
      <void/>
     </methodsynopsis>
    <para>
	 Erstellt eine temporre Datei mit einem eindeutigen
	 Dateinamen im Schreibmodus und gibt einen Dateizeiger
	 hnlich wie es bei der Funktion <function>fopen</function>
	 erfolgt, zurck. Die Datei wird automatisch gelscht, wenn
	 sie geschlossen wird (mit <function>fclose</function>), oder
	 das Skript beendet wird.
    </para>
	<para>
	 Fr Details konsultieren Sie bitte die Dokumentation Ihres
	 Betriebssystems bzgl. der <literal>tmpfile(3)</literal> Funktion,
	 wie auch die <filename>stdio.h</filename> Header-Datei.
    </para>
    <para>
     <example>
      <title><function>tmpfile</function></title>
      <programlisting role="php">
<![CDATA[
$temp = tmpfile();
fwrite($temp, "schreibt in Temporrdatei");
fclose($temp); // dies entfernt die Datei
]]>
      </programlisting>
     </example>
    </para>
	<para>
	 Siehe auch <function>tempnam</function>.
	</para>
   </refsect1>
  </refentry>

  <refentry id="function.touch">
   <refnamediv>
    <refname>touch</refname>
    <refpurpose>
     Setzt die Zugriffs- und Modifizierungszeit einer Datei
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>touch</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>
      	 time
      	</parameter></methodparam>
     </methodsynopsis>
    <para>
     Setzt Datum und Uhrzeit der letzten nderung und des letzten Zugriffs
     der durch <parameter>filename</parameter> spezifizierten Datei auf den
     durch <parameter>time</parameter> spezifizierten Wert. Wenn die Option
     <parameter>time</parameter> nicht angegeben wurde, wird die aktuelle
     Zeit benutzt. Dies ist quivalent zu dem, was utime tut (manchmal wird
     auch als utimes davon gesprochen).
    </para>
    <para>
     Wenn die Datei nicht existiert, wird sie erzeugt.
    </para>
    <para>
     Gibt &true; bei Erfolg, andernfalls &false; zurck.
     <example>
      <title><function>touch</function></title>
      <programlisting role="php">
<![CDATA[
if (touch ($DateiName)) {
    print "$DateiName Modifizierungs-Zeit wurde auf das aktuelle 
          Datum und die aktuelle Uhrzeit gesetzt.";
} else {
    print "Tut mir leid, Modifikations-Zeit von $DateiName konnte 
          nicht gendert werden.";
}
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.umask">
   <refnamediv>
    <refname>umask</refname>
    <refpurpose>
     ndert die aktuelle umask (Zugriffsrechte)
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>umask</methodname>
      <methodparam><type>int</type><parameter>mask</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>umask</function> setzt PHP's umask auf
     <parameter>mask</parameter> &amp; 0777 und gibt die alte umask
     zurck. Wenn PHP als Servermodul benutzt wird, wird die umask
     zurckgespeichert wenn die jeweilige Anfrage beendet ist.
    </para>
    <para>
     <function>umask</function> ohne Argumente gibt einfach die
     aktuelle umask zurck.
    </para>
    &note.no-windows;
   </refsect1>
  </refentry>

  <refentry id="function.unlink">
   <refnamediv>
    <refname>unlink</refname>
    <refpurpose>Lscht eine Datei</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Beschreibung</title>
     <methodsynopsis>
      <type>int</type><methodname>unlink</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
     </methodsynopsis>
    <para>
     Lscht <parameter>filename</parameter>. hnlich der UNIX C
     unlink() Funktion.
    </para>
    <para>
     &return.success;
    </para>
    <para>
     Siehe auch <function>rmdir</function> um Verzeichnisse zu lschen.
    </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:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->