การใช้งาน CRUD

ก่อนการใช้งานฐานข้อมูลทุกครั้งเราจะต้องมีการเชื่อมต่อกับฐานข้อมูลกันก่อน ซึ่งวิธีอย่างง่ายในการเชื่อมต่อกับฐานข้อมูลคือเรียกใช้โมเดล

// เริ่มต้นใช้งานฐานข้อมูล (Model)
$model = new \Kotchasan\Model;

ซึ่งการเชื่อมต่อกับฐานข้อมูลจะเกิดขึ้นโดยอัตโนมัติเมื่อมีการสร้างโมเดล

การร้องขอข้อมูลจากฐานข้อมูล พื้นฐานจะใช้คำสั่ง $model->db()->customQuery() ซึ่งจะเป็นการประมวลผลคำสั่ง SQL โดยตรง

ตัวอย่างการ query ข้อมูลจากฐานข้อมูล

// SELECT * FROM world LIMIT 1
$result = $model->db()->customQuery('SELECT * FROM world LIMIT 1');
// แสดงผลลัพท์
var_dump($result);

ซึ่งผลลัพท์ที่ได้จะอยู่ในรูปแอเรย์ของอ๊อปเจ็ค

// SELECT * FROM world ORDER BY id DESC LIMIT 5
foreach ($model->db()->customQuery('SELECT * FROM world ORDER BY id DESC LIMIT 5') as $item) {
  echo $item->id.'<br>';
}

ในกรณีที่ต้องการผลลัพท์เป็นแอเรย์ให้ระบุพารามิเตอร์ตัวที่ 2 เป็น true

// SELECT * FROM world ORDER BY id DESC LIMIT 5
foreach ($model->db()->customQuery('SELECT * FROM world ORDER BY id DESC LIMIT 5', true) as $item) {
  echo $item['id'].'<br>';
}

ในกรณีที่ต้องการ Query แบบที่ไม่ต้องการผลลัพท์ตอบกลับ เราจะ Query ผ่านเมธอด $model->db()->query() ซึ่งเมธอดนี้จะตอบกลับแค่สำเร็จหรือไม่แค่นั้น (True หรือ False) โดยทั่วๆไปจะใช้คำสั่งนี้ในการสร้างตาราง หรือการลบข้อมูล หรือ อัปเดทข้อมูล เป็นต้น

// DELETE FROM world WHERE id=1000
$model->db()->query('DELETE FROM world WHERE id=:id', array(':id' => 1000));

ทั้ง customQuery และ query ใช้ในการประมวลผลคำสั่ง SQL โดยใช้ความสามารถของฐานข้อมูลโดยตรง ดังนั้นมันจึงสามารถทำได้ทุกอย่างที่ฐานข้อมูลที่ใช้งานอยู่ สามารถทำได้

การค้นหาข้อมูล
วิธีแรกเป็นการค้นหาตามรูปแบบของ PDO โดยใช้ customQuery โดยมีการแยกพารามิเตอร์ที่จะค้นหาใส่ลงในพารามิเตอร์ตัวที่ 3 ในรูปแบบแอเรย์ (สามารถใส่ข้อมูลค้นหาลงใน Query ก็ได้แต่จะปลอดภัยสู้การแยกใส่ไม่ได้)

// SELECT * FROM world WHERE id=1000
$result = $model->db()->customQuery('SELECT * FROM world WHERE id=:id', false, array(':id' => 1000));
var_dump($result);

วิธีที่สอง ค้นหาข้อมูลด้วยคำสั่ง find() ให้ผลลัพท์เป็นแอเรย์ของอ๊อปเจ็คทั้งหมดที่ตรงตามเงื่อนไข

// SELECT * FROM world WHERE `id` = 1000 ORDER BY `id` DESC, `created_at` ASC
$result = $model->db()->find('world', array('id', 1000), array('id DESC', 'created_at ASC'));
print_r($result);

วิธีที่สาม ค้นหาข้อมูลด้วยคำสั่ง first() คืนค่าผลลัพท์ที่พบเพียงรายการเดียว

// SELECT * FROM world WHERE id=1000 LIMIT 1
$result = $model->db()->first('world', array('id', 1000));
print_r($result);

การเพิ่มข้อมูลลงในฐานข้อมูล ใช้ $model->db()->insert()

// INSERT INTO world (`id`,`created_at`) VALUES (1000, '2016-09-14 20:41:36')
$newId = $model->db()->insert('world', array('id' => 1000, 'created_at' => date('Y-m-d H:i:s')));

เมธอด insert จะคืนค่า id ของรายการที่เพิ่มใหม่กลับมา การแก้ไขข้อมูลในฐานข้อมูล ใช้ $model->db()->update()

// UPDATE world SET `name` = 'ทดสอบ', `user_id` = 1 WHERE `id` = 1000
$model->db()->update('world', 1000, array('name' => 'ทดสอบ', 'user_id' => 1));

แก้ไขข้อมูลทั้งหมดในตาราง

// UPDATE world SET `name` = 'ทดสอบ', `user_id` = 1
$model->db()->updateAll('world', array('name' => 'ทดสอบ', 'user_id' => 1));

การลบข้อมูล

// DELETE FROM world WHERE id=1000
$model->db()->delete('world', 1000);

ลบข้อมูลทั้งหมดในตาราง

// TRUNCATE TABLE world
$model->db()->emptyTable('world');

ในกรณีที่การใช้งาน CRUD อยู่ในโมเดลอยู่แล้ว สามารถใช้คีย์เวิร์ด $this แทนการสร้างการเขื่อมต่อใหม่ได้

namespace Index\Mysql;

class Model extends \Kotchasan\Model
{

  public function get($id)
  {
    // SELECT * FROM world WHERE id=$id LIMIT 1
    $result = $this->db()->customQuery('SELECT * FROM world WHERE id=:id LIMIT 1', false, array(':id' => $id));
    // คืนค่าข้อมูลที่พบรายการเดียว ไม่พบข้อมูลคืนค่า false
    return empty($result) ? false : $result[0];
  }
}