README

Dcat-plus Admin是一个基于 `Dcat Admin `二次开发而成的后台系统构建工具，只需很少的代码即可快速构建出一个功能完善的高颜值后台系统。内置丰富的后台常用组件，开箱即用，让开发者告别冗杂的HTML代码，对后端开发者非常友好。

在线演示

laravel13 && php8.4（3.x） >>>查看
laravel12 && php8.2（2.x） >>>查看

现在的开源维护作者杨光

可加作者微信:Q3664839, 加入 dcat-admin 开发交流群。

赞助者名单(赞助开源，才能让Dcat-plus开源走的更远)

再次感谢以下人员对Dcat-plus开源赞助

Lev*ies 200元
香港*小波 500元
Fer*yice 66.66元
匿名人士自建云服务器一台
丝*路 200元
Br*ian.C 100元
and*yzu 88.88元
Cybe*rLink 100元
杜*勇 100元
王*旻 500元
e*ZO 200元

功能特性

简洁优雅、灵活可扩展的API
用户管理
RBAC权限管理，支持无限极权限节点
菜单管理
使用pjax构建无刷新页面，支持按需加载静态资源，可以无限扩展组件而不影响整体性能
松耦合的页面构建与数据操作设计，可轻松切换数据源
自定义页面
自定义主题配色
多主题切换功能，内置多种主题色
可轻松构建无菜单栏的独立页面（如可用于构建弹窗选择器等功能）
插件功能
可视化代码生成器，可根据数据表一键生成增删改查页面
数据表格构建工具，内置丰富的表格常用功能（如组合表头、数据导出、搜索、快捷创建、批量操作等）
树状表格功能构建工具，支持分页和点击加载
数据表单构建工具，内置丰富的表单类型，支持表单异步提交
分步表单构建工具
弹窗表单构建工具
数据详情页构建工具
无限层级树状页面构建工具，支持用拖拽的方式实现数据的层级、排序等操作
内置丰富的常用页面组件（如图表、数据统计卡片、下拉菜单、Tab卡片、提示工具等）
Section功能（类似Wordpress的Filter和blade模板的section标签）
异步文件上传表单，支持分块多线程上传
多应用
选择数据表一键生成11种接口
自带多端接口文档,管理端，商家端，用户端接口文档。
插件市场，只需在管理页面轻轻点击鼠标即可完成插件的安装、更新和卸载等操作

3.x 版本亮点

3.x 是当前主要维护版本，要求 PHP 8.3+，主要变化：

重构 RBAC 角色权限体系，角色/权限绑定更清晰可控
内置 ERP 经营驾驶舱首页示例（ApexCharts 图表 + Swiper 轮播 + 跑马灯公告 + 订单/库存卡片），替换数据源即可用于生产
新增 Swiper 轮播、MarqueeNotice 跑马灯公告、HonorWall 荣誉墙组件
ApexCharts v5 支持，新增 ChinaMap 中国地图组件
登录页改版，集成图片验证码
升级 UEditor 内核，未单独配置时也有默认值，开箱即用
增强代码生成器：多数据库脚手架、admin:action 支持参数化一次创建与异步加载表格/表单
内置系统日志、操作日志与缓存清理
接口文档切换为 ycookies/apidoc，自带管理端、商家端、用户端接口文档
HasMany 表格模式重构：结构化表头，支持列宽/对齐/表头 help 提示
随包分发 AI 编码技能（skills）与扩展包开发工作流，配合 ZCode/Claude Code 等 AI 工具开发

环境

3.x 环境（当前版本）

PHP >= 8.3

Laravel 12 ~ 13.*

Fileinfo PHP Extension

2.x 环境

PHP >= 8.3

Laravel 12 ~ 13.*

Fileinfo PHP Extension

1.x 环境

PHP >= 7.4

Laravel 8.0 ~ 12.*

Fileinfo PHP Extension

安装

如果安装过程中出现composer下载过慢或安装失败的情况，请运行命令composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/把composer镜像更换为阿里云镜像。

首先需要安装laravel框架，如已安装可以跳过此步骤。如果您是第一次使用laravel，请务必先阅读文档 Laravel文档

composer create-project --prefer-dist "laravel/laravel:13.*" laravel13.test

安装完laravel之后需要修改.env文件，设置数据库连接设置正确

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dcat-admin
DB_USERNAME=root
DB_PASSWORD=

安装dcat-admin

cd {项目名称}

#  dcat-admin plus版 (杨光维护)

# 安装 3.x 版本（当前版本，要求 PHP >= 8.3）
composer require dcat-plus/laravel-admin:^3.0

# 安装 2.x 版本
composer require dcat-plus/laravel-admin:^2.0

# 安装 1.x 版本
composer require dcat-plus/laravel-admin:1.*

然后运行下面的命令来发布资源：

php artisan admin:publish

在该命令会生成配置文件config/admin.php，可以在里面修改安装的地址、数据库连接、以及表名，建议都是用默认配置不修改。

然后运行下面的命令完成安装：

执行这一步命令可能会报以下错误Specified key was too long ... 767 bytes，如果出现这个报错，请在app/Providers/AppServiceProvider.php文件的boot方法中加上代码\Schema::defaultStringLength(191);，然后删除掉数据库中的所有数据表，再重新运行一遍php artisan admin:install命令即可。

php artisan admin:install

上述步骤操作完成之后就可以配置web服务了，注意需要把web目录指向public目录！如果用的是nginx，还需要在配置中加上伪静态配置

location / {
	try_files $uri $uri/ /index.php?$query_string;
}

设置目录权限（这一步至关重要,很多问题是由目录文件权限引起的）

cd /path/to/laravel-project

# 设置目录权限
chmod -R 775 storage/
chmod -R 775 bootstrap/cache/
chmod -R 775 lang/
chmod -R 755 public/


# 设置文件所有者（假设运行用户为nginx或apache）
chown -R nginx:nginx .  # 如果使用Nginx
# 或
chown -R apache:apache .  # 如果使用Apache

启动服务后，在浏览器打开 http://localhost/admin，使用用户名 admin 和密码 admin登陆。

扩展

扩展	描述	dcat-admin 版本
mosiboom/dcat-iframe-tab	IFRAME TAB标签切换	2.x
super-eggs/dcat-distpicker	省市区联动	2.x
ueditor	百度在线编辑器	1.x
grid-sortable	表格拖曳排序工具	1.x