README

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

功能特性

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

环境

PHP >= 8.1（支持至 8.5；Laravel 13 自身要求 PHP >= 8.3）
Laravel 10.x / 11.x / 12.x / 13.x
Fileinfo PHP Extension

版本支持矩阵

Laravel 版本	支持的 PHP 版本（官方要求）	支持状态
13.x	8.3 ~ 8.5	✅ 支持
12.x	8.2 ~ 8.5	✅ 支持
11.x	8.2 ~ 8.4	✅ 支持
10.x	8.1 ~ 8.3	✅ 支持
≤ 9.x	-	❌ 不再支持（自本次支持 Laravel 13 的改造起移除）

破坏性变更（BC）说明

自本次「新增 Laravel 13 支持」改造起，全局函数 isTableColumnNullable($table, $column) 的返回值语义发生了反转。

变更前：返回 true 表示该字段不允许为空（NOT NULL）——与函数名含义相反，属于历史实现缺陷；
变更后：返回 true 表示该字段允许为 NULL——与函数名一致。

如果你在下游项目里直接调用过这个函数，请务必核对调用逻辑并进行相应取反。元数据读取失败（例如使用了不支持的数据库驱动）时返回 true，即宽松放行、不做必填校验。

本次改造同时移除了对 doctrine/dbal、ycookies/plugin-store、dcat/easy-excel 的强制依赖（三者已在 composer.json 中降级为 suggest，不再强制安装）。

依赖约束调整（如果你的项目此前依赖这些包的老版本，请留意）：

tymon/jwt-auth 从 ^1.0|^2.1 收窄为 ^2.1（不再支持 1.x）；
spatie/eloquent-sortable 从 3.*|4.* 放宽为 3.*|4.*|5.*（Laravel 13 下有硬性需要）；
dcat/easy-excel 已废弃（deprecated）：运行时代码不再使用它。Excel 的导入与导出已统一改用 maatwebsite/excel（^3.1）实现，涉及 ExcelExporter、数据导入表单、导入模板下载三处。

作者与开源协议

原作者：杨光（3664839@qq.com）——本项目基于其 dcat-plus-admin 二次开发，原作者署名予以保留。
当前维护：lkddi（lkddi@163.com）——仓库 github.com/lkddi/dcat-plus-admin。
开源协议：MIT（见 LICENSE 文件，未做修改）。二次分发时请一并保留原作者信息与 MIT 声明。
当前版本：3.1.0（对应 Dcat\Admin\Admin::VERSION）。

安装

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

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

composer create-project --prefer-dist laravel/laravel 项目名称 10.*
# 或
composer create-project --prefer-dist laravel/laravel 项目名称

安装完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 版（原作者：杨光；当前维护：lkddi）
composer require lkddi/dcat-plus-admin

# 或指定版本号
composer require lkddi/dcat-plus-admin:3.1.0

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

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