printnow / laravel-admin
Dcat admin 永久分叉版 / 支持 Laravel 10-13, PHP 版本限制 >= 8.1(支持 PHP 8.5)
Requires
- php: >=8.1
- ext-dom: *
- ext-fileinfo: *
- ext-libxml: *
- ext-zip: *
- laravel/framework: ~10.0|~11.0|~12.0|~13.0
- spatie/eloquent-sortable: ^4.0|^5.0
Requires (Dev)
- fakerphp/faker: ^1.24
- laravel/dusk: ^8.3
- mockery/mockery: ^1.6
- phpstan/phpstan: ^2.1
- phpunit/phpunit: ^10.0 || ^11.0 || ^12.0 || ^13.0
Suggests
None
Provides
None
Conflicts
None
Replaces
- dcat/laravel-admin: 2.4.7
- 2.4.7
- 2.4.6
- 2.4.5
- 2.4.4
- 2.4.3
- v2.4.3-rc.1
- v2.4.2
- v2.4.2-beta.2
- 2.4.2-beta
- 2.4.1
- 2.4.1-beta
- 2.4.0
- 2.4.0-beta
- 2.3.9-beta
- 2.3.8-beta
- 2.3.7-beta
- 2.3.6-beta
- 2.3.5-beta
- 2.3.4-beta
- 2.3.3-beta
- 2.3.2-beta
- 2.3.1-beta
- 2.3.0-beta
- 2.0.x-dev
- dev-release/2.5.0
- dev-fix/inputmask-compat
- dev-feat/number-integer
- dev-test/2.5.0
- dev-chore/release-2.4.7
- dev-fix/frontend-misreferences
- dev-chore/release-2.4.6
- dev-fix/issue-38-upload-title-undefined
- dev-chore/bump-version-2.4.5
- dev-fix/asset-placeholder-filter
- dev-fix/dropdown-display-regressions
- dev-fix/l12-upgrade-regressions
- dev-feat/web-artisan
- dev-perf/permission-and-cache-optimization
- dev-fix/security-and-cleanup
- dev-refactor/modernization
- dev-perf/Admin-mix_MiddlewareGroup--performance
- dev-laravel13-compat-test
- dev-support-laravel-12
This package is auto-updated.
Last update: 2026-11-19 08:37:19 UTC
README
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-admin 迁移
适用于正在使用 dcat/laravel-admin 2.x 的项目,业务代码无需修改。
前提:项目已升级到 Laravel 10+、PHP 8.1+。如果还在更低版本上,请先完成 Laravel 升级。原版 1.x 不在迁移范围内。
1. 替换 Composer 依赖
# 从 composer.json 中移除原版(--no-update:避免依赖原版的扩展阻止移除) composer remove dcat/laravel-admin --no-update # 安装本项目 composer require printnow/laravel-admin
Important
不要跳过第一步直接 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 # 目录应不存在
2. 更新前端资源
php artisan admin:publish --assets --force
3. 检查已发布 / 已覆盖的文件
| 项目 | 是否需要处理 |
|---|---|
| 数据库 | 无新增迁移,无需执行 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 |
4. 清理缓存
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配置已标记为废弃)
Bug 修复
- 修复表单隐藏字段被渲染两次、
MultipleSelect提交空值,导致提交参数重复的问题 - 修复
Radio、Checkbox、Switch等组件的name属性中下划线被编码为_,导致表单提交异常的问题 - 修复 Grid 以
LazyRenderable渲染时 Group Filter 筛选不生效的问题(@deflinhec) - 修复
Scope筛选器条件方法参数名错误的问题 - 修复管理员用户保存密码的逻辑问题
其他
- 基于 PHP 8.0 / 8.1 新特性进行现代化改造(
match、str_contains等),并优化多处循环内数组合并的性能 - 引入 PHPStan 静态分析
文档
功能用法与原项目一致,请参考原项目文档:
免责声明
本项目已通过测试并在实际生产环境中使用,但无法保证所有修改绝对无误,上线前请充分测试。
如果你在使用过程中遇到任何问题,欢迎提交 Issue,感谢每一位反馈和贡献的朋友。