2017 © Pedro PelĂĄez
 

library streamer

Object-oriented API to PHP streams

image

fzaninotto/streamer

Object-oriented API to PHP streams

  • Tuesday, January 31, 2017
  • by fzaninotto
  • Repository
  • 14 Watchers
  • 245 Stars
  • 5,772 Installations
  • PHP
  • 2 Dependents
  • 0 Suggesters
  • 27 Forks
  • 4 Open issues
  • 2 Versions
  • 12 % Grown

The README.md

Streamer

Streamer is an Object-Oriented API for PHP streams., (*1)

Why should I use Streams?

A stream is a flow of bytes from one container to the other. You already use streams a lot in PHP, for instance each time you load a file into memory (file_get_contents()). You should explicitly use streams each time that:, (*2)

  • You need to access data from a container, but you don't know the size of this container (e.g. reading from STDIN, or a web service using streaming)
  • You need to start processing data from a container before the whole transfer is finished (e.g. start zipping a file before it's all in memory)
  • You need to save time and memory

What is Streamer?

PHP has a very elaborate stream API ; unfortunately, it uses functions for most stream operations (except for wrappers - go figure). Streamer is a generic library focusing on offering an object-oriented API to streams, and only that., (*3)

Installation

Streamer is published on packagist.org, so you can add it to your composer.json file for an easy installation:, (*4)

composer require fzaninotto/Streamer

or, (*5)

{
    "require": {
        "fzaninotto/Streamer": "0.0.1"
    }
}

Example

<?php
use Streamer\Stream,
    Streamer\FileStream,
    Streamer\NetworkStream;

// basic usage
$stream = new Stream(fopen('smiley.png', 'r'));
$image = '';
while (!$stream->isEOF()) {
  $image .= $stream->read();
}

// pipe dreams!
$stream1 = new Stream(fopen('smiley.png', 'r'));
$stream2 = new Stream(fopen('tmp.png', 'w'));
// copy the contents from the first stream to the second one
$stream1->pipe($stream2);

// factory
$fileStream = FileStream::create('smiley.png', 'r');
print_r($fileStream);

$networkStream = NetworkStream::create('tcp://www.google.com:80');
print_r($networkStream);

Credits

Streamer is heavily inspired by other Stream class implementations:, (*6)

The Versions

31/01 2017

dev-master

9999999-dev https://github.com/fzaninotto/Streamer

Object-oriented API to PHP streams

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by François Zaninotto

02/07 2012

0.0.1

0.0.1.0 https://github.com/fzaninotto/Streamer

Object-oriented API to PHP streams

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by François Zaninotto