laravel-admin后台框架基本使用

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