README

Universal 是一个通用的 PHP 库。

组件

• 类加载器
• 容器
• HTTP 请求

类加载器

SplClassLoader

use Universal\ClassLoader\SplClassLoader;
$loader = new \UniversalClassLoader\SplClassLoader( array(  
        'Vendor\Onion' => 'path/to/Onion',
        'Vendor\CLIFramework' => 'path/to/CLIFramework',
));
$loader->addNamespace(array( 
    'NS' => 'path'
));
$loader->useIncludePath();
$loader->register();

BasePathClassLoader

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

包含路径操作器

包含路径操作器

$includer = new PathIncluder(array( 'to/path', ... ));
$includer->add( 'path/to/lib' );
$includer->setup();   // write set_include_path

HTTP

StreamResponse

MXHR 支持

    $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

对于多个文件

<?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'];

获取 FILE

$req = new HttpRequest;

获取 $_FILES['uploaded'] 哈希值

$req->files->uploaded;

获取文件大小

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

获取文件 MIME 类型

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

获取上传错误

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

遍历文件

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

ObjectContainer

构建 $container 对象或从它继承

$container = new Universal\Container\ObjectContainer;

注册对象构建器以进行懒加载。

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

通过 __get 魔法方法获取单例对象

$mailer = $container->mailer;

或通过 instance 方法从单例对象获取

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

构建新对象

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

用参数构建新对象

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

会话

支持的会话存储后端

• Memcache
• Redis
• 原生

使用 ObjectContainer 传递选项

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

原生会话

$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' );

使用 memcache 后端的会话

$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' );

事件

use Universal\Event\PhpEvent;
$e = PhpEvent::getInstance();

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

});

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

需求检查器

try {
    $require = new Universal\Requirement\Requirement;
    $require->extensions( 'apc','mbstring' );
    $require->classes( 'ClassName' , 'ClassName2' );
    $require->functions( 'func1' , 'func2' , 'function3' )
}
catch( RequireExtensionException $e ) {

}
catch( RequireFunctionException $e ) {

}
catch( RequireClassException $e ) {

}