讲师中心 微信公众号
AI工具推荐 视频效率加速

Laravel 多应用间共享 Session 的完整实现方案

胖宇小哥_7128

胖宇小哥_7128

发布时间:2026-02-04 09:48:08

|

943人浏览过

|

来源于php中文网

原创

Laravel 多应用间共享 Session 的完整实现方案

通过统一数据库存储 session,可让多个 laravel 应用共享登录状态,实现单点登录(sso)式体验:用户在 app1 登录后跳转至 app2 仍保持认证,操作完成后返回 app1 无需重复登录。

在 Laravel 中实现多 Web 应用间 Session 共享,核心思路是剥离 Session 存储逻辑,使其脱离单应用本地环境,交由所有应用共用的中心化存储(如 MySQL 数据库)统一管理。这避免了文件、Redis 实例隔离或 Cookie 域名限制等常见障碍,是生产环境中稳定、可控的推荐方案。

✅ 前置准备:创建专用 Session 数据库

首先,在数据库服务器中新建一个独立数据库(例如 laravel_sessions),专用于存储所有应用的 session 记录。该库仅需一张表,Laravel 提供了标准迁移:

php artisan session:table
php artisan migrate --database=sessions_database
⚠️ 注意:执行迁移前需确保 sessions_database 连接已正确配置(见下文),且该数据库已存在并具备写权限。

✅ 步骤一:配置多数据库连接

在 config/database.php 中新增一个名为 sessions_database 的数据库连接配置(与主库 default 并列),指向上述专用 Session 数据库:

'sessions_database' => [
    'driver' => env('DB_CONNECTION_SESSION', 'mysql'),
    'host' => env('DB_HOST_SESSION', '127.0.0.1'),
    'port' => env('DB_PORT_SESSION', '3306'),
    'database' => env('DB_DATABASE_SESSION', 'laravel_sessions'),
    'username' => env('DB_USERNAME_SESSION', 'homestead'),
    'password' => env('DB_PASSWORD_SESSION', 'secret'),
    'charset' => 'utf8mb4',
    'collation' => 'utf8mb4_unicode_ci',
    'prefix' => '',
    'strict' => true,
    'engine' => null,
],

同时,在 .env 文件中为两个应用保持完全一致的 Session 数据库配置:

1Password Cli For Agents
1Password Cli For Agents

使用服务账户令牌通过1Password CLI安全访问和管理密钥,执行保险库操作如读取、写入、编辑和删除。

下载
# .env (App1 和 App2 均需相同)
DB_CONNECTION_SESSION=mysql
DB_HOST_SESSION=your-shared-db-host
DB_PORT_SESSION=3306
DB_DATABASE_SESSION=laravel_sessions
DB_USERNAME_SESSION=shared_user
DB_PASSWORD_SESSION=shared_password

✅ 步骤二:切换 Session 驱动并指定连接

修改 config/session.php,将 driver 设为 database,并显式指定 connection 为上一步定义的连接名:

'driver' => env('SESSION_DRIVER', 'database'),
'connection' => env('SESSION_CONNECTION', 'sessions_database'),
'table' => 'sessions',
'expire_on_close' => false,
'lifetime' => 120, // 分钟,建议统一设置

并在 .env 中确保:

SESSION_DRIVER=database
SESSION_CONNECTION=sessions_database

✅ 关键点:两个应用必须使用相同的 session.cookie.domain(如 .example.com),否则浏览器不会在跨子域请求中携带 Cookie。若应用部署在不同主域(如 app1.com 与 app2.org),此方案不适用——需改用 OAuth2 或 JWT 等无状态认证方案。

✅ 补充说明与注意事项

  • 安全性保障:Session 表中的 payload 字段已由 Laravel 自动加密(基于 APP_KEY),但所有共享 Session 的应用必须使用完全相同的 APP_KEY,否则解密失败导致会话无效。
  • 清理机制:Laravel 会自动通过 session:gc 命令清理过期 session,建议在任一应用中配置定时任务(如 Laravel Scheduler)定期执行:
    // app/Console/Kernel.php
    protected function schedule(Schedule $schedule)
    {
        $schedule->command('session:gc')->hourly();
    }
  • 不推荐方案规避:
    • ❌ 不要使用 file 驱动(文件路径无法共享);
    • ❌ 避免多个应用共用同一 Redis 实例但未统一 prefix 或 database,易引发 key 冲突;
    • ❌ 不要依赖 cookie 驱动跨域共享(受同源策略严格限制)。

通过以上配置,两个 Laravel 应用即可无缝共享用户会话状态——登录态、Flash 消息、自定义 Session 数据均实时同步。这是构建企业级多系统集成平台(如后台管理 + SaaS 子应用)的基础能力之一。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

837

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

815

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2468

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3721

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

5270

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

3516

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

6649

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1376

2026.03.04

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 180人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 287人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn