Laravel 8升级至Laravel 9时srlabs/centaur兼容问题咨询

问题背景 #

当前维护一款旧应用，使用srlabs/centaur 11.*版本，尝试升级Laravel到9.x时遇到以下Composer依赖冲突：

- srlabs/centaur 11.01.00 requires illuminate/support ^8.0 -> satisfiable by illuminate/support[v8.0.0, ..., v8.83.27].
- Only one of these can be installed: illuminate/support[v5.1.1, ..., v5.8.36, v6.0.0, ..., v6.20.44, v7.0.0, ..., v7.30.6, v8.0.0, ..., v8.83.27, v9.0.0, ..., v9.52.8, v10.0.0, ..., v10.13.2], laravel/framework[v9.0.0, ..., v9.52.8]. laravel/framework replaces illuminate/support and thus cannot coexist with it.
- Root composer.json requires laravel/framework ^9.0 -> satisfiable by laravel/framework[v9.0.0, ..., v9.52.8].

已知Centaur仅支持到Laravel 8，需解决：

• 如何完成Laravel 9升级？
• 是否需要替换为Sentinel？
• 若替换是否需要重写所有自定义代码？

可行解决方案 #

方案1：修改Centaur兼容Laravel 9（风险较高，适合临时过渡） #

• 克隆Centaur仓库到本地，修改其composer.json中illuminate/support的依赖为^8.0|^9.0
• 在应用的composer.json中，将srlabs/centaur的依赖替换为指向你的克隆仓库，示例：

  "repositories": [
      {
          "type": "vcs",
          "url": "https://github.com/your-username/Centaur.git"
      }
  ],
  "require": {
      "srlabs/centaur": "dev-laravel9-support"
  }
  

• 执行composer update srlabs/centaur，然后全面测试用户认证、角色权限等核心功能，排查Laravel 9带来的API变动问题
• 注意：此方式无官方维护，后续Laravel版本升级可能再次出现兼容问题

方案2：替换为Sentinel（成熟替代方案，无需完全重写） #

Sentinel支持Laravel 9+，与Centaur同为角色权限型认证系统，核心概念一致，只需针对性调整代码：

1. 安装Sentinel：

   composer require cartalyst/sentinel:^6.0
   

2. API映射调整：
   • Centaur的Centaur::login($credentials) → Sentinel的Sentinel::authenticate($credentials)
   • Centaur的$user->hasRole('admin') → Sentinel的$user->inRole('admin')
   • 权限检查、用户创建、角色分配等方法逻辑类似，可参考官方文档对应替换
3. 数据迁移：
   • 对比Centaur与Sentinel的数据库表结构，编写迁移脚本将用户、角色、权限数据迁移到Sentinel的对应表中（两者表结构差异不大，主要调整外键和部分字段名）
4. 逐步替换测试：
   • 分批替换控制器、视图、中间件中的Centaur调用，每替换一部分就测试对应功能，确保业务逻辑一致

方案3：改用Laravel原生Auth + Spatie权限包（长期维护最优解） #

如果希望贴合Laravel官方生态，推荐使用原生Auth配合Spatie的权限包：

1. 移除Centaur：

   composer remove srlabs/centaur
   

2. 启用原生Auth：

   php artisan ui bootstrap --auth # 根据项目使用的UI框架调整命令
   

3. 安装Spatie权限包：

   composer require spatie/laravel-permission
   

4. 数据迁移与代码替换：
   • 将Centaur的用户、角色、权限数据迁移到原生用户表和Spatie的权限表中
   • 替换现有代码中的Centaur调用为原生Auth方法+Spatie权限检查，例如auth()->user()->hasRole('admin')

内容的提问来源于stack exchange，提问作者Rasyidi Alwee