การจัดการ Error ด้วย try-catch block

การจัดการ Error ด้วย try-catch block

ในการทำงานกับฐานข้อมูลโดยใช้ PDO (PHP Data Objects) สิ่งหนึ่งที่สำคัญไม่แพ้การเขียน Query คือการจัดการกับ Error ที่อาจเกิดขึ้นระหว่างการทำงาน ไม่ว่าจะเป็น Error จากการเชื่อมต่อ, Query ผิดพลาด, หรือข้อจำกัดของฐานข้อมูล การจัดการ Error ที่ดีจะช่วยให้โปรแกรมของเราทำงานได้อย่างราบรื่นและสามารถแจ้งเตือนหรือบันทึก Error เพื่อแก้ไขปัญหาได้ทันท่วงที

ในบทนี้ เราจะมาเรียนรู้วิธีการใช้ try-catch block เพื่อจัดการ Error ที่เกิดจาก PDO อย่างมีประสิทธิภาพ

การใช้ try-catch

try-catch เป็นโครงสร้างควบคุม (Control Structure) ในภาษา PHP ที่ช่วยให้เราสามารถดักจับ (Catch) Exception หรือ Error ที่เกิดขึ้นในส่วนของ Code ที่เราต้องการตรวจสอบได้ โดยโครงสร้างของ try-catch มีลักษณะดังนี้:

try {
  // โค้ดที่อาจเกิด Exception
} catch (ExceptionType $e) {
  // โค้ดที่ทำงานเมื่อ Exception เกิดขึ้น
}

โดย:

• try: เป็น Block ที่เราใส่ Code ที่เราคาดว่าจะเกิด Exception ขึ้น
• catch: เป็น Block ที่เราใส่ Code ที่จะทำงานเมื่อ Exception ที่ระบุ (ExceptionType) เกิดขึ้น
• ExceptionType: คือ Class ของ Exception ที่เราต้องการดักจับ (เช่น PDOException, InvalidArgumentException)
• $e: คือ Variable ที่เก็บ Instance ของ Exception ที่เกิดขึ้น ซึ่งเราสามารถใช้เพื่อเข้าถึงข้อมูลเกี่ยวกับ Error ที่เกิดขึ้นได้ (เช่น Message, Code)

เมื่อ Code ใน try Block ทำงานและเกิด Exception ขึ้น PHP จะหยุดการทำงานของ try Block ทันที และกระโดดไปยัง catch Block ที่เหมาะสมกับ Exception ที่เกิดขึ้น หากไม่มี catch Block ที่เหมาะสม PHP จะแสดง Error Message ออกมา

การ catch PDOException

เมื่อทำงานกับ PDO Error ที่เรามักจะเจอคือ PDOException ซึ่งเป็น Exception ที่ PDO จะ Throw เมื่อเกิด Error เกี่ยวกับการเชื่อมต่อหรือการ Query ฐานข้อมูล ดังนั้น การ Catch PDOException จึงเป็นสิ่งสำคัญในการจัดการ Error ที่เกิดจาก PDO

ตัวอย่างการใช้ try-catch เพื่อ Catch PDOException:

<?php

$host = 'localhost';
$dbname = 'mydatabase';
$username = 'root';
$password = '';

try {
  $pdo = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
  // ตั้งค่าให้ PDO Throw Exception เมื่อเกิด Error
  $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

  // ตัวอย่าง Query ที่อาจเกิด Error
  $sql = "SELECT * FROM users WHERE id = :id";
  $stmt = $pdo->prepare($sql);
  $stmt->bindParam(':id', $id); //สมมติว่า $id ยังไม่ได้กำหนดค่า
  $stmt->execute();

  $results = $stmt->fetchAll(PDO::FETCH_ASSOC);

  foreach ($results as $row) {
    echo $row['username'] . "<br>";
  }

} catch (PDOException $e) {
  echo "Connection failed: " . $e->getMessage();
}

?>

ในตัวอย่างนี้:

• เราใส่ Code ที่อาจเกิด Error (การเชื่อมต่อฐานข้อมูลและการ Query) ไว้ใน try Block
• เราใช้ $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); เพื่อบอกให้ PDO Throw Exception เมื่อเกิด Error (โดยปกติ PDO จะไม่ Throw Exception แต่จะ Return false แทน) การตั้งค่านี้จะช่วยให้เราจัดการ Error ได้ง่ายขึ้น
• หากเกิด PDOException ขึ้น catch Block จะทำงาน และเราจะแสดง Error Message ออกมาโดยใช้ $e->getMessage()
• เนื่องจาก `$id` ไม่ได้ถูกกำหนดค่าไว้ก่อนที่จะ `bindParam`, PDO จะ throw exception ออกมา

