[TOC]
# 分组
组 Group By
~~~
use DB;
//SELECT `gender`,COUNT(`gender`) as `count` FROM `users` GROUP BY `gender`
User::groupBy('gender')->get(['gender', DB::raw('COUNT(`gender`) as `count`')]);
// gender count
// 1 234
// 2 123
~~~
> 在需要使用SQL语句的情况下，可使用 DB::raw() 来包裹
# 别名 AS
## 字段别名
~~~
//SELECT `id` as `uid`, `username` as `account` FROM `users` WHERE `id` = 1
$user = User::find(1, ['id as uid', 'username as account']);
$user->uid; //1
~~~
## 表别名
~~~
//SELECT `users`.*, `b`.`role_id` FROM `users` INNER JOIN `role_user` AS `b` ON `b`.`user_id` = `users`.`id` WHERE `b`.`role_id` = 99
User::join('role_user as b', 'b.user_id', '=', 'users.id', 'INNER')->where('b.role_id', 99)->get(['users.*', 'b.role_id'])
~~~
# 实际调用
* Model中的 where、whereIn、orderBy、groupBy、join等方法，都是通过
Illuminate\Database\Eloquent\Builder
Illuminate\Database\Query\Builder
来实现的。
* Model中的find，create，destroy，update 都是封装的一些常规方法
# 模型的 boot() 方法
在一个 Eloquent 模型中，有个神奇的地方，叫 boot()，在那里，你可以覆盖默认的行为：
~~~
class User extends Model
{
public static function boot()
{
parent::boot();
static::updating(function($model)
{
// 写点日志啥的
// 覆盖一些属性，类似这样 $model->something = transform($something);
});
}
}
~~~
在创建模型对象时设置某些字段的值，大概是最受欢迎的例子之一了。 一起来看看在创建模型对象时，你想要生成 UUID 字段 该怎么做。
~~~
public static function boot()
{
parent::boot();
self::creating(function ($model) {
$model->uuid = (string)Uuid::generate();
});
}
~~~
# 模型特性：时间、追加等
Eloquent模型有些参数，使用类的属性形式。最常用是：
~~~
class User extends Model {
protected $table = 'users';
protected $fillable = ['email', 'password']; // 可以被批量赋值字段，如 User::create() 新增时，可使用字段
protected $dates = ['created_at', 'deleted_at']; // 需要被Carbon维护的字段名
protected $appends = ['field1', 'field2']; // json返回时，附加的字段
}
~~~
不只这些，还有：
~~~
protected $primaryKey = 'uuid'; // 更换主键
public $incrementing = false; // 设置 不自增长
protected $perPage = 25; // 定义分页每页显示数量（默认15）
const CREATED_AT = 'created_at';
const UPDATED_AT = 'updated_at'; //重写 时间字段名
public $timestamps = false; // 设置不需要维护时间字段
~~~
还有更多,我只列出了一些有意思的特性，具体参考文档 [abstract Model class](https://github.com/laravel/framework/blob/5.6/src/Illuminate/Database/Eloquent/Model.php) 了解所有特性.
# WhereX
有一种优雅的方式能将这种代码：
~~~
$users = User::where('approved', 1)->get();
~~~
转换成这种：
~~~
$users = User::whereApproved(1)->get();
~~~
对，你没有看错，使用字段名作为后缀添加到 where 后面，它就能通过魔术方法运行了。
另外，在 Eloquent 里也有些和时间相关的预定义方法：
~~~
User::whereDate('created_at', date('Y-m-d'));
User::whereDay('created_at', date('d'));
User::whereMonth('created_at', date('m'));
User::whereYear('created_at', date('Y'));
~~~
# 通过关系排序
一个复杂一点的「技巧」。你想对论坛话题按最新发布的帖子来排序？论坛中最新更新的主题在最前面是很常见的需求，对吧？
首先，为主题的最新帖子定义一个单独的关系：
~~~
public function latestPost()
{
return $this->hasOne(\App\Post::class)->latest();
}
~~~
然后，在控制器中，我们可以实现这个「魔法」：
~~~
$users = Topic::with('latestPost')->get()->sortByDesc('latestPost.created_at');
~~~
# `Eloquent::when() -- 不再使用 if-else`
很多人都喜欢使用"if-else"来写查询条件，像这样：
~~~
if (request('filter_by') == 'likes') {
$query->where('likes', '>', request('likes_amount', 0));
}
if (request('filter_by') == 'date') {
$query->orderBy('created_at', request('ordering_rule', 'desc'));
}
~~~
有一种更好的方法 -- 使用 when()
~~~
$query = Author::query();
$query->when(request('filter_by') == 'likes', function ($q) {
return $q->where('likes', '>', request('likes_amount', 0));
});
$query->when(request('filter_by') == 'date', function ($q) {
return $q->orderBy('created_at', request('ordering_rule', 'desc'));
});
~~~
它可能看上去不是很优雅，但它强大的功能是传递参数：
~~~
$query = User::query();
$query->when(request('role', false), function ($q, $role) {
return $q->where('role_id', $role);
});
$authors = $query->get();
~~~
# BelongsTo 默认模型
假如有一个 Post 模型附属于 Author 模型，在 Blade 模板里可以写作如下代码：
~~~
{{ $post->author->name }}
~~~
但是如果作者被删除了，或者因为某些原因未设置？你就会得到一个错误信息，类似「不存在的对象属性」。
那么，你可以这么避免它：
~~~
{{ $post->author->name ?? '' }}
~~~
但是你可以在 Eloquent 关系模型级别做到这种效果：
~~~
public function author()
{
return $this->belongsTo('App\Author')->withDefault();
}
~~~
这个例子中，如果帖子没有作者的话，author() 关系方法会返回一个空的 App\Author 模型对象。
此外，我们还可以为默认模型分配一个默认的属性值。
~~~
public function author()
{
return $this->belongsTo('App\Author')->withDefault([
'name' => 'Guest Author'
]);
}
~~~
# 通过赋值函数进行排序
想象一下你有这样的代码:
~~~
function getFullNameAttribute()
{
return $this->attributes['first_name'] . ' ' . $this->attributes['last_name'];
}
~~~
现在,你想要通过 `"full_name"` 进行排序? 发现是没有效果的:
~~~
$clients = Client::orderBy('full_name')->get(); //没有效果
~~~
解决办法很简单.我们需要在获取结果后对结果进行排序.
~~~
$clients = Client::get()->sortBy('full_name'); // 成功!
~~~
注意的是方法名称是不相同的 -- 它不是orderBy,而是sortBy
# 全局作用域下的默认排序
如果你想要 User::all() 总是按照 name 字段来排序呢？ 你可以给它分配一个全局作用域。让我们回到 boot() 这个我们在上文提到过的方法：
~~~
protected static function boot()
{
parent::boot();
// 按照 name 正序排序
static::addGlobalScope('order', function (Builder $builder) {
$builder->orderBy('name', 'asc');
});
}
~~~
扩展阅读 [查询作用域](https://laravel-china.org/docs/laravel/5.6/eloquent#query-scopes)
# 原生查询方法
有时候，我们需要在 Eloquent 语句中添加原生查询。 幸运的是，确实有这样的方法。
~~~
// whereRaw
$orders = DB::table('orders')
->whereRaw('price > IF(state = "TX", ?, 100)', [200])
->get();
// havingRaw
Product::groupBy('category_id')->havingRaw('COUNT(*) > 1')->get();
// orderByRaw
User::where('created_at', '>', '2016-01-01')
->orderByRaw('(updated_at - created_at) desc')
->get();
~~~
# 复制：复制一行的副本
很简单。说明不是很深入，下面是复制数据库实体（一条数据）的最佳方法：
~~~
$task = Tasks::find(1);
$newTask = $task->replicate();
$newTask->save();
~~~
# Chunk() 方法之大块数据
与 Eloquent 不完全相关,它更多的关于 Collection (集合),但是对于处理大数据集合,仍然是很有用的。你可以使用 chunk() 将这些数据分割成小数据块
修改前:
~~~
$users = User::all();
foreach ($users as $user) {
// ...
~~~
你可以这样做:
~~~
User::chunk(100, function ($users) {
foreach ($users as $user) {
// ...
}
});
~~~
# 创建模型时创建额外的东西
我们都知道Artisan命令：
~~~
php artisan make:model Company
~~~
但是，你知道有三个有用的标记可以为模型生成相关文件吗？
~~~
php artisan make:model Company -mcr
~~~
* -m 将创建一个迁移文件
* -c 将创建一个控制器
* -r 表示控制器应该是一个资源控制器
# 调用 save 方法的时候指定 updated_at
你知道 `->save() `方法可以接受参数吗? 我们可以通过传入参数阻止它的默认行为：更新 updated_at 的值为当前时间戳。
~~~
$product = Product::find($id);
$product->updated_at = '2019-01-01 10:00:00';
$product->save(['timestamps' => false]);
~~~
这样，我们成功在 save 时指定了 updated_at 的值。
# update() 的结果是什么
你是否想知道这段代码实际上返回什么？
~~~
$result = $products->whereNull('category_id')->update(['category_id' => 2]);
~~~
我是说，更新操作是在数据库中执行的，但 $result 会包含什么？
答案是受影响的行。 因此如果你想检查多少行受影响， 你不需要额外调用其他任何内容 -- update() 方法会给你返回此数字。
# 把括号转换成 Eloquent 查询
如果你有个 and 和 or 混合的 SQL 查询，像这样子的：
~~~
... WHERE (gender = 'Male' and age >= 18) or (gender = 'Female' and age >= 65)
~~~
怎么用 Eloquent 来翻译它呢？ 下面是一种错误的方式：
~~~
$q->where('gender', 'Male');
$q->orWhere('age', '>=', 18);
$q->where('gender', 'Female');
$q->orWhere('age', '>=', 65);
~~~
顺序就没对。正确的打开方式稍微复杂点，使用闭包作为子查询：
~~~
$q->where(function ($query) {
$query->where('gender', 'Male')
->where('age', '>=', 18);
})->orWhere(function($query) {
$query->where('gender', 'Female')
->where('age', '>=', 65);
})
~~~
# 复数参数的 orWhere
终于，你可以传递阵列参数给 orWhere()。平常的方式：
~~~
$q->where('a', 1);
$q->orWhere('b', 2);
$q->orWhere('c', 3);
~~~
你可以这样做：
~~~
$q->where('a', 1);
$q->orWhere(['b' => 2, 'c' => 3]);
~~~
- 配置
- composer安装
- composer用法
- composer版本约束表达
- phpstorm
- sftp文件同步
- php类型约束
- laradock
- 配置文件缓存详解
- git
- 自定义函数
- 核心概念
- IOC
- 服务提供者
- Facade
- 契约
- 生命周期
- 路由
- 请求
- 命名路由
- 路由分组
- 资源路由
- 控制器路由
- 响应宏
- 响应
- Command
- 创建命令
- 定时任务
- console路由
- 执行用户自定义的定时任务
- artisan命令
- 中间件
- 创建中间件
- 使用中间件
- 前置和后置
- 详细介绍
- 访问次数限制
- 为 VerifyCsrfToken 添加过滤条件
- 单点登录
- 事件
- 创建
- ORM
- 简介
- DB类
- 配置
- CURD
- queryScope和setAttribute
- 查看sql执行过程
- 关联关系
- 一对一
- 一对多
- 多对多
- 远程关联
- 多态一对多
- 多态多对多
- 关联数据库的调用
- withDefault
- 跨模型更新时间戳
- withCount,withSum ,withAvg, withMax,withMin
- SQL常见操作
- 模型事件
- 模型事件详解
- 模型事件与 Observer
- deleted 事件未被触发
- model validation
- ORM/代码片段
- Repository模式
- 多重where语句
- 中间表类型转换
- Collection集合
- 新增的一些方法
- 常见用法
- 求和例子
- 机场登机例子
- 计算github活跃度
- 转化评论格式
- 计算营业额
- 创建lookup数组
- 重新组织出表和字段关系并且字段排序
- 重构循环
- 其他例子
- 其他问题一
- 去重
- 第二个数组按第一个数组的键值排序
- 搜索ES
- 安装
- 表单
- Request
- sessiom
- Response
- Input
- 表单验证
- 简介
- Validator
- Request类
- 接口中的表单验证
- Lumen 中自定义表单验证返回消息
- redis
- 广播事件
- 发布订阅
- 队列
- 守护进程
- redis队列的坑
- beanstalkd
- rabbitmq
- redis队列
- 日志模块
- 错误
- 日志详解
- 数据填充与迁移
- 生成数据
- 数据填充seed
- migrate
- 常见错误
- Blade模板
- 流程控制
- 子视图
- URL
- 代码片段
- Carbon时间类
- 一些用法
- 邮件
- 分页
- 加密解密
- 缓存
- 文件上传
- 优化
- 随记
- 嵌套评论
- 判断字符串是否是合法的 json 字符串
- 单元测试
- 计算出两个日期的diff
- 自定义一个类文件让composer加载
- 时间加减
- 对象数组互转方法
- 用户停留过久自动退出登录
- optional 辅助方法
- 文件下载
- Api
- Dingo api
- auth.basic
- api_token
- Jwt-Auth
- passport
- Auth
- Authentication 和 Authorization
- Auth Facade
- 授权策略
- Gates
- composer包
- debug包
- idehelp包
- image处理
- 验证码
- jq插件
- 第三方登录
- 第三方支付
- log显示包
- 微信包
- xss过滤
- Excel包
- MongoDB
- php操作
- 聚合查询
- 发送带附件邮件
- 中文转拼音包
- clockwork网页调试
- emoji表情
- symfony组件
- swooletw/laravel-swoole
- 常见问题
- 跨域问题
- Laravel队列优先级的一个坑
- cache:clear清除缓存问题
- .env无法读取
- 源码相关基础知识
- __set和__get
- 依赖注入、控制反转和依赖倒置原则
- 控制反转容器（Ioc Container）
- 深入服务容器
- call_user_func
- compact
- 中间件简易实现
- array_reduce
- 中间件实现代码
- Pipeline管道操作
- composer自动加载
- redis延时队列
- 了解laravel redis队列
- cli
- 源码解读
- Facade分析
- Facade源码分析
- IOC服务容器
- 中间件原理
- 依赖注入浅析
- 微信
- 微信公众号
- 常用接收消息
- 6大接收接口
- 常用被动回复消息
- 接口调用凭证
- 自定义菜单
- 新增素材
- 客服消息
- 二维码
- 微信语音
- LBS定位
- 网页授权
- JSSDK
- easywechat
- 小程序
- 小程序配置app.json