如何在现有PHP（核心）MVC项目中引入Laravel框架？

针对大型现有项目，渐进式迁移是风险最低、效率最高的方案，避免一次性重构带来的业务中断风险，具体步骤如下：

1. 实现Laravel与旧项目共存 #

• 在现有项目目录外新建Laravel项目（或通过Composer将Laravel核心依赖引入现有项目根目录），通过Web服务器配置实现路由分流：
  • 比如Nginx中，将新功能路由（如/new-api/*、/admin-v2/*）指向Laravel的public目录，旧业务路由仍指向原项目入口文件。
  • 配置Laravel使用与旧项目相同的数据库连接，确保数据层共用，无需额外同步。

2. 分阶段迁移模块 #

• 优先开发新功能：所有新增业务直接用Laravel实现，既不影响旧系统运行，也能让团队快速熟悉Laravel开发模式。
• 迁移低风险旧模块：先处理辅助工具类、非核心业务页面（如帮助中心、用户设置），将其重构成Laravel的控制器、模型、视图，完成后切换路由指向Laravel。
• 最后迁移核心业务：针对核心模块，先编写覆盖旧功能的测试用例，再在Laravel中重构逻辑，测试通过后逐步替换旧路由，确保业务连续性。

3. 复用现有代码资源 #

• 将旧项目中的通用工具类、自定义组件打包成Composer包，或直接放到Laravel的app/Libraries目录，通过命名空间引入复用，避免重复开发。
• 视图层兼容：可先将旧模板文件复制到Laravel的resources/views/legacy目录，通过自定义视图加载器直接调用，后续再逐步迁移为Blade模板。

4. 统一认证与会话 #

• 若旧项目有独立认证系统，可将两者的会话存储统一为Redis或数据库，配置相同的会话密钥和驱动，实现跨系统会话共享，用户无需重复登录。
• 逐步替换认证逻辑：用Laravel Breeze/Jetstream替代旧Web认证，用Passport/JWT处理API认证，待所有模块迁移完成后彻底移除旧认证代码。

5. 测试与风险控制 #

• 每个迁移模块都需编写单元测试、功能测试，确保与旧模块功能完全一致。
• 上线后通过监控工具（如Sentry）跟踪新旧模块运行状态，及时定位并修复问题。

6. 最终合并清理 #

• 待所有模块迁移完成后，逐步删除旧项目冗余代码，统一使用Laravel的目录结构，清理过时配置与资源。

内容的提问来源于stack exchange，提问作者santiago morales