PHP จัดการข้อผิดพลาดด้วย exception



แนวคิด: เมื่อฟังก์ชันทำงานที่ขอไม่ได้ ให้ “โยน” exception ออกมา แทนที่จะคืนค่าแปลก ๆ (false, null, -1) ที่คนเรียกอาจลืมเช็ค

throw และ try / catch

<?php
declare(strict_types=1);

function divide(int $a, int $b): float
{
    if ($b === 0) {
        throw new InvalidArgumentException('หารด้วยศูนย์ไม่ได้');
    }
    return $a / $b;
}

try {
    echo divide(10, 2), "\n";      // 5
    echo divide(10, 0), "\n";      // โยน exception ตรงนี้
    echo "บรรทัดนี้ไม่ถูกรัน\n";
} catch (InvalidArgumentException $e) {
    echo "ผิดพลาด: {$e->getMessage()}\n";
}

echo "โปรแกรมทำงานต่อ\n";
5
ผิดพลาด: หารด้วยศูนย์ไม่ได้
โปรแกรมทำงานต่อ

เมื่อ throw ทำงาน โค้ดที่เหลือใน try ถูกข้าม กระโดดไป catch ที่ตรงชนิด ถ้าไม่มี catch ที่รับไหว exception จะลอยขึ้นไปเรื่อย ๆ จนถึง top-level แล้วโปรแกรมตายพร้อม “Uncaught Exception”

finally — ทำเสมอไม่ว่าจะเกิดอะไร

<?php
function processFile(string $path): void
{
    $handle = fopen($path, 'r');
    try {
        // อ่านและประมวลผล ... อาจ throw
        $line = fgets($handle);
        if ($line === false) {
            throw new RuntimeException('ไฟล์ว่าง');
        }
    } finally {
        fclose($handle);           // ปิดไฟล์เสมอ แม้ throw หรือ return
    }
}

finally รันเสมอ — ทั้งกรณีสำเร็จ, กรณี catch, และกรณี return กลางคัน เหมาะกับการคืน resource

จับหลายชนิด

<?php
try {
    $result = riskyOperation();
} catch (NetworkException $e) {
    echo "ปัญหาเครือข่าย ลองใหม่ภายหลัง\n";
} catch (ValidationException $e) {
    echo "ข้อมูลไม่ถูกต้อง: {$e->getMessage()}\n";
} catch (Throwable $e) {
    // จับที่เหลือทั้งหมด (รวม Error ด้วย)
    echo "เกิดข้อผิดพลาดไม่คาดคิด\n";
    error_log($e->getMessage());
}

จับหลายชนิดใน catch เดียวด้วย |:

<?php
try {
    // ...
} catch (NetworkException | TimeoutException $e) {
    echo "ปัญหาการเชื่อมต่อ\n";
}

ลำดับสำคัญ: catch ที่เจาะจงกว่าต้องมาก่อน ถ้า catch (Throwable) อยู่บนสุดจะกินทุกอย่าง ตัวล่างไม่ได้ทำงาน

ลำดับชั้นของ Throwable

Throwable (interface)
├── Error                    ← ข้อผิดพลาดระดับ engine (ปกติไม่ควร catch)
│   ├── TypeError
│   ├── DivisionByZeroError
│   └── ...
└── Exception                ← ข้อผิดพลาดระดับแอป (catch ได้)
    ├── LogicException        ← บั๊กในโค้ด ควรแก้ ไม่ใช่ catch
    │   ├── InvalidArgumentException
    │   ├── DomainException
    │   └── LengthException
    └── RuntimeException      ← สิ่งที่ผิดพลาดตอนรัน (นอกเหนือการควบคุม)
        ├── OutOfRangeException
        └── UnexpectedValueException

แนวทาง:

  • LogicException และลูก = “โปรแกรมเมอร์เขียนผิด” เช่นส่ง argument ผิด — ควรแก้โค้ด ไม่ใช่ catch
  • RuntimeException และลูก = “สภาพแวดล้อมมีปัญหา” เช่นไฟล์หาย, เน็ตล่ม — catch แล้วจัดการ
  • Error = engine พัง เช่น type ผิด — ปกติปล่อยให้ตาย แต่ catch ได้ในระดับ framework

เขียน exception ของตัวเอง

<?php
declare(strict_types=1);

namespace App\Exception;

class InsufficientFundsException extends \RuntimeException
{
    public function __construct(
        public readonly float $requested,
        public readonly float $available,
    ) {
        parent::__construct(
            sprintf('ต้องการ %.2f แต่มี %.2f', $requested, $available)
        );
    }
}

