universal/universal

Universal library for PHP

Universal

Universal is a general proprose PHP library., _(*1)

, _(*2)

Install

composer require universal/universal 2.0.x-dev

Components

• ClassLoaders
• Container
• HTTPRequest

Classloader

BasePathClassLoader

$loader = new BasePathClassLoader( array( 
    'vendor/pear', 'external_vendor/src'
) );
$loader->useEnvPhpLib();
$loader->register();

Include Path Manipulator

Include Path manipulator, _(*3)

```php $includer = new PathIncluder(array( 'to/path', ... )); $includer->add( 'path/to/lib' ); $includer->setup(); // write set_include_path, <sub>(*4)</sub>

## Http

### StreamResponse

MXHR support

```php
$response = new Universal\Http\StreamResponse;
for( $i = 0 ; $i < 30000 ; $i++ ) {
    $response->write(json_encode(array('i' => $i)), array(
        'Content-Type' => 'application/json',
    ));
    usleep(200000);
}
$response->finish();

HttpRequest

For multiple files:, <sub>(*5)</sub>

<?php

$req = new HttpRequest;
foreach( $req->files as $f ) {
    $extname = $f->getExtension();
    $filename = $f->getPathname();
}

$req->param( 'username' );   // get $_REQUEST['username'];

$req->get->username;    // get $_GET['username'];

$req->post->username;   // get $_POST['username'];

$req->server->path_info;  // get $_SERVER['path_info'];

To get FILE:, <sub>(*6)</sub>

$req = new HttpRequest;

Get $_FILES['uploaded'] hash:, <sub>(*7)</sub>

$req->files->uploaded;

Get file size:, <sub>(*8)</sub>

$req->files->uploaded->size;

Get file mime type:, <sub>(*9)</sub>

$req->files->uploaded->type; // plain/text

Get upload error:, <sub>(*10)</sub>

$req->files->uploaded->error;

Foreach file:, <sub>(*11)</sub>

foreach( $req->files->uploaded as $f ) {
    $f->size;
}

ObjectContainer

Construct a $container object or inherit from it:, <sub>(*12)</sub>

$container = new Universal\Container\ObjectContainer;

Register a object builder for lazy building., <sub>(*13)</sub>

$container->mailer = function() {
    return new YourMailer;
};

To get singleton object via __get magic method:, <sub>(*14)</sub>

$mailer = $container->mailer;

Or get singleton object from instance method:, <sub>(*15)</sub>

$mailer = $container->instance('mailer');

To build a new object:, <sub>(*16)</sub>

$mailer = $container->build('mailer');

To build a new object with arguments:, <sub>(*17)</sub>

$mailer = $container->build('mailer', array( ... ));

Session

Supported Session Storage backend:, <sub>(*18)</sub>

• Memcache
• Redis
• Native

use ObjectContainer to pass options:, <sub>(*19)</sub>

$container = new Universal\Container\ObjectContainer;
$container->state = function() {
    return new Universal\Session\State\NativeState;
};
$container->storage = function() {
    return new Universal\Session\Storage\NativeStorage;
};

Native Session:, <sub>(*20)</sub>

$session = new Universal\Session\Session(array(  
    'state'   => new Universal\Session\State\NativeState,
    'storage' => new Universal\Session\Storage\NativeStorage,
));
$counter = $session->get( 'counter' );
$session->set( 'counter' , ++$counter );
echo $session->get( 'counter' );

Session with memcache backend:, <sub>(*21)</sub>

$session = new Universal\Session\Session(array(  
    'state'   => new Universal\Session\State\CookieState,
    'storage' => new Universal\Session\Storage\MemcacheStorage,
));
$counter = $session->get( 'counter' );
$session->set( 'counter' , ++$counter );
echo $session->get( 'counter' );

Event

use Universal\Event\EventDispatcher;

$e = Event::getInstance();

// register your handler
$e->register('test', function($a, $b, $c) {
    // do what you want
});

// trigger event handlers
$e->trigger('test', 1,2,3);