Active Record

$customer = new Customer();
$customer->name = 'Benz';
$customer->save();

Customer เป็น Active Record ของตาราง customer ที่มี column ชื่อว่า name มีค่าเท่ากับ 'Benz'

Querying Data

หลังจากการประกาศ Active Record คุณสามารถใช้มันในการ query data จากตารางในฐานข้อมูล ดังนี้

 $customer = Customer::find()
    ->where(['id' => 123])
    ->one();

// return all active customers and order them by their IDs
// SELECT * FROM `customer` WHERE `status` = 1 ORDER BY `id`
$customers = Customer::find()
    ->where(['status' => Customer::STATUS_ACTIVE])
    ->orderBy('id')
    ->all();

จากข้างบน $customers เท่ากับ Customer object ในขณะที่ $customers จะเป็นอาเรย์ของ Customer objects โดยจะถูกดึงมาจากตาราง customer

 // returns a single customer whose ID is 123
// SELECT * FROM `customer` WHERE `id` = 123
$customer = Customer::findOne(123);

// returns customers whose ID is 100, 101, 123 or 124
// SELECT * FROM `customer` WHERE `id` IN (100, 101, 123, 124)
$customers = Customer::findAll([100, 101, 123, 124]);

// returns an active customer whose ID is 123
// SELECT * FROM `customer` WHERE `id` = 123 AND `status` = 1
$customer = Customer::findOne([
    'id' => 123,
    'status' => Customer::STATUS_ACTIVE,
]);

// returns all inactive customers
// SELECT * FROM `customer` WHERE `status` = 0
$customers = Customer::findAll([
    'status' => Customer::STATUS_INACTIVE,
]);

Massive Assignment

 $values = [   'name' => 'James',
    'email' => 'james@example.com',
];

$customer = new Customer();
$customer->attributes = $values;
$customer->save();

Updating Counters

 $post = Post::findOne(100);

// UPDATE `post` SET `view_count` = `view_count` + 1 WHERE `id` = 100
$post->updateCounters(['view_count' => 1]);

Deleting Data

$customer = Customer::findOne(123);
$customer->delete();

Customer::deleteAll(['status' => Customer::STATUS_INACTIVE]);

การประกาศ Relations

ในการทำงานกับ Relations สิ่งที่ต้องทำคือ ประกาศ relation method ใน model ที่ต้องการใช้ดังนี้

class Customer extends ActiveRecord{
    // ...

    public function getOrders()
    {
        return $this->hasMany(Order::className(), ['customer_id' => 'id']);
    }
}

class Order extends ActiveRecord
{
    // ...

    public function getCustomer()
    {
        return $this->hasOne(Customer::className(), ['id' => 'customer_id']);
    }
}

จากด้านบนจะเป็นความสัมพันธ์ระหว่าง Customer กับ Order เป็นแบบ one to many กล่าวคือ ลูกค้าหนึ่งคนมีได้หลาย order และ order หนึ่งมาจากลูกค้าคนเดียวซึ่งสามารถเข้าถึง relation ได้ดังนี้

$customer = Customer::findOne(123);

// SELECT * FROM `order` WHERE `customer_id` = 123
// $orders is an array of Order objects
$orders = $customer->orders;

เมื่อประกาศชื่อ Relation ว่า orders ด้วย ชื่อ getter method ว่า getOrders() เรายังสามารถเข้าถึง getOrders() ที่เหมือนกับ object property ได้ดังนี้

$customer->orders; // is an array of `Order` objects
$customer->getOrders(); // returns an ActiveQuery instance

จะเห็นว่า การเข้าถึง getOrders() ที่เหมือนกับ object property จะ return เป็น ActiveQuery instance ส่วน relation จะให้ค่าเป็น Array object

การ​ดึงข้อมูลของ Relation แบบ Dynamic

เนื่องจาก relation method จะ return ค่าเป็น instance ของ ActiveQuery คุณสามารถสร้างการ query ต่อจากนี้ได้เลย เช่น

 $customer = Customer::findOne(123);

// SELECT * FROM `order` WHERE `customer_id` = 123 AND `subtotal` > 200 ORDER BY `id`
$orders = $customer->getOrders()
    ->where(['>', 'subtotal', 200])
    ->orderBy('id')
    ->all();

Lazy Loading