ใช้งาน:

<?php
use App\Exception\InsufficientFundsException;

class Wallet
{
    public function __construct(private float $balance) {}

    public function withdraw(float $amount): void
    {
        if ($amount > $this->balance) {
            throw new InsufficientFundsException($amount, $this->balance);
        }
        $this->balance -= $amount;
    }
}

try {
    (new Wallet(500))->withdraw(800);
} catch (InsufficientFundsException $e) {
    echo $e->getMessage(), "\n";
    echo "ขาดอีก " . ($e->requested - $e->available) . " บาท\n";
}

exception ที่ตั้งชื่อเฉพาะทำให้ catch เจาะจงได้ และพก data ที่เกี่ยวข้องไปด้วย (->requested, ->available)

ห่อ exception เดิม (exception chaining)

เมื่อจับ exception ระดับล่างแล้วอยากโยนใหม่ในภาษาของ layer ตัวเอง — ส่งตัวเดิมเป็นพารามิเตอร์ที่ 3:

<?php
try {
    $data = json_decode($raw, true, flags: JSON_THROW_ON_ERROR);
} catch (\JsonException $e) {
    throw new \RuntimeException('อ่าน config ไม่ได้', previous: $e);
}

ปลายทางเรียก $e->getPrevious() ดูต้นตอได้ — ไม่สูญเสีย stack trace เดิม

throw เป็น expression (PHP 8.0+)

<?php
$user = findUser($id) ?? throw new NotFoundException("ไม่พบผู้ใช้ $id");

$config = $_ENV['DB_HOST'] ?? throw new RuntimeException('ไม่ได้ตั้ง DB_HOST');

$status = match ($code) {
    200 => 'ok',
    404 => 'not found',
    default => throw new UnexpectedValueException("code แปลก: $code"),
};

ข้อมูลใน exception

<?php
catch (\Throwable $e) {
    $e->getMessage();     // ข้อความ
    $e->getCode();        // รหัส (int)
    $e->getFile();        // ไฟล์ที่เกิด
    $e->getLine();        // บรรทัด
    $e->getTrace();       // stack trace เป็นอาร์เรย์
    $e->getTraceAsString();
    $e->getPrevious();    // exception ที่ถูกห่อไว้
}

เรื่องที่คนมักพลาด

  • catch (\Exception $e) แล้วคิดว่าจับหมด — Error (เช่น TypeError) ไม่ใช่ลูกของ Exception ใช้ catch (\Throwable $e) ถ้าอยากจับจริง ๆ
  • catch แล้วเงียบ — catch (\Throwable $e) {} กลืน error หมด ดีบั๊กไม่ได้ อย่างน้อยต้อง error_log()
  • ใช้ exception เป็น flow control ปกติ เช่น “ไม่เจอข้อมูล” ในการค้นหาที่คาดว่าอาจไม่เจอ — คืน null เหมาะกว่า เก็บ exception ไว้กับสิ่งที่ “ผิดปกติ” จริง ๆ
  • throw ใน finally — จะกลบ exception ที่กำลังลอยอยู่ ทำให้ต้นตอหาย
  • catch เร็วเกินไป — จับที่ layer ล่างแล้วคืน false ทำให้ layer บนไม่รู้ว่าเกิดอะไร ปล่อยให้ลอยไปจัดการที่จุดที่ตัดสินใจได้
  • ลืมว่า exception ที่ไม่ถูก catch = โปรแกรมตาย — ที่ entry point (index.php) ควรมี try/catch หรือ error handler ครอบ เพื่อแสดงหน้า error ที่เหมาะสม

สรุป

  • throw new SomeException('...') เมื่อทำงานที่ขอไม่ได้ — ดีกว่าคืน false
  • try { } catch (Type $e) { } finally { } — finally รันเสมอ (ใช้คืน resource)
  • จับเจาะจงก่อนกว้าง, catch (A | B $e) จับหลายชนิด, Throwable = ทุกอย่าง
  • LogicException = แก้โค้ด, RuntimeException = catch แล้วจัดการ
  • เขียน exception เอง (extends RuntimeException) ให้ catch เจาะจง + พก data
  • ห่อด้วย previous: เพื่อไม่ให้ต้นตอหาย, throw ใช้เป็น expression กับ ?? / match ได้

บทถัดไปว่าด้วย Composer — เครื่องมือจัดการแพ็กเกจของ PHP ที่จะสร้าง autoloader ให้เราและติดตั้งไลบรารีจากทั่วโลก