eschmid Sun Apr 22 21:40:11 2001 EDT
Modified files:
/phpdoc/de/functions filesystem.xml
Log:
Some enhancements by Thomas.
Index: phpdoc/de/functions/filesystem.xml
diff -u phpdoc/de/functions/filesystem.xml:1.20 phpdoc/de/functions/filesystem.xml:1.21
--- phpdoc/de/functions/filesystem.xml:1.20 Sat Apr 14 02:37:27 2001
+++ phpdoc/de/functions/filesystem.xml Sun Apr 22 21:40:11 2001
@@ -1,2754 +1,2946 @@
- <reference id="ref.filesystem">
- <title>Funktionen des Dateisystems</title>
- <titleabbrev>Filesystem</titleabbrev>
-
- <refentry id="function.basename">
- <refnamediv>
- <refname>basename</refname>
- <refpurpose>
- Gibt den Namen einer Datei aus einer vollst�ndigen Pfadangabe
- zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>basename</function></funcdef>
- <paramdef>string <parameter>path</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Diese Funktion extrahiert aus einer vollst�ndigen Pfadangabe den
- Namen der Datei und gibt diesen zur�ck.
- </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> Beispiel</title>
- <programlisting role="php">
-$path = "/home/httpd/html/index.php3";
-$file = basename($path); // $file enth�lt den Wert "index.php3"
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch <function>dirname</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.chgrp">
- <refnamediv>
- <refname>chgrp</refname>
- <refpurpose>
- Wechselt die Gruppenzugeh�rigkeit einer Datei
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>chgrp</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>mixed <parameter>group</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Weist einer Datei einer Benutzergruppe zu. Um diese Funktion
- ausf�hren zu k�nnen, m�ssen Sie Superuser sein. Andere Benutzer
- k�nnen die Gruppenzugeh�rigkeit einer Datei in jede Gruppe
- �ndern, derer sie angeh�ren.
- </para>
- <para>
- Gibt bei Erfolg TRUE zur�ck, andernfalls FALSE.
- </para>
- <note>
- <para>
- Unter Windows-Systemen bleibt diese Funktion ohne Effekt.
- </para>
- </note>
- <para>
- Siehe auch <function>chown</function> und
- <function>chmod</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.chmod">
- <refnamediv>
- <refname>chmod</refname>
- <refpurpose>�ndert die Zugriffsrechte einer Datei</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>chmod</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>int <parameter>mode</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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
- f�r einen Oktalwert gehalten wird. Um sicher zu gehen, dass die
- Operation wie erwartet verl�uft sollten Sie
- <parameter>mode</parameter> mit dem Prefix Null (0) versehen:
- <informalexample>
- <programlisting role="php">
-chmod ("/somedir/somefile", 755); // dezimal; m�glicherweise 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 zur�ck, andernfalls FALSE.
- </para>
- <para>
- Siehe auch <function>chown</function> und
- <function>chgrp</function>.
- </para>
- <note>
- <simpara>
- Diese Funktion bleibt unter Windows-Systemen ohne Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.chown">
- <refnamediv>
- <refname>chown</refname>
- <refpurpose>�ndert den Eigent�mer einer Datei</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>chown</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>mixed <parameter>user</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- �ndert den Eigent�mer der Datei <parameter>filename</parameter>
- in Benutzer <parameter>user</parameter>. Nur der Superuser kann
- den Eigent�mer einer Datei �ndern.
- </para>
- <para>
- Gibt bei Erfolg TRUE zur�ck, andernfalls FALSE.
- <note>
- <simpara>
- Unter Windows bleibt diese Funktion ohne Effekt.
- </simpara>
- </note>
- </para>
- <para>
- Siehe auch <function>chown</function> und
- <function>chmod</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.clearstatcache">
- <refnamediv>
- <refname>clearstatcache</refname>
- <refpurpose>L�scht den Status Cache</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>clearstatcache</function></funcdef>
- <void/>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>clearstatcache</function> l�scht 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 aufgef�hrten
- Funktionen f�r die n�chste 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, ver�ndert oder
- verschwunden ist, k�nnen Sie diese Funktion dazu benutzen, das
- Ergebnis des letzten Aufrufes aus dem Speicher zu leeren.
- </para>
- <para>
- Dieser Wert wird nur f�r 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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>copy</function></funcdef>
- <paramdef>string <parameter>source</parameter></paramdef>
- <paramdef>string <parameter>dest</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Die Funktion <function>copy</function> kopiert eine Datei. Sie
- gibt TRUE zur�ck, wenn der Kopiervorgang erfolgreich war,
- andernfalls FALSE.
- <example>
- <title><function>Copy</function> Beispiel</title>
- <programlisting role="php">
-if (!copy ($file, $file.'.bak')) {
- print ("failed to copy $file...<br>\n");
-}
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch: <function>rename</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.delete">
- <refnamediv>
- <refname>delete</refname>
- <refpurpose>"Dummy Handbuch Eintrag"</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>delete</function></funcdef>
- <paramdef>string <parameter>file</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Dieses ist ein "Dummy Handbuch Eintrag" f�r 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 l�schen,
- <function>unset</function> um Variablen zu l�schen.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.dirname">
- <refnamediv>
- <refname>dirname</refname>
- <refpurpose>
- Extrahiert den Verzeichnis-Namen aus einer vollst�ndigen
- Pfadangabe
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>dirname</function></funcdef>
- <paramdef>string <parameter>path</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Bei einer vollst�ndigen Pfadangabe gibt diese Funktion den
- Verzeichnispfad zur�ck.
- </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> Beispiel</title>
- <programlisting role="php">
-$path = "/etc/passwd";
-$file = dirname ($path); // $file enth�lt den Wert "/etc"
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch <function>basename</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.diskfreespace">
- <refnamediv>
- <refname>diskfreespace</refname>
- <refpurpose>
- Gibt den freien Speicherplatz in einem Verzeichnis zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>float <function>diskfreespace</function></funcdef>
- <paramdef>string <parameter>directory</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Diese Funktion gibt den freien Speicherplatz eines Verzeichnisses
- in Byte zur�ck.
- </para>
- <para>
- <example>
- <title><function>diskfreespace</function> Beispiel</title>
- <programlisting role="php">
-$df = diskfreespace("/"); // $df h�lt die Anzahl an freien Bytes
- // im Verzeichnis "/"
- </programlisting>
- </example>
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fclose">
- <refnamediv>
- <refname>fclose</refname>
- <refpurpose>Schlie�t einen offenen Dateizeiger</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fclose</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Die Datei, auf die der Dateizeiger <parameter>fp</parameter>
- zeigt wird geschlossen.
- </para>
- <para>
- Gibt bei erfolgreichem Schlie�en der Datei TRUE, andernfalls
- FALSE zur�ck.
- </para>
- <para>
- Der Datei-Zeiger muss g�ltig sein, d.h. die Datei, auf die
- gezeigt wird muss zuvor mit <function>fopen</function>,
- <function>popen</function> oder <function>fsockopen</function>
- ge�ffnet worden sein.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.feof">
- <refnamediv>
- <refname>feof</refname>
- <refpurpose>
- Pr�ft, ob der Dateizeiger am Ende der Datei steht
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>feof</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck, falls der Dateizeiger am Ende der Datei steht
- oder ein Fehler aufgetreten ist, andernfalls FALSE.
- </para>
- <para>
- Der Dateizeiger muss g�ltig sein, d.h. die Datei, auf die gezeigt
- wird, muss zuvor mit <function>fopen</function>,
- <function>popen</function> oder <function>fsockopen</function>
- ge�ffnet worden sein.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fflush">
- <refnamediv>
- <refname>fflush</refname>
- <refpurpose>Flushes the output to a file</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fflush</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- This function forces a write of all buffered output to the
- to the resource pointed to by the file handle
- <parameter>fp</parameter>. Returns true if succesful, false
- otherwise.
- </para>
- <para>
- The file pointer must be valid, and must point to a file
- successfully opened by <function>fopen</function>,
- <function>popen</function>, or <function>fsockopen</function>.
- </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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>fgetc</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt einen String zur�ck, der ein einzelnes Zeichen von der
- aktuellen Position des Dateizeigers <parameter>fp</parameter>
- enth�lt. Gibt FALSE zur�ck, wenn der Dateizeiger am Ende der
- Datei steht (wie die Funktion <function>feof</function>).
- </para>
- <para>
- Der Dateizeiger muss g�ltig sein, d.h. die Datei, auf die gezeigt
- wird, muss zuvor mit <function>fopen</function>,
- <function>popen</function> oder <function>fsockopen</function>
- ge�ffnet 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
- �berpr�ft diese auf Komma-Separierte-Werte (CSV)
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>fgetcsv</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>length</parameter></paramdef>
- <paramdef>string
- <parameter>
- <optional>Trennzeichen (Delimiter)</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <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 �berpr�ft. Das Ergebnis wird als Array
- zur�ckgegeben. 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 g�ltig sein,
- d.h. die Datei, auf die gezeigt wird, muss zuvor mit
- <function>fopen</function>, <function>popen</function> oder
- <function>fsockopen</function> ge�ffnet worden sein.
- </simpara>
- <simpara>
- 'length' muss gr��er sein als die l�ngste in der CSV-Datei
- vorhandene Zeile (um das Erkennen von EndOfLine(Ende der Zeile)
- Zeichen zu erm�glichen).
- </simpara>
- <simpara>
- <function>fgetcsv</function> gibt FALSE am Dateiende und bei
- Lesefehlern zur�ck.
- </simpara>
- <simpara>
- Eine leere Zeile der CSV-Datei wird als Array mit einem Feld das
- den Wert NULL h�lt zur�ckgegeben. 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">
-$row = 1; // Anzahl der Arrays
-$fp = fopen ("test.csv","r"); // Datei wird zum Lesen
- // ge�ffnet
-while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei
- // in einen Array $data gelesen
- $num = count ($data); // Felder im Array $data
- // werden gez�hlt
- 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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>fgets</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>length</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt eine Zeile zur�ck mit einer in <parameter>length</parameter>
- definierten L�nge -1 Byte, welche aus der Datei von der aktuellen
- Position des Dateizeigers <parameter>fp</parameter> aus
- ausgelesen wird. Die Zeile endet an einem Zeilenumbruch, EOF
- (Ende der Datei) oder bei <parameter>lenght</parameter> Zeichen
- (Je nachdem, was eher auftritt).
- </para>
- <para>
- Wenn ein Fehler auftritt, wird FALSE zur�ckgegeben.
- </para>
- <para>
- H�ufig auftretende Fehler:
- </para>
- <simpara>
- Wenn Sie an die C-Semantik von fgets gew�hnt sind, sollten
- Sie auf die unterschiedliche Behandlung von EOF (genauer:
- wie EOF zur�ckgegeben wird) achten.
- </simpara>
- <simpara>
- Der Datei-Zeiger <parameter>fp</parameter> muss g�ltig sein,
- d.h. die Datei, auf die gezeigt wird, muss zuvor mit
- <function>fopen</function>, <function>popen</function> oder
- <function>fsockopen</function> ge�ffnet worden sein.
- </simpara>
- <para>
- Ein einfaches Beispiel:
- <example>
- <title>Eine Datei Zeile f�r Zeile einlesen</title>
- <programlisting role="php">
-$fd = fopen ("/tmp/inputfile.txt", "r");
-while (!feof($fd)) {
- $buffer = fgets($fd, 4096);
- echo $buffer;
-}
-fclose ($fd);
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch <function>fread</function>,
- <function>fopen</function>, <function>popen</function>,
- <function>fgetc</function> und <function>fsockopen</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fgetss">
- <refnamediv>
- <refname>fgetss</refname>
- <refpurpose>
- Liest eine Zeile von der aktuellen Position des Dateizeigers
- und entfernt HTML und PHP-Tags.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>fgetss</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>length</parameter></paramdef>
- <paramdef>string
- <parameter>
- <optional>allowable_tags</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Diese Funktion ist identisch mit der Funktion
- <function>fgets</function>, ausser das
- <function>fgetss</function> versucht, vorhandene HTML und
- PHP-Tags aus dem gelesenen Text zu entfernen.
- </para>
- <para>
- Optional k�nnen 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
- hinzugef�gt, PHP4B3.
- </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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>file</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>int
- <parameter><optional>use_include_path</optional></parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Die Funktion <function>file</function> ist identisch mit der
- Funktion <function>readfile</function>, bis auf den Umstand, das
- die eingelesene Datei als Array zur�ckgegeben wird. Jedes Feld
- des Arrays korrespondiert mit einer Zeile der Datei. Der
- Zeilenumbruch bleibt erhalten.
- </para>
- <para>
- Optional kann der zweiter 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">
-<?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 = join ('', file ('http://www.php.net'));
-?>
- </programlisting>
- </informalexample>
- </para>
- <para>
- Siehe auch <function>readfile</function>,
- <function>fopen</function>, and <function>popen</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.file-exists">
- <refnamediv>
- <refname>file_exists</refname>
- <refpurpose>�berpr�ft, ob eine Datei existiert</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>file_exists</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- Gibt TRUE zur�ck, 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 �berpr�ft werden soll muss
- �ber das Dateisystem des Servers erreichbar sein.
- </simpara>
- <simpara>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.fileatime">
- <refnamediv>
- <refname>fileatime</refname>
- <refpurpose>
- Gibt Datum und Uhrzeit des letzten Zugriffs auf eine Datei zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fileatime</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- Gibt Datum und Uhrzeit des letzten Zugriffs auf eine Datei
- zur�ck, oder FALSE wenn ein Fehler auftrat. Das Datum wird als
- UNIX-Timestamp zur�ckgegeben.
- </simpara>
- <simpara>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.filectime">
- <refnamediv>
- <refname>filectime</refname>
- <refpurpose>
- Gibt Datum und Uhrzeit der letzten �nderung des Dateizeigers
- Inode zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>filectime</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt Zeit der letzten �nderung des Dateizeigers Inode zur�ck,
- oder FALSE wenn ein Fehler auftrat. Die Zeit wird als
- UNIX-Timestamp zur�ckgegeben.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.filegroup">
- <refnamediv>
- <refname>filegroup</refname>
- <refpurpose>
- Gibt die Gruppenzugeh�rigkeit einer Datei zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>filegroup</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt die Gruppen ID des Besitzers einer Datei zur�ck, oder FALSE
- wenn ein Fehler auftrat. Die Gruppen ID wird im numerischen
- Format zur�ckgegeben. Mit der Funktion
- <function>posix_getgrgid</function> k�nnen Sie diese zu ihrem
- Gruppennamen aufl�sen.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- <note>
- <simpara>
- Diese Funktion hat unter Windows-Systemen keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.fileinode">
- <refnamediv>
- <refname>fileinode</refname>
- <refpurpose>Gibt Inode-Nummer einer Datei aus</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fileinode</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt die Inode-Nummer einer Datei zur�ck, oder FALSE wenn ein
- Fehler auftrat.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- <note>
- <simpara>
- Diese Funktion hat unter Windows-Systemen keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.filemtime">
- <refnamediv>
- <refname>filemtime</refname>
- <refpurpose>
- Gibt Datum und Uhrzeit der letzten Datei�nderung aus
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>filemtime</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt Datum und Uhrzeit zur�ck, wann die Datei das letzte mal
- modifiziert wurde, oder FALSE wenn ein Fehler auftrat. Das Datum
- wird als UNIX-Timestamp zur�ckgegeben.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fileowner">
- <refnamediv>
- <refname>fileowner</refname>
- <refpurpose>Gibt den Dateieigent�mer aus</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fileowner</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt die Benutzer ID des Eigent�mers einer Datei zur�ck, oder
- FALSE wenn ein Fehler auftrat. Die Benutzer ID wird in
- numerischem Format zur�ckgegeben und kann mit der Funktion
- <function>posix_getpwuid</function> zum Benutzernamen aufgel�st
- werden.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- <note>
- <simpara>
- Diese Funktion hat unter Windows keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.fileperms">
- <refnamediv>
- <refname>fileperms</refname>
- <refpurpose>Gibt die Zugriffsrechte einer Datei aus</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fileperms</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt die Zugriffsrechte einer Datei zur�ck, oder FALSE wenn ein
- Fehler auftrat.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.filesize">
- <refnamediv>
- <refname>filesize</refname>
- <refpurpose>Gibt die Gr��e einer Datei aus</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>filesize</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt die Gr��e einer Datei zur�ck, oder FALSE wenn ein Fehler
- auftrat.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.filetype">
- <refnamediv>
- <refname>filetype</refname>
- <refpurpose>Gibt den Typ einer Datei zur�ck</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>filetype</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt den Typ einer Datei zur�ck. M�gliche Werte sind fifo, char,
- dir, block, link, file und unknown.
- </para>
- <para>
- Gibt FALSE zur�ck, wenn ein Fehler auftrat.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.flock">
- <refnamediv>
- <refname>flock</refname>
- <refpurpose>Portables Datei-Verriegelungs-Verfahren</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>flock</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>operation</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- PHP liefert einen portablen Weg, Dateien in einer "beratenden"
- Art und Weise zu verriegeln. D.h. alle zugreifende Programme
- m�ssen 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 1.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Um eine exklusive, nur schreibende Verriegelung zu erhalten,
- setzen Sie <parameter>operation</parameter> auf 2.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Um eine Verriegelung freizugeben (lesend oder schreibend),
- setzten Sie <parameter>operation</parameter> auf 3.
- </simpara>
- </listitem>
- <listitem>
- <simpara>
- Wenn Sie Zugriffe w�hrend der Verriegelung durch
- <function>flock</function> erlauben wollen, f�gen Sie 4 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 jedem
- Betriebsystem benutzt werden kann (UNICES- und Windows- Systeme).
- </simpara>
- <simpara>
- <function>flock</function> gibt TRUE bei Erfolg, FALSE wenn ein
- Fehler auftrat (z.B. wenn eine Verriegelung nicht erstellt werden
- konnte) zur�ck.
- </simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.fopen">
- <refnamediv>
- <refname>fopen</refname>
- <refpurpose>�ffnet eine Datei oder URL</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fopen</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>string <parameter>mode</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>use_include_path</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- Wenn <parameter>filename</parameter> mit "http://"; (nicht case
- sensitive) beginnt, wird zu dem spezifiziertem Server eine HTTP
- 1.0 Connection ge�ffnet und ein Dateizeiger auf den Anfang des
- Textes der Antwort zur�ckgegeben. Ein 'Host:' header wird mit der
- Anfrage geschickt, um namens-basierte Virtual Hosts zu verarbeiten.
- </simpara>
- <simpara>
- Weiterleitungen (HTTP Redirects) werden nicht unterst�tzt, die
- Datei muss daher vollst�ndig und mit abschlie�endem "/"
- beschrieben werden.
- </simpara>
- <simpara>
- Wenn <parameter>filename</parameter> mit "ftp://"; (nicht case
- sensitive) beginnt, wird eine ftp-Connection zu dem
- spezifiziertem Server ge�ffnet und ein Zeiger auf die
- angeforderte Datei zur�ckgegeben. Wenn der Server keinen
- passiven FTP-Modus unterst�tzt, wird diese Methode
- fehlschlagen. Sie k�nnen Dateien entweder zum Schreiben oder zum
- Lesen �ffnen, jedoch nicht f�r beides gleichzeitig.
- </simpara>
- <simpara>
- Wenn <parameter>filename</parameter> "php://stdin",
- "php://stdout", oder "php://stderr" ist, wird der
- korrespondierende stdio stream ge�ffnet (Feature wurde in Version
- 3.0.13 eingef�hrt, in fr�heren 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 ge�ffnet und ein
- Dateizeiger auf die ge�ffnete Datei zur�ckgegeben.
- </simpara>
- <simpara>
- Wenn das �ffnen scheitert, gibt die Funktion FALSE zur�ck.
- </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 L�nge 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 L�nge 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>
- Zus�tzlich kann <parameter>mode</parameter> der Buchstabe 'b'
- hinzugef�gt werden, der die Behandlung von Bin�r-Dateien
- erlaubt. Dieses ist sinnvoll auf Systemen, welche zwischen Bin�r-
- und Text-Dateien unterscheiden. Wenn das Feature nicht gebraucht
- wird, wird es einfach ignoriert.
- </para>
- <para>
- Sie k�nnen 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 m�chten.
- </para>
- <para>
- <example>
- <title>fopen() Beispiel</title>
- <programlisting role="php">
-$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:[EMAIL PROTECTED]/";, "w");
- </programlisting>
- </example>
- </para>
- <simpara>
- Wenn Sie Probleme haben mit dem Lesen oder Schreiben von Dateien
- (Wenn Sie PHP als Servermodul benutzen), stellen Sie zun�chst
- sicher, dass die Dateien und Verzeichnisse die Sie benutzen
- wollen auch f�r den Server-Proze� zug�nglich sind
- (Rechtevergabe).
- </simpara>
- <para>
- Achten Sie auf Windows-Systemen darauf, dass Sie als
- Verzeichnistrenner normale Schr�gstriche '/' benutzen um
- plattformunabh�ngig programmieren zu k�nnen. Sollten Sie dennoch
- Backslashes verwenden, vergessen Sie nicht diese zu escapen '\\'
- <informalexample>
- <programlisting role="php">
-$fp = fopen ("c:\\data\\info.txt", "r");
- </programlisting>
- </informalexample>
- </para>
- <simpara>
- Siehe auch <function>fclose</function>,
- <function>fsockopen</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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fpassthru</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- Die Funktion liest alle Daten vom Dateizeiger bis EOF aus und
- gibt die Daten auf der Standartausgabe (Browser) aus.
- </simpara>
- <simpara>
- Wenn ein Fehler auftritt, gibt <function>fpassthru</function>
- FALSE zur�ck.
- </simpara>
- <simpara>
- Der Dateizeiger muss g�ltig sein und auf eine erfolgreich durch
- <function>fopen</function>, <function>popen</function> oder
- <function>fsockopen</function> ge�ffnete Datei zeigen. Die Datei
- wird geschlossen, wenn <function>fpassthru</function> die Datei
- komplett gelesen hat (hinterl��t 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> ge�ffnet haben
- m�ssen.
- </simpara>
- <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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fputs</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>string <parameter>str</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>length</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Fputs</function> ist ein Alias f�r 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 Bin�r-Dateien aus einer Datei</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>fread</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>length</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- <function>Fread</function> liest <parameter>length</parameter>
- Bytes vom Dateizeiger, maximal jedoch bis zum Dateiende.
- </simpara>
- <para>
- <informalexample>
- <programlisting role="php">
-// 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>
- <simpara>
- Siehe auch <function>fwrite</function>,
- <function>fopen</function>, <function>fsockopen</function>,
- <function>popen</function>, <function>fgets</function>,
- <function>fgetss</function>, <function>file</function> und
- <function>fpassthru</function>.
- </simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.fscanf">
- <refnamediv>
- <refname>fscanf</refname>
- <refpurpose>Parses input from a file according to a format</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>mixed <function>fscanf</function></funcdef>
- <paramdef>int <parameter>handle</parameter></paramdef>
- <paramdef>string <parameter>format</parameter></paramdef>
- <paramdef>string
- <parameter><optional>var1</optional></parameter>...
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- The function <function>fscanf</function> is similar to
- <function>sscanf</function>, but it takes its input from a file
- associated with <parameter>handle</parameter> and interprets the
- input according to the specified
- <parameter>format</parameter>. If only two parameters were passed
- to this function, the values parsed will be returned as an array.
- Otherwise, if optional parameters are passed, the function will
- return the number of assigned values. The optional parameters
- must be passed by reference.
- <example>
- <title><function>Fscanf</function> Example</title>
- <programlisting role="php">
-$fp = fopen ("users.txt","r");
-while ($userinfo = fscanf ($fp, "%s\t%s\t%s\n")) {
- list ($name, $profession, $countrycode) = $userinfo;
- //... do something with the values
-}
-fclose($fp);
- </programlisting>
- </example>
- <example>
- <title>users.txt</title>
- <programlisting>
-javier argonaut pe
-hiroshi sculptor jp
-robert slacker us
-luigi florist it
- </programlisting>
- </example>
- </para>
- <para>
- See also <function>fread</function>, <function>fgets</function>,
- <function>fgetss</function>, <function>sscanf</function>,
- <function>printf</function>, and <function>sprintf</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fseek">
- <refnamediv>
- <refname>fseek</refname>
- <refpurpose>
- Positioniert den Dateizeiger um einen Offset 'offset' vor oder
- zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fseek</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>offset</parameter></paramdef>
- <paramdef>int <parameter><optional>whence</optional></parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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 Hinzuf�gen 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>.</member>
- </simplelist>
- </para>
- <para>Wenn <parameter>whence</parameter> nicht angegeben wurde, wird
- SEEK_SET angenommen.
- </para>
- <para>
- Bei Erfolg wird '0' zur�ckgegeben, 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>
- <para>
- Siehe auch <function>ftell</function> und
- <function>rewind</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fstat">
- <refnamediv>
- <refname>fstat</refname>
- <refpurpose>
- Gets information about a file using an open file pointer
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>fstat</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gathers the statistics of the file opened by the file
- pointer fp. This function is similar to the
- <function>stat</function> function except that it operates
- on an open file pointer instead of a filename.
- </para>
- <para>
- Returns an array with the statistics of the file with the
- following elements:
- <orderedlist>
- <listitem><simpara>device</simpara></listitem>
- <listitem><simpara>inode</simpara></listitem>
- <listitem><simpara>number of links</simpara></listitem>
- <listitem><simpara>user id of owner</simpara></listitem>
- <listitem><simpara>group id owner</simpara></listitem>
- <listitem><simpara>device type if inode device *</simpara></listitem>
- <listitem><simpara>size in bytes</simpara></listitem>
- <listitem><simpara>time of last access</simpara></listitem>
- <listitem><simpara>time of last modification</simpara></listitem>
- <listitem><simpara>time of last change</simpara></listitem>
- <listitem><simpara>blocksize for filesystem I/O *</simpara></listitem>
- <listitem><simpara>number of blocks allocated</simpara></listitem>
- </orderedlist>
- * - only valid on systems supporting the st_blksize type--other
- systems (i.e. Windows) return -1</para>
- <para>
- The results of this function are cached. See
- <function>clearstatcache</function> for more details.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.ftell">
- <refnamediv>
- <refname>ftell</refname>
- <refpurpose>
- Ermittelt die aktuelle Position des Dateizeigers
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>ftell</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt die aktuelle Position des Dateizeigers
- <parameter>fp</parameter> zur�ck, z.B. seinen Offset im
- Dateistream.
- </para>
- <para>
- Wenn ein Fehler auftritt, wird FALSE zur�ckgegeben.
- </para>
- <para>
- Der Dateizeiger muss g�ltig sein und auf eine erfolgreich durch
- <function>fopen</function>, <function>popen</function> oder
- <function>fsockopen</function> ge�ffnete 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>
- Truncates a file to a given length.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>ftruncate</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>size</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Takes the filepointer, fp, and truncates the file to length, size.
- This function returns true on success and false on failure.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.fwrite">
- <refnamediv>
- <refname>fwrite</refname>
- <refpurpose>Schreibt Bin�rdaten in eine Datei</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>fwrite</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>string <parameter>string</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>length</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <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>
- 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>
- <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 f�r einen gegebenen Dateizeiger
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>set_file_buffer</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- <paramdef>int <parameter>buffer</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- <function>set_file_buffer</function> setzt die Pufferung f�r
- Schreiboperationen eines gegebenen Dateizeigers
- <parameter>fp</parameter> auf <parameter>buffer</parameter>
- Bytes. Wenn <parameter>buffer</parameter> auf 0 gesetzt ist oder
- 0 ist, wird die Schreibpufferung ausgeschaltet.
- </simpara>
- <simpara>
- Die Funktion gibt 0 bei Erfolg, oder EOF wenn die Anfrage nicht
- erfolgreich war zur�ck.
- </simpara>
- <simpara>
- Bedenken Sie, dass der Standartwert beim Aufruf von
- <function>fopen</function> mit set_file_buffer immer 8K ist.
- </simpara>
- <simpara>
- Siehe auch <function>fopen</function>.
- </simpara>
- </refsect1>
- </refentry>
-
- <refentry id="function.is-dir">
- <refnamediv>
- <refname>is_dir</refname>
- <refpurpose>
- Ermittelt, ob der gegebene Dateiname ein Verzeichnis ist
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_dir</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck, 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> f�r 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>
- Ermittelt, ob eine Datei ausf�hrbar ist
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_executable</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck, wenn die Datei existiert und ausf�hrbar ist.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- <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>
- Ermittelt, ob der Dateiname eine regul�re Datei ist
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_file</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck, wenn die Datei existiert und eine regul�re
- Datei ist.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> f�r 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>
- Ermittelt, ob der Dateiname ein synmbolischer Link ist
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_link</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck, 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> f�r weitere
- Einzelheiten.
- </para>
- <para>
- Siehe auch <function>is_dir</function> und
- <function>is_file</function>.
- </para>
- <note>
- <simpara>
- Diese Funktion hat auf Windows-Systemen keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.is-readable">
- <refnamediv>
- <refname>is_readable</refname>
- <refpurpose>
- Ermittelt ob eine Datei lesbar ist
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_readable</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck wenn die Datei existiert und sie lesbar ist.
- </para>
- <para>
- Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
- zugreift, unter der der Webserver l�uft (oftmals ist dieses
- 'nobody'). Beschr�nkungen durch safe_mode werden nicht
- ber�cksichtigt.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- <para>
- Siehe auch <function>is_writeable</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.is-writeable">
- <refnamediv>
- <refname>is_writeable</refname>
- <refpurpose>
- Ermittelt, ob in eine Datei geschrieben werden kann
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_writeable</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Gibt TRUE zur�ck, wenn die Datei existiert und nicht
- schreibgesch�tzt ist. Das Dateinamen-Argument kann ein
- Verzeichnisname sein. So k�nnen Sie �berpr�fen, ob in ein
- Verzeichnis geschrieben werden kann.
- </para>
- <para>
- Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
- zugreift, unter der der Webserver l�uft (oftmals ist dieses
- 'nobody'). Beschr�nkungen durch safe_mode werden nicht
- ber�cksichtigt.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- <para>
- Siehe auch <function>is_readable</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.is-uploaded-file">
- <refnamediv>
- <refname>is_uploaded_file</refname>
- <refpurpose>Tells whether the file was uploaded via HTTP POST.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>is_uploaded_file</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- This function is available only in versions of PHP 3 after PHP
- 3.0.16, and in versions of PHP 4 after 4.0.2.
- </para>
-
- <para>
- Returns true if the file named by <varname>filename</varname> was
- uploaded via HTTP POST. This is useful to help ensure that a
- malicious user hasn't tried to trick the script into working on
- files upon which it should not be working--for instance,
- <filename>/etc/passwd</filename>.
- </para>
-
- <para>
- This sort of check is especially important if there is any chance
- that anything done with uploaded files could reveal their
- contents to the user, or even to other users on the same
- system.
- </para>
-
- <para>
- See also <function>move_uploaded_file</function>, and the section
- <link linkend="features.file-upload">Handling file uploads</link>
- for a simple usage example.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.link">
- <refnamediv>
- <refname>link</refname>
- <refpurpose>Erzeugt einen absoluten Link</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>link</function></funcdef>
- <paramdef>string <parameter>target</parameter></paramdef>
- <paramdef>string <parameter>link</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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>
- <simpara>
- Diese Funktion hat unter Windows-Systemen keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.linkinfo">
- <refnamediv>
- <refname>linkinfo</refname>
- <refpurpose>Ermittelt Informationen �ber einen Link</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>linkinfo</function></funcdef>
- <paramdef>string <parameter>path</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Linkinfo</function> gibt das st_dev Feld des UNIX C
- stat structure resultierend aus dem lstat System Call
- zur�ck. Diese Funktion wird benutzt, um zu verifizieren ob ein
- Link (auf den mit <parameter>path</parameter> gezeigt wird)
- wirklich exisitiert (Hierbei wird die gleiche Methode benutzt,
- die in dem S_ISLNK Makro in stat.h definiert ist). Gibt 0 oder
- FALSE zur�ck wenn ein Fehler auftrat.
- </para>
- <para>
- Siehe auch <function>symlink</function>,
- <function>link</function>, und <function>readlink</function>.
- </para>
- <note>
- <simpara>
- Diese Funktion hat unter Windows keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.mkdir">
- <refnamediv>
- <refname>mkdir</refname>
- <refpurpose>Erstellt ein Verzeichnis</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>mkdir</function></funcdef>
- <paramdef>string <parameter>pathname</parameter></paramdef>
- <paramdef>int <parameter>mode</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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.
- <informalexample>
- <programlisting role="php">
-mkdir ("/path/to/my/dir", 0700);
- </programlisting>
- </informalexample>
- </para>
- <para>
- Gibt TRUE bei Erfolg, andernfalls FALSE zur�ck.
- </para>
- <para>
- Siehe auch <function>rmdir</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.move-uploaded-file">
- <refnamediv>
- <refname>move_uploaded_file</refname>
- <refpurpose>Moves an uploaded file to a new location.</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>bool <function>move_uploaded_file</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>string <parameter>destination</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
-
- <para>
- This function is available only in versions of PHP 3 after PHP
- 3.0.16, and in versions of PHP 4 after 4.0.2.
- </para>
-
- <para>
- This function checks to ensure that the file designated by
- <parameter>filename</parameter> is a valid upload file (meaning
- that it was uploaded via PHP's HTTP POST upload mechanism). If
- the file is valid, it will be moved to the filename given by
- <parameter>destination</parameter>.
- </para>
-
- <para>
- If <parameter>filename</parameter> is not a valid upload file,
- then no action will occur, and
- <function>move_uploaded_file</function> will return
- <literal>false</literal>.
- </para>
-
- <para>
- If <parameter>filename</parameter> is a valid upload file, but
- cannot be moved for some reason, no action will occur, and
- <function>move_uploaded_file</function> will return
- <literal>false</literal>. Additionally, a warning will be issued.
- </para>
-
- <para>
- This sort of check is especially important if there is any chance
- that anything done with uploaded files could reveal their
- contents to the user, or even to other users on the same
- system.
- </para>
-
- <para>
- See also <function>is_uploaded_file</function>, and the section
- <link linkend="features.file-upload">Handling file uploads</link>
- for a simple usage example.
- </para>
- </refsect1>
- </refentry>
-
-
- <refentry id="function.pathinfo">
- <refnamediv>
- <refname>pathinfo</refname>
- <refpurpose>Returns information about a file path</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>pathinfo</function></funcdef>
- <paramdef>string <parameter>path</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>pathinfo</function> returns an associative array
- containing information about <parameter>path</parameter>. The
- following array elements are returned:
- <parameter>dirname</parameter>, <parameter>basename</parameter>
- and <parameter>extension</parameter>.
- </para>
- <para>
- <example>
- <title><function>pathinfo</function> Example</title>
- <programlisting role="php">
-<?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>
- Would produce:
- <informalexample>
- <programlisting>
-/www/htdocs
-index.html
-html
- </programlisting>
- </informalexample>
- </para>
- <para>
- See also <function>dirname</function>,
- <function>basename</function> and <function>realpath</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.pclose">
- <refnamediv>
- <refname>pclose</refname>
- <refpurpose>Schlie�t einen Prozess-Dateizeiger</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>pclose</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Schlie�t einen Prozess-Dateizeiger, der durch einen Aufruf von
- <function>popen</function> ge�ffnet wurde.
- </para>
- <para>
- Der Dateizeiger muss g�ltig sein und durch einen erfolgreichen
- Funktionsaufruf von <function>popen</function> zur�ckgegeben
- worden sein.
- </para>
- <para>
- Gibt den End-Status eines laufenden Prozesses zur�ck.
- </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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>popen</function></funcdef>
- <paramdef>string <parameter>command</parameter></paramdef>
- <paramdef>string <parameter>mode</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- �ffnet eine Verbindung zu einem Prozess, der durch die Anweisung
- <parameter>command</parameter> ausgef�hrt wurde.
- </para>
- <para>
- Gibt einen Dateizeiger zur�ck, der identisch ist mit dem, der bei
- der Funktion <function>fopen</function> zur�ckgegeben wird,
- ausser 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 zur�ck.
- </para>
- <para>
- <informalexample>
- <programlisting role="php">
-$fp = popen ("/bin/ls", "r");
- </programlisting>
- </informalexample>
- </para>
- <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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>readfile</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>use_include_path</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Liest den Inhalt einer Datei und gibt ihn an der Standartausgabe
- (Browser) aus.
- </para>
- <para>
- Gibt die Anzahl der Bytes einer Datei zur�ck. Wenn ein Fehler
- auftritt wird FALSE zur�ckgegeben 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 Connection zu dem
- spezifiziertem Server ge�ffnet und der Text der Antwort wird auf
- die Standartausgabe geschrieben.
- </para>
- <para>
- Weiterleitungen (HTTP Redirects) werden nicht unterst�tzt, daher
- muss die Datei vollst�ndig mit abschliessendem '/' geschrieben
- werden.
- </para>
- <para>
- Wenn <parameter>filename</parameter> mit "ftp://"; (nicht case
- sensitive) beginnt, wird eine FTP-Connection zu dem
- spezifiziertem Server ge�ffnet und die angeforderte Datei wird
- auf der Standartausgabe ausgegeben. Wenn der Server keinen
- passiven Mode unterst�tzt, wird diese Funktion fehlschlagen.
- </para>
- <para>
- Wenn <parameter>filename</parameter> mit keinem dieser
- Zeichenketten beginnt, wird die Datei vom lokalen Dateisystem
- ge�ffnet und ihr Inhalt auf der Standartausgabe ausgegeben.
- </para>
- <para>
- Sie k�nnen optional den zweiten Paratmeter benutzen und diesen
- auf '1' setzen, wenn Sie auch im <link
- linkend="ini.include-path"> include_path</link> nach der Datei
- suchen m�chten.
- </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>
- Gibt das Ziel eines symbolischen Links zur�ck
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>readlink</function></funcdef>
- <paramdef>string <parameter>path</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Readlink</function> ist von der Funktionalit�t her
- identisch mit der 'readlink C Funktion' und gibt den Inhalt des
- Pfades des symbolischen Links zur�ck oder 0, wenn der Aufruf
- fehlschlug.
- </para>
- <para>
- Siehe auch <function>symlink</function>,
- <function>readlink</function> und <function>linkinfo</function>.
- </para>
- <note>
- <simpara>
- Diese Funktion hat unter Windows keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.rename">
- <refnamediv>
- <refname>rename</refname>
- <refpurpose>Benennt eine Datei um</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>rename</function></funcdef>
- <paramdef>string <parameter>oldname</parameter></paramdef>
- <paramdef>string <parameter>newname</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Versucht eine Datei <parameter>oldname</parameter> in
- <parameter>newname</parameter> umzubenennen.
- </para>
- <para>
- Gibt TRUE bei Erfolg, andernfalls FALSE zur�ck.
- </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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>rewind</function></funcdef>
- <paramdef>int <parameter>fp</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Setzt den Dateizeiger (Datei-Positions-Indikator) f�r
- <parameter>fp</parameter> an den Anfang des Dateistreams.
- </para>
- <para>
- Wenn ein Fehler auftritt, gibt der Funktionsaufruf 0 zur�ck.
- </para>
- <para>
- Der Dateizeiger muss g�ltig sein und auf eine Datei zeigen, die
- zuvor erfolgreich durch <function>fopen</function> ge�ffnet
- wurde.
- </para>
- <para>
- Siehe auch <function>fseek</function> und
- <function>ftell</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.rmdir">
- <refnamediv>
- <refname>rmdir</refname>
- <refpurpose>L�scht ein Verzeichnis</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>rmdir</function></funcdef>
- <paramdef>string <parameter>dirname</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Versucht ein Verzeichnis spezifiziert durch die Pfadangabe zu
- l�schen. Das Verzeichnis muss leer sein und die relevanten Rechte
- m�ssen erteilt sein.
- </para>
- <para>
- Wenn ein Fehler auftritt wird 0 zur�ckgegeben.
- </para>
- <para>
- Siehe auch <function>mkdir</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.stat">
- <refnamediv>
- <refname>stat</refname>
- <refpurpose>
- Ermittelt diverse Informationen �ber eine Datei
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>stat</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Versucht Informationen �ber eine Datei spezifiziert in
- <parameter>filename</parameter> auszugeben.
- </para>
- <para>
- Gibt einen Array mit folgenden statistischen Informationen als
- Array- Elemente zur�ck:
- <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>Gr��e 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>Blockgr��e f�r das Dateisystem I/O *</simpara>
- </listitem>
- <listitem>
- <simpara>Anzahl der zugewiesenen Bl�cke</simpara>
- </listitem>
- </orderedlist>
- * - nur g�ltig auf Systemen, die st_blksize unterst�tzen. Andere
- Systeme (z.B. Windows) geben '-1' zur�ck.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.lstat">
- <refnamediv>
- <refname>lstat</refname>
- <refpurpose>
- Ermittelt Informationen �ber einen symbolischen Link.
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>array <function>lstat</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Ermittelt statistische Informationen �ber einen symbolischen Link
- spezifiziert in <parameter>filename</parameter>. Diese Funktion
- ist identisch mit der Funktion <function>stat</function> ausser
- dass, wenn der Parameter <parameter>filename</parameter> ein
- symbolischer Link ist, dessen Status zur�ckgegeben 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 zur�ck:
- <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>Gr��e 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>Blockgr��e f�r das Dateisystem I/O *</simpara>
- </listitem>
- <listitem>
- <simpara>Anzahl der zugewiesenen Bl�cke</simpara>
- </listitem>
- </orderedlist>
- * - nur g�ltig auf Systemen, die st_blksize unterst�tzen. Andere
- Systeme (z.B. Windows) geben '-1' zur�ck.
- </para>
- <para>
- Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
- Siehe auch <function>clearstatcache</function> f�r weitere
- Einzelheiten.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.realpath">
- <refnamediv>
- <refname>realpath</refname>
- <refpurpose>Return canonicalized absolute pathname</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>realpath</function></funcdef>
- <paramdef>string <parameter>path</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>realpath</function> expands all symbolic links and
- resolves references to '/./', '/../' and extra '/' characters in
- the input <parameter>path</parameter> and return the canonicalized
- absolute pathname. The resulting path will have no symbolic link,
- '/./' or '/../' components.
- </para>
-
- <para>
- <example>
- <title><function>realpath</function> example</title>
- <programlisting role="php">
-$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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>symlink</function></funcdef>
- <paramdef>string <parameter>target</parameter></paramdef>
- <paramdef>string <parameter>link</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <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> zusammmen mit
- <function>linkinfo</function>.
- </para>
- <note>
- <simpara>
- Diese Funktion hat unter Windows-Systemen keinen Effekt.
- </simpara>
- </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.tempnam">
- <refnamediv>
- <refname>tempnam</refname>
- <refpurpose>Erzeugt einen eindeutigen Dateinamen</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>string <function>tempnam</function></funcdef>
- <paramdef>string <parameter>dir</parameter></paramdef>
- <paramdef>string <parameter>prefix</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Erzeugt einen eindeutigen einmaligen tempor�ren Dateinamen in dem
- spezifizierten Verzeichnis. Wenn das Verzeichnis nicht existiert,
- wird <function>tempnam</function> einen Dateinamen im tempor�ren
- Verzeichnis des Systems erstellen.
- </para>
- <para>
- Das Verhalten von <function>tempnam</function> ist
- systemabh�ngig. Unter Windows wird die TMP-Umgebungsvariable den
- <parameter>dir</parameter> Parameter �berschreiben, unter
- Linux-Systemen hat die TMPDIR Umgebungsvariable Vorrang, w�hrend
- 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 tempor�ren Dateinamen bei Erfolg, oder eine
- NULL-Zeichenkette wenn ein Fehler auftritt zur�ck.
- <example>
- <title><function>Tempnam</function> Beispiel</title>
- <programlisting role="php">
-$tmpfname = tempnam ("/tmp", "FOO");
- </programlisting>
- </example>
- </para>
- <para>
- Siehe auch <function>tmpfile</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.tmpfile">
- <refnamediv>
- <refname>tmpfile</refname>
- <refpurpose>Legt eine tempor�re Datei an</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>tmpfile</function></funcdef>
- <paramdef>void</paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Erstellt eine tempor�re Datei mit einem eindeutigen
- Dateinamen im Schreibmodus und gibt einen Dateizeiger
- �hnlich wie es bei der Funktion <function>fopen</function>
- erfolgt, zur�ck. Die Datei wird automatisch gel�scht, wenn
- sie geschlossen wird (mit <function>fclose</function>), oder
- das Skript beendet wird.
- </para>
- <para>
- F�r 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>
- Siehe auch <function>tempnam</function>.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.touch">
- <refnamediv>
- <refname>touch</refname>
- <refpurpose>
- Setzt das Datum der letzten �nderung einer Datei
- </refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>touch</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- <paramdef>int
- <parameter>
- <optional>time</optional>
- </parameter>
- </paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- Versucht das Datum der letzten Modifikation einer Datei
- spezifiziert durch <parameter>filename</parameter> auf den Wert
- spezifiziert durch <parameter>time</parameter> zu setzten. Wenn
- die Option <parameter>time</parameter> nicht angegeben wurde,
- benutzt die Funktion die aktuelle Zeit.
- </para>
- <para>
- Wenn die Datei nicht existiert, wird sie erzeugt.
- </para>
- <para>
- Gibt TRUE bei Erfolg, andernfalls FALSE zur�ck.
- <example>
- <title><function>Touch</function> Beispiel</title>
- <programlisting role="php">
-if (touch ($DateiName)) {
- print "$DateiName Modifizierungs-Zeit wurde auf das aktuelle
- Datum und und die aktuelle Uhrzeit gesetzt.";
-} else {
- print "Tut mir leid, Modifikations-Zeit von $DateiName konnte
- nicht ge�ndert 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>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>umask</function></funcdef>
- <paramdef>int <parameter>mask</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- <function>Umask</function> setzt PHP's umask auf
- <parameter>mask</parameter> & 0777 und gibt die alte umask
- zur�ck. Wenn PHP als Servermodul benutzt wird, wird die umask
- zur�ckgespeichert wenn die jeweilige Anfrage beendet ist.
- </para>
- <para>
- <function>Umask</function> ohne Argumente gibt einfach die
- aktuelle umask zur�ck.
- </para>
- </refsect1>
- </refentry>
-
- <refentry id="function.unlink">
- <refnamediv>
- <refname>unlink</refname>
- <refpurpose>L�scht eine Datei</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Beschreibung</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>int <function>unlink</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <para>
- L�scht <parameter>filename</parameter>. �hnlich der UNIX C
- unlink() Funktion.
- </para>
- <para>
- Gibt 0 oder FALSE zur�ck, wenn ein Fehler auftritt.
- </para>
- <para>
- Siehe auch <function>rmdir</function> um Verzeichnisse zu l�schen.
- </para>
- <note>
- <simpara>
- Diese Funktion bleibt unter Windows-Systemen ohne Effekt.
- </simpara>
- </note>
- </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
-sgml-parent-document:nil
-sgml-default-dtd-file:"../../manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
--->
-
+ <reference id="ref.filesystem">
+ <title>Funktionen des Dateisystems</title>
+ <titleabbrev>Filesystem</titleabbrev>
+
+ <refentry id="function.basename">
+ <refnamediv>
+ <refname>basename</refname>
+ <refpurpose>
+ Gibt den Namen einer Datei aus einer vollst�ndigen Pfadangabe
+ zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>basename</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion extrahiert aus einer vollst�ndigen Pfadangabe den
+ Namen der Datei und gibt diesen zur�ck.
+ </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> Beispiel</title>
+ <programlisting role="php">
+$path = "/home/httpd/html/index.php3";
+$file = basename($path); // $file enth�lt den Wert "index.php3"
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Siehe auch <function>dirname</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.chgrp">
+ <refnamediv>
+ <refname>chgrp</refname>
+ <refpurpose>
+ Wechselt die Gruppenzugeh�rigkeit einer Datei
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>chgrp</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>mixed <parameter>group</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Weist einer Datei einer Benutzergruppe zu. Um diese Funktion
+ ausf�hren zu k�nnen, m�ssen Sie Superuser sein. Andere Benutzer
+ k�nnen die Gruppenzugeh�rigkeit einer Datei in jede Gruppe
+ �ndern, derer sie angeh�ren.
+ </para>
+ <para>
+ Gibt bei Erfolg TRUE zur�ck, andernfalls FALSE.
+ </para>
+ <note>
+ <para>
+ Unter Windows-Systemen bleibt diese Funktion ohne Effekt.
+ </para>
+ </note>
+ <para>
+ Siehe auch <function>chown</function> und
+ <function>chmod</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.chmod">
+ <refnamediv>
+ <refname>chmod</refname>
+ <refpurpose>�ndert die Zugriffsrechte einer Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>chmod</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>int <parameter>mode</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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
+ f�r einen Oktalwert gehalten wird. Um sicher zu gehen, dass die
+ Operation wie erwartet verl�uft sollten Sie
+ <parameter>mode</parameter> mit dem Prefix Null (0) versehen:
+ <informalexample>
+ <programlisting role="php">
+chmod ("/somedir/somefile", 755); // dezimal; m�glicherweise 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 zur�ck, andernfalls FALSE.
+ </para>
+ <para>
+ Siehe auch <function>chown</function> und
+ <function>chgrp</function>.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion bleibt unter Windows-Systemen ohne Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.chown">
+ <refnamediv>
+ <refname>chown</refname>
+ <refpurpose>�ndert den Eigent�mer einer Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>chown</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>mixed <parameter>user</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ �ndert den Eigent�mer der Datei <parameter>filename</parameter>
+ in Benutzer <parameter>user</parameter>. Nur der Superuser kann
+ den Eigent�mer einer Datei �ndern.
+ </para>
+ <para>
+ Gibt bei Erfolg TRUE zur�ck, andernfalls FALSE.
+ <note>
+ <simpara>
+ Unter Windows bleibt diese Funktion ohne Effekt.
+ </simpara>
+ </note>
+ </para>
+ <para>
+ Siehe auch <function>chown</function> und
+ <function>chmod</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.clearstatcache">
+ <refnamediv>
+ <refname>clearstatcache</refname>
+ <refpurpose>L�scht den Status Cache</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>clearstatcache</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>clearstatcache</function> l�scht 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 aufgef�hrten
+ Funktionen f�r die n�chste 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, ver�ndert oder
+ verschwunden ist, k�nnen Sie diese Funktion dazu benutzen, das
+ Ergebnis des letzten Aufrufes aus dem Speicher zu leeren.
+ </para>
+ <para>
+ Dieser Wert wird nur f�r 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>copy</function></funcdef>
+ <paramdef>string <parameter>source</parameter></paramdef>
+ <paramdef>string <parameter>dest</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Die Funktion <function>copy</function> kopiert eine Datei. Sie
+ gibt TRUE zur�ck, wenn der Kopiervorgang erfolgreich war,
+ andernfalls FALSE.
+ <example>
+ <title><function>Copy</function> Beispiel</title>
+ <programlisting role="php">
+if (!copy ($file, $file.'.bak')) {
+ print ("failed to copy $file...<br>\n");
+}
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Siehe auch: <function>rename</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.delete">
+ <refnamediv>
+ <refname>delete</refname>
+ <refpurpose>"Dummy Handbuch Eintrag"</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>delete</function></funcdef>
+ <paramdef>string <parameter>file</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Dieses ist ein "Dummy Handbuch Eintrag" f�r 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 l�schen,
+ <function>unset</function> um Variablen zu l�schen.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dirname">
+ <refnamediv>
+ <refname>dirname</refname>
+ <refpurpose>
+ Extrahiert den Verzeichnis-Namen aus einer vollst�ndigen
+ Pfadangabe
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>dirname</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Bei einer vollst�ndigen Pfadangabe gibt diese Funktion den
+ Verzeichnispfad zur�ck.
+ </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> Beispiel</title>
+ <programlisting role="php">
+$path = "/etc/passwd";
+$file = dirname ($path); // $file enth�lt den Wert "/etc"
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ Siehe auch <function>basename</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.diskfreespace">
+ <refnamediv>
+ <refname>diskfreespace</refname>
+ <refpurpose>
+ Gibt den freien Speicherplatz in einem Verzeichnis zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>float <function>diskfreespace</function></funcdef>
+ <paramdef>string <parameter>directory</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion gibt den freien Speicherplatz eines Verzeichnisses
+ in Byte zur�ck.
+ </para>
+ <para>
+ <example>
+ <title><function>diskfreespace</function> Beispiel</title>
+ <programlisting role="php">
+$df = diskfreespace("/"); // $df h�lt die Anzahl an freien Bytes
+ // im Verzeichnis "/"
+ </programlisting>
+ </example>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fclose">
+ <refnamediv>
+ <refname>fclose</refname>
+ <refpurpose>Schlie�t einen offenen Dateizeiger</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fclose</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Die Datei, auf die der Dateizeiger <parameter>fp</parameter>
+ zeigt wird geschlossen.
+ </para>
+ <para>
+ Gibt bei erfolgreichem Schlie�en der Datei TRUE, andernfalls
+ FALSE zur�ck.
+ </para>
+ <para>
+ Der Datei-Zeiger muss g�ltig sein, d.h. die Datei, auf die
+ gezeigt wird muss zuvor mit <function>fopen</function>
+ oder <function>fsockopen</function> ge�ffnet worden sein.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.feof">
+ <refnamediv>
+ <refname>feof</refname>
+ <refpurpose>
+ Pr�ft, ob der Dateizeiger am Ende der Datei steht
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>feof</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck, falls der Dateizeiger am Ende der Datei steht
+ oder ein Fehler aufgetreten ist, andernfalls FALSE.
+ </para>
+ <para>
+ Der Dateizeiger muss g�ltig sein, d.h. die Datei, auf die gezeigt
+ wird, muss zuvor mit <function>fopen</function>,
+ <function>popen</function> oder <function>fsockopen</function>
+ ge�ffnet 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fflush</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 zur�ck.
+ </para>
+ <para>
+ Der Dateizeiger muss g�ltig sein, und auf eine mittels
+ <function>fopen</function>, <function>popen</function>, oder
+ <function>fsockopen</function> erfolgreich ge�ffnete 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>fgetc</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt einen String zur�ck, der ein einzelnes Zeichen von der
+ aktuellen Position des Dateizeigers <parameter>fp</parameter>
+ enth�lt. Gibt FALSE zur�ck, wenn der Dateizeiger am Ende der
+ Datei steht (wie die Funktion <function>feof</function>).
+ </para>
+ <para>
+ Der Dateizeiger muss g�ltig sein, d.h. die Datei, auf die gezeigt
+ wird, muss zuvor mit <function>fopen</function>,
+ <function>popen</function> oder <function>fsockopen</function>
+ ge�ffnet 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
+ �berpr�ft diese auf Komma-Separierte-Werte (CSV)
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>fgetcsv</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>length</parameter></paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>Trennzeichen (Delimiter)</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 �berpr�ft. Das Ergebnis wird als Array
+ zur�ckgegeben. 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 g�ltig sein,
+ d.h. die Datei, auf die gezeigt wird, muss zuvor mit
+ <function>fopen</function>, <function>popen</function> oder
+ <function>fsockopen</function> ge�ffnet worden sein.
+ </simpara>
+ <simpara>
+ 'length' muss gr��er sein als die l�ngste in der CSV-Datei
+ vorhandene Zeile (um das Erkennen von EndOfLine(Ende der Zeile)
+ Zeichen zu erm�glichen).
+ </simpara>
+ <simpara>
+ <function>fgetcsv</function> gibt FALSE am Dateiende und bei
+ Lesefehlern zur�ck.
+ </simpara>
+ <simpara>
+ Eine leere Zeile der CSV-Datei wird als Array mit einem Feld das
+ den Wert NULL h�lt zur�ckgegeben. 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">
+$row = 1; // Anzahl der Arrays
+$fp = fopen ("test.csv","r"); // Datei wird zum Lesen
+ // ge�ffnet
+while ($data = fgetcsv ($fp, 1000, ",")) { // Daten werden aus der Datei
+ // in einen Array $data gelesen
+ $num = count ($data); // Felder im Array $data
+ // werden gez�hlt
+ 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>fgets</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>length</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt eine Zeile bis zu <parameter>length</parameter> -1 Bytes
+ L�nge zur�ck, welche aus der Datei von der aktuellen Position des
+ Dateizeigers <parameter>fp</parameter> aus ausgelesen wird. Die
+ Zeile endet an einem Zeilenumbruch (welcher im R�ckgabewert enthalten
+ ist), EOF (Ende der Datei) oder bei <parameter>length</parameter>
+ - 1 Bytes (Je nachdem, was eher auftritt).
+ </para>
+ <para>
+ Wenn ein Fehler auftritt, wird FALSE zur�ckgegeben.
+ </para>
+ <para>
+ H�ufig auftretende Fehler:
+ </para>
+ <simpara>
+ Wenn Sie an die C-Semantik von fgets gew�hnt sind, sollten
+ Sie auf die unterschiedliche Behandlung von EOF (genauer:
+ wie EOF zur�ckgegeben wird) achten.
+ </simpara>
+ <simpara>
+ Der Datei-Zeiger <parameter>fp</parameter> muss g�ltig sein,
+ d.h. die Datei, auf die gezeigt wird, muss zuvor mit
+ <function>fopen</function>, <function>popen</function> oder
+ <function>fsockopen</function> ge�ffnet worden sein.
+ </simpara>
+ <para>
+ Ein einfaches Beispiel:
+ <example>
+ <title>Eine Datei Zeile f�r Zeile einlesen</title>
+ <programlisting role="php">
+$fd = fopen ("/tmp/inputfile.txt", "r");
+while (!feof($fd)) {
+ $buffer = fgets($fd, 4096);
+ echo $buffer;
+}
+fclose ($fd);
+ </programlisting>
+ </example>
+ </para>
+ <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 aktuellen Position des Dateizeigers
+ und entfernt HTML und PHP-Tags.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>fgetss</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>length</parameter></paramdef>
+ <paramdef>string
+ <parameter>
+ <optional>allowable_tags</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion ist identisch mit der Funktion
+ <function>fgets</function>, ausser das
+ <function>fgetss</function> versucht, vorhandene HTML und
+ PHP-Tags aus dem gelesenen Text zu entfernen.
+ </para>
+ <para>
+ Optional k�nnen 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
+ hinzugef�gt, PHP4B3.
+ </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>file</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>use_include_path</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Die Funktion <function>file</function> ist identisch mit der
+ Funktion <function>readfile</function>, bis auf den Umstand, das
+ die eingelesene Datei als Array zur�ckgegeben wird. Jedes Feld
+ des Arrays korrespondiert mit einer Zeile der Datei. Der
+ Zeilenumbruch bleibt erhalten.
+ </para>
+ <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">
+<?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 = join ('', file ('http://www.php.net'));
+?>
+ </programlisting>
+ </informalexample>
+ </para>
+ <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>�berpr�ft, ob eine Datei existiert</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>file_exists</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Gibt TRUE zur�ck, 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 �berpr�ft werden soll muss
+ �ber das Dateisystem des Servers erreichbar sein.
+ </simpara>
+ <simpara>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fileatime">
+ <refnamediv>
+ <refname>fileatime</refname>
+ <refpurpose>
+ Gibt Datum und Uhrzeit des letzten Zugriffs auf eine Datei zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fileatime</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Gibt Datum und Uhrzeit des letzten Zugriffs auf eine Datei
+ zur�ck, oder FALSE wenn ein Fehler auftrat. Das Datum wird als
+ UNIX-Timestamp zur�ckgegeben.
+ </simpara>
+ <simpara>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </simpara>
+ <simpara>
+ Anmerkung: Die atime einer Datei vorgesehen sich immer zu �ndern,
+ sobald Datenbl�cke einer Datei ge�ndert werden. Das kann sich
+ folgenschwer auf die Performance auswirken, wenn eine Anwendung
+ regelm�ssig auf eine grosse Anzahl Dateien oder Verzeichnisse zugreift.
+ Manche Unix Dateisysteme k�nnen mit deaktivierter atime-Aktualisierung
+ gemountet werden, um die Performance solcher Applikationen zu erh�hen;
+ USENET news spools sind ein h�ufiges Beispiel. Auf solchen
+ Dateisystemen wird diese Funktion nutzlos.
+ </simpara>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.filectime">
+ <refnamediv>
+ <refname>filectime</refname>
+ <refpurpose>
+ Gibt Datum und Uhrzeit der letzten �nderung des Dateizeigers
+ Inode zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>filectime</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt Zeit der letzten �nderung des Dateizeigers Inode zur�ck,
+ oder FALSE wenn ein Fehler auftrat. Die Zeit wird als
+ UNIX-Timestamp zur�ckgegeben.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <para>
+ Anmerkung: Bei den meisten Unix Dateisystemen gilt eine Datei als
+ ge�ndert, sobald ihre Inode-Daten ge�ndert wurden; d.h. wenn die
+ Rechte, Eigent�mer, Grupp, oder andere Metadaten des Inodes
+ aktualisiert werden. Siehe auch <function>filemtime</function> (das
+ ist was Sie suchen, wenn Sie Fusszeilen mit "Zuletzt Aktualisiert"
+ f�r Webseiten erstellen m�chten) 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 f�r die Erstellung
+ von Unix Dateien.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.filegroup">
+ <refnamediv>
+ <refname>filegroup</refname>
+ <refpurpose>
+ Gibt die Gruppenzugeh�rigkeit einer Datei zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>filegroup</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Gruppen ID des Besitzers einer Datei zur�ck, oder FALSE
+ wenn ein Fehler auftrat. Die Gruppen ID wird im numerischen
+ Format zur�ckgegeben. Mit der Funktion
+ <function>posix_getgrgid</function> k�nnen Sie diese zu ihrem
+ Gruppennamen aufl�sen.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat unter Windows-Systemen keinen Effekt.
+ </simpara>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fileinode">
+ <refnamediv>
+ <refname>fileinode</refname>
+ <refpurpose>Gibt Inode-Nummer einer Datei aus</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fileinode</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Inode-Nummer einer Datei zur�ck, oder FALSE wenn ein
+ Fehler auftrat.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat unter Windows-Systemen keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.filemtime">
+ <refnamediv>
+ <refname>filemtime</refname>
+ <refpurpose>
+ Gibt Datum und Uhrzeit der letzten Datei�nderung aus
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>filemtime</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt Datum und Uhrzeit zur�ck, wann die Datei das letzte mal
+ modifiziert wurde, oder FALSE wenn ein Fehler auftrat. Das Datum
+ wird als UNIX-Timestamp zur�ckgegeben.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ <para>Anmerkung: Diese Funktion gibt den Zeitpunkt zur�ck, an dem in
+ die Datenbl�cke 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 ausgabef�higes �nderungsdatum
+ f�r z.B. Fusszeilen in Webseiten zu erhalten.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fileowner">
+ <refnamediv>
+ <refname>fileowner</refname>
+ <refpurpose>Gibt den Dateieigent�mer aus</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fileowner</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Benutzer ID des Eigent�mers einer Datei zur�ck, oder
+ FALSE wenn ein Fehler auftrat. Die Benutzer ID wird in
+ numerischem Format zur�ckgegeben und kann mit der Funktion
+ <function>posix_getpwuid</function> zum Benutzernamen aufgel�st
+ werden.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ <note>
+ <simpara>
+ Diese Funktion hat unter Windows keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fileperms">
+ <refnamediv>
+ <refname>fileperms</refname>
+ <refpurpose>Gibt die Zugriffsrechte einer Datei aus</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fileperms</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Zugriffsrechte einer Datei zur�ck, oder FALSE wenn ein
+ Fehler auftrat.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.filesize">
+ <refnamediv>
+ <refname>filesize</refname>
+ <refpurpose>Gibt die Gr��e einer Datei aus</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>filesize</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die Gr��e einer Datei zur�ck, oder FALSE wenn ein Fehler
+ auftrat.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.filetype">
+ <refnamediv>
+ <refname>filetype</refname>
+ <refpurpose>Gibt den Typ einer Datei zur�ck</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>filetype</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt den Typ einer Datei zur�ck. M�gliche Werte sind fifo, char,
+ dir, block, link, file und unknown.
+ </para>
+ <para>
+ Gibt FALSE zur�ck, wenn ein Fehler auftrat.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.flock">
+ <refnamediv>
+ <refname>flock</refname>
+ <refpurpose>Portables Datei-Verriegelungs-Verfahren</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>flock</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>operation</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>wouldblock</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ PHP liefert einen portablen Weg, Dateien in einer "beratenden"
+ Art und Weise zu verriegeln. D.h. alle zugreifende Programme
+ m�ssen 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 w�hrend der Verriegelung durch
+ <function>flock</function> erlauben wollen, f�gen 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 UNICES- und Windows-Systemen).
+ 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) zur�ck.
+ </simpara>
+ <warning>
+ <para>
+ Bei den meisten Betriebssystemen ist <function>flock</function>
+ auf dem Prozesslevel implementiert. Wenn Sie ein multithreaded
+ Server API wie ISAPI benutzen k�nnen Sie sich nicht auf
+ <function>flock</function> verlassen, um Dateien vor anderen PHP-Scripten
+ zu sch�tzen, 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fopen</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>string <parameter>mode</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>use_include_path</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Wenn <parameter>filename</parameter> mit "http://"; (nicht case
+ sensitive) beginnt, wird zu dem spezifiziertem Server eine HTTP
+ 1.0 Connection ge�ffnet und ein Dateizeiger auf den Anfang des
+ Textes der Antwort zur�ckgegeben. Ein 'Host:' header wird mit der
+ Anfrage geschickt, um namens-basierte Virtual Hosts zu verarbeiten.
+ </simpara>
+ <simpara>
+ Weiterleitungen (HTTP Redirects) werden nicht unterst�tzt, die
+ Datei muss daher vollst�ndig und mit abschlie�endem "/"
+ beschrieben werden.
+ </simpara>
+ <simpara>
+ Wenn <parameter>filename</parameter> mit "ftp://"; (nicht case
+ sensitive) beginnt, wird eine ftp-Connection zu dem
+ spezifizierten Server ge�ffnet und ein Zeiger auf die
+ angeforderte Datei zur�ckgegeben. Wenn der Server keinen
+ passiven FTP-Modus unterst�tzt, wird diese Methode
+ fehlschlagen. Sie k�nnen Dateien entweder zum Schreiben oder zum
+ Lesen �ffnen, jedoch nicht f�r beides gleichzeitig.
+ </simpara>
+ <simpara>
+ Wenn <parameter>filename</parameter> "php://stdin",
+ "php://stdout", oder "php://stderr" ist, wird der
+ korrespondierende stdio stream ge�ffnet (Feature wurde in Version
+ 3.0.13 eingef�hrt, in fr�heren 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 ge�ffnet und ein
+ Dateizeiger auf die ge�ffnete Datei zur�ckgegeben.
+ </simpara>
+ <simpara>
+ Wenn das �ffnen scheitert, gibt die Funktion FALSE zur�ck.
+ </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 L�nge 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 L�nge 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>
+ Zus�tzlich kann <parameter>mode</parameter> der Buchstabe 'b'
+ hinzugef�gt werden, der die Behandlung von Bin�r-Dateien
+ erlaubt. Dies ist nur auf Systemen sinnvoll, welche zwischen Bin�r-
+ und Text-Dateien unterscheiden (z.B. Windows. Ist bei Unix sinnlos).
+ Wenn das Feature nicht gebraucht wird, wird es einfach ignoriert.
+ </para>
+ <para>
+ Sie k�nnen 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 m�chten.
+ </para>
+ <para>
+ <example>
+ <title>fopen() Beispiel</title>
+ <programlisting role="php">
+$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:[EMAIL PROTECTED]/";, "w");
+ </programlisting>
+ </example>
+ </para>
+ <simpara>
+ Wenn Sie Probleme mit dem Lesen oder Schreiben von Dateien haben
+ und PHP als Servermodul benutzen, stellen Sie zun�chst
+ sicher, dass die Dateien und Verzeichnisse die Sie benutzen
+ wollen auch f�r den Server-Proze� zug�nglich sind
+ (Rechtevergabe).
+ </simpara>
+ <para>
+ Achten Sie auf Windows-Systemen darauf, dass Sie als
+ Verzeichnistrenner normale Schr�gstriche '/' benutzen um
+ plattformunabh�ngig programmieren zu k�nnen. Sollten Sie dennoch
+ Backslashes verwenden, vergessen Sie nicht diese zu escapen '\\'
+ <informalexample>
+ <programlisting role="php">
+$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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fpassthru</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Die Funktion liest alle Daten vom Dateizeiger bis EOF aus und
+ gibt die Daten auf der Standartausgabe (Browser) aus.
+ </simpara>
+ <simpara>
+ Wenn ein Fehler auftritt, gibt <function>fpassthru</function>
+ FALSE zur�ck.
+ </simpara>
+ <simpara>
+ Der Dateizeiger muss g�ltig sein und auf eine erfolgreich durch
+ <function>fopen</function>, <function>popen</function> oder
+ <function>fsockopen</function> ge�ffnete Datei zeigen. Die Datei
+ wird geschlossen, wenn <function>fpassthru</function> die Datei
+ komplett gelesen hat (hinterl��t 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> ge�ffnet haben
+ m�ssen.
+ </simpara>
+ <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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fputs</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>string <parameter>str</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>length</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Fputs</function> ist ein Alias f�r 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 Bin�rdaten aus einer Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>fread</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>length</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ <function>Fread</function> liest <parameter>length</parameter>
+ Bytes vom Dateizeiger, maximal jedoch bis zum Dateiende.
+ </simpara>
+ <para>
+ <informalexample>
+ <programlisting role="php">
+// 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 Bin�r- und Textdateien (z.B. Windows)
+ unterscheiden, mu� die Datei mit 'b' im <function>fopen</function>
+ Mode-Parameter ge�ffnet werden.
+ </para>
+ </note>
+ <para>
+ <informalexample>
+ <programlisting role="php">
+$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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>mixed <function>fscanf</function></funcdef>
+ <paramdef>int <parameter>handle</parameter></paramdef>
+ <paramdef>string <parameter>format</parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>var1</optional></parameter>...
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 zur�ckgegeben. Werden auch optionale Parameter
+ �bergeben, gibt die Funktion die Anzahl der ermittelten Werte zur�ck.
+ Die optionalen Parameter m�ssen refenziert �bergeben werden.
+ <example>
+ <title><function>Fscanf</function> Beispiel</title>
+ <programlisting role="php">
+$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>
+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 um einen Offset 'offset' vor oder
+ zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fseek</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>offset</parameter></paramdef>
+ <paramdef>int <parameter><optional>whence</optional></parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 Hinzuf�gen 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>.</member>
+ </simplelist>
+ </para>
+ <para>Wenn <parameter>whence</parameter> nicht angegeben wurde, wird
+ SEEK_SET angenommen.
+ </para>
+ <para>
+ Bei Erfolg wird '0' zur�ckgegeben, 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 RC1
+ eingef�hrt.
+ </para>
+ </note>
+ <para>
+ Siehe auch <function>ftell</function> und
+ <function>rewind</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fstat">
+ <refnamediv>
+ <refname>fstat</refname>
+ <refpurpose>
+ �bergibt Informationen �ber eine Datei mit offenem Dateizeiger
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>fstat</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Tr�gt die Statistiken der mittel des Dateizeigers fp ge�ffneten
+ Datei zusammen. Diese Funktion ist �hnlich der Funktion
+ <function>stat</function>, au�er 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 zur�ck:
+ <orderedlist>
+ <listitem><simpara>Ger�t</simpara></listitem>
+ <listitem><simpara>Inode</simpara></listitem>
+ <listitem><simpara>Anzahl Links</simpara></listitem>
+ <listitem><simpara>User id des Eigent�mers</simpara></listitem>
+ <listitem><simpara>Gruppen id Eigent�mer</simpara></listitem>
+ <listitem><simpara>Ger�tetype wenn ein Inode-Ger�t *</simpara></listitem>
+ <listitem><simpara>Gr��e 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>Blockgr��e f�r Dateisystem I/O *</simpara></listitem>
+ <listitem><simpara>Anzahl der Bl�cke</simpara></listitem>
+ </orderedlist>
+ * - nur g�ltig bei Systemen, welche den st_blksize Typ unterst�tzen, andere
+ Systeme (z.B. Windows) geben -1 zur�ck</para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. Siehe
+ <function>clearstatcache</function> f�r 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ftell</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt die aktuelle Position des Dateizeigers
+ <parameter>fp</parameter> zur�ck, z.B. seinen Offset im
+ Dateistream.
+ </para>
+ <para>
+ Wenn ein Fehler auftritt, wird FALSE zur�ckgegeben.
+ </para>
+ <para>
+ Der Dateizeiger muss g�ltig sein und auf eine erfolgreich durch
+ <function>fopen</function> oder <function>popen</function>
+ ge�ffnete 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>
+ K�rzt eine Datei auf die angegebene L�nge
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>ftruncate</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>size</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Nimmt den Dateizeiger <parameter>fp</parameter>, und verk�rzt die
+ Datei auf die L�nge <parameter>size</parameter>.
+ Diese Funktion gibt bei Erfolg TRUE, ansonsten FALSE zur�ck.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.fwrite">
+ <refnamediv>
+ <refname>fwrite</refname>
+ <refpurpose>Schreibt Bin�rdaten in eine Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>fwrite</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>string <parameter>string</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>length</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ 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 Bin�r- und Textdateien (z.B. Windows)
+ unterscheiden, mu� die Datei mit 'b' im <function>fopen</function>
+ Mode-Parameter ge�ffnet 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 f�r einen gegebenen Dateizeiger
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>set_file_buffer</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ <paramdef>int <parameter>buffer</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Eine Ausgabe mittels <function>fwrite</function> wird normalerweise
+ mit 8k gepuffert. Das hei�t, 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 f�r
+ 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 k�nnen.
+ </simpara>
+ <simpara>
+ Die Funktion gibt bei Erfolg 0, oder EOF wenn die Anfrage nicht
+ erfolgreich war, zur�ck.
+ </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> Beispiel</title>
+ <programlisting role="php">
+$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>
+ Ermittelt, ob der gegebene Dateiname ein Verzeichnis ist
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_dir</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck, 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> f�r 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>
+ Ermittelt, ob eine Datei ausf�hrbar ist
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_executable</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck, wenn die Datei existiert und ausf�hrbar ist.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe auch <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar 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>
+ Ermittelt, ob der Dateiname eine regul�re Datei ist
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_file</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck, wenn die Datei existiert und eine regul�re
+ Datei ist.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe auch <function>clearstatcache</function> f�r 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>
+ Ermittelt, ob der Dateiname ein symbolischer Link ist
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_link</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck, 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> f�r weitere
+ Einzelheiten.
+ </para>
+ <para>
+ Siehe auch <function>is_dir</function> und
+ <function>is_file</function>.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ <note>
+ <simpara>
+ Diese Funktion hat auf Windows-Systemen keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.is-readable">
+ <refnamediv>
+ <refname>is_readable</refname>
+ <refpurpose>
+ Ermittelt ob eine Datei lesbar ist
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_readable</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck wenn die Datei existiert und sie lesbar ist.
+ </para>
+ <para>
+ Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
+ zugreift, unter der der Webserver l�uft (oftmals ist dieses
+ 'nobody'). Beschr�nkungen durch safe_mode werden nicht
+ ber�cksichtigt.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe auch <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ <para>
+ Siehe auch <function>is_writable</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.is-writable">
+ <refnamediv>
+ <refname>is_writable</refname>
+ <refpurpose>
+ Ermittelt, ob in eine Datei geschrieben werden kann
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_writable</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Gibt TRUE zur�ck, wenn die Datei existiert und nicht
+ schreibgesch�tzt ist. Das Dateinamen-Argument
+ <parameter>filename</parameter> kann ein Verzeichnisname
+ sein. So k�nnen Sie �berpr�fen, ob in ein Verzeichnis
+ geschrieben werden kann.
+ </para>
+ <para>
+ Bedenken Sie, dass PHP mit der Benutzer ID auf die Datei
+ zugreift, unter der der Webserver l�uft (oftmals ist dieses
+ 'nobody'). Beschr�nkungen durch safe_mode werden nicht
+ ber�cksichtigt.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe auch <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ <simpara>
+ Diese Funktion ist nicht f�r <link
+ linkend="features.remote-files">remote Dateien</link> geeignet, die zu
+ pr�fende Datei muss �ber das Dateisystem des Servers verf�gbar sein.
+ </simpara>
+ <para>
+ Siehe auch <function>is_readable</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.is-writeable">
+ <refnamediv>
+ <refname>is_writeable</refname>
+ <refpurpose>Ermittelt, ob in eine Datei geschrieben werden kann</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_writeable</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Dies ist ein Alias f�r <function>is_writable</function>
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.is-uploaded-file">
+ <refnamediv>
+ <refname>is_uploaded_file</refname>
+ <refpurpose>Ermittelt, ob die Datei mittels HTTP POST
+ upgeloaded wurde.</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>is_uploaded_file</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion ist nur in PHP 3 Versionen nach PHP 3.0.16, und
+ PHP 4 Versionen nach PHP 4.0.2 verf�gbar.
+ </para>
+
+ <para>
+ Gibt TRUE zur�ck, wenn die Datei <varname>filename</varname> mittels
+ HTTP POST upgeloaded wurde. Das ist hilfreich sicherzustellen, da�
+ kein b�swilliger User versucht hat das Script zu �berlisten, indem
+ er es Dateien bearbeiten l�sst, die es gar nicht bearbeiten sollte.
+ Zum Beispiel <filename>/etc/passwd</filename>.
+ </para>
+ <para>
+ Diese Pr�fung ist speziell dort interessant, wo irgendeine Aktion mit
+ upgeloadeten Dateien deren Inhalt dem User zug�nglich machen k�nnte
+ (oder auch anderen Usern auf dem selben System).
+ </para>
+ <para>
+ Siehe auch <function>move_uploaded_file</function>, und das Kapitel
+ <link linkend="features.file-upload">Steuerung von Dateiuploads</link>
+ f�r 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>link</function></funcdef>
+ <paramdef>string <parameter>target</parameter></paramdef>
+ <paramdef>string <parameter>link</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>
+ <simpara>
+ Diese Funktion hat unter Windows-Systemen keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.linkinfo">
+ <refnamediv>
+ <refname>linkinfo</refname>
+ <refpurpose>Ermittelt Informationen �ber einen Link</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>linkinfo</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Linkinfo</function> gibt das st_dev Feld des UNIX C
+ stat structure resultierend aus dem lstat System Call
+ zur�ck. Diese Funktion wird benutzt, um zu verifizieren ob ein
+ Link (auf den mit <parameter>path</parameter> gezeigt wird)
+ wirklich exisitiert (Hierbei wird die gleiche Methode benutzt,
+ die in dem S_ISLNK Makro in stat.h definiert ist). Gibt 0 oder
+ FALSE zur�ck wenn ein Fehler auftrat.
+ </para>
+ <para>
+ Siehe auch <function>symlink</function>,
+ <function>link</function>, und <function>readlink</function>.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat unter Windows keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.mkdir">
+ <refnamediv>
+ <refname>mkdir</refname>
+ <refpurpose>Erstellt ein Verzeichnis</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>mkdir</function></funcdef>
+ <paramdef>string <parameter>pathname</parameter></paramdef>
+ <paramdef>int <parameter>mode</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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.
+ <informalexample>
+ <programlisting role="php">
+mkdir ("/path/to/my/dir", 0700);
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ Gibt TRUE bei Erfolg, andernfalls FALSE zur�ck.
+ </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>bool <function>move_uploaded_file</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>string <parameter>destination</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Diese Funktion ist nur in PHP 3 Versionen nach PHP 3.0.16, und
+ PHP 4 Versionen nach PHP 4.0.2 verf�gbar.
+ </para>
+ <para>
+ Diese Funktion pr�ft, ob die mit <parameter>filename</parameter>
+ bezeichnete Datei eine g�ltige Upload-Datei ist (d.h., dass sie
+ mittels PHP's HTTP POST Upload-Mechanismus upgeloaded wurde).
+ Ist die Datei g�ltig, wird sie zum in
+ <parameter>destination</parameter> bezeichneten Dateinamen
+ verschoben.
+ </para>
+
+ <para>
+ Wenn <parameter>filename</parameter> keine g�ltige Datei ist, wird
+ keine Aktion ausgef�hrt, und
+ <function>move_uploaded_file</function> gibt
+ <literal>false</literal> zur�ck.
+ </para>
+
+ <para>
+ Wenn <parameter>filename</parameter> eine g�ltige Datei ist, jedoch
+ aus irgendeinem Grund nicht verschoben werden kann, wird keine
+ Aktion ausgef�hrt, und <function>move_uploaded_file</function>
+ gibt <literal>false</literal> zur�ck. Zus�tzlich wird eine Warnung
+ ausgegeben.
+ </para>
+
+ <para>
+ Diese Pr�fung ist speziell dort interessant, wo irgendeine Aktion mit
+ upgeloadeten Dateien deren Inhalt dem User zug�nglich machen k�nnte
+ (oder auch anderen Usern auf dem selben System).
+ </para>
+
+ <para>
+ Siehe auch <function>is_uploaded_file</function>, und das Kapitel
+ <link linkend="features.file-upload">Steuerung von Dateiuploads</link>
+ f�r ein einfaches Anwendungsbeispiel.
+ </para>
+ </refsect1>
+ </refentry>
+
+
+ <refentry id="function.pathinfo">
+ <refnamediv>
+ <refname>pathinfo</refname>
+ <refpurpose>Gibt Informationen �ber den Dateipfad</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>pathinfo</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>pathinfo</function> gibt ein assoziatives Array
+ mit Informationen �ber den Pfad <parameter>path</parameter>
+ zur�ck. Die folgenden Arrayelemente werden zur�ckgegeben:
+ den Verzeichnisnamen <parameter>dirname</parameter>, den Dateinamen
+ <parameter>basename</parameter>, und die Dateinamenserweiterung
+ <parameter>extension</parameter>.
+ </para>
+ <para>
+ <example>
+ <title><function>pathinfo</function> Beispiel</title>
+ <programlisting role="php">
+<?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>
+ W�rde ausgeben:
+ <informalexample>
+ <programlisting>
+/www/htdocs
+index.html
+html
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ Siehe auch <function>dirname</function>,
+ <function>basename</function> und <function>realpath</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.pclose">
+ <refnamediv>
+ <refname>pclose</refname>
+ <refpurpose>Schlie�t einen Prozess-Dateizeiger</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>pclose</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Schlie�t einen Prozess-Dateizeiger, der durch einen Aufruf von
+ <function>popen</function> ge�ffnet wurde.
+ </para>
+ <para>
+ Der Dateizeiger muss g�ltig sein und durch einen erfolgreichen
+ Funktionsaufruf von <function>popen</function> zur�ckgegeben
+ worden sein.
+ </para>
+ <para>
+ Gibt den End-Status eines laufenden Prozesses zur�ck.
+ </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>popen</function></funcdef>
+ <paramdef>string <parameter>command</parameter></paramdef>
+ <paramdef>string <parameter>mode</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ �ffnet eine Verbindung zu einem Prozess, der durch die Anweisung
+ <parameter>command</parameter> ausgef�hrt wurde.
+ </para>
+ <para>
+ Gibt einen Dateizeiger zur�ck, der identisch ist mit dem, der bei
+ der Funktion <function>fopen</function> zur�ckgegeben wird,
+ ausser 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 zur�ck.
+ </para>
+ <para>
+ <informalexample>
+ <programlisting role="php">
+$fp = popen ("/bin/ls", "r");
+ </programlisting>
+ </informalexample>
+ </para>
+ <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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>readfile</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>use_include_path</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Liest den Inhalt einer Datei und gibt ihn an der Standartausgabe
+ (Browser) aus.
+ </para>
+ <para>
+ Gibt die Anzahl der Bytes einer Datei zur�ck. Wenn ein Fehler
+ auftritt wird FALSE zur�ckgegeben 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 Connection zu dem
+ spezifiziertem Server ge�ffnet und der Text der Antwort wird auf
+ die Standartausgabe geschrieben.
+ </para>
+ <para>
+ Weiterleitungen (HTTP Redirects) werden nicht unterst�tzt, daher
+ muss die Datei vollst�ndig mit abschliessendem '/' geschrieben
+ werden.
+ </para>
+ <para>
+ Wenn <parameter>filename</parameter> mit "ftp://"; (nicht case
+ sensitive) beginnt, wird eine FTP-Connection zu dem
+ spezifiziertem Server ge�ffnet und die angeforderte Datei wird
+ auf der Standartausgabe ausgegeben. Wenn der Server keinen
+ passiven Mode unterst�tzt, wird diese Funktion fehlschlagen.
+ </para>
+ <para>
+ Wenn <parameter>filename</parameter> mit keinem dieser
+ Zeichenketten beginnt, wird die Datei vom lokalen Dateisystem
+ ge�ffnet und ihr Inhalt auf der Standartausgabe ausgegeben.
+ </para>
+ <para>
+ Sie k�nnen optional den zweiten Paratmeter benutzen und diesen
+ auf '1' setzen, wenn Sie auch im <link
+ linkend="ini.include-path"> include_path</link> nach der Datei
+ suchen m�chten.
+ </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>
+ Gibt das Ziel eines symbolischen Links zur�ck
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>readlink</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Readlink</function> ist von der Funktionalit�t her
+ identisch mit der 'readlink C Funktion' und gibt den Inhalt des
+ Pfades des symbolischen Links zur�ck oder 0, wenn der Aufruf
+ fehlschlug.
+ </para>
+ <para>
+ Siehe auch <function>symlink</function>,
+ <function>readlink</function> und <function>linkinfo</function>.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat unter Windows keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.rename">
+ <refnamediv>
+ <refname>rename</refname>
+ <refpurpose>Benennt eine Datei um</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>rename</function></funcdef>
+ <paramdef>string <parameter>oldname</parameter></paramdef>
+ <paramdef>string <parameter>newname</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Versucht eine Datei <parameter>oldname</parameter> in
+ <parameter>newname</parameter> umzubenennen.
+ </para>
+ <para>
+ Gibt TRUE bei Erfolg, andernfalls FALSE zur�ck.
+ </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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>rewind</function></funcdef>
+ <paramdef>int <parameter>fp</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Setzt den Dateizeiger (Datei-Positions-Indikator) f�r
+ <parameter>fp</parameter> an den Anfang des Dateistreams.
+ </para>
+ <para>
+ Wenn ein Fehler auftritt, gibt die Funktion 0 zur�ck.
+ </para>
+ <para>
+ Der Dateizeiger muss g�ltig sein und auf eine Datei zeigen, die
+ zuvor erfolgreich durch <function>fopen</function> ge�ffnet
+ wurde.
+ </para>
+ <para>
+ Siehe auch <function>fseek</function> und
+ <function>ftell</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.rmdir">
+ <refnamediv>
+ <refname>rmdir</refname>
+ <refpurpose>L�scht ein Verzeichnis</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>rmdir</function></funcdef>
+ <paramdef>string <parameter>dirname</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Versucht ein Verzeichnis spezifiziert durch die Pfadangabe zu
+ l�schen. Das Verzeichnis muss leer sein und die relevanten Rechte
+ m�ssen erteilt sein.
+ </para>
+ <para>
+ Wenn ein Fehler auftritt wird 0 zur�ckgegeben.
+ </para>
+ <para>
+ Siehe auch <function>mkdir</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.stat">
+ <refnamediv>
+ <refname>stat</refname>
+ <refpurpose>
+ Ermittelt diverse Informationen �ber eine Datei
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>stat</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Versucht Informationen �ber eine Datei spezifiziert in
+ <parameter>filename</parameter> auszugeben.
+ </para>
+ <para>
+ Gibt einen Array mit folgenden statistischen Informationen als
+ Array- Elemente zur�ck:
+ <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>Gr��e 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>Blockgr��e f�r das Dateisystem I/O *</simpara>
+ </listitem>
+ <listitem>
+ <simpara>Anzahl der zugewiesenen Bl�cke</simpara>
+ </listitem>
+ </orderedlist>
+ * - nur g�ltig auf Systemen, die st_blksize unterst�tzen. Andere
+ Systeme (z.B. Windows) geben '-1' zur�ck.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe auch <function>clearstatcache</function> f�r weitere
+ Einzelheiten.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.lstat">
+ <refnamediv>
+ <refname>lstat</refname>
+ <refpurpose>
+ Gibt Informationen �ber eine Datei oder einen symbolischen Link.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>array <function>lstat</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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>, ausser dass wenn der Parameter
+ <parameter>filename</parameter> ein symbolischer Link ist, dessen
+ Status zur�ckgegeben 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 zur�ck:
+ <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>Gr��e 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>Blockgr��e f�r das Dateisystem I/O *</simpara>
+ </listitem>
+ <listitem>
+ <simpara>Anzahl der zugewiesenen Bl�cke</simpara>
+ </listitem>
+ </orderedlist>
+ * - nur g�ltig auf Systemen, die st_blksize unterst�tzen. Andere
+ Systeme (z.B. Windows) geben '-1' zur�ck.
+ </para>
+ <para>
+ Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert.
+ Siehe auch <function>clearstatcache</function> f�r 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>realpath</function></funcdef>
+ <paramdef>string <parameter>path</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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 zur�ck. Der Pfad im Ergebnis enth�lt keine Komponenten
+ eines symbolischen Links mehr, wie '/./' or '/../'.
+ </para>
+
+ <para>
+ <example>
+ <title><function>realpath</function> Beispiel</title>
+ <programlisting role="php">
+$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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>symlink</function></funcdef>
+ <paramdef>string <parameter>target</parameter></paramdef>
+ <paramdef>string <parameter>link</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <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> zusammmen mit
+ <function>linkinfo</function>.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat unter Windows-Systemen keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.tempnam">
+ <refnamediv>
+ <refname>tempnam</refname>
+ <refpurpose>Erzeugt einen eindeutigen Dateinamen</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>tempnam</function></funcdef>
+ <paramdef>string <parameter>dir</parameter></paramdef>
+ <paramdef>string <parameter>prefix</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Erzeugt einen eindeutigen tempor�ren Dateinamen in dem
+ spezifizierten Verzeichnis. Wenn das Verzeichnis nicht existiert,
+ wird <function>tempnam</function> einen Dateinamen im tempor�ren
+ Verzeichnis des Systems erstellen.
+ </para>
+ <para>
+ Das Verhalten von <function>tempnam</function> ist
+ systemabh�ngig. Unter Windows wird die TMP-Umgebungsvariable den
+ <parameter>dir</parameter> Parameter �berschreiben, unter
+ Linux-Systemen hat die TMPDIR Umgebungsvariable Vorrang, w�hrend
+ 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 tempor�ren Dateinamen bei Erfolg, oder eine
+ NULL-Zeichenkette wenn ein Fehler auftritt zur�ck.
+ <example>
+ <title><function>Tempnam</function> Beispiel</title>
+ <programlisting role="php">
+$tmpfname = tempnam ("/tmp", "FOO");
+ </programlisting>
+ </example>
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat ihr Verhalten seit PHP 4.0.3 ge�ndert.
+ Die tempor�re 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 k�nnte.
+ </simpara>
+ </note>
+ <para>
+ Siehe auch <function>tmpfile</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.tmpfile">
+ <refnamediv>
+ <refname>tmpfile</refname>
+ <refpurpose>Legt eine tempor�re Datei an</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>tmpfile</function></funcdef>
+ <paramdef>void</paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Erstellt eine tempor�re Datei mit einem eindeutigen
+ Dateinamen im Schreibmodus und gibt einen Dateizeiger
+ �hnlich wie es bei der Funktion <function>fopen</function>
+ erfolgt, zur�ck. Die Datei wird automatisch gel�scht, wenn
+ sie geschlossen wird (mit <function>fclose</function>), oder
+ das Skript beendet wird.
+ </para>
+ <para>
+ F�r 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>
+ Siehe auch <function>tempnam</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.touch">
+ <refnamediv>
+ <refname>touch</refname>
+ <refpurpose>
+ Setzt das Datum der letzten �nderung einer Datei
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>touch</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ <paramdef>int
+ <parameter>
+ <optional>time</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Versucht das Datum der letzten Modifikation einer Datei
+ spezifiziert durch <parameter>filename</parameter> auf den Wert
+ spezifiziert durch <parameter>time</parameter> zu setzten. Wenn
+ die Option <parameter>time</parameter> nicht angegeben wurde,
+ benutzt die Funktion die aktuelle Zeit.
+ </para>
+ <para>
+ Wenn die Datei nicht existiert, wird sie erzeugt.
+ </para>
+ <para>
+ Gibt TRUE bei Erfolg, andernfalls FALSE zur�ck.
+ <example>
+ <title><function>Touch</function> Beispiel</title>
+ <programlisting role="php">
+if (touch ($DateiName)) {
+ print "$DateiName Modifizierungs-Zeit wurde auf das aktuelle
+ Datum und und die aktuelle Uhrzeit gesetzt.";
+} else {
+ print "Tut mir leid, Modifikations-Zeit von $DateiName konnte
+ nicht ge�ndert 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>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>umask</function></funcdef>
+ <paramdef>int <parameter>mask</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>Umask</function> setzt PHP's umask auf
+ <parameter>mask</parameter> & 0777 und gibt die alte umask
+ zur�ck. Wenn PHP als Servermodul benutzt wird, wird die umask
+ zur�ckgespeichert wenn die jeweilige Anfrage beendet ist.
+ </para>
+ <para>
+ <function>Umask</function> ohne Argumente gibt einfach die
+ aktuelle umask zur�ck.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion hat auf Windows-Systemen keinen Effekt.
+ </simpara>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.unlink">
+ <refnamediv>
+ <refname>unlink</refname>
+ <refpurpose>L�scht eine Datei</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>int <function>unlink</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ L�scht <parameter>filename</parameter>. �hnlich der UNIX C
+ unlink() Funktion.
+ </para>
+ <para>
+ Gibt 0 oder FALSE zur�ck, wenn ein Fehler auftritt.
+ </para>
+ <para>
+ Siehe auch <function>rmdir</function> um Verzeichnisse zu l�schen.
+ </para>
+ <note>
+ <simpara>
+ Diese Funktion k�nnte auf Windows-Systemen ohne Effekt bleiben.
+ </simpara>
+ </note>
+ </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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+
