icewind/streams

A set of generic stream wrappers

Streams

, _(*1)

Generic stream wrappers for php., _(*2)

CallBackWrapper

A CallBackWrapper can be used to register callbacks on read, write and closing of the stream, it wraps an existing stream and can thus be used for any stream in php, _(*3)

The callbacks are passed in the stream context along with the source stream and can be any valid php callable, _(*4)

Example

<?php

use \Icewind\Streams\CallBackWrapper;

require('vendor/autoload.php');

// get an existing stream to wrap
$source = fopen('php://temp', 'r+');

// register the callbacks
$stream = CallbackWrapper::wrap($source,
    // read callback
    function ($count) {
        echo "read " . $count . "bytes\n";
    },
    // write callback
    function ($data) {
        echo "wrote '" . $data . "'\n";
    },
    // close callback
    function () {
        echo "stream closed\n";
    });

fwrite($stream, 'some dummy data');

rewind($stream);
fread($stream, 5);

fclose($stream);

Note: due to php's internal stream buffering the $count passed to the read callback will be equal to php's internal buffer size (8192 on default) an not the number of bytes requested by fopen(), _(*5)