junthink / dcat-admin

v3.0.0 2026-10-23 05:43 UTC

Requires

• php: ^8.3
• ext-fileinfo: *
• ext-zip: *
• dcat/easy-excel: ^1.1
• laravel/framework: ^13.0
• spatie/eloquent-sortable: ^5.0.1

Requires (Dev)

• fakerphp/faker: ^1.23
• intervention/image: ^4.4
• laravel/dusk: ^8.7.2
• mockery/mockery: ^1.6
• nikic/php-parser: ^5.0
• orchestra/testbench: ^11.0
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.5.8

Suggests

• intervention/image: ^4.4 for image transformations and thumbnails (GD or Imagick required)

Conflicts

• dcat/laravel-admin: *
• intervention/image: <4.4

MIT

• jqh
• junthink

• admin
• form
• grid
• laravel
• laravel admin
• dcat

Published on Packagist.org on 2026-10-23 05:49 UTC

README

Dcat Admin 是基于 Laravel 的后台系统构建工具，提供用户与角色权限管理、菜单管理、数据表格、表单、详情页和扩展机制，方便快速开发管理后台。

本项目基于 jqhph/dcat-admin 维护，适配 Laravel 13。Composer 包名为 junthink/dcat-admin，保留 Dcat\Admin 命名空间。

环境要求

• PHP 8.3 或更高版本，启用 Fileinfo、Zip 扩展。
• Laravel 13。
• Composer。

安装

创建 Laravel 项目；已有 Laravel 13 应用可跳过此步：

composer create-project laravel/laravel my-admin "^13.0"
cd my-admin

在 .env 中配置已创建的数据库：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=my_admin
DB_USERNAME=your_username
DB_PASSWORD=your_password

通过 Composer 安装：

composer require junthink/dcat-admin:^3.0 --with-all-dependencies
php artisan admin:publish
php artisan admin:install
php artisan serve

打开 http://127.0.0.1:8000/admin，使用安装命令输出的账号和随机初始密码登录。也可在安装前通过 .env 设置 ADMIN_INITIAL_USERNAME 和 ADMIN_INITIAL_PASSWORD。

部署时，将 Web 服务的根目录指向 Laravel 项目的 public 目录。

使用

安装后，主要开发入口如下：

• config/admin.php：后台地址、认证、数据库和主题配置。
• app/Admin/routes.php：后台路由。
• app/Admin/Controllers/：后台控制器，通过 Dcat\Admin\Grid、Dcat\Admin\Form、Dcat\Admin\Show 构建列表、表单和详情页。
• app/Admin/bootstrap.php：后台组件和行为的初始化配置。

在 app/Admin/routes.php 已有的路由组中注册资源控制器，例如：

$router->resource('posts', 'PostController');

后台控制器可参考 app/Admin/Controllers/HomeController.php。查看可用管理命令：

php artisan admin

更新包后，重新发布前端资源：

php artisan admin:publish --assets --force

修改本仓库的前端源码时，需要 Node.js 22 或更高版本，在仓库根目录执行：

npm ci
npm run production