triangle / session
Triangle Session Component
Requires
- php: ^8.1
- triangle/engine: ^9.0
Requires (Dev)
- ext-mongodb: *
- mongodb/mongodb: ^2.0
Suggests
- ext-redis: For RedisSessionHandler and RedisClusterSessionHandler
- mongodb/mongodb: For MongoSessionHandler
Provides
None
Conflicts
None
Replaces
None
README
Triangle Session
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.
Requirements
- PHP 8.1 or later
triangle/engine9.x, which requires Localzet Server 7.1 or later
Installation
composer require triangle/session:^2.0
Engine 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').
Using a session
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.
Storage drivers
| 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.
Development checks
composer validate --strict --no-check-publish
composer test
composer audit --locked
The 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.