Triangle Session connects Engine applications to the HTTP session storage provided by Localzet Server. It includes file, Redis, Redis Cluster and MongoDB handlers and a session() helper for the current request.
- PHP 8.1 or later
triangle/engine9.x, which requires Localzet Server 7.1 or later
composer require triangle/session:^2.0Engine 9 loads Triangle\Session\Bootstrap with its built-in components. This compatibility update is for the next major release because Engine 8.1 resolves to Server 4 and does not provide the Server 7 session API used by this package. To copy the package configuration into an application that does not publish package configuration automatically, run Triangle\Session\Install::install() in the application installation context. The default storage driver is file; its path comes from runtime_path('sessions').
The helper operates on the current request's Server session:
session(['user_id' => 42]);
$userId = session('user_id');
$theme = session('preferences.theme', 'light');The helper returns the current session when called without a key, reads values for string keys, and writes the supplied values when given an array. Session storage is request-scoped by Server; use scalar values and arrays. Objects restored from stored payloads are not instantiated.
| Driver | Additional requirement | Configuration key |
|---|---|---|
file |
Writable runtime directory | session.config.file |
redis |
PHP Redis extension | session.config.redis |
redis_cluster |
PHP Redis extension and a configured Redis Cluster | session.config.redis_cluster |
mongo |
mongodb/mongodb and the PHP MongoDB extension |
session.config.mongo |
Set SESSION_TYPE to the selected driver and provide its connection details through the environment or config/session.php. For HTTPS deployments, set SESSION_COOKIE_SECURE=true; configure the cookie domain and SameSite policy for the application’s deployment topology.
composer validate --strict --no-check-publish
composer test
composer audit --lockedThe compatibility test exercises Engine bootstrap loading, Server session-handler contracts, file-backed round trips, and safe handling of serialized values. MongoDB and Redis network services are optional and are not started by this test.
Copyright © 2016-2026 Localzet Group. All rights reserved.