配置即一切
一切皆于需求,后台从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‘=>‘[email protected]‘]); 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="@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对应字段?