jqhph/dcat-admin 的永久维护 fork。原项目已停止维护,本项目持续跟进 Laravel / PHP 新版本兼容、安全修复和功能增强。
与原版 2.x 保持 API 兼容:命名空间(Dcat\Admin)、数据表结构、配置项均未改变,已有项目可直接替换。
| Laravel 10 | Laravel 11 | Laravel 12 | Laravel 13 | |
|---|---|---|---|---|
| PHP 8.1 | ✅ | ✅ | ✅ | ✅ |
| PHP 8.2 | ✅ | ✅ | ✅ | ✅ |
| PHP 8.3 | ✅ | ✅ | ✅ | ✅ |
| PHP 8.4 | ✅ | ✅ | ✅ | ✅ |
| PHP 8.5 | ✅ | ✅ | ✅ | ✅ |
实际可用的组合以 Laravel 本身对 PHP 版本的要求为准(如 Laravel 12 需要 PHP 8.2+)。
全新项目:
composer require printnow/laravel-admin
# 发布配置、语言包、迁移文件和前端资源
php artisan admin:publish
# 执行迁移并初始化管理员账号(admin / admin)
php artisan admin:install适用于正在使用 dcat/laravel-admin 2.x 的项目,业务代码无需修改。
前提:项目已升级到 Laravel 10+、PHP 8.1+。如果还在更低版本上,请先完成 Laravel 升级。原版 1.x 不在迁移范围内。
# 从 composer.json 中移除原版(--no-update:避免依赖原版的扩展阻止移除)
composer remove dcat/laravel-admin --no-update
# 安装本项目
composer require printnow/laravel-adminImportant
不要跳过第一步直接 composer require,否则原版不会被卸载,两个包会同时存在于 vendor 中,Dcat\Admin\* 类实际加载哪一份是不确定的。
本项目在 composer.json 中声明了 "replace": {"dcat/laravel-admin": "self.version"},依赖原版的第三方扩展会自动使用本项目,不会再把原版装回来。
完成后确认原版已被移除:
composer show dcat/laravel-admin # 应提示未安装,或显示由 printnow/laravel-admin 替代
ls vendor/dcat/laravel-admin # 目录应不存在php artisan admin:publish --assets --force| 项目 | 是否需要处理 |
|---|---|
| 数据库 | 无新增迁移,无需执行 migrate |
config/admin.php |
无需修改。可选新增 assets_version 配置,见功能增强 |
| 语言包 | 如果之前发布过语言包(lang/vendor/admin),需手动补充新增的 click_to_view 键;或执行 php artisan admin:publish --lang --force 覆盖(会丢失自定义翻译) |
| 视图 | 如果之前覆盖过 resources/views/vendor/admin 下的视图,请对比以下文件的改动,否则对应修复不会生效:partials/alerts、partials/toastr、partials/exception、form/multipleselect |
doctrine/dbal |
本项目不再依赖 doctrine/dbal。如果你的项目代码(如 Laravel 10 下迁移文件中的 ->change())依赖它,请在项目中显式 composer require doctrine/dbal |
php artisan optimize:clear- 支持 Laravel 11 / 12 / 13,最低要求提升至 Laravel 10、PHP 8.1
- Laravel 13:修复
redirect()->with()将MessageBag序列化为数组导致视图报错的问题,引入SessionMessage值对象替代,兼容 session 的 JSON / PHP 两种序列化模式 - PHP 8.4 / 8.5:修复隐式 nullable 参数声明、动态属性等弃用警告
- Octane / FrankenPHP:修复常驻进程下主题 CSS 路径被重复追加的问题
- 移除
doctrine/dbal依赖
- 修复
Show详情页json()方法可能导致的 XSS toastr消息输出改用json_encode(),防止单引号 / 反斜杠破坏 JS 语法及潜在 XSS- 统一 HTML 转义标志为
ENT_QUOTES | ENT_HTML5(如Code组件原先使用ENT_NOQUOTES) - 移除
extract()调用,避免变量污染
- 新增
admin.assets_version配置项(或ADMIN_ASSETS_VERSION环境变量),可独立控制 JS/CSS 缓存版本号,不再强制跟随框架版本 - 新增
Viewable列展示类,点击眼睛图标切换显示 / 隐藏值 - 新增
HighlightJS列展示类,支持代码块语法高亮 - 支持
BackedEnum枚举:表格列取值、数据仓库字段渲染、Select筛选器 - 支持
.5列宽,如col-sm-1.5(目前仅blue主题的预编译 CSS 包含这些样式) - 优化 HTTPS 站点的资源 URL 生成(推荐配置
TrustProxies,admin.https配置已标记为废弃)
- 修复表单隐藏字段被渲染两次、
MultipleSelect提交空值,导致提交参数重复的问题 - 修复
Radio、Checkbox、Switch等组件的name属性中下划线被编码为_,导致表单提交异常的问题 - 修复 Grid 以
LazyRenderable渲染时 Group Filter 筛选不生效的问题(@deflinhec) - 修复
Scope筛选器条件方法参数名错误的问题 - 修复管理员用户保存密码的逻辑问题
- 基于 PHP 8.0 / 8.1 新特性进行现代化改造(
match、str_contains等),并优化多处循环内数组合并的性能 - 引入 PHPStan 静态分析
功能用法与原项目一致,请参考原项目文档:
本项目已通过测试并在实际生产环境中使用,但无法保证所有修改绝对无误,上线前请充分测试。
如果你在使用过程中遇到任何问题,欢迎提交 Issue,感谢每一位反馈和贡献的朋友。
