必须启用会话加密配置:在.env中设session_secure_cookie=true、session_http_only=true、session_same_site=lax,在config/session.php中设'encrypt'=>true,并确保app_key有效且app_debug=false。

如果您在 Laravel 应用中启用会话功能,但未配置加密相关选项,则会话 Cookie 可能以明文形式传输或被篡改,导致敏感用户状态信息泄露。以下是配置会话加密选项的具体方法:
一、启用 SESSION_SECURE_COOKIE 和 SESSION_HTTP_ONLY
这两个选项控制会话 Cookie 的传输安全性和访问权限。SESSION_SECURE_COOKIE 强制 Cookie 仅通过 HTTPS 发送,防止中间人窃取;SESSION_HTTP_ONLY 阻止 JavaScript 访问 Cookie,缓解 XSS 攻击风险。
1、打开项目根目录下的 .env 文件。
2、确保存在并修改以下两行配置:
SESSION_SECURE_COOKIE=true
SESSION_HTTP_ONLY=true
3、若当前环境为 HTTP(如本地开发),请勿启用 SESSION_SECURE_COOKIE,否则会导致登录失败或会话无法写入。
二、配置会话驱动为加密兼容模式
Laravel 的 file、database、redis 等会话驱动本身不直接提供加密能力,但需配合 APP_KEY 和 session.encrypt 配置才能对会话内容进行加密。默认情况下,session.encrypt=false,即仅加密 Cookie 值(签名),而非会话数据本身;设为 true 后,整个会话负载将被加密存储。
1、编辑 config/session.php 文件。
2、定位到 'encrypt' => false 行。
3、将其修改为 'encrypt' => true。
4、确认 APP_KEY 已正确生成且未为空——该密钥是会话加密的唯一基础,缺失将导致会话初始化失败。
三、设置 SameSite 属性防止跨站请求伪造
SameSite 属性限制浏览器在跨站请求中是否携带会话 Cookie,可有效缓解 CSRF 攻击。Laravel 支持 Lax(默认)、Strict 和 None 三种值,其中 None 必须与 SESSION_SECURE_COOKIE=true 共同启用。
1、在 .env 文件中添加或修改:
SESSION_SAME_SITE=Lax
2、若需支持嵌入式跨域请求(如 iframe 场景),则设为:
SESSION_SAME_SITE=None
3、此时必须同步确保 SESSION_SECURE_COOKIE=true,否则浏览器将拒绝设置该 Cookie。
四、验证会话 Cookie 是否含 Secure 和 HttpOnly 标志
浏览器开发者工具中的 Application → Cookies 面板可直观查看会话 Cookie 属性。若未生效,说明配置未加载或缓存未刷新。
1、在浏览器中登录应用,打开开发者工具(F12)。
2、切换至 Application 标签页,展开 Cookies 列表,找到名为 laravel_session 的条目。
3、检查其属性列中是否同时包含 Secure 和 HttpOnly 标识。
4、若缺失,执行 php artisan config:clear 清除配置缓存,并重启 Web 服务器(如 Nginx 或 Apache)。
五、禁用调试模式避免密钥泄露
当 APP_DEBUG=true 时,Laravel 错误页面可能暴露 APP_KEY、会话加密算法细节及内部结构,攻击者可据此构造恶意会话或绕过加密校验。
1、检查 .env 文件中 APP_DEBUG 的值。
2、生产环境中必须设为 APP_DEBUG=false。
3、部署后访问一个不存在的路由,确认返回的是通用 404 页面,而非包含堆栈跟踪的异常页。
4、同时检查 storage/logs/ 目录权限,确保其不可通过 Web 路径直接访问,防止日志中残留加密上下文信息。











