如何把基于dcat-admin的老项目 平滑升级到 dcat-plus admin?
升级准备
- 为了保障升级过程不会造成老项目的不稳定。首先把老项目整个copy 一份出来备份。可在副本中尝试升级。
- 备份这3个文件
app/Admin/Controllers/AuthController.php
,app/Admin/Controllers/HomeController.php
,config/admin.php
因为强制发布资源,会把这3个文件覆盖,在升级完成后,用备份的文件去覆盖。
升级步骤
- 进入终端,在项目的根目录下执行:
composer remove dcat/laravel-admin
移除 原有扩展包 - 重新安装plus版扩展包,
composer require dcat-plus/laravel-admin:1.3.3
最好 指定 最新版本号。 - 强制发布资源
php artisan admin:publish --force
一定要带上 –force. - (非必要) 创建资源软链接
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
学习建议:
- 建议新学的同学,可以下载一些基于dcat开源的项目。把他们的代码全部看一遍。把官方的demo 看一遍。
重点
不能完全依赖于文档。可以去翻阅dcat-plus admin 扩展包的源代码。可以直观的看到,都有提供哪些方法可以调用
dcat-admin 并未停止不前,plus版 持续更新 保持活力
dcat-plus admin (plus版)沿用 dcat-admn 最新代码,并让dcat-admin 保持活力。已支持到Laravel11,并新增多个组件。
加群学习交流
微信:Q3664839 (加微信 后拉你进入微信技术交流群)
本作品采用《CC 协议》,转载必须注明作者和本文链接
laravel-admin dcat-admin dcat-admin-plus
大佬 第一步就炸了