laravel-admin官方中文文档：http://laravel-admin.org/docs/#/zh/
laravel-admin的github：https://github.com/z-song/laravel-admin
一、安装与配置
按照官方文档或者github的步骤安装和配置即可。
二、建立控制器
在app/Admin/Controllers新建对应的控制器来管理某个数据表。
控制器例子：
<?php
namespace App\Admin\Controllers;
use Encore\Admin\Form;
use Encore\Admin\Grid;
use Encore\Admin\Facades\Admin;
use Encore\Admin\Layout\Content;
use App\Http\Controllers\Controller;
use Encore\Admin\Controllers\ModelForm;
class ExampleController extends Controller
{
use ModelForm;
/**
* Index interface.
*
* @return Content
*/
public function index()
{
return Admin::content(function (Content $content) {
$content->header('header');
$content->description('description');
$content->body($this->grid());
});
}
/**
* Edit interface.
*
* @param $id
* @return Content
*/
public function edit($id)
{
return Admin::content(function (Content $content) use ($id) {
$content->header('header');
$content->description('description');
$content->body($this->form()->edit($id));
});
}
/**
* Create interface.
*
* @return Content
*/
public function create()
{
return Admin::content(function (Content $content) {
$content->header('header');
$content->description('description');
$content->body($this->form());
});
}
/**
* Make a grid builder.
*
* @return Grid
*/
protected function grid()
{
return Admin::grid(YourModel::class, function (Grid $grid) {
$grid->id('ID')->sortable();
$grid->created_at();
$grid->updated_at();
});
}
/**
* Make a form builder.
*
* @return Form
*/
protected function form()
{
return Admin::form(YourModel::class, function (Form $form) {
$form->display('id', 'ID');
$form->display('created_at', 'Created At');
$form->display('updated_at', 'Updated At');
});
}
}
其中最重要的方法是 grid() 和 form() ，分别对应数据列表（表格）和数据表单的内容。
建立控制器后，在 app\Admin\routes.php 加上相应的资源路由：
$router->resource('example', ExampleController::class);
至此即可使用 /admin/example 访问这个管理的数据列表。
三、生成模型表格
1、由于laravel-admin模型表格基于laravel的数据模型，所以首先需要建立数据表的对应数据模型。如：
/*加上 -m 可以同时生成迁移文件（按需）*/
php artisan make:model Models\Investor -m
2、在控制器中 index() 是模型表格页面的入口，Admin::content 则可以在方法内设置本页面的内容。header 和 description 是页面的主、副标题，可按需设置。另外可看到本页面body的内容由 $this->grid() 提供。
public function index()
{
return Admin::content(function (Content $content) {
$content->header('页面主标题');
$content->description('页面副标题');
$content->body($this->grid());
});
}
3、grid() 方法用于构建基于数据模型的数据表格。首先要将 YourModel 改为真实的数据模型，然后就可以使用 $grid 构建表单。
每个$grid代表一列数据，指向的是数据表字段名，括号内的是本列的标题名称。若括号内不填标题名称，则自动使用数据表字段名的字符串代替。
protected function grid()
{
return Admin::grid(YourModel::class, function (Grid $grid) {
// 直接通过字段名`username`添加列
$grid->username('用户名');
// 效果和上面一样
$grid->column('username', '用户名');
//若需要经过复杂逻辑，可使用display方法修改输出
$grid->gender('性别')->display(function($data){
$result = '';
$result = YourModel::$genderGroup[$data];
return $result;
});
$grid->mobile_phone('手机');
$grid->address('通讯地址');
});
}
4、数据表格最后一列默认是操作列，包含编辑按钮与删除按钮。如果需要自定义操作列，则可以把默认的操作列禁用，再进行自定义。
$grid->disableActions();
四、生成模型表单
控制器内的 created() 和 edit() 分别对应着模型表单的新增与编辑操作。并且新增、编辑表单共用控制器内的 form() 进行表单构建。
修改form()来构建表单内容：
$form指向的是表单控件类型（text是文本域，radio是单选框等），方法内第一个参数是数据表字段名，第二个参数是字段显示名称。
protected function form()
{
return Admin::form(Investor::class, function (Form $form) {
//display仅作显示对应内容
$form->display('id', 'ID');
//文本域
$form->text('name','姓名');
//单选框，options方法是单选框内容，格式为key=>value的数组形式。
$form->radio('gender','性别')->options(Investor::$genderGroup);
//......
});
}
更多的表单组件使用方法请查看http://laravel-admin.org/docs/#/zh/model-form-fields
网友评论