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 则可以在方法内设置本页面的内容。headerdescription 是页面的主、副标题,可按需设置。另外可看到本页面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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,509评论 6 504
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,806评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,875评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,441评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,488评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,365评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,190评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,062评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,500评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,706评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,834评论 1 347
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,559评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,167评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,779评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,912评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,958评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,779评论 2 354

推荐阅读更多精彩内容

  • 原文链接 必备品 文档:Documentation API:API Reference 视频:Laracasts ...
    layjoy阅读 8,607评论 0 121
  • HTML表单 在HTML中,表单是 ... 之间元素的集合,它们允许访问者输入文本、选择选项、操作对象等等,然后将...
    兰山小亭阅读 3,417评论 2 14
  • 在这个求快的时代,写信寄信等信读信是一件件很慢却给人心灵享受的事。 写信是一件幸福事。手握笔杆,坐于案前,思绪万千...
    闲散25划阅读 187评论 0 0
  • 描述: 信用加,让生活更简单! 信用加是集各种信用管理于一体的辅助型工具,为年轻人提供免费的查询功能。它的界面清新...
    兼客网络科技阅读 523评论 0 0
  • 我们这世界上大部分的失落,都是因为我们自己没成为更好的自己,却奢求着别人成为更好的别人。我们想读书的人,不会说没文...
    黄飞鸿528阅读 230评论 0 0