laravel-admin后台框架基本使用

laravel-admin官方中文文档：http://laravel-admin.org/docs/#/zh/
laravel-admin的github：https://github.com/z-song/laravel-admin

一、安装与配置

按照官方文档或者github的步骤安装和配置即可。

二、建立控制器

在app/Admin/Controllers新建对应的控制器来管理某个数据表。
控制器例子：

 1 <?php
 2 
 3 namespace App\Admin\Controllers;
 4 
 5 use Encore\Admin\Form;
 6 use Encore\Admin\Grid;
 7 use Encore\Admin\Facades\Admin;
 8 use Encore\Admin\Layout\Content;
 9 use App\Http\Controllers\Controller;
10 use Encore\Admin\Controllers\ModelForm;
11 
12 class ExampleController extends Controller
13 {
14     use ModelForm;
15 
16     /**
17      * Index interface.
18      *
19      * @return Content
20      */
21     public function index()
22     {
23         return Admin::content(function (Content $content) {
24 
25             $content->header(\'header\');
26             $content->description(\'description\');
27 
28             $content->body($this->grid());
29         });
30     }
31 
32     /**
33      * Edit interface.
34      *
35      * @param $id
36      * @return Content
37      */
38     public function edit($id)
39     {
40         return Admin::content(function (Content $content) use ($id) {
41 
42             $content->header(\'header\');
43             $content->description(\'description\');
44 
45             $content->body($this->form()->edit($id));
46         });
47     }
48 
49     /**
50      * Create interface.
51      *
52      * @return Content
53      */
54     public function create()
55     {
56         return Admin::content(function (Content $content) {
57 
58             $content->header(\'header\');
59             $content->description(\'description\');
60 
61             $content->body($this->form());
62         });
63     }
64 
65     /**
66      * Make a grid builder.
67      *
68      * @return Grid
69      */
70     protected function grid()
71     {
72         return Admin::grid(YourModel::class, function (Grid $grid) {
73 
74             $grid->id(\'ID\')->sortable();
75 
76             $grid->created_at();
77             $grid->updated_at();
78         });
79     }
80 
81     /**
82      * Make a form builder.
83      *
84      * @return Form
85      */
86     protected function form()
87     {
88         return Admin::form(YourModel::class, function (Form $form) {
89 
90             $form->display(\'id\', \'ID\');
91 
92             $form->display(\'created_at\', \'Created At\');
93             $form->display(\'updated_at\', \'Updated At\');
94         });
95     }
96 }

其中最重要的方法是 grid() 和 form() ，分别对应数据列表（表格）和数据表单的内容。

建立控制器后，在 app\Admin\routes.php 加上相应的资源路由：

1 $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() 提供。

 1 public function index()
 2     {
 3         return Admin::content(function (Content $content) {
 4 
 5             $content->header(\'页面主标题\');
 6             $content->description(\'页面副标题\');
 7 
 8             $content->body($this->grid());
 9         });
10     }

3、grid() 方法用于构建基于数据模型的数据表格。首先要将 YourModel 改为真实的数据模型，然后就可以使用 $grid 构建表单。

每个$grid代表一列数据，指向的是数据表字段名，括号内的是本列的标题名称。若括号内不填标题名称，则自动使用数据表字段名的字符串代替。

 1 protected function grid()
 2     {
 3         return Admin::grid(YourModel::class, function (Grid $grid) {
 4 
 5             // 直接通过字段名`username`添加列
 6             $grid->username(\'用户名\');
 7             // 效果和上面一样
 8             $grid->column(\'username\', \'用户名\');
 9             //若需要经过复杂逻辑，可使用display方法修改输出
10             $grid->gender(\'性别\')->display(function($data){
11                 $result = \'\';
12                 $result = YourModel::$genderGroup[$data];
13                 return $result;
14             });
15             $grid->mobile_phone(\'手机\');
16             $grid->address(\'通讯地址\');
17         });
18     }

4、数据表格最后一列默认是操作列，包含编辑按钮与删除按钮。如果需要自定义操作列，则可以把默认的操作列禁用，再进行自定义。

1 $grid->disableActions();

四、生成模型表单

控制器内的 created() 和 edit() 分别对应着模型表单的新增与编辑操作。并且新增、编辑表单共用控制器内的 form() 进行表单构建。

修改form()来构建表单内容：
$form指向的是表单控件类型（text是文本域，radio是单选框等），方法内第一个参数是数据表字段名，第二个参数是字段显示名称。

 1 protected function form()
 2     {
 3         return Admin::form(Investor::class, function (Form $form) {
 4             //display仅作显示对应内容
 5             $form->display(\'id\', \'ID\');
 6             //文本域
 7             $form->text(\'name\',\'姓名\');
 8             //单选框，options方法是单选框内容，格式为key=>value的数组形式。
 9             $form->radio(\'gender\',\'性别\')->options(Investor::$genderGroup);
10             //......
11         });
12     }

更多的表单组件使用方法请查看http://laravel-admin.org/docs/#/zh/model-form-fields