快速上手DCAT-Admin开发指南

安装 DCAT-Admin

确保系统已安装 PHP（≥7.3）和 Composer。通过 Composer 创建 Laravel 项目并安装 DCAT-Admin：

bash 复制代码

composer create-project laravel/laravel dcat-admin-demo
cd dcat-admin-demo
composer require dcat/laravel-admin

发布资源文件并执行数据库迁移：

bash 复制代码

php artisan admin:publish
php artisan migrate

配置基础信息

修改 .env 文件配置数据库连接：

ini 复制代码

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dcat_admin
DB_USERNAME=root
DB_PASSWORD=

创建管理员账号：

bash 复制代码

php artisan admin:admin

创建数据模型与控制器

使用 Artisan 命令生成模型和控制器：

bash 复制代码

php artisan make:model Product -m
php artisan admin:controller ProductController --model=App\\Models\\Product

编辑迁移文件 database/migrations/xxxx_create_products_table.php：

php 复制代码

Schema::create('products', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->decimal('price', 10, 2);
    $table->text('description')->nullable();
    $table->timestamps();
});

运行迁移：

bash 复制代码

php artisan migrate

配置后台菜单

在 app/Admin/bootstrap.php 中添加菜单项：

php 复制代码

use Dcat\Admin\Admin;

Admin::menu()->add([
    [
        'title' => '产品管理',
        'icon' => 'fa-shopping-bag',
        'uri' => 'products',
    ],
]);

自定义列表页与表单

编辑 app/Admin/Controllers/ProductController.php：

php 复制代码

use App\Models\Product;
use Dcat\Admin\Form;
use Dcat\Admin\Grid;

protected function grid()
{
    return Grid::make(new Product(), function (Grid $grid) {
        $grid->column('id')->sortable();
        $grid->column('name');
        $grid->column('price');
        $grid->column('created_at');
    });
}

protected function form()
{
    return Form::make(new Product(), function (Form $form) {
        $form->text('name')->required();
        $form->currency('price')->symbol('¥');
        $form->textarea('description');
    });
}

启动开发服务器

运行 Laravel 开发服务器并访问后台：

bash 复制代码

php artisan serve

通过浏览器访问 http://localhost:8000/admin，使用创建的管理员账号登录。

扩展功能示例

添加图片上传字段到表单：

php 复制代码

$form->image('image')->uniqueName()->move('products');

启用数据表格过滤器：

php 复制代码

$grid->filter(function (Grid\Filter $filter) {
    $filter->like('name', '名称');
    $filter->between('price', '价格');
});

部署到生产环境

配置 Nginx/Apache 指向项目 public 目录，优化性能：

bash 复制代码

php artisan config:cache
php artisan route:cache
php artisan view:cache