yii2 ActiveRecord多表关联以及多表关联搜索的实现

作者：白狼 出处：http://www.manks.top/yii2_many_ar_relation_search.html 本文版权归作者，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。

一个老生常谈的问题。最近通过群里的反馈，觉得很多人还是没有去理解这个问题。今天把这个问题讲明白了，看看yii2 ActiveRecord是怎么个多表关联以及如何去优化这个关联。

场景需求：

假设我们有一张用户表user和一张用户渠道表auth，两张数据表通过user.id和auth.uid进行一对一关联。现需要在user列表展示auth表的来源渠道source，且该渠道可搜索。

首先我们先通过gii生成user和auth系列相关的model和操作。此处不做详细说明，有关gii的操作可参考xxx

我看继续看重要的几个操作步骤：

1、找到user表对应的AR模型类 common\models\User.php，在该类文件中进行关联auth表

/**
 *  关联auth表
 * @see http://www.manks.top/yii2_many_ar_relation_search.html
 */
public function getAuth()
{
    // hasOne要求返回两个参数 第一个参数是关联表的类名 第二个参数是两张表的关联关系 
    // 这里uid是auth表关联id, 关联user表的uid id是当前模型的主键id
    return $this->hasOne(common\models\Auth::className(), ['uid' => 'id']);
}

设置好了之后，并不代表两张数据表自动进行关联了！我们访问user列表页（该列表页采用gii生成，目前我们没操作过），通过debug查看Database Queries不难发现，实际中的query并没有进行关联auth表

2、在gridview中添加关联表的来源渠道字段source

<?= GridView::widget([
    // other codes
    'columns' => [
        // other columns
        'auth.source',
    ]
]); ?>

有同学感觉疑问了，上面不是说了没进行关联吗，这个怎么可以直接使用auth.source？

先别急，此时我们打开debug看看实际的query。

我们会发现有很多类似 select * from `auth` where uid = xxx;之类的操作，如果你的分页默认20条数据时，会有20个类似的query。

我们先搞明白发生了什么？

实际上这属于php的基础知识了。读取和写入对象的一个不存在的成员变量时， __get() __set() 魔术函数会被自动调用。yii也是利用了这一点对其进行了实现！

该操作跟大部分人在gridview中封装方法获取关联表数据几乎一致，但是！20条sql的查询明显增加了众多的开销。如果这里是left join操作多好！

3、优化sql

我们需要优化的是：

20条sql变1条sql

只获取关联表需要的字段

有同学要嚷嚷了，这里是yii自带的操作，怎么优化？我们回到数据源的获取上，发现user列表的数据是通过userSearch model的search方法提供的。

也就是说我们的数据查询实际上就没有去进行关联表查询！既然如此，我们就在UserSearch加上关联查询

$query = User::find();
$query->joinWith(['auth']);
$query->select("user.*, auth.source");

我们再来刷新下user列表页，然后通过debug分析发现有两条sql引起了我们的注意

SELECT `user`.*, `auth`.`source` FROM `user` LEFT JOIN `auth` ON `user`.`id` = `auth`.`uid` LIMIT 20
SELECT * FROM `auth` WHERE `user_id` IN (20个uid);

也就是说我么已经达到了优化sql的目的，通过debug分析发现，DB的查询时间少了很多。

4、关联表字段增加查询

gridview中的搜索模型也是通过searchModel实现的，该模型通过rules控制着哪个字段可搜索，哪个字段不可搜索。

我们现在需要增加关联表的source可搜索，因此我们在searchModel中定义一个属性source且添加到rules中

public $source;
public function rules()
{
    return [
    // other rules
        ['source', 'safe'],
    ];
}

接着我们把gridview中的auth.source修改一下

// 'auth.source',
[
    'attribute' => 'source',
    'value' => 'auth.source',
    'label' => '渠道来源',
],

到这里我们界面上是ok的，要实现程序上的搜索还差一步，我们在数据源获取的地方加上新增的source条件即可

$query->andFilterWhere([
    // other params
    'auth.source' => $this->source,
]);

[考虑目前国内网站大部分采集文章十分频繁，更有甚者不注明原文出处，原作者更希望看客们查看原文，以防有任何问题不能更新所有文章，避免误导！]

查看原文