cvs: phpdoc-de /reference/filesystem/functions fopen.xml fpassthru.xml fscanf.xml fwrite.xml is-dir.xml parse-ini-file.xml
| From: | Thomas Schoefbeck | Date: | Sat, 19 Oct 2002 07:40:11 +0000 |
| Subject: | cvs: phpdoc-de /reference/filesystem/functions fopen.xml fpassthru.xml fscanf.xml fwrite.xml is-dir.xml parse-ini-file.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-310@lists.php.net to get a copy of this message | ||
tom Sat Oct 19 03:40:11 2002 EDT
Modified files:
/phpdoc-de/reference/filesystem/functions fopen.xml fpassthru.xml
fscanf.xml fwrite.xml
is-dir.xml
parse-ini-file.xml
Log:
sync to en
Index: phpdoc-de/reference/filesystem/functions/fopen.xml diff -u phpdoc-de/reference/filesystem/functions/fopen.xml:1.3 phpdoc-de/reference/filesystem/functions/fopen.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fopen.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fopen.xml Sat Oct 19 03:40:10 2002 @@ -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 'fopen' 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.5 Maintainer: tom Status: ready --> <refentry id="function.fopen"> <refnamediv> <refname>fopen</refname> @@ -15,72 +12,47 @@ <type>int</type><methodname>fopen</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - use_include_path - </parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>zcontext</parameter></methodparam> </methodsynopsis> <simpara> - Wenn <parameter>filename</parameter> mit "http://" (nicht case - sensitive) beginnt, wird zu dem spezifiziertem Server eine HTTP - 1.0 Verbindung geöffnet, die Seite mittels der HTTP GET Methode - angefordert, 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> - Ab PHP 4.3.0 (noch nicht freigegeben) können Sie eine HTTP Verbindung - über SSL mit "https://" verwenden, wenn Sie PHP mit Unterstützung für - OpenSSL kompiliert haben. - </simpara> - <simpara> - Beachten Sie, dass Ihnen der Dateizeiger nur den Empfang des - <emphasis>body</emphasis> aus der Antwort erlaubt. Um den HTTP - Antwortheader zu erhalten, benötigen Sie PHP ab Version 4.0.5. Die - Headers werden in der Variable $http_response_header gespeichert. - Ab PHP 4.3.0 (noch nicht freigegeben) kann die Header Information - mittels <function>file_get_wrapper_data</function> geholt werden. - </simpara> - <simpara> - HTTP Verbindungen sind nur zum Lesen, d.h. Sie können keine Daten - schreiben oder Dateien an eine HTTP Ressource kopieren. - </simpara> - <simpara> - In älteren Versionen als PHP 4.0.5 werden Weiterleitungen (HTTP - Redirects) nicht unterstützt, hier muss die Datei 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. Wenn die - entfernte Datei bereits auf dem FTP-Server existiert und Sie - versuchen sie zum Schreiben zu öffnen, wird das nicht funktionieren. - Wenn Sie bestehende Dateien über FTP aktualisieren wollen, verwenden - Sie <function>ftp_connect</function>. - </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> + <function>fopen</function> bindet eine benannte Resource, welche + mittels <parameter>filename</parameter> spezifiziert wurde, an einen + Stream. Hat <parameter>filename</parameter> die Form "schema://..." + wird angenommen, dass es sich hier um eine URL handelt und PHP sucht + nach einem Protokollhandler (auch als Wrapper bekannt) für dieses + Schema. Sind keine Wrapper für dieses Protokoll registriert, gibt + PHP als Hilfe zum Verfolgen potentieller Probleme in Ihrem Skript + einen Hinweis aus und setzt dann weiter fort, obwohl + <parameter>filename</parameter> eine reguläre Datei spezifiziert. + </simpara> + <simpara> + Ist PHP zu dem Schluss gekommen, dass <parameter>filename</parameter> + eine lokale Datei spezifiziert, wird es versuchen, einen Stream + an dieser Datei zu öffnen. Die Datei muss für PHP verfügbar sein, + weshalb Sie sicherstellen müssen, dass die Dateirechte diesen + Zugriff ermöglichen. Wenn Sie <link + linkend="ini.safe-mode">safe_mode</link> oder <link + linkend="ini.open-basedir">open_basedir</link> aktiviert haben, + können weitere Einschränkungen zutreffen. + </simpara> + <simpara> + Kam PHP zum Schluss, dass es sich bei <parameter>filename</parameter> + um ein registriertes Protokoll handelt, und ist dieses Protokoll + als eine Netzwerk URL registriert, prüft PHP, ob <link + linkend="ini.allow-url-fopen">allow_url_fopen</link> aktiviert ist. + Ist es nicht aktiviert, gibt PHP eine Warnung aus, und der + Aufruf von fopen wird scheitern. + </simpara> + <note> + <simpara> + Die Liste der unterstützten Wrapper finden Sie unter + <xref linkend="wrappers"/>. + </simpara> + </note> <para> - <parameter>mode</parameter> kann einen der folgenden Werte - einnehmen: + <parameter>mode</parameter> spezifiziert den von Ihnen gewünschten + Zugriffstyp auf den Stream, kann die folgenden Werte haben: <itemizedlist> <listitem> <simpara> @@ -130,22 +102,32 @@ 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. + Sie sollten den 'b' Flag verwenden, um Ihre Skripte portabler zu + machen. + </para> + <para> + Sie können den optionalen Parameter <parameter>use_include_path</parameter> + auf '1' oder &true; setzten, wenn Sie die Datei auch im <link + linkend="ini.include-path">include_path</link> suchen möchten. </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. + Der optionale vierte Parameter <parameter>zcontext</parameter> wird + zur Spezifikation von Einstellungsparametern und Callbacks verwendet. </para> + <simpara> + Scheitert das Öffnen der Datei, gibt die Funktion &false; zurück. + </simpara> <para> <example> - <title>fopen()</title> + <title><function>fopen</function></title> <programlisting role="php"> <![CDATA[ -$fp = fopen ("/home/simi/simi.txt", "r"); -$fp = fopen ("/home/simi/simi.gif", "wb"); +<?php +$fp = fopen ("/home/rasmus/file.txt", "r"); +$fp = fopen ("/home/rasmus/file.gif", "wb"); $fp = fopen ("http://www.example.com/", "r"); $fp = fopen ("ftp://user:password@example.com/", "w"); +?> ]]> </programlisting> </example> @@ -165,15 +147,22 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $fp = fopen ("c:\\data\\info.txt", "r"); +?> ]]> </programlisting> </informalexample> </para> <simpara> - Siehe auch <function>fclose</function>, + Siehe auch <xref linkend="wrappers"/>, + <function>fclose</function>, + <function>fgets</function>, <function>fsockopen</function>, - <function>socket_set_timeout</function>, und + <function>file</function>, + <function>file_exists</function>, + <function>is_readable</function>, + <function>socket_set_timeout</function> und <function>popen</function>. </simpara> </refsect1> Index: phpdoc-de/reference/filesystem/functions/fpassthru.xml diff -u phpdoc-de/reference/filesystem/functions/fpassthru.xml:1.4 phpdoc-de/reference/filesystem/functions/fpassthru.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fpassthru.xml:1.4 Mon Aug 26 08:41:26 2002 +++ phpdoc-de/reference/filesystem/functions/fpassthru.xml Sat Oct 19 03:40:11 2002 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'fpassthru' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.fpassthru"> <refnamediv> <refname>fpassthru</refname> @@ -19,7 +16,7 @@ </methodsynopsis> <simpara> Die Funktion liest alle Daten von der aktuellen Position des Dateizeigers - bis EOF aus und gibt die Daten auf der Standardausgabe (Browser) aus. + bis EOF aus und schreibt die Daten in den Ausgabepuffer. </simpara> <simpara> Wenn ein Fehler auftritt, gibt <function>fpassthru</function> @@ -36,18 +33,22 @@ (hinterlässt nutzlosen <parameter>fp</parameter>-Dateizeiger). </simpara> <simpara> - Wenn Sie den Inhalt einer Datei nur auf der Standardausgabe - (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. + Wenn Sie den Inhalt einer Datei nur nur in den Ausgabepuffer schreiben + wollen ohne diese ändern bzw. an eine bestimmte Stelle gehen wollen, + sollten Sie besser <function>readfile</function> benutzen, bei der + Sie sich den Aufruf von <function>fopen</function> ersparen. </simpara> <note> <para> Wenn Sie <function>fpassthru</function> auf eine binäre Datei unter Windows anwenden, sollten Sie sicherstellen, dass die Datei - im Binärmodus geöffnet wurde, indem Sie ein <literal>b</literal> an den - Mode-Parameter von <function>fopen</function> anhängen. + im Binärmodus geöffnet wurde, indem Sie ein <literal>b</literal> an + den Mode-Parameter von <function>fopen</function> anhängen. + </para> + <para> + Auch wenn es Ihr System nicht verlangt, sollten Sie den + <literal>b</literal> Flag bei Binärdateien verwenden, um die + Portabilität Ihrer Skripte zu erhöhen. </para> </note> <simpara> Index: phpdoc-de/reference/filesystem/functions/fscanf.xml diff -u phpdoc-de/reference/filesystem/functions/fscanf.xml:1.3 phpdoc-de/reference/filesystem/functions/fscanf.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fscanf.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fscanf.xml Sat Oct 19 03:40:11 2002 @@ -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 'fscanf' 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.4 Maintainer: tom Status: ready --> <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> @@ -27,6 +24,15 @@ 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 referenziert übergeben werden. + </para> + <para> + Irgendwelche Whitespace-Zeichen (z.B. Leerzeichen, Tabulator, etc.) + im Format String gelten mit irgendwelchen Whitespace-Zeichen des + Input-Streams als übereinstimmend. Das heißt, dass auch ein + Tabulator <literal>\t</literal> im Format String mit einem einzigen + Leerzeichen im Input-Stream als übereinstimmend gelten kann. + </para> + <para> <example> <title><function>fscanf</function></title> <programlisting role="php"> Index: phpdoc-de/reference/filesystem/functions/fwrite.xml diff -u phpdoc-de/reference/filesystem/functions/fwrite.xml:1.3 phpdoc-de/reference/filesystem/functions/fwrite.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fwrite.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fwrite.xml Sat Oct 19 03:40:11 2002 @@ -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 'fwrite' 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.fwrite"> <refnamediv> <refname>fwrite</refname> @@ -45,6 +42,44 @@ Mode-Parameter geöffnet werden. </para> </note> + <para> + <example> + <title>Ein einfaches Beispiel für fwrite</title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = 'test.txt'; +$somecontent = "Add this to the file\n"; + +// Sichergehen, dass die Datei existiert und beschreibbar ist +if (is_writable($filename)) { + + // Wir öffnen $filename im "Anhänge" - Modus. + // Der Dateizeiger befindet sich am Ende der Datei, und + // dort wird $somecontent später mit fwrite() geschrieben. + if (!$fp = fopen($filename, 'a')) { + print "Cannot open file ($filename)"; + exit; + } + + // Schreibe $somecontent in die geöffnete Datei. + if (!fwrite($fp, $somecontent)) { + print "Cannot write to file ($filename)"; + exit; + } + + print "Success, wrote ($somecontent) to file ($filename)"; + + fclose($fp); + +} else { + print "The file $filename is not writable"; +} +?> +]]> + </programlisting> + </example> + </para> <simpara> Siehe auch <function>fread</function>, <function>fopen</function>, <function>fsockopen</function>, Index: phpdoc-de/reference/filesystem/functions/is-dir.xml diff -u phpdoc-de/reference/filesystem/functions/is-dir.xml:1.4 phpdoc-de/reference/filesystem/functions/is-dir.xml:1.5 --- phpdoc-de/reference/filesystem/functions/is-dir.xml:1.4 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/is-dir.xml Sat Oct 19 03:40:11 2002 @@ -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.is-dir"> <refnamediv> <refname>is_dir</refname> @@ -26,7 +26,8 @@ Einzelheiten. </para> <para> - Siehe auch <function>chdir</function>, <function>is_file</function> und + Siehe auch <function>chdir</function>, <link linkend="class.dir">dir</link>, + <function>opendir</function>, <function>is_file</function> und <function>is_link</function>. </para> </refsect1> Index: phpdoc-de/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.5 phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.6 --- phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.5 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/parse-ini-file.xml Sat Oct 19 03:40:11 2002 @@ -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.parse-ini-file"> <refnamediv> <refname>parse_ini_file</refname> @@ -32,6 +32,12 @@ </para> </note> <note> + <para> + Enthält ein Wert in der ini Datei nicht alphanumerische Zeichen, so + muss dieser von doppelten Anführungszeichen (") eingeschlossen sein. + </para> + </note> + <note> <simpara> Seit PHP 4.2.1 wird diese Funktion auch von <link linkend="ini.safe-mode">safe_mode</link> und <link @@ -60,6 +66,7 @@ [zweite_gruppe] pfad = /usr/local/bin +URL = "http://www.example.com/~username" ]]> </programlisting> </example> @@ -94,6 +101,7 @@ [eins] => 1 [fünf] => 5 [pfad] => /usr/local/bin + [URL] => http://www.example.com/~username ) Array ( @@ -106,6 +114,7 @@ [zweite_gruppe] => Array ( [pfad] => /usr/local/bin + [URL] => http://www.example.com/~username ) )
Index: phpdoc-de/reference/filesystem/functions/fopen.xml diff -u phpdoc-de/reference/filesystem/functions/fopen.xml:1.3 phpdoc-de/reference/filesystem/functions/fopen.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fopen.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fopen.xml Sat Oct 19 03:40:10 2002 @@ -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 'fopen' 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.5 Maintainer: tom Status: ready --> <refentry id="function.fopen"> <refnamediv> <refname>fopen</refname> @@ -15,72 +12,47 @@ <type>int</type><methodname>fopen</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter> - use_include_path - </parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>use_include_path</parameter></methodparam> + <methodparam choice="opt"><type>resource</type><parameter>zcontext</parameter></methodparam> </methodsynopsis> <simpara> - Wenn <parameter>filename</parameter> mit "http://" (nicht case - sensitive) beginnt, wird zu dem spezifiziertem Server eine HTTP - 1.0 Verbindung geöffnet, die Seite mittels der HTTP GET Methode - angefordert, 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> - Ab PHP 4.3.0 (noch nicht freigegeben) können Sie eine HTTP Verbindung - über SSL mit "https://" verwenden, wenn Sie PHP mit Unterstützung für - OpenSSL kompiliert haben. - </simpara> - <simpara> - Beachten Sie, dass Ihnen der Dateizeiger nur den Empfang des - <emphasis>body</emphasis> aus der Antwort erlaubt. Um den HTTP - Antwortheader zu erhalten, benötigen Sie PHP ab Version 4.0.5. Die - Headers werden in der Variable $http_response_header gespeichert. - Ab PHP 4.3.0 (noch nicht freigegeben) kann die Header Information - mittels <function>file_get_wrapper_data</function> geholt werden. - </simpara> - <simpara> - HTTP Verbindungen sind nur zum Lesen, d.h. Sie können keine Daten - schreiben oder Dateien an eine HTTP Ressource kopieren. - </simpara> - <simpara> - In älteren Versionen als PHP 4.0.5 werden Weiterleitungen (HTTP - Redirects) nicht unterstützt, hier muss die Datei 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. Wenn die - entfernte Datei bereits auf dem FTP-Server existiert und Sie - versuchen sie zum Schreiben zu öffnen, wird das nicht funktionieren. - Wenn Sie bestehende Dateien über FTP aktualisieren wollen, verwenden - Sie <function>ftp_connect</function>. - </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> + <function>fopen</function> bindet eine benannte Resource, welche + mittels <parameter>filename</parameter> spezifiziert wurde, an einen + Stream. Hat <parameter>filename</parameter> die Form "schema://..." + wird angenommen, dass es sich hier um eine URL handelt und PHP sucht + nach einem Protokollhandler (auch als Wrapper bekannt) für dieses + Schema. Sind keine Wrapper für dieses Protokoll registriert, gibt + PHP als Hilfe zum Verfolgen potentieller Probleme in Ihrem Skript + einen Hinweis aus und setzt dann weiter fort, obwohl + <parameter>filename</parameter> eine reguläre Datei spezifiziert. + </simpara> + <simpara> + Ist PHP zu dem Schluss gekommen, dass <parameter>filename</parameter> + eine lokale Datei spezifiziert, wird es versuchen, einen Stream + an dieser Datei zu öffnen. Die Datei muss für PHP verfügbar sein, + weshalb Sie sicherstellen müssen, dass die Dateirechte diesen + Zugriff ermöglichen. Wenn Sie <link + linkend="ini.safe-mode">safe_mode</link> oder <link + linkend="ini.open-basedir">open_basedir</link> aktiviert haben, + können weitere Einschränkungen zutreffen. + </simpara> + <simpara> + Kam PHP zum Schluss, dass es sich bei <parameter>filename</parameter> + um ein registriertes Protokoll handelt, und ist dieses Protokoll + als eine Netzwerk URL registriert, prüft PHP, ob <link + linkend="ini.allow-url-fopen">allow_url_fopen</link> aktiviert ist. + Ist es nicht aktiviert, gibt PHP eine Warnung aus, und der + Aufruf von fopen wird scheitern. + </simpara> + <note> + <simpara> + Die Liste der unterstützten Wrapper finden Sie unter + <xref linkend="wrappers"/>. + </simpara> + </note> <para> - <parameter>mode</parameter> kann einen der folgenden Werte - einnehmen: + <parameter>mode</parameter> spezifiziert den von Ihnen gewünschten + Zugriffstyp auf den Stream, kann die folgenden Werte haben: <itemizedlist> <listitem> <simpara> @@ -130,22 +102,32 @@ 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. + Sie sollten den 'b' Flag verwenden, um Ihre Skripte portabler zu + machen. + </para> + <para> + Sie können den optionalen Parameter <parameter>use_include_path</parameter> + auf '1' oder &true; setzten, wenn Sie die Datei auch im <link + linkend="ini.include-path">include_path</link> suchen möchten. </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. + Der optionale vierte Parameter <parameter>zcontext</parameter> wird + zur Spezifikation von Einstellungsparametern und Callbacks verwendet. </para> + <simpara> + Scheitert das Öffnen der Datei, gibt die Funktion &false; zurück. + </simpara> <para> <example> - <title>fopen()</title> + <title><function>fopen</function></title> <programlisting role="php"> <![CDATA[ -$fp = fopen ("/home/simi/simi.txt", "r"); -$fp = fopen ("/home/simi/simi.gif", "wb"); +<?php +$fp = fopen ("/home/rasmus/file.txt", "r"); +$fp = fopen ("/home/rasmus/file.gif", "wb"); $fp = fopen ("http://www.example.com/", "r"); $fp = fopen ("ftp://user:password@example.com/", "w"); +?> ]]> </programlisting> </example> @@ -165,15 +147,22 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $fp = fopen ("c:\\data\\info.txt", "r"); +?> ]]> </programlisting> </informalexample> </para> <simpara> - Siehe auch <function>fclose</function>, + Siehe auch <xref linkend="wrappers"/>, + <function>fclose</function>, + <function>fgets</function>, <function>fsockopen</function>, - <function>socket_set_timeout</function>, und + <function>file</function>, + <function>file_exists</function>, + <function>is_readable</function>, + <function>socket_set_timeout</function> und <function>popen</function>. </simpara> </refsect1> Index: phpdoc-de/reference/filesystem/functions/fpassthru.xml diff -u phpdoc-de/reference/filesystem/functions/fpassthru.xml:1.4 phpdoc-de/reference/filesystem/functions/fpassthru.xml:1.5 --- phpdoc-de/reference/filesystem/functions/fpassthru.xml:1.4 Mon Aug 26 08:41:26 2002 +++ phpdoc-de/reference/filesystem/functions/fpassthru.xml Sat Oct 19 03:40:11 2002 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> -<!-- splitted from ./de/functions/filesystem.xml, last change in rev 1.22 --> -<!-- last change to 'fpassthru' in en/ tree in rev 1.2 --> -<!-- EN-Revision: 1.2 Maintainer: tom Status: ready --> -<!-- OLD-Revision: 1.142/EN.1.2 --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.3 Maintainer: tom Status: ready --> <refentry id="function.fpassthru"> <refnamediv> <refname>fpassthru</refname> @@ -19,7 +16,7 @@ </methodsynopsis> <simpara> Die Funktion liest alle Daten von der aktuellen Position des Dateizeigers - bis EOF aus und gibt die Daten auf der Standardausgabe (Browser) aus. + bis EOF aus und schreibt die Daten in den Ausgabepuffer. </simpara> <simpara> Wenn ein Fehler auftritt, gibt <function>fpassthru</function> @@ -36,18 +33,22 @@ (hinterlässt nutzlosen <parameter>fp</parameter>-Dateizeiger). </simpara> <simpara> - Wenn Sie den Inhalt einer Datei nur auf der Standardausgabe - (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. + Wenn Sie den Inhalt einer Datei nur nur in den Ausgabepuffer schreiben + wollen ohne diese ändern bzw. an eine bestimmte Stelle gehen wollen, + sollten Sie besser <function>readfile</function> benutzen, bei der + Sie sich den Aufruf von <function>fopen</function> ersparen. </simpara> <note> <para> Wenn Sie <function>fpassthru</function> auf eine binäre Datei unter Windows anwenden, sollten Sie sicherstellen, dass die Datei - im Binärmodus geöffnet wurde, indem Sie ein <literal>b</literal> an den - Mode-Parameter von <function>fopen</function> anhängen. + im Binärmodus geöffnet wurde, indem Sie ein <literal>b</literal> an + den Mode-Parameter von <function>fopen</function> anhängen. + </para> + <para> + Auch wenn es Ihr System nicht verlangt, sollten Sie den + <literal>b</literal> Flag bei Binärdateien verwenden, um die + Portabilität Ihrer Skripte zu erhöhen. </para> </note> <simpara> Index: phpdoc-de/reference/filesystem/functions/fscanf.xml diff -u phpdoc-de/reference/filesystem/functions/fscanf.xml:1.3 phpdoc-de/reference/filesystem/functions/fscanf.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fscanf.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fscanf.xml Sat Oct 19 03:40:11 2002 @@ -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 'fscanf' 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.4 Maintainer: tom Status: ready --> <refentry id="function.fscanf"> <refnamediv> <refname>fscanf</refname> @@ -27,6 +24,15 @@ 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 referenziert übergeben werden. + </para> + <para> + Irgendwelche Whitespace-Zeichen (z.B. Leerzeichen, Tabulator, etc.) + im Format String gelten mit irgendwelchen Whitespace-Zeichen des + Input-Streams als übereinstimmend. Das heißt, dass auch ein + Tabulator <literal>\t</literal> im Format String mit einem einzigen + Leerzeichen im Input-Stream als übereinstimmend gelten kann. + </para> + <para> <example> <title><function>fscanf</function></title> <programlisting role="php"> Index: phpdoc-de/reference/filesystem/functions/fwrite.xml diff -u phpdoc-de/reference/filesystem/functions/fwrite.xml:1.3 phpdoc-de/reference/filesystem/functions/fwrite.xml:1.4 --- phpdoc-de/reference/filesystem/functions/fwrite.xml:1.3 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/fwrite.xml Sat Oct 19 03:40:11 2002 @@ -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 'fwrite' 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.fwrite"> <refnamediv> <refname>fwrite</refname> @@ -45,6 +42,44 @@ Mode-Parameter geöffnet werden. </para> </note> + <para> + <example> + <title>Ein einfaches Beispiel für fwrite</title> + <programlisting role="php"> +<![CDATA[ +<?php +$filename = 'test.txt'; +$somecontent = "Add this to the file\n"; + +// Sichergehen, dass die Datei existiert und beschreibbar ist +if (is_writable($filename)) { + + // Wir öffnen $filename im "Anhänge" - Modus. + // Der Dateizeiger befindet sich am Ende der Datei, und + // dort wird $somecontent später mit fwrite() geschrieben. + if (!$fp = fopen($filename, 'a')) { + print "Cannot open file ($filename)"; + exit; + } + + // Schreibe $somecontent in die geöffnete Datei. + if (!fwrite($fp, $somecontent)) { + print "Cannot write to file ($filename)"; + exit; + } + + print "Success, wrote ($somecontent) to file ($filename)"; + + fclose($fp); + +} else { + print "The file $filename is not writable"; +} +?> +]]> + </programlisting> + </example> + </para> <simpara> Siehe auch <function>fread</function>, <function>fopen</function>, <function>fsockopen</function>, Index: phpdoc-de/reference/filesystem/functions/is-dir.xml diff -u phpdoc-de/reference/filesystem/functions/is-dir.xml:1.4 phpdoc-de/reference/filesystem/functions/is-dir.xml:1.5 --- phpdoc-de/reference/filesystem/functions/is-dir.xml:1.4 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/is-dir.xml Sat Oct 19 03:40:11 2002 @@ -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.is-dir"> <refnamediv> <refname>is_dir</refname> @@ -26,7 +26,8 @@ Einzelheiten. </para> <para> - Siehe auch <function>chdir</function>, <function>is_file</function> und + Siehe auch <function>chdir</function>, <link linkend="class.dir">dir</link>, + <function>opendir</function>, <function>is_file</function> und <function>is_link</function>. </para> </refsect1> Index: phpdoc-de/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.5 phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.6 --- phpdoc-de/reference/filesystem/functions/parse-ini-file.xml:1.5 Sun Jun 9 06:55:38 2002 +++ phpdoc-de/reference/filesystem/functions/parse-ini-file.xml Sat Oct 19 03:40:11 2002 @@ -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.parse-ini-file"> <refnamediv> <refname>parse_ini_file</refname> @@ -32,6 +32,12 @@ </para> </note> <note> + <para> + Enthält ein Wert in der ini Datei nicht alphanumerische Zeichen, so + muss dieser von doppelten Anführungszeichen (") eingeschlossen sein. + </para> + </note> + <note> <simpara> Seit PHP 4.2.1 wird diese Funktion auch von <link linkend="ini.safe-mode">safe_mode</link> und <link @@ -60,6 +66,7 @@ [zweite_gruppe] pfad = /usr/local/bin +URL = "http://www.example.com/~username" ]]> </programlisting> </example> @@ -94,6 +101,7 @@ [eins] => 1 [fünf] => 5 [pfad] => /usr/local/bin + [URL] => http://www.example.com/~username ) Array ( @@ -106,6 +114,7 @@ [zweite_gruppe] => Array ( [pfad] => /usr/local/bin + [URL] => http://www.example.com/~username ) )