Laravel怎么使用Session会话_Laravel用户状态管理教程【跟踪】

尼克

发布时间：2026-02-22 06:17:36

657人浏览过

来源于php中文网

原创

laravel session 默认可用但需确保 session_driver 配置正确，推荐生产环境使用 redis 或 database；必须通过 laravel api 操作 session，避免直接操作 $_session；startsession 中间件顺序至关重要，api 路由需显式添加 'web' 中间件；过期时间受 driver、gc、redis 策略等多因素影响。

laravel怎么使用session会话_laravel用户状态管理教程【跟踪】

Session 在 Laravel 里默认就可用，但得确认 driver 配置正确

Laravel 默认启用 Session，但如果你发现 session() 没反应、request()->session() 取不到数据，大概率是 SESSION_DRIVER 没配对。常见错误是本地用 file（默认），但部署到无写入权限的容器或服务器时没切到 database 或 redis。

config/session.php 中的 driver 必须和 .env 里的 SESSION_DRIVER=redis 一致
redis driver 要求 phpredis 扩展已启用，且 REDIS_HOST 可连；database driver 要求先运行 php artisan session:table + php artisan migrate
array driver 仅用于测试，每次请求重置，上线千万别留着

存取 Session 数据别直接用 $_SESSION，走 Laravel 的 API

手动操作 $_SESSION 会绕过 Laravel 的加密、序列化、垃圾回收逻辑，导致 flash 失效、跨请求丢失，甚至报 Serialization of closure is not allowed 错误。

图可丽批量抠图

用AI技术提高数据生产力，让美好事物更容易被发现

下载

存：用 session(['key' => 'value']) 或 request()->session()->put('key', 'value')
取：用 session('key') 或 session('key', 'default')（带默认值更安全）
删：用 session()->forget('key')，不是 unset($_SESSION['key'])
闪存（flash）必须用 session()->flash('key', 'value')，它只在下一次请求有效，别用 put 模拟

中间件顺序错乱会导致 Session 写不进响应

Session 写入依赖 StartSession 中间件——它负责从请求中解密并挂载 session 实例，并在响应结束前把变更写回存储。如果自定义中间件放在它前面且提前返回响应（比如权限拦截 throw 了异常），Session 就不会被保存。

检查 app/Http/Kernel.php 中 $middlewareGroups['web']，确保 \Illuminate\Session\Middleware\StartSession::class 在你自定义中间件之前
不要在中间件里调用 exit 或 die；要用 return response()->...->withCookie(...) 等标准方式终止流程
API 路由默认不加载 StartSession，如果需要 session（比如调试用），得显式加 middleware('web')

Session 过期时间不只看 lifetime，还要看 driver 的 GC 和配置

SESSION_LIFETIME=120 表示「闲置 120 分钟后过期」，但实际失效时间还受 driver 影响。比如 file driver 的 GC（垃圾回收）概率触发，可能让 session 提前消失；redis 则严格按 TTL，但若 Redis 自身设置了 maxmemory-policy=volatile-lru，也可能被挤掉。