diff --git a/reference/stream/book.xml b/reference/stream/book.xml new file mode 100644 index 000000000..2e9d9084b --- /dev/null +++ b/reference/stream/book.xml @@ -0,0 +1,93 @@ + + + + + + Streams + + + &reftitle.intro; + + Streams sind die Möglichkeit, Datei-, Netzwerk-, Datenkompressions- und + andere Operationen zu verallgemeinern, die einen gemeinsamen Satz von + Funktionen und Verwendungszwecken teilen. In seiner einfachsten Definition + ist ein Stream ein + resource-Objekt, das ein streambares Verhalten zeigt. Das + heißt, es kann auf lineare Weise gelesen oder beschrieben werden und kann + mittels fseek an eine beliebige Position innerhalb des + Streams springen. + + + Ein Wrapper ist zusätzlicher Code, der dem Stream + mitteilt, wie er bestimmte Protokolle/Kodierungen zu behandeln hat. So weiß + zum Beispiel der http-Wrapper, wie eine URL in eine + HTTP/1.0-Anfrage für eine Datei auf einem entfernten + Server zu übersetzen ist. PHP enthält standardmäßig viele Wrapper (siehe + ), und es können entweder innerhalb eines + PHP-Skripts mittels stream_wrapper_register oder direkt + aus einer Erweiterung weitere, benutzerdefinierte Wrapper hinzugefügt + werden. Da PHP jede beliebige Art von Wrapper hinzugefügt werden kann, gibt + es keine feste Grenze für das, was mit ihnen getan werden kann. Um auf die + Liste der aktuell registrierten Wrapper zuzugreifen, ist + stream_get_wrappers zu verwenden. + + + Ein Stream wird referenziert als: scheme://target + + + + scheme (string) - + Der Name des zu verwendenden Wrappers. Beispiele sind: file, http, + https, ftp, ftps, compress.zlib, compress.bz2 und php. Siehe + für eine Liste der in PHP integrierten + Wrapper. Wird kein Wrapper angegeben, wird der Standardwert der Funktion + verwendet (typischerweise file://). + + + + + target - + Hängt vom verwendeten Wrapper ab. Bei dateisystembezogenen Streams ist + dies typischerweise ein Pfad und der Dateiname der gewünschten Datei. + Bei netzwerkbezogenen Streams ist dies typischerweise ein Hostname, oft + mit einem angehängten Pfad. Siehe auch hier + für eine Beschreibung der Ziele integrierter Streams. + + + + + + + &reference.stream.setup; + &reference.stream.constants; + &reference.stream.filters; + &reference.stream.contexts; + &reference.stream.errors; + &reference.stream.examples; + &reference.stream.php-user-filter; + &reference.stream.streamwrapper; + &reference.stream.streambucket; + &reference.stream.reference; + + + + \ No newline at end of file diff --git a/reference/stream/streambucket.xml b/reference/stream/streambucket.xml new file mode 100644 index 000000000..c54e55eb2 --- /dev/null +++ b/reference/stream/streambucket.xml @@ -0,0 +1,121 @@ + + + + + Die Klasse StreamBucket + StreamBucket + + + +
+ &reftitle.intro; + + Ein Stream-Bucket ist ein Teilstück eines Streams, das aus Bucket-Brigaden + extrahiert werden kann. + +
+ +
+ &reftitle.classsynopsis; + + + + final + StreamBucket + + + &Properties; + + public + readonly + resource + bucket + + + public + readonly + string + data + + + public + readonly + int + datalen + + + public + readonly + int + dataLength + + +
+ +
+ &reftitle.properties; + + + resource bucket + + Eine userfilter.bucket-Ressource. + + + + string data + + Die aktuelle Zeichenkette im Bucket. + + + + int datalen + + + Die Länge der Zeichenkette im Bucket. + Seit PHP 8.4 zugunsten von StreamBucket::$dataLength + veraltet. + + + + + int dataLength + + Die Länge der Zeichenkette im Bucket. + + + +
+ +
+ &reftitle.seealso; + + stream_bucket_new + stream_bucket_append + stream_bucket_prepend + stream_bucket_make_writeable + +
+ +
+ +
+ \ No newline at end of file