首页 > 代码库 > 使用laravel一分钟搭建CURD后台页面

使用laravel一分钟搭建CURD后台页面

配置即一切

一切皆于需求,后台从0开始搭建,但是写了一两个页面后发现太多的是对单表的增删改查操作,于是就想到了,能不能做一个快速搭建的后台。想到一句话,配置即一切。如果一个CURD后台能只进行配置就自动生成,该是多么美妙的事情,那么就开始搭建这么个结构。
 

首先配置文件应该怎么设计

起初想到将配置文件放到config目录下,但是想想还是放弃了这个想法,那样子可能会导致有一个“万能”文件,又臭又长。那么,其次,这个功能只针对单表,所以,是不是可以将配置文件放置在Model中,后来也觉得这个想法不大好,这个配置文件是承担页面展示的功能的,如果放在Model中就算是入侵了Model层了。所以最后决定放在了Controller中。
 

最后的效果大概是什么样子的?

后台大概会有几个页面:

列表页:

列表页中有查询操作,编辑,删除按钮,新建按钮。

新建页面:

 

编辑页面:

 
好了,对应这几个页面,我们可以设置配置项了。
 
基本想法是搭建一个FormController,所有以后需要配置生成后台的controller就继承这个FormController就好了。在FormController中定义属性:
class FormController extends BaseController {      // 对应的模型     protected $model;      // 所有的字段     protected $fields_all;      // 列表页显示的字段     protected $fields_show;      // 编辑页面显示的字段     protected $fields_edit;      // 创建页面显示的字段     protected $fields_create;}
定义了Model,来表示这个Controller是对那个Model进行单表操作的。
定义了fields_all属性,来将所有的字段来进行一个说明和定义。这个定义和说明就包括字段显示名字,字段是否要进行搜索,字段类型是什么。
对于列表页,不是所有属性都显示出来,所以定义一个$fields_show,这个数组存放的是$fields_all中的一些字段,用来显示的字段。
对于编辑页面,要显示的字段就放在$field_edit中
对于创建页面,要显示的字段就放在$field_create中
 
好了,现在继承FormController的类就只需要这么配置就好;
<?php // 账号管理系统class BadminController extends FormController{      public function __construct()     {          $this->model = \Badmin;          $this->fields_all = [               id => [                    show => 序号,               ],               nickname => [                    show => 昵称,                    search => "nickname like CONCAT(‘%‘, ?, ‘%‘)"               ],               username => [                    show => 用户名,               ],               email => [                    show => 邮箱,               ],               password => [                    show => 密码,               ],               created_at => [                    show => 创建时间,               ],               updated_at => [                    show => 更新时间,               ],          ];           $this->fields_show = [id ,nickname, username, email, created_at];          $this->fields_edit = [nickname, username];          $this->fields_create = [nickname, username, email, password];          parent::__construct();     }} 
在构造函数中定义model,$fields_all, $fields_show, $fields_edit, $fields_create。
对于fields_all,key为数据库对应的字段名,value为一个数组,show是显示名,如果你在列表页希望这个字段能进行搜索,就设置下search属性。
 

路由

下面是路由,laravel中路由基本有三种:
Route::get(order/{id},[as=>order.detail,uses=>OrderController@show]);Route::controller(preview, PreviewController);Route::resource(badmin, BadminController);

 

第三种已经完全定义好了增删改查操作,看起来能省我不少的事情,好吧,我就使用这个resource来做了。
 
所以在route.php中我只需要定义这么一条就ok了
 
// 管理员账号管理Route::resource(badmin, BadminController);

 

Controller 

下面写FromController中的resource方法
 
按照laravel的resource定义的,需要填充的方法有:
 
我习惯在构造函数中把一些诸如Input,全局定义的东西都share到模版中,代码如下:
     public function __construct()     {           // TODO:做一些基础的判断,如果没有的话就抛出异常                   $route = Route::currentRouteAction();          list($this->controller, $action) = explode(@, $route);          View::share(controller, $this->controller);           $fields_show = array();          foreach ($this->fields_show as $field) {               $fields_show[$field] = $this->fields_all[$field];          }          View::share(fields_show, $fields_show);           $fields_edit = array();          foreach ($this->fields_edit as $field) {               $fields_edit[$field] = $this->fields_all[$field];          }          View::share(fields_edit, $fields_edit);           $fields_create = array();          foreach ($this->fields_create as $field) {               $fields_create[$field] = $this->fields_all[$field];          }          View::share(fields_create, $fields_create);           View::share(input, Input::all());     }

 

这里把controller放到外面是为了在view中可以使用诸如:
action($controller . ‘@destroy‘, $model->id),
的路径定义
 
index函数:
 
      public function index()     {          $model = new $this->model;          $builder = $model->orderBy(id, desc);           $input = Input::all();          foreach ($input as $field => $value) {               if (empty($value)) {                    continue;               }               if (!isset($this->fields_all[$field])) {                    continue;               }               $search = $this->fields_all[$field];               $builder->whereRaw($search[search], [$value]);          }          $models = $builder->paginate(20);           return View::make(form.index, [               models => $models,          ]);     } 

$builder在laravel中真是太TMD好用了,对于这里的搜索,我使用whereRaw进行prepare查询。这里还有一个点,之前在fields_all设计的时候,我定义的直接是一个 ‘search‘ => "nickname like CONCAT(‘%‘, ?, ‘%‘)"  这里定义搜索字段的时候其实有很多种设计方法,比如定义为

‘search’ => [     type => like,     value => %?%]

 

 
但是考虑到使用这个FromController的都是程序员,所以这里的search直接使用预处理的语句,然后在index中直接使用whereRaw,这样使得配置文件的易读性增加了。
 
下面是

create函数:

     public function create()     {          return View::make(form.create, []);     } 

 

store函数:

     public function store()     {          $model = new $this->model;          $model->fill(Input::all());          $model->save();          return Redirect::to(action($this->controller . @index));     } 

 

这里的model的fill是不是很简单,爽到爆。当然model中还是需要定义fillable字段
 

edit,update,destory函数

如法炮制就好
 
     public function edit($id)     {          $model = new $this->model;          $model = $model->find($id);          return View::make(form.edit, compact(model));     }      public function update($id)     {          $model = new $this->model;          $model = $model->find($id);          $model->fill(Input::all());          $model->save();           return Redirect::to(action($this->controller . @index));     }      public function destroy($id)     {          $model = new $this->model;          $model->destroy($id);                   return Redirect::to(action($this->controller . @index));     } 

 

 View

下面就是view的编写。
view大概就只要三个页面,列表页面,编辑页面,创建页面
 

列表页面注意事项:

1 使用laravel自带分页,注意记得带上本页的输入参数,这个时候,构造函数中share的Input就很有用了

{{$models->appends($input)->links()}}
 

2 可以使用laravel自带的from操作,比如删除操作由于需要调用HTTP的DELETE 方法,可以这么写

                 {{ Form::open(array(                  id => "delete_{$model->id}",                  url => action($controller . @destroy, $model->id),                  class => dropdown-toggle)) }}                    {{ Form::hidden(_method, DELETE) }}                  {{ Form::close() }}

 

 
其实自己写DELETE也行,就是在From表单中多传递一个_method隐藏域
 

3 搜索直接使用一个form就可以搞定了

     <form class="form-inline" role="form" action="{{action($controller . ‘@index‘)}}">          @foreach ($fields_show as $field => $field_info)            @if (isset($field_info[search]))            <div class="form-group">              <label class="col-sm-3 control-label">{{$field_info[show]}}</label>              <div class="col-md-3">                <input name="{{$field}}" type="input" class="form-control" placeholder="" value=http://www.mamicode.com/"@if (isset($input[$field])){{$input[$field]}}@endif">              </div>            </div>            @endif          @endforeach          <input type="submit" class="btn btn-success" value=http://www.mamicode.com/"查询" />        </form>

 

编辑页面和创建页面

简单到只需要一个form就能搞定了
 
  <form class="form-horizontal"          role="form"          action="{{action($controller . "@update", $model->id)}}" method=POST>          <input type="hidden" name="_method" value=http://www.mamicode.com/"PUT">            @foreach ($fields_edit as $field => $field_info)            <div class="form-group">              <label class="col-sm-2 control-label">{{$field_info[show]}}</label>              <div class="col-sm-10">                <input name="{{$field}}" type="text" class="form-control" placeholder="" value=http://www.mamicode.com/"{{$model->$field}}">              </div>            </div>            <div class="line line-dashed line-lg pull-in"></div>            @endforeach            <div class="col-sm-4 col-sm-offset-2">              <button type="submit" class="btn btn-primary">提交</button>            </div>          </form>

 

 
记得resource中更新的操作是要使用PUT方式,删除的操作要使用DELETE方式。
至于view的模版,我这里使用的是一款叫notebook的模版,它是基于bootstrap的,你也可以使用其他更好看的模版来写。
 
好了,至此这么个快速搭建CURD的结构就完成了。现在可以在运营人员给需求的时候,很牛逼地说,等我一分钟,我就给你一个世界~~

后记

其实回想下,这整个结构不算复杂。配置即一切的思想能解决很多问题。但是依赖配置的路子最怕的是几个事情:
1 配置文件过于复杂。(如果你的配置文件过于复杂,已经超过了敲代码本身需要了解的东西,那么这个配置项的学习成本就太太太高了)
2 配置字段语意不清。(配置的字段名字和意思不对,字段名和变量名一样重要!)
 
当然这个就是个初步,改进的几个点还有
1 所有字段都使用input标签,需要在配置中加入其它标签类型
2 是不是考虑view中所有的东西都使用laravel自带的form对应字段?

使用laravel一分钟搭建CURD后台页面