tom Sun Apr 14 14:09:09 2002 EDT
Modified files:
/phpdoc/de/functions filesystem.xml
Log:
sync to en
Index: phpdoc/de/functions/filesystem.xml
diff -u phpdoc/de/functions/filesystem.xml:1.38 phpdoc/de/functions/filesystem.xml:1.39
--- phpdoc/de/functions/filesystem.xml:1.38 Tue Apr 9 17:09:27 2002
+++ phpdoc/de/functions/filesystem.xml Sun Apr 14 14:09:08 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.139 Maintainer: tom Status: ready -->
+<!-- EN-Revision: 1.142 Maintainer: tom Status: ready -->
<reference id="ref.filesystem">
<title>Funktionen des Dateisystems</title>
<titleabbrev>Filesystem</titleabbrev>
@@ -706,6 +706,89 @@
</refsect1>
</refentry>
+ <refentry id="function.file-register-wrapper">
+ <refnamediv>
+ <refname>file_register_wrapper</refname>
+ <refpurpose>Register a URL wrapper implemented as a PHP class</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Beschreibung</title>
+ <methodsynopsis>
+ <type>boolean</type><methodname>file_register_wrapper</methodname>
+ <methodparam><type>string</type><parameter>protocol</parameter></methodparam>
+ <methodparam><type>string</type><parameter>classname</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Diese Funktion ist derzeit nur anhand des folgenden Beispieles dokumentiert:
+ <example>
+ <title>Implementieren eines base64 encoding Protokolls</title>
+ <programlisting role="php">
+<![CDATA[
+class Base64EncodingStream {
+ var $fp = null;
+
+ function stream_open($path, $mode, $options, &$opened_path)
+ {
+ $this->fp = fopen($path, $mode);
+ return is_resource($this->fp);
+ }
+ function stream_close()
+ {
+ fclose($this->fp);
+ }
+ function stream_read($count)
+ {
+ return false; // Wir erlauben nur schreiben
+ }
+ function stream_write($data)
+ {
+ return fwrite($this->fp, base64_encode($data));
+ }
+ function stream_flush()
+ {
+ fflush($this->fp);
+ return true;
+ }
+ function stream_seek($offset, $whence)
+ {
+ return false;
+ }
+ function stream_gets()
+ {
+ return false;
+ }
+ function stream_tell()
+ {
+ return false;
+ }
+ function stream_eof()
+ {
+ return false;
+ }
+}
+file_register_wrapper("base64", "Base64EncodingStream")
+ or die("Failed to register protocol");
+
+copy("/tmp/inputfile.txt", "base64:///tmp/outputfile.txt");
+readfile("/tmp/outputfile");
+]]>
+ </programlisting>
+ </example>
+
+ </para>
+ <para>
+ <function>file_register_wrapper</function> gibt &false; zurück, falls
+ <parameter>protocol</parameter> bereits einen Handler hat, oder wenn
+ "fopen wrappers" deaktiviert sind.
+ </para>
+ <note>
+ <para>
+ Diese Funktion wurde in PHP 4.3.0 eingeführt.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
<refentry id="function.file-get-contents">
<refnamediv>
<refname>file_get_contents</refname>
@@ -723,6 +806,11 @@
außer dass <function>file_get_contents</function> die Datei in
einem String zurückgibt.
</para>
+ <note>
+ <para>
+ Diese Funktion wurde in PHP 4.3.0 eingeführt.
+ </para>
+ </note>
¬e.bin-safe;
&tip.fopen-wrapper;
</refsect1>
@@ -1227,15 +1315,15 @@
</refsect1>
</refentry>
- <refentry id="function.fgetwrapperdata">
+ <refentry id="function.file_get_wrapper_data">
<refnamediv>
- <refname>fgetwrapperdata</refname>
+ <refname>file_get_wrapper_data</refname>
<refpurpose>Liefert Kopf-/Metadaten von geöffneten Dateien</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
- <type>mixed</type><methodname>fgetwrapperdata</methodname>
+ <type>mixed</type><methodname>file_get_wrapper_data</methodname>
<methodparam><type>int</type><parameter>fp</parameter></methodparam>
</methodsynopsis>
<simpara>
@@ -1246,7 +1334,7 @@
</simpara>
<simpara>
Das Format der zurückgegebenen Daten ist derzeit bewusst nicht
- dokumentiert.
+ dokumentiert, und ist von dem verwendeten Wrapper abhängig.
</simpara>
<note>
<para>
@@ -1290,7 +1378,7 @@
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>fgetwrapperdata</function> geholt werden.
+ mittels <function>file_get_wrapper_data</function> geholt werden.
</simpara>
<simpara>
HTTP Verbindungen sind nur zum Lesen, d.h. Sie können keine Daten
@@ -1307,8 +1395,12 @@
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.
+ 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",