การเข้าถึงข้อมูล Relation ที่มีการใช้ sql query ใหม่ทุกครั้ง ทำให้ช้า ดังตัวอย่าง

// SELECT * FROM `customer` LIMIT 100
$customers = Customer::find()->limit(100)->all();

foreach ($customers as $customer) {
    // SELECT * FROM `order` WHERE `customer_id` = ...
    $orders = $customer->orders;
}

จะเห็นว่ามีการ ใช้ SQL query ทั้งหมด 101 ครั้ง

Eager Loading

การเข้าถึงข้อมูล Relation ด้วยการใช้ sql query ใหม่เพียง 2 ครั้ง ทำให้ประหยัดเวลา โดยการ call function with() ดังตัวอย่าง

 // SELECT * FROM `customer` LIMIT 100;
// SELECT * FROM `orders` WHERE `customer_id` IN (...)
$customers = Customer::find()
    ->with('orders')
    ->limit(100)
    ->all();

foreach ($customers as $customer) {
    // no SQL executed
    $orders = $customer->orders;
}

สามารถใช้แบบ nested relation ได้ดังนี้

 // eager loading "orders" and the nested relation "orders.items"
$customers = Customer::find()->with('orders.items')->all();
// access the items of the first order of the first customer
// no SQL executed
$items = $customers[0]->orders[0]->items;

Joining with Relations

 $customers = Customer::find()
    ->joinWith('orders')
    ->where(['order.status' => Order::STATUS_ACTIVE])
    ->all();

joinWith นี้จะเป็น earger loading อัตโนมัติ 

Saving Relations

การบันทึกความสัมพันธ์ของ Relation ทำได้สองวิธี 

วิธีที่1

$customer = Customer::findOne(123);
$order = new Order();
$order->subtotal = 100;
// ...

// setting the attribute that defines the "customer" relation in Order
$order->customer_id = $customer->id;
$order->save();

วิธีที่2

$customer = Customer::findOne(123);
$order = new Order();
$order->subtotal = 100;
// ...

$order->link('customer', $customer);

method link() นี้ ตามด้วย relation และ instance ของ  Active Record ที่ต้องการ link ในตัวอย่างต้องการ link customer ไปยัง order
ข้อดีของ method นี้ จะดีตรงที่ใช้กับความสัมพันธ์แบบ  Many to Many เมื่อใช้ method นี้ จะสร้าง Record ให้กับ Join table ให้อัตโนมัติ 
และหากต้องการลบความสัมพันธ์ทั้งสองก็ใช้ method unlink() ดังนี้

$customer = Customer::find()->with('orders')->where(['id' => 123])->one();
$customer->unlink('orders', $customer->orders[0]);

เมื่อใช้ method unlink จะใส่ค่า nullให้แต่ถ้าต้องการลบไปเลยให้ใส่ $delete เป็น true

Orderby

$order = Order::find()->where(['customer_id'=>1])->orderBy('updated_at desc')->all();

$order = Order::find()->where(['customer_id'=>1])->orderBy([''updated_at"=>"SORT_DESC",'item_no'=>'SORT_ASC'])->all();

limit

$order = Order::find()->limit(100)->all();

offset

$order = Order::find()->limit(100)->offset(3)->all();

การเปรียบเทียบ

$order = Order::find()->where(['customer_id'=>1])->andWhere(['>','amount',100])->all();

$order = Order::find()->where(['customer_id'=>1])->andWhere(['<','amount',100])->all();

$order = Order::find()->where(['customer_id'=>1])->andWhere(['>','amount',100])->all();

$order = Order::find()->where(['customer_id'=>1])->andWhere(['between','amount',100,200])->all();

$order = Order::find()->where(['customer_id'=>1])->andWhere(['!=','amount',100])->all();

$order = Order::find()->where(['customer_id'=>1])->andWhere(['like','name','invoice'])->all();

$order = Order::find()->where(['customer_id'=>[1,2,3]]->all();

$order = Order::find()->where(['in','customer_id',[1,2,3]]->all();

$order = Order::find()->where(['not in','customer_id',[1,2,3]]->all();

$order = Order::find()->all()->count();

$order = Order::find()->max('amount');

$order = Order::find()->min('amount');

การเปรียบเทียบวันที่

$order = Order::find()->where(['customer_id'=>1])->andWhere(['between','updated_at',$date1,$date2])->all();