groton-school/session-cookie-middleware

Implementation of PSR-15 middleware to manage session cookies with CHIPS partition support

dev-main 2025-09-04 11:31 UTC

Requires

• dflydev/fig-cookies: ^3.2
• odan/session: ^6.4
• psr/http-message: ^2.0

GPL-3.0

• Seth Battis

README

Implementation of PSR-15 middleware to manage session cookies with CHIPS partition support

Install

composer require groton-school/session-cookie-middleware

Use

In app/dependencies.php:

use DI;
use GrotonSchool\Session\Session;
use Odan\Session\SessionInterface;
use Odan\Session\SessionManagerInterface;

return function (ContainerBuilder $containerBuilder) {
    $containerBuilder->addDefinitions([

        // ...other dependencies...

        Session::class => function(ContainerInterface $container) {
            return new Session([
                'name' => 'session-cookie',
                'lifetime' => 86400,
                'path' => '/',
                'secure' => true,
                'httponly' => true,
                'partitioned' => false
            ]);
        },
        SessionInterface::class => DI\get(Session::class),
        SessionManagerInterface::class => DI\get(Session::class)
    ])
}

Either in app/routes.php:

use GrotonSchool\Session\SessionCookieMiddleware;

// ...

$app->get('/route/that/needs/session', SomeAction::class)
  ->add(SessionCookieMiddleware::class);

...or in app/middleware.php:

use GrotonSchool\Session\SessionCookieMiddleware;

// ...

$app->add(SessionCookieMiddleware::class);