cvs: phpdoc-de /reference/filesystem/functions chmod.xml file-get-contents.xml filemtime.xml filetype.xml fread.xml fscanf.xml fwrite.xml mkdir.xml
parse-ini-file.xml
| From: | Thomas Schoefbeck | Date: | Sat, 11 Jan 2003 09:47:40 +0000 |
| Subject: | cvs: phpdoc-de /reference/filesystem/functions chmod.xml file-get-contents.xml filemtime.xml filetype.xml fread.xml fscanf.xml fwrite.xml mkdir.xml parse-ini-file.xml |
||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-430@lists.php.net to get a copy of this message | ||
tom Sat Jan 11 04:47:40 2003 EDT
Modified files:
/phpdoc-de/reference/filesystem/functions chmod.xml
file-get-contents.xml
filemtime.xml
filetype.xml fread.xml
fscanf.xml fwrite.xml
mkdir.xml
parse-ini-file.xml
Log:
sync to en
Index: phpdoc-de/reference/filesystem/functions/chmod.xml diff -u phpdoc-de/reference/filesystem/functions/chmod.xml:1.5 phpdoc-de/reference/filesystem/functions/chmod.xml:1.6 --- phpdoc-de/reference/filesystem/functions/chmod.xml:1.5 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/chmod.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.chmod"> <refnamediv> <refname>chmod</refname> @@ -32,6 +32,45 @@ ]]> </programlisting> </informalexample> + </para> + <para> + Der <parameter>mode</parameter> Parameter besteht aus drei oktalen + Nummernteilen, welche die Zugriffsbeschränkungen für den Eigentümer, + die Benutzergruppe des Eigentümers, und allen anderen in dieser + Reihenfolge spezifiziert. Eine Komponente kann mittels Addition + derbenötigten Rechte für die gewünschten Benutzer berechnet werden. + Die Zahl 1 bedeutet das Recht zum Ausführen, die Zahl 2 bedeutet das + Recht zum Schreiben der Datei und mit der Zahl 4 machen Sie die Datei + lesbar. Addieren Sie diese Zahlen, um die benötigten Rechte zu + spezifizieren. Weitere Informationen zu den Modi finden Sie auf Unix + Systemen mit 'man 1 chmod' and 'man 2 chmod'. + <informalexample> + <programlisting role="php"> +<![CDATA[ +// Lesen und Schreiben für den Eigentümer, nichts für alle anderen +chmod ("/somedir/somefile", 0600); + +// Lesen und Schreiben für den Eigentümer, Lesen für alle anderen +chmod ("/somedir/somefile", 0644); + +// Alles für den Eigentümer, Lesen und Ausführen für andere +chmod ("/somedir/somefile", 0755); + +// Alles für den Eigentümer, Lesen und Ausführen für die +// Benutzergruppe des Eigentümers +chmod ("/somedir/somefile", 0750); +]]> + </programlisting> + </informalexample> + </para> + <para> + <note> + <para> + Der aktuelle Benutzer ist der, unter dem PHP läuft. Das ist + unter Umständen nicht der Benutzer, den Sie für normale + Shell- oder FTP-Zugriffe benutzen. + </para> + </note> </para> <para> &return.success; Index: phpdoc-de/reference/filesystem/functions/file-get-contents.xml diff -u phpdoc-de/reference/filesystem/functions/file-get-contents.xml:1.5 phpdoc-de/reference/filesystem/functions/file-get-contents.xml:1.6 --- phpdoc-de/reference/filesystem/functions/file-get-contents.xml:1.5 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/file-get-contents.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.file-get-contents"> <refnamediv> <refname>file_get_contents</refname> @@ -14,7 +14,7 @@ <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> </methodsynopsis> <para> - Diese Funktion ist mit <function>readfile</function> identisch, + Diese Funktion ist mit <function>file</function> identisch, außer dass <function>file_get_contents</function> die Datei in einem String zurückgibt. </para> Index: phpdoc-de/reference/filesystem/functions/filemtime.xml diff -u phpdoc-de/reference/filesystem/functions/filemtime.xml:1.3 phpdoc-de/reference/filesystem/functions/filemtime.xml:1.4 --- phpdoc-de/reference/filesystem/functions/filemtime.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/filemtime.xml Sat Jan 11 04:47:40 2003 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'filemtime' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.filemtime"> <refnamediv> <refname>filemtime</refname> @@ -20,7 +17,8 @@ <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. + wird als UNIX-Timestamp zurückgegeben, was für die Funktion + <function>date</function> sehr passend ist. </para> <para> Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. @@ -32,14 +30,31 @@ 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 + <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. Fußzeilen in Webseiten zu erhalten. + Änderung des Inhalts der Datei. + </para> + <para> + <example> + <title><function>filemtime</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Gibt z.B. aus: somefile.txt was last modified: December 29 2002 22:16:23. + +$filename = 'somefile.txt'; +if (file_exists($filename)) { + echo "$filename was last modified: " . date ("F d Y H:i:s.", filemtime($filename)); +} +?> +]]> + </programlisting> + </example> </para> <para> - Siehe auch <function>filectime</function> und <function>touch</function>. + Siehe auch <function>filectime</function>, <function>stat</function>, + <function>touch</function> und <function>getlastmod</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/filetype.xml diff -u phpdoc-de/reference/filesystem/functions/filetype.xml:1.4 phpdoc-de/reference/filesystem/functions/filetype.xml:1.5 --- phpdoc-de/reference/filesystem/functions/filetype.xml:1.4 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/filetype.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.filetype"> <refnamediv> <refname>filetype</refname> @@ -17,7 +17,9 @@ dir, block, link, file und unknown. </para> <para> - Gibt &false; zurück, wenn ein Fehler auftrat. + Gibt &false; zurück, wenn ein Fehler auftrat. <function>filetype</function> + erzeugt auch eine <constant>E_NOTICE</constant> Meldung, wenn der stat-Aufruf + fehlschlägt oder der Dateityp ubekannt ist. </para> <para> Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. Index: phpdoc-de/reference/filesystem/functions/fread.xml diff -u phpdoc-de/reference/filesystem/functions/fread.xml:1.3 phpdoc-de/reference/filesystem/functions/fread.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fread.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fread.xml Sat Jan 11 04:47:40 2003 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'fread' in en/ tree in rev 1.25 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.25 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.fread"> <refnamediv> <refname>fread</refname> @@ -17,18 +14,22 @@ <methodparam><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <simpara> - <function>fread</function> liest <parameter>length</parameter> - Bytes vom Dateizeiger, maximal jedoch bis zum Dateiende. + <function>fread</function> liest <parameter>length</parameter> Bytes + vom Dateizeiger <parameter>fp</parameter>. Das Lesen wird beendet, wenn + <parameter>length</parameter> Bytes gelesen oder EOF (end of file bzw. + Dateiende) erreicht wurde (was eben früher zutrifft). </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ +<?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> @@ -44,10 +45,12 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $filename = "c:\\files\\somepic.gif"; $fd = fopen ($filename, "rb"); $contents = fread ($fd, filesize ($filename)); fclose ($fd); +?> ]]> </programlisting> </informalexample> Index: phpdoc-de/reference/filesystem/functions/fscanf.xml diff -u phpdoc-de/reference/filesystem/functions/fscanf.xml:1.4 phpdoc-de/reference/filesystem/functions/fscanf.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fscanf.xml:1.4 Sat Oct 19 03:40:11 2002 +++ phpdoc-de/reference/filesystem/functions/fscanf.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> @@ -58,6 +58,13 @@ </programlisting> </example> </para> + <note> + <simpara> + Vor PHP 4.3.0 war die maximale Anzahl der von der Datei eingelesenen + Zeichen 512 (oder bis zu dem ersten \n, was zuerst eintrat). + Seit PHP 4.3.0 werden beliebig lange Zeilen gelesen und interprtiert. + </simpara> + </note> <para> Siehe auch <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, Index: phpdoc-de/reference/filesystem/functions/fwrite.xml diff -u phpdoc-de/reference/filesystem/functions/fwrite.xml:1.4 phpdoc-de/reference/filesystem/functions/fwrite.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fwrite.xml:1.4 Sat Oct 19 03:40:11 2002 +++ phpdoc-de/reference/filesystem/functions/fwrite.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.fwrite"> <refnamediv> <refname>fwrite</refname> @@ -25,7 +25,7 @@ </simpara> <simpara> <function>fwrite</function> gibt bei Erfolg die Anzahl der - geschriebenen Bytes zurück, andernfalls -1. + geschriebenen Bytes zurück, andernfalls &false;. </simpara> <simpara> Bedenken Sie, dass wenn der <parameter>length</parameter> Index: phpdoc-de/reference/filesystem/functions/mkdir.xml diff -u phpdoc-de/reference/filesystem/functions/mkdir.xml:1.3 phpdoc-de/reference/filesystem/functions/mkdir.xml:1.4 --- phpdoc-de/reference/filesystem/functions/mkdir.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/mkdir.xml Sat Jan 11 04:47:40 2003 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'mkdir' in en/ tree in rev 1.39 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.39 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.mkdir"> <refnamediv> <refname>mkdir</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>int</type><methodname>mkdir</methodname> <methodparam><type>string</type><parameter>pathname</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> Versucht ein Verzeichnis mit dem spezifiziertem Namen zu @@ -26,6 +23,18 @@ voranstehende Null haben sollte. Der Mode wird ebenfalls mit der aktuellen umask modifiziert, welchen Sie mittels <function>umask</function> ändern können. + </para> + <para> + <note> + <para> + Mode wird unter Windows ignoriert, und wurde in PHP 4.2.0 optional. + </para> + </note> + </para> + <para> + Mode ist standardmäßig 0777 was den weitestmöglichen Zugriff + bedeutet. Weitere Informationen zu den Modi finden Sie auf der + Seite <function>chmod</function>. <informalexample> <programlisting role="php"> <![CDATA[ Index: phpdoc-de/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.6 phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.7 --- phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.6 Sat Oct 19 03:40:11 2002 +++ phpdoc-de/reference/filesystem/functions/parse-ini-file.xml Sat Jan 11 04:47:40 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: tom Status: ready --> <refentry id="function.parse-ini-file"> <refnamediv> <refname>parse_ini_file</refname> - <refpurpose>Analysiert eine Konfiguratiionsdatei</refpurpose> + <refpurpose>Analysiert eine Konfigurationsdatei</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -47,14 +47,16 @@ <para> Die Struktur der ini Datei ist der von &php.ini; ähnlich. </para> - <warning> - <para> - Ist die zu parsende ini-Datei missgebildet, beendet PHP das Skript. - </para> - </warning> + <para> + <link linkend="language.constants">Konstanten</link> können in der ini + Datei ebenfalls geparsed werden. Wenn Sie eine Konstante als einen ini + Wert definieren bevor Sie <function>parse_ini_file</function> aufrufen, + wird diese in den Ergebnissen enthalten sein. Es werden nur ini Werte + ausgewertet. Zum Beispiel: + </para> <para> <example> - <title>Inhalt der sample.ini</title> + <title>Inhalt der <filename>sample.ini</filename></title> <programlisting> <![CDATA[ ; Dies ist ein Beispiel für eine Konfigurationsdatei @@ -63,6 +65,7 @@ [erste_gruppe] eins = 1 fünf = 5 +animal = BIRD [zweite_gruppe] pfad = /usr/local/bin @@ -78,6 +81,8 @@ <![CDATA[ <?php +define ('BIRD', 'Dodo bird'); + // Ohne Gruppen analysieren $ini_array = parse_ini_file("sample.ini"); print_r($ini_array); @@ -100,6 +105,7 @@ ( [eins] => 1 [fünf] => 5 + [animal] => Dodo bird [pfad] => /usr/local/bin [URL] => http://www.example.com/~username ) @@ -109,6 +115,7 @@ ( [eins] => 1 [fünf] => 5 + [animal] = Dodo bird ) [zweite_gruppe] => Array
Index: phpdoc-de/reference/filesystem/functions/chmod.xml diff -u phpdoc-de/reference/filesystem/functions/chmod.xml:1.5 phpdoc-de/reference/filesystem/functions/chmod.xml:1.6 --- phpdoc-de/reference/filesystem/functions/chmod.xml:1.5 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/chmod.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.chmod"> <refnamediv> <refname>chmod</refname> @@ -32,6 +32,45 @@ ]]> </programlisting> </informalexample> + </para> + <para> + Der <parameter>mode</parameter> Parameter besteht aus drei oktalen + Nummernteilen, welche die Zugriffsbeschränkungen für den Eigentümer, + die Benutzergruppe des Eigentümers, und allen anderen in dieser + Reihenfolge spezifiziert. Eine Komponente kann mittels Addition + derbenötigten Rechte für die gewünschten Benutzer berechnet werden. + Die Zahl 1 bedeutet das Recht zum Ausführen, die Zahl 2 bedeutet das + Recht zum Schreiben der Datei und mit der Zahl 4 machen Sie die Datei + lesbar. Addieren Sie diese Zahlen, um die benötigten Rechte zu + spezifizieren. Weitere Informationen zu den Modi finden Sie auf Unix + Systemen mit 'man 1 chmod' and 'man 2 chmod'. + <informalexample> + <programlisting role="php"> +<![CDATA[ +// Lesen und Schreiben für den Eigentümer, nichts für alle anderen +chmod ("/somedir/somefile", 0600); + +// Lesen und Schreiben für den Eigentümer, Lesen für alle anderen +chmod ("/somedir/somefile", 0644); + +// Alles für den Eigentümer, Lesen und Ausführen für andere +chmod ("/somedir/somefile", 0755); + +// Alles für den Eigentümer, Lesen und Ausführen für die +// Benutzergruppe des Eigentümers +chmod ("/somedir/somefile", 0750); +]]> + </programlisting> + </informalexample> + </para> + <para> + <note> + <para> + Der aktuelle Benutzer ist der, unter dem PHP läuft. Das ist + unter Umständen nicht der Benutzer, den Sie für normale + Shell- oder FTP-Zugriffe benutzen. + </para> + </note> </para> <para> &return.success; Index: phpdoc-de/reference/filesystem/functions/file-get-contents.xml diff -u phpdoc-de/reference/filesystem/functions/file-get-contents.xml:1.5 phpdoc-de/reference/filesystem/functions/file-get-contents.xml:1.6 --- phpdoc-de/reference/filesystem/functions/file-get-contents.xml:1.5 Sat Oct 12 10:11:33 2002 +++ phpdoc-de/reference/filesystem/functions/file-get-contents.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.file-get-contents"> <refnamediv> <refname>file_get_contents</refname> @@ -14,7 +14,7 @@ <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> </methodsynopsis> <para> - Diese Funktion ist mit <function>readfile</function> identisch, + Diese Funktion ist mit <function>file</function> identisch, außer dass <function>file_get_contents</function> die Datei in einem String zurückgibt. </para> Index: phpdoc-de/reference/filesystem/functions/filemtime.xml diff -u phpdoc-de/reference/filesystem/functions/filemtime.xml:1.3 phpdoc-de/reference/filesystem/functions/filemtime.xml:1.4 --- phpdoc-de/reference/filesystem/functions/filemtime.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/filemtime.xml Sat Jan 11 04:47:40 2003 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'filemtime' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.filemtime"> <refnamediv> <refname>filemtime</refname> @@ -20,7 +17,8 @@ <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. + wird als UNIX-Timestamp zurückgegeben, was für die Funktion + <function>date</function> sehr passend ist. </para> <para> Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. @@ -32,14 +30,31 @@ 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 + <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. Fußzeilen in Webseiten zu erhalten. + Änderung des Inhalts der Datei. + </para> + <para> + <example> + <title><function>filemtime</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Gibt z.B. aus: somefile.txt was last modified: December 29 2002 22:16:23. + +$filename = 'somefile.txt'; +if (file_exists($filename)) { + echo "$filename was last modified: " . date ("F d Y H:i:s.", filemtime($filename)); +} +?> +]]> + </programlisting> + </example> </para> <para> - Siehe auch <function>filectime</function> und <function>touch</function>. + Siehe auch <function>filectime</function>, <function>stat</function>, + <function>touch</function> und <function>getlastmod</function>. </para> </refsect1> </refentry> Index: phpdoc-de/reference/filesystem/functions/filetype.xml diff -u phpdoc-de/reference/filesystem/functions/filetype.xml:1.4 phpdoc-de/reference/filesystem/functions/filetype.xml:1.5 --- phpdoc-de/reference/filesystem/functions/filetype.xml:1.4 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/filetype.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> <refentry id="function.filetype"> <refnamediv> <refname>filetype</refname> @@ -17,7 +17,9 @@ dir, block, link, file und unknown. </para> <para> - Gibt &false; zurück, wenn ein Fehler auftrat. + Gibt &false; zurück, wenn ein Fehler auftrat. <function>filetype</function> + erzeugt auch eine <constant>E_NOTICE</constant> Meldung, wenn der stat-Aufruf + fehlschlägt oder der Dateityp ubekannt ist. </para> <para> Das Ergebnis dieses Funktionsaufrufes wird zwischengespeichert. Index: phpdoc-de/reference/filesystem/functions/fread.xml diff -u phpdoc-de/reference/filesystem/functions/fread.xml:1.3 phpdoc-de/reference/filesystem/functions/fread.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fread.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fread.xml Sat Jan 11 04:47:40 2003 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'fread' in en/ tree in rev 1.25 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.25 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> <refentry id="function.fread"> <refnamediv> <refname>fread</refname> @@ -17,18 +14,22 @@ <methodparam><type>int</type><parameter>length</parameter></methodparam> </methodsynopsis> <simpara> - <function>fread</function> liest <parameter>length</parameter> - Bytes vom Dateizeiger, maximal jedoch bis zum Dateiende. + <function>fread</function> liest <parameter>length</parameter> Bytes + vom Dateizeiger <parameter>fp</parameter>. Das Lesen wird beendet, wenn + <parameter>length</parameter> Bytes gelesen oder EOF (end of file bzw. + Dateiende) erreicht wurde (was eben früher zutrifft). </simpara> <para> <informalexample> <programlisting role="php"> <![CDATA[ +<?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> @@ -44,10 +45,12 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $filename = "c:\\files\\somepic.gif"; $fd = fopen ($filename, "rb"); $contents = fread ($fd, filesize ($filename)); fclose ($fd); +?> ]]> </programlisting> </informalexample> Index: phpdoc-de/reference/filesystem/functions/fscanf.xml diff -u phpdoc-de/reference/filesystem/functions/fscanf.xml:1.4 phpdoc-de/reference/filesystem/functions/fscanf.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fscanf.xml:1.4 Sat Oct 19 03:40:11 2002 +++ phpdoc-de/reference/filesystem/functions/fscanf.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.4 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> @@ -58,6 +58,13 @@ </programlisting> </example> </para> + <note> + <simpara> + Vor PHP 4.3.0 war die maximale Anzahl der von der Datei eingelesenen + Zeichen 512 (oder bis zu dem ersten \n, was zuerst eintrat). + Seit PHP 4.3.0 werden beliebig lange Zeilen gelesen und interprtiert. + </simpara> + </note> <para> Siehe auch <function>fread</function>, <function>fgets</function>, <function>fgetss</function>, <function>sscanf</function>, Index: phpdoc-de/reference/filesystem/functions/fwrite.xml diff -u phpdoc-de/reference/filesystem/functions/fwrite.xml:1.4 phpdoc-de/reference/filesystem/functions/fwrite.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fwrite.xml:1.4 Sat Oct 19 03:40:11 2002 +++ phpdoc-de/reference/filesystem/functions/fwrite.xml Sat Jan 11 04:47:40 2003 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.5 Maintainer: tom Status: ready --> <refentry id="function.fwrite"> <refnamediv> <refname>fwrite</refname> @@ -25,7 +25,7 @@ </simpara> <simpara> <function>fwrite</function> gibt bei Erfolg die Anzahl der - geschriebenen Bytes zurück, andernfalls -1. + geschriebenen Bytes zurück, andernfalls &false;. </simpara> <simpara> Bedenken Sie, dass wenn der <parameter>length</parameter> Index: phpdoc-de/reference/filesystem/functions/mkdir.xml diff -u phpdoc-de/reference/filesystem/functions/mkdir.xml:1.3 phpdoc-de/reference/filesystem/functions/mkdir.xml:1.4 --- phpdoc-de/reference/filesystem/functions/mkdir.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/mkdir.xml Sat Jan 11 04:47:40 2003 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'mkdir' in en/ tree in rev 1.39 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.39 --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: tom Status: ready --> <refentry id="function.mkdir"> <refnamediv> <refname>mkdir</refname> @@ -14,7 +11,7 @@ <methodsynopsis> <type>int</type><methodname>mkdir</methodname> <methodparam><type>string</type><parameter>pathname</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>mode</parameter></methodparam> </methodsynopsis> <para> Versucht ein Verzeichnis mit dem spezifiziertem Namen zu @@ -26,6 +23,18 @@ voranstehende Null haben sollte. Der Mode wird ebenfalls mit der aktuellen umask modifiziert, welchen Sie mittels <function>umask</function> ändern können. + </para> + <para> + <note> + <para> + Mode wird unter Windows ignoriert, und wurde in PHP 4.2.0 optional. + </para> + </note> + </para> + <para> + Mode ist standardmäßig 0777 was den weitestmöglichen Zugriff + bedeutet. Weitere Informationen zu den Modi finden Sie auf der + Seite <function>chmod</function>. <informalexample> <programlisting role="php"> <![CDATA[ Index: phpdoc-de/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.6 phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.7 --- phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.6 Sat Oct 19 03:40:11 2002 +++ phpdoc-de/reference/filesystem/functions/parse-ini-file.xml Sat Jan 11 04:47:40 2003 @@ -1,10 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.6 Maintainer: tom Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.10 Maintainer: tom Status: ready --> <refentry id="function.parse-ini-file"> <refnamediv> <refname>parse_ini_file</refname> - <refpurpose>Analysiert eine Konfiguratiionsdatei</refpurpose> + <refpurpose>Analysiert eine Konfigurationsdatei</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -47,14 +47,16 @@ <para> Die Struktur der ini Datei ist der von &php.ini; ähnlich. </para> - <warning> - <para> - Ist die zu parsende ini-Datei missgebildet, beendet PHP das Skript. - </para> - </warning> + <para> + <link linkend="language.constants">Konstanten</link> können in der ini + Datei ebenfalls geparsed werden. Wenn Sie eine Konstante als einen ini + Wert definieren bevor Sie <function>parse_ini_file</function> aufrufen, + wird diese in den Ergebnissen enthalten sein. Es werden nur ini Werte + ausgewertet. Zum Beispiel: + </para> <para> <example> - <title>Inhalt der sample.ini</title> + <title>Inhalt der <filename>sample.ini</filename></title> <programlisting> <![CDATA[ ; Dies ist ein Beispiel für eine Konfigurationsdatei @@ -63,6 +65,7 @@ [erste_gruppe] eins = 1 fünf = 5 +animal = BIRD [zweite_gruppe] pfad = /usr/local/bin @@ -78,6 +81,8 @@ <![CDATA[ <?php +define ('BIRD', 'Dodo bird'); + // Ohne Gruppen analysieren $ini_array = parse_ini_file("sample.ini"); print_r($ini_array); @@ -100,6 +105,7 @@ ( [eins] => 1 [fünf] => 5 + [animal] => Dodo bird [pfad] => /usr/local/bin [URL] => http://www.example.com/~username ) @@ -109,6 +115,7 @@ ( [eins] => 1 [fünf] => 5 + [animal] = Dodo bird ) [zweite_gruppe] => Array