Laravel 5系列教程八：queryScope 和 setAttribute

原文来自 https://laravist.com/article/16

免费视频教程地址 https://laravist.com/series/laravel-5-basic

Laravist是我刚刚上线的Laravel社区，有任何与Laravel相关的问题能够到这里来问我，我会尽力去帮你们解决问题，后期会尝试录制一些视频教程，形式大概是这样的

https://laravist.com/lesson/1

直接就是按照上一节所说的那样，咱们来讲说queryScope和setAttribute在laravel的用法。

关于应用场景

这里我首先是想向你们简单说说这两个知识点得应用场景是什么，咱们在开发的时候，老是但愿有一种偷懒的方式，因此考虑如下这两个场景：

1. 数据在存入数据库的时候须要进行预先处理，好比考虑一个简单地例子：咱们在保存用户的登陆密码的时候，都是须要将密码用某种方式加密事后在写入数据库的，咱们难道在每一次在提交表单过来以后都对传过来的数据进行一次数据加密么？能不能有一种自动完成对密码入库前就加密的机制呢？这样咱们在处理表单的时候就不用关心密码加密的问题了

2. 想想咱们在向用户展现的数据是否是基本上都是从数据库取的呢？那么每每咱们会有不少的查询语句，在这样的状况之下不少的查询语句能够就会重复，可是在写代码这一行中，一旦出现多个重复，基本上就会有优化方式存在，因此这个时候queryScope就派上用场了

setAttributes

以前，咱们都是将published_at设置为文章建立的日期：

$input['published_at'] = Carbon::now();

然而这并非咱们想要的，咱们但愿有一种能够控制的方式，好比在表单之中设置文章的发布日期，因此，咱们来实现一下：首先将published_at这个字段放到咱们的form之中，在create.blade.php中，加入published_at 输入框输入：

<div class="form-group">
{!! Form::label('published_at','发布日期') !!}
{!! Form::input('date','published_at',date('Y-m-d'),['class'=>'form-control']) !!}
</div>

这一段代码加在textarea后面，这里使用了Form::input()，这个方法，由于Form这个类没有相似Form::date()指定date的方法，因此咱们使用Form::input()并指定input的类型为date，并使用date('Y-m-d')来指定默认值为文章发布当天，可是咱们能够修改，咱们来看看咱们的页面如今是什么样的：

这里咱们能够看到咱们拿到了published_at这个字段了，这个时候，能够修改一下ArticleController中的store()方法的代码了：

$input = $request->all();
$input['intro'] = mb_substr($request->get('content'),0,64);
Article::create($input);
return redirect('/');

咱们删除了$input['published_at'] = Carbon::now();这一行代码，而后尝试建立一篇文章来看看：

OK，到这里，文章能够建立成功了，可是若是咱们看看数据库当中的数据：

这里的日期设置成的格式并非理想的模式，有没有一种方式能够将其设置为跟created_at和updated_at同样的呢？时分秒均可以知道的呢？这个时候就可使用setAttribute来完成了，在Article.php中添加下面的方法：

public function setPublishedAtAttribute($date)
{
    $this->attributes['published_at'] = Carbon::createFromFormat('Y-m-d',$date);
}

这里注意这个写法set+字段名+Attribute，还有的就是使用驼峰法。好比你要加密密码的时候能够这样：

public function setPasswordAttribute($passowrd)
{
    $this->attributes['password'] = Hash::make($passowrd);
    //仅仅是举例
}

这里咱们使用了Carbon这个类，由于咱们还想将published_at字段做为Carbon对象来处理，这样后期会有很大的好处。注意在文件头部使用use Carbon\Carbon;来引入Carbon。这个时候咱们再来发表一次：

再来看看数据库：

这样一来格式是对了，那么再来为Article.php添加一行代码使published_at做为Carbon对象来处理：

protected $dates = ['published_at'];

对这样就完成了，关于更多地Carbon好处和使用特性，咱们在后面再说。

queryScope

上面实现了用published_at实现了文章的发布日期，可是如今的文章展现仍是原来的样式，这并非咱们想要的结果，由于咱们刚刚设置发表日期为9-12的文章(写文章的时候为9-08)也展现出来了,咱们得限制一下。首先咱们能够在查询的时候直接实现，好比在ArticleController的index()方法中将查询语句写成这样：

$articles = Article::where('published_at','<=',Carbon::now())->latest()->get();

咱们使用where()直接限制published_at时间小于或等于当前时间的文章才进行显示，看看效果：

发如今将来时间发布的文章确实隐藏了，这样貌似已经达到了目的，为何还要引入qeuryScope这个用法呢？这是由于考虑到代码的重用性，好比咱们要是多个地方使用到Article::where('published_at','<=',Carbon::now())这个条件限制呢，咱们有没有一种方式能够将查询语句写成相似下面这种形式呢？

$articles = Article::latest()->published()->get();

就是直接使用published()这个自定义的方法来代替where('published_at','<=',Carbon::now())呢，这样代码可读性也会更好。

因此咱们就来讲说，queryScope的用法了，想一想咱们以前设置published_at这个字段的目的：

咱们但愿能够对文章进行简单地管理，好比咱们在写系列文章的时候，有可能一天写了好几篇，可是这种时候其实咱们发一篇文章就行了，天天消化一篇文章就很不错了，因此做为做者，我并不想还没到发布日期的文章就展现给用户看，可是，我写了文章也想把它存入数据库，让它在该发布的日期自动显示，这样就行了。因而，咱们能够好好利用一下published_at这个字段

在咱们的Article.php中增长下面的方法：

public function scopePublished($query)
{
    $query->where('published_at','<=',Carbon::now());
}

这里注意一下写法scope+自定义的方法名字，还有就是一如既往的驼峰法。好比咱们想使用published()这个方法，就定义为scopePublished($query)。这个时候就能够真正的使用上面说的查询了，在ArticleController的index()方法中：

$articles = Article::latest()->published()->get();

再去看看效果，相信你刷新以后仍是同样的。

总结

又是最后的结尾了，这里咱们简单的介绍了queryScope和setAttribute的用法，下一节打算说说Eloquent的一个重要的内容：Eloquent Relationship。那个时候也就会愈来愈以为laravel的强大了。

最后：Happy Hacking