使用Laravel搭建CURD后台页面

 

本文版权归 博客园 叶剑峰 所有，此处为技术收藏，如有再转，敬请于文章篇头添加原创作者及出处信息，以示尊重！！

专注Web开发50年。请加群：

本文基于署名-非商业性使用 3.0许可协议发布，欢迎转载，演绎，但是必须保留本文的署名叶剑峰（包含链接http://www.cnblogs.com/yjf512/），且不得用于商业目的。如您有任何疑问或者授权方面的协商，请与我联系。

配置即一切

一切皆于需求，后台从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属性，来将所有的字段来进行一个说明和定义。这个定义和说明就包括字段显示名字，字段是否要进行搜索，字段类型是什么。

对于列表页，不是所有属性都显示出来，所以定义一个fieldsshow，这个数组存放的是fieldsshow，这个数组存放的是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，fieldsall,fieldsall,fields_show, fieldsedit,fieldsedit,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′,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(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="@if (isset($input[$field])){{$input[$field]}}@endif">
              </div>
            </div>
            @endif
          @endforeach
          <input type="submit" class="btn btn-success" value="查询" />
        </form>

 

编辑页面和创建页面

简单到只需要一个form就能搞定了

 

  <form class="form-horizontal"
          role="form"
          action="{{action($controller . "@update", $model->id)}}" method='POST'>
          <input type="hidden" name="_method" value="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="{{$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对应字段？