现在有客户表、订单表、图书表、作者表,
怎么来确定是一对多 还是一对一呢?这个很简单,比如下面的Customer,一个Customer有多个Order,所以就是一对多;又比如Book,一个Book只有一个作者(这里的情况就是一本书只有一个作者),所以就是一对一。
下面是这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中的表之间的关联有2种,它们用来指定两个模型之间的关联。
- 一对多:hasMany
- 一对一:hasOne
返回结果:这两个方法的返回结果都为yii\db\ActiveQuery
对象
第一个参数:所关联的模型的类名称。
第二个参数:是一个数组,其中键为所关联的模型中的属性,值为当前模型中的属性。
关联的使用
现在我们获取一个客户的所有的订单信息
// 获取一个客户信息
$customer = Customer::findOne(1); $orders = $customer->orders; // 通过在Customer中定义的关联方法(getOrders())来获取这个客户的所有的订单。
上面的两行代码会生成如下sql语句
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对象都是不一样的。
其中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();
查询一个客户大于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′);
我们都知道可以用join on来写多个表之间的关联。先看看yii2中joinWit的声明
joinWith( $with, $eagerLoading = true, $joinType = ‘LEFT JOIN’ )
$with 数据类型为字符串或数组,
如果为字符串,则为模型中定义的关联的名称(可以为子关联)。
如果为数组,键为model中以getXXX格式定义的关联,值为对这个关联的进一步的回调操作。
$eagerLoading 是否加载在$with中关联的模型的数据。
$joinType 联接类型,可用值为:LEFT JOIN、INNER JOIN,默认值为LEFT JOIN
在实现上,Yii 先执行满足JOIN查询条件的SQL语句,把结果填充到主模型中, 然后再为每个关联执行一条查询语句, 并填充相应的关联模型。
// Order和books关联 inner join ,但不获取books关联对应的数据 $orders = Order::find()->innerJoinWith('books', false)->all();
在定义关联的时候还可以指定on条件
class User extends ActiveRecord { public function getBooks() { return $this->hasMany(Item::className(), \['owner\_id' => 'id'\])->onCondition(\['category\_id' => 1\]); } }
//先查询主模型(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条件