A set of generic stream wrappers
Find a file
2021-03-02 20:23:40 +01:00
.github/workflows try testing with older phpunit 2021-03-02 20:23:40 +01:00
src add error cases to type hints 2021-03-02 19:44:41 +01:00
tests try testing with older phpunit 2021-03-02 20:23:40 +01:00
.gitignore adjust tests to new phpunit 2021-03-02 19:34:10 +01:00
.php_cs.dist adjust tests to new phpunit 2021-03-02 19:34:10 +01:00
composer.json adjust tests to new phpunit 2021-03-02 19:34:10 +01:00
LICENCE Create LICENCE 2015-09-01 16:56:35 +02:00
README.md badge 2021-03-02 20:03:14 +01:00

Streams

CI codecov

Generic stream wrappers for php.

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

The callbacks are passed in the stream context along with the source stream and can be any valid php callable

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()