表结构
如今有客户表、订单表、图书表、做者表,sql
- 客户表Customer (id customer_name)
- 订单表Order (id order_name customer_id book_id)
- 图书表 (id book_name author_id)
- 做者表 (id author_name)
模型定义
下面是这4个个模型的定义,只写出其中的关联
Customer 数据库
- class Customer extends \yii\db\ActiveRecord
- {
- // 这是获取客户的订单,由上面咱们知道这个是一对多的关联,一个客户有多个订单
- public function getOrders()
- {
- // 第一个参数为要关联的子表模型类名,
- // 第二个参数指定 经过子表的customer_id,关联主表的id字段
- return $this->hasMany(Order::className(), ['customer_id' => 'id']);
- }
- }
复制代码
Order 数组
- class Order extends \yii\db\ActiveRecord
- {
- // 获取订单所属用户
- public function getCustomer()
- {
- //一样第一个参数指定关联的子表模型类名
- //
- return $this->hasOne(Customer::className(), ['id' => 'customer_id']);
- }
- // 获取订单中全部图书
- public function getBooks()
- {
- //一样第一个参数指定关联的子表模型类名
- //
- return $this->hasMany(Book::className(), ['id' => 'book_id']);
- }
- }
复制代码
Book 缓存
- class Book extends \yii\db\ActiveRecord
- {
- // 获取图书的做者
- public function getAuthor()
- {
- //一样第一个参数指定关联的子表模型类名
- return $this->hasOne(Author::className(), ['id' => 'author_id']);
- }
- }
复制代码
Author yii2
- class Autor extends \yii\db\ActiveRecord
- {
-
- }
复制代码
hasMany、hasOne使用
Yii2中的表之间的关联有2种,它们用来指定两个模型之间的关联。 yii
- 返回结果:这两个方法的返回结果都为yii\db\ActiveQuery对象
- 第一个参数:所关联的模型的类名称。
- 第二个参数:是一个数组,其中键为所关联的模型中的属性,值为当前模型中的属性。
关联的使用
如今咱们获取一个客户的全部的订单信息 函数
- // 获取一个客户信息
- $customer = Customer::findOne(1);
- $orders = $customer->orders; // 经过在Customer中定义的关联方法(getOrders())来获取这个客户的全部的订单。
复制代码
上面的两行代码会生成以下sql语句 this
- SELECT * FROM customer WHERE id=1;
- SELECT * FROM order WHERE customer_id=1;
复制代码
关联结果缓存
若是客户的订单改变了,咱们再从新调用 对象
- $orders = $customer->orders;
复制代码
再次获得订单的时候你会发现没有变化。 缘由是只会在第一次执行$customer->orders的时候才会去数据库里面查询,而后会把结果缓存起来,之后查询的时候都不会再执行sql。
那么若是我想再次执行sql如何作呢?能够执行 排序
- unset($customer->orders);
- $customer->orders;
复制代码
而后就能够从数据库里面取数据了。
定义多个关联
一样,咱们还能够在Customer里面定义多个关联。
如返回总数大于100的订单。
- class Customer extends \yii\db\ActiveRecord
- {
- public function getBigOrders($threshold = 100)
- {
- return $this->hasMany(Order::className(), ['customer_id' => 'id'])
- ->where('subtotal > :threshold', [':threshold' => $threshold])
- ->orderBy('id');
- }
- }
复制代码
关联的两种访问方式
如上面的,若是使用
- $customer->bigOrders
复制代码
将会获得大于100的全部的订单。若是要返回大于200的订单能够这样写
- $orders = $customer->getBigOrders(200)->all();
复制代码
从上面能够看出访问一个关联的时候有两种方法
- 若是以函数的方式调用,会返回一个 ActiveQuery 对象($customer->getOrders()->all())
- 若是以属性的方式调用,会直接返回模型的结果($customer->orders)
with的使用 看以下代码,是取一个客户的订单
- // 执行sql语句: SELECT * FROM customer WHERE id=1
- $customer = Customer::findOne(1);
- //执行sql:SELECT * FROM order WHERE customer_id=1
- $orders1 = $customer->orders;
- //这个不会执行sql,直接使用上面的缓存结果
- $orders2 = $customer->orders;
复制代码
若是如今咱们要取出100个用户,而后访问每一个用户的订单,从上面的了解咱们可能会写出以下代码
- // 执行sql语句: SELECT * FROM customer LIMIT 100
- $customers = Customer::find()->limit(100)->all();
- foreach ($customers as $customer) {
- // 执行sql: SELECT * FROM order WHERE customer_id=...
- $orders = $customer->orders;
- // 处理订单。。。
- }
复制代码
然而,若是真要这样写的话,会在foreach的每一个循环里面都执行一次sql去数据库里面查询数据。由于每一个$customer对象都是不同的。
为了解决上面的问题 可使用 yii\db\ActiveQuery::with() 。
其中width的参数为 关系的名称 ,也就在model里面定义的getOrders,getCustomer中的orders和customer
- // 先执行sql: SELECT * FROM customer LIMIT 100;
- // SELECT * FROM orders WHERE customer_id IN (1,2,...)
- $customers = Customer::find()->limit(100)
- ->with('orders')->all();
- foreach ($customers as $customer) {
- // 在这个循环的时候就不会再执行sql了
- $orders = $customer->orders;
- // ...handle $orders...
- }
复制代码
若是使用了select来指定返回的列,必定要确保返回的列里面包含 所关联的模型的关联字段 ,不然将不会返回关联的表的Model
- $orders = Order::find()->select(['id', 'amount'])->with('customer')->all();
- // $orders[0]->customer 的结果将会是null
- // 由于上面的select中没有返回所关联的模型(customer)中的指定的关联字段。
- // 若是加上customer_id,$orders[0]->customer就能够返回正确的结果
- $orders = Order::find()->select(['id', 'amount', 'customer_id'])->with('customer')->all();
复制代码
给with加过滤条件
查询一个客户大于100的订单
- //首先执行sql: SELECT * FROM customer WHERE id=1
- $customer = Customer::findOne(1);
- // 再执行查询订单的sql语句:SELECT * FROM order WHERE customer_id=1 AND subtotal>100
- $orders = $customer->getOrders()->where('subtotal>100')->all();
复制代码
查询100个客户的,每一个客户的总合大于100的订单
- // 下面的代码会执行sql语句:
- // SELECT * FROM customer LIMIT 100
- // SELECT * FROM order WHERE customer_id IN (1,2,...) AND subtotal>100
- $customers = Customer::find()->limit(100)->with([
- 'orders' => function($query) {
- $query->andWhere('subtotal>100');
- },
- ])->all();
复制代码
在这里width的参数为数组,键为关联的名称,值为回调函数。
也就是说 对orders这个关联返回的ActiveQuery,再执行一次$query->andWhere('subtotal>100');
使用joinWith进行表关联
咱们都知道能够用join on来写多个表之间的关联。先看看yii2中joinWit的声明
joinWith( $with, $eagerLoading = true, $joinType = 'LEFT JOIN' )
- $with 数据类型为字符串或数组,
若是为字符串,则为模型中定义的关联的名称(能够为子关联)。
若是为数组,键为model中以getXXX格式定义的关联,值为对这个关联的进一步的回调操做。
- $eagerLoading 是否加载在$with中关联的模型的数据。
- $joinType 联接类型,可用值为:LEFT JOIN、INNER JOIN,默认值为LEFT JOIN
- // 订单表和客户表以Left join的方式关联。
- // 查找全部订单,并以客户 ID 和订单 ID 排序
- $orders = Order::find()->joinWith('customer')->orderBy('customer.id, order.id')->all();
- // 订单表和客户表以Inner join的方式关联
- // 查找全部的订单和书
- $orders = Order::find()->innerJoinWith('books')->all();
复制代码
- // 使用inner join 链接order中的 books关联和customer关联。
- // 并对custmer关联再次进行回调过滤:找出24小时内注册客户包含书籍的订单
- $orders = Order::find()->innerJoinWith([
- 'books',
- 'customer' => function ($query) {
- $query->where('customer.created_at > ' . (time() - 24 * 3600));
- }
- ])->all();
- // 使用left join链接 books关联,books关联再用left join 链接 author关联
- $orders = Order::find()->joinWith('books.author')->all();
复制代码
在实现上,Yii 先执行知足JOIN查询条件的SQL语句,把结果填充到主模型中, 而后再为每一个关联执行一条查询语句, 并填充相应的关联模型。
- // Order和books关联 inner join ,但不获取books关联对应的数据
- $orders = Order::find()->innerJoinWith('books', false)->all();
复制代码
On条件
在定义关联的时候还能够指定on条件
- class User extends ActiveRecord
- {
- public function getBooks()
- {
- return $this->hasMany(Item::className(), ['owner_id' => 'id'])->onCondition(['category_id' => 1]);
- }
- }
复制代码
在joinWith中使用
- //先查询主模型(User)的数据, SELECT user.* FROM user LEFT JOIN item ON item.owner_id=user.id AND category_id=1
- // 而后再根据关联条件查询相关模型数据SELECT * FROM item WHERE owner_id IN (...) AND category_id=1
- // 这两个在查询的过程当中都使用了 on条件。
- $users = User::find()->joinWith('books')->all();
复制代码
若是没有使用join操做,即便用的是with 或者 直接以属性来访问关联。这个时候on条件会做为where 条件。
- // SELECT * FROM user WHERE id=10
- $user = User::findOne(10);
复制代码
总结
- 首先须要在模型中定义好 关联 (如getOrders中的 Orders 为一个关联)
- 而后在 with 或者 joinWith 中使用在模型中定义的关联。
- 其中在使用关联的时候还能够指定回调方法。
- 再有就是能够给 关联、with、joinWith 指定where或者on条件