如何把基于dcat-admin的老项目 平滑升级到 dcat-plus admin？

升级准备#

• 为了保障升级过程不会造成老项目的不稳定。首先把老项目整个 copy 一份出来备份。可在副本中尝试升级。
• 备份这 3 个文件 app/Admin/Controllers/AuthController.php,app/Admin/Controllers/HomeController.php，config/admin.php 因为强制发布资源，会把这 3 个文件覆盖，在升级完成后，用备份的文件去覆盖。

升级步骤#

1. 进入终端，在项目的根目录下执行：composer remove dcat/laravel-admin 移除 原有扩展包
2. 重新安装 plus 版扩展包，composer require dcat-plus/laravel-admin:1.3.3 最好 指定 最新版本号。
3. 强制发布资源 php artisan admin:publish --force 一定要带上 –force.
4. (非必要) 创建资源软链接 php artisan storage:link

完成以上步骤就能达到升级效果。

升级说明#

plus 版，只是换了包名。命名空间还是 Dcat\Admin. 所以能直接兼容。
plus 版，沿用 dcat-admin (v2.2.2) 最新代码，在其基础上修正问题，发布更新。

dcat-admin (v2.2.3) 只是合并了修正 bug 的代码发布而来的版本。这些 bug 在 plus 版中都已修正。

查看官方提供的平滑升级示例#

我们拿一个基于 dcat-admin 开源很火的项目，进行尝试。

(IT 资产管理系统) 咖啡壶是一个免费、开源、高效且漂亮的资产管理平台。资产管理、归属 / 使用者追溯、盘点以及可靠的服务器状态管理面板。基于优雅的 Laravel 框架 （dcat-admin）开发。（Star 2.6k)
作者：（由于上游技术栈放弃维护等相关原因，本项目已经进入长期维护阶段）。
开源地址：gitee.com/celaraze/chemex

咖啡壶（celaraze） 升级成 dcat-plus admin 的演示地址：
itams.saishiyun.net 产品页由 AI 生成。请点试用。

效果截图#

dcat-plus admin 都增加了什么？#

增加表单组件#

• 增加 媒体选择器
• 集成 步骤表单组件
• 集成 diy 表单字段组件
• 集成 省市区选择器组件
• 增加 上传图片 指定示例图组件
• 增加 商品 SKU 组件
• 增加 多个日期选择组件
• 增加原有表单组件的能力。
• 更多…

  增加页面组件#

• 日历行程

扩展数据表格功能#

• 数据表格 合并单元格
• 支持数据导入
• 支持自定义右侧工具栏
• 支持多种格式化展示数据

  优化更多细节#

• modal 优化
• 数据表格优化
• 更多..

  修正原有小 bug#

• 数据表格 使用 limit 时，内容全是英文不换行的问题。
• 页面中使用数据图表 card，在浏览器回退时，触发大量异步请求的问题
• 诸多小问题

参考与学习 dcat-admin#

DcatAdmin 扩展和项目

学习建议：

1. 建议新学的同学，可以下载一些基于 dcat 开源的项目。把他们的代码全部看一遍。把官方的 demo 看一遍。
2. 重点 不能完全依赖于文档。可以去翻阅 dcat-plus admin 扩展包的源代码。可以直观的看到，都有提供哪些方法可以调用

dcat-admin 并未停止不前，plus 版 持续更新 保持活力#

dcat-plus admin （plus 版）沿用 dcat-admn 最新代码，并让 dcat-admin 保持活力。已支持到 Laravel11，并新增多个组件。

• plus 版 官方网站
• 备份中文文档
• github
• Demo / 在线演示
• 示例源码
• 技术社区

加群学习交流#

微信：Q3664839 （加微信 后拉你进入微信技术交流群）

本作品采用《CC 协议》，转载必须注明作者和本文链接