上次我们学习了laravel-admin的安装。今天我们来说说laravel-admin的使用。
菜单创建好之后,url路径我们也定好了,接下来就是创建资源控制器了,使用如下命令:
php artisan admin:make MemberController - -model=App\Models\Member
后面的 – model 告诉此控制器使用哪一个模型。我们的Member 模型是提前创建好的。创建好的控制器是一个资源控制器,如下:
header('Index')
->description('description')
->body($this->grid());
}
/**
* Show interface.
*
* @param mixed $id
* @param Content $content
* @return Content
*/
public function show($id, Content $content)
{
return $content
->header('Detail')
->description('description')
->body($this->detail($id));
}
/**
* Edit interface.
*
* @param mixed $id
* @param Content $content
* @return Content
*/
public function edit($id, Content $content)
{
return $content
->header('Edit')
->description('description')
->body($this->form()->edit($id));
}
/**
* Create interface.
*
* @param Content $content
* @return Content
*/
public function create(Content $content)
{
return $content
->header('Create')
->description('description')
->body($this->form());
}
/**
* Make a grid builder.
*
* @return Grid
*/
protected function grid()
{
$grid = new Grid(new Member);
return $grid;
}
/**
* Make a show builder.
*
* @param mixed $id
* @return Show
*/
protected function detail($id)
{
$show = new Show(Member::findOrFail($id));
return $show;
}
/**
* Make a form builder.
*
* @return Form
*/
protected function form()
{
$form = new Form(new Member);
return $form;
}
}
其中最重要的方法是 grid() 和 form() ,分别对应数据列表(表格)和数据表单的内容。
创建好之后,需要在Admin目录下的routes.php里面添加路由信息,如下:
config('admin.route.prefix'),
'namespace' => config('admin.route.namespace'),
'middleware' => config('admin.route.middleware'),
], function (Router $router) {
$router->get('/', 'HomeController@index');
/**这里是自己添加的新资源路由***/
$router->resource('member', 'MemberController');
});
1.创建模型
使用 如下命令创建模型(后面的 -m 代表生成迁移文件,根据自己的需要而来)
php artisan make:model Models\Member -m
在迁移文件里面定义数据表的字段、迁移、添加测试数据,这里不在赘述,具体数据库迁移见下面的文章:
https://blog.csdn.net/dmguying/article/details/87654279
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() 方法用于构建基于数据模型的数据表格。首先要将 MemberModel 改为真实的数据模型,然后就可以使用 $grid 构建表单。
每个$grid代表一列数据,指向的是数据表字段名,括号内的是本列的标题名称。若括号内不填标题名称,则自动使用数据表字段名的字符串代替,如下:
protected function grid()
{
$grid = new Grid(new Member);
// 直接通过字段名`name`添加列
$grid->name('用户名');
//效果和上面一样
$grid->column('phone', '手机号');
$grid->email('邮箱');
// //若需要经过复杂逻辑,可使用display方法修改输出
$grid->sex('性别')->display(function ($sex) {
$ret = '';
if ($sex == 1){
$ret = '帅哥';
}elseif($sex == 0){
$ret = '美女';
}else{
$ret = '保密';
}
return $ret;
});
//处理图片有专门的
//http://m.laravel.cc 这个是站点的域名,显示的时候自动把数据表的字段连接起来
$grid->head_image('头像')->image('http://m.laravel.cc', 30, 30);
return $grid;
}
4、数据表格最后一列默认是操作列,包含编辑按钮与删除按钮。如果需要自定义操作列,则可以把默认的操作列禁用,再进行自定义。
//禁用按钮,自己定义 $grid->disableActions();
//在原来的基础上修改
$grid->actions(function ($actions) {
$id = $actions->getKey();
// prepend一个操作
$str = '自定义操作2';
$actions->prepend($str);
});
控制器内的 created() 和 edit() 分别对应着模型表单的新增与编辑操作。并且新增、编辑表单共用控制器内的 form() 进行表单构建。
修改form()来构建表单内容:
$form指向的是表单控件类型(text是文本域,radio是单选框等),方法内第一个参数是数据表字段名,第二个参数是字段显示名称。如下:
protected function form()
{
$form = new Form(new Member);
// 显示记录id
$form->display('id', 'ID');
// 添加text类型的input框
$form->text('name', '姓名');
$form->text('email', '邮箱');
$form->text('phone','手机号')->placeholder('请输入手机号');
$form->password('password','密码');
$form->datetime('created_at','创建时间')->default(date('Y-m-d'));
$form->image('head_image','头像');
return $form;
}
这里注意上传图片时配置相应的图片上传路径等相关操作,具体参考官网文档:
https://laravel-admin.org/docs/zh/model-form-upload。
1、实际开发过程中一般是先把数据表确定好,然后再建模型以及控制器,这样在创建控制器之后laravel-admin会自动把控制器中的form和grid根据定义的字段类型,填充出来,需要的时候只做部分修改即可。
2、laravel-admin还可以更好ui界面,按照规则更换自己喜欢的页面风格,具体使用见官方文档:https://laravel-admin.org/docs/zh。