README

#Session

这是一个简单的严格类型会话类，支持只读（read_and_close）和懒加载。此包还提供了一个有用的PSR-7兼容中间件，例如用于Slim Framework 3.x的会话启动。

###安装

composer require acfo/session

###使用方法

将会话类和中间件添加到您的依赖注入容器中（例如Pimple）

$container[\Acfo\Session\Session::class] = function () {
    return new \Acfo\Session\SessionImpl();
};

$container[\Acfo\Session\Middleware\Slim3\SessionMiddleware] = function ($container) {
    return new \Acfo\Session\Middleware\Slim3\SessionMiddleware(
        $container->get(\Acfo\Session\Session::class)
    );
};

添加中间件（例如Slim 3.x）

$app->add(\Acfo\Session\Middleware\Slim3\SessionMiddleware::class);

此配置将允许读取和写入操作，并在实际使用之前不启动会话，例如：

$session = $container->get(\Acfo\Session\Session::class);

$value = $session->get('key'); // lazy load: first access will invoke start_session

$session->set('key', 1234);

$session->regenerate();

$session->delete('key');

$session->deleteAll();

$session->close(); // call close if you want to end a read/write session as soon as possible. 
 

###高级使用

会话类支持使用PHP 7.0中引入的read_and_close标志启动会话。此功能可以帮助将特定用户会话锁定的时间保持在必要的最低限度。这对于通常不写入数据的异步Web应用程序特别有用。

要指定哪些请求只需要对会话数据的读取访问，请将实现ReadOnlySessionStrategy接口的对象列表作为中间件构造函数的参数传递，例如：

class GetRequestReadOnlySessionStrategy implements ReadOnlySessionStrategy
{
    public function isReadOnly(ServerRequestInterface $request): bool
    {
        return $request->getMethod() == 'GET';
    }
}

$container[\Acfo\Session\Middleware\Slim3\SessionMiddleware] = function ($container) {
    $readOnlySessionStrategies = [
        new GetRequestReadOnlySessionStrategy()
    ];

    return new \Acfo\Session\Middleware\Slim3\SessionMiddleware(
        $container->get(\Acfo\Session\Session::class),
        $readOnlySessionStrategies
    );
};

$app->add(\Acfo\Session\Middleware\Slim3\SessionMiddleware::class);

会话的默认设置适合大多数应用程序。如果您需要调整设置，最有效的方法是编辑php.ini文件。如果您无法或不想编辑php.ini文件，可以将设置列表传递给SessionMiddleware。

$settings = \Acfo\Session\Middleware\Slim3\SessionMiddleware::RECOMMENDED_SETTINGS;

$container[\Acfo\Session\Middleware\Slim3\SessionMiddleware] = function ($container) {
    $settings = \Acfo\Session\Middleware\Slim3\SessionMiddleware::RECOMMENDED_SETTINGS;

    return new \Acfo\Session\Middleware\Slim3\SessionMiddleware(
        $container->get(\Acfo\Session\Session::class),
        null,
        $settings
    );
};


$app->add(\Acfo\Session\Middleware\Slim3\SessionMiddleware::class);

祝您享受！