从安装到部署：laravel-admin一站式使用教程

2026-01-29 12:25:19作者：裴麒琰

想要快速构建功能完善的后台管理系统吗？laravel-admin就是你的终极解决方案！这款基于Laravel框架的后台管理工具，让你在10分钟内就能搭建出专业级的后台界面。🚀

为什么选择laravel-admin？

laravel-admin是一款专为Laravel开发者设计的后台管理系统，它提供了丰富的组件和优雅的API，让后台开发变得简单高效。无论你是新手还是资深开发者，都能快速上手。

快速安装步骤

环境要求

PHP 7.0+
Laravel 5.5+

一键安装命令

首先确保你的Laravel项目已经配置好数据库连接：

composer require encore/laravel-admin "1.5.*"

发布资源文件：

php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

完成安装：

php artisan admin:install

安装完成后，访问 http://localhost/admin，使用默认账号（admin/admin）即可登录。

项目结构解析

安装完成后，你的项目中将生成以下重要文件：

配置文件

config/admin.php - 所有后台配置都在这里

核心目录

app/Admin
├── Controllers
│   ├── ExampleController.php
│   └── HomeController.php
├── bootstrap.php
└── routes.php

快速创建数据管理界面

假设你有一个User模型，想要为其创建完整的CRUD操作：

生成控制器

php artisan admin:make UserController --model=App\\User

配置路由

在 app/Admin/routes.php 中添加：

$router->resource('users', UserController::class);

添加菜单

访问后台菜单管理页面（http://localhost/admin/auth/menu），添加对应的菜单项即可在侧边栏看到用户管理入口。

强大的数据表格功能

laravel-admin的Grid组件提供了丰富的数据展示功能：

基础表格配置

$grid = Admin::grid(User::class, function(Grid $grid){
    $grid->id('ID')->sortable();
    $grid->name('姓名');
    $grid->email('邮箱');
    $grid->created_at('创建时间');
});

关联模型展示

支持一对一、一对多、多对多关联模型的展示：

// 展示用户关联的角色信息
$grid->roles()->display(function ($roles) {
    return join(', ', array_column($roles, 'name'));
});

自定义表单构建

laravel-admin的表单构建器同样强大：

表单字段配置

$form->text('name', '姓名')->rules('required');
$form->email('email', '邮箱')->rules('required|email');
$form->password('password', '密码')->rules('required|min:6');