**ข้อผิดพลาดที่พบบ่อย:**

• **ลืมตั้งค่า PDO::ATTR_ERRMODE:** หากไม่ตั้งค่านี้ PDO จะไม่ Throw Exception ทำให้เราไม่สามารถ Catch Error ได้
• **Catch Exception ผิดประเภท:** หากเรา Catch Exception ประเภทอื่นที่ไม่ใช่ PDOException เราจะไม่สามารถจัดการ Error ที่เกิดจาก PDO ได้
• **ละเลย Error Message:** การไม่แสดงหรือบันทึก Error Message จะทำให้เราไม่สามารถแก้ไขปัญหาที่เกิดขึ้นได้

การแสดง error message

เมื่อเรา Catch PDOException ได้แล้ว สิ่งที่สำคัญคือการแสดง Error Message ที่มีความหมาย เพื่อให้เราสามารถเข้าใจได้ว่าเกิดอะไรขึ้นและแก้ไขปัญหาได้อย่างถูกต้อง

PDOException มี Method ที่เราสามารถใช้เพื่อเข้าถึงข้อมูลเกี่ยวกับ Error ได้ดังนี้:

• getMessage(): Returns the error message from the database driver.
• getCode(): Returns the error code from the database driver.
• getFile(): Returns the name of the file in which the exception was created.
• getLine(): Returns the line number where the exception was created.

ตัวอย่างการแสดง Error Message:

<?php

$host = 'localhost';
$dbname = 'mydatabase';
$username = 'root';
$password = '';

try {
  $pdo = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
  $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

  $sql = "SELECT * FROM users WHERE id = :id";
  $stmt = $pdo->prepare($sql);
  $stmt->bindParam(':id', $id); //สมมติว่า $id ยังไม่ได้กำหนดค่า
  $stmt->execute();

} catch (PDOException $e) {
  echo "Error: " . $e->getMessage() . "<br>";
  echo "Code: " . $e->getCode() . "<br>";
  echo "File: " . $e->getFile() . "<br>";
  echo "Line: " . $e->getLine() . "<br>";
}

?>

ในตัวอย่างนี้ เราได้แสดง Error Message, Error Code, File ที่เกิด Error, และ Line Number ที่เกิด Error ซึ่งข้อมูลเหล่านี้จะช่วยให้เราสามารถระบุสาเหตุของ Error และแก้ไขปัญหาได้อย่างรวดเร็ว

**กรณีใช้งานจริง:**

สมมติว่าเราต้องการเพิ่มข้อมูลผู้ใช้ใหม่ลงในฐานข้อมูล แต่เกิด Error ขึ้นเนื่องจาก Username ซ้ำกับที่มีอยู่แล้วในฐานข้อมูล เราสามารถใช้ try-catch เพื่อจัดการ Error นี้ได้ดังนี้:

<?php

$host = 'localhost';
$dbname = 'mydatabase';
$username = 'root';
$password = '';

$newUsername = 'existing_user'; //สมมติว่า username นี้มีอยู่แล้ว
$newPassword = 'password123';

try {
  $pdo = new PDO("mysql:host=$host;dbname=$dbname", $username, $password);
  $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

  $sql = "INSERT INTO users (username, password) VALUES (:username, :password)";
  $stmt = $pdo->prepare($sql);
  $stmt->bindParam(':username', $newUsername);
  $stmt->bindParam(':password', password_hash($newPassword, PASSWORD_DEFAULT));
  $stmt->execute();

  echo "User added successfully!";

} catch (PDOException $e) {
  if ($e->getCode() == '23000') { // 23000 คือ SQLSTATE code สำหรับ Duplicate Key
    echo "Error: Username already exists. Please choose a different username.";
  } else {
    echo "Error: " . $e->getMessage();
  }
}

?>

ในตัวอย่างนี้ เราได้ตรวจสอบ Error Code ที่ได้จาก PDOException หาก Error Code คือ 23000 (SQLSTATE code สำหรับ Duplicate Key) เราจะแสดง Error Message ที่เฉพาะเจาะจงว่า Username ซ้ำกับที่มีอยู่แล้ว ซึ่งจะช่วยให้ผู้ใช้เข้าใจปัญหาได้ง่ายขึ้น

การจัดการ Error ด้วย try-catch block เป็นสิ่งสำคัญในการพัฒนาโปรแกรม PHP ที่ทำงานกับฐานข้อมูล การ Catch PDOException และการแสดง Error Message ที่มีความหมายจะช่วยให้เราสามารถแก้ไขปัญหาที่เกิดขึ้นได้อย่างรวดเร็วและมีประสิทธิภาพ