آموزش جامع مدیریت خطا با Try Catch و Exception در PHP (اصول و استانداردهای تمیز)

مقدمه: چرا مدیریت خطا در PHP حیاتی است؟

در دنیای برنامه‌نویسی وب، مواجهه با خطاهای پیش‌بینی نشده امری اجتناب‌ناپذیر است. از قطع اتصال پایگاه داده گرفته تا عدم وجود یک فایل حیاتی یا ورودی‌های نامعتبر از سوی کاربر، همگی می‌توانند باعث متوقف شدن ناگهانی نرم‌افزار شوند. استاندارد توسعه گوگل و اصول کدنویسی تمیز (Clean Code) ایجاب می‌کند که نرم‌افزار شما رفتاری پیش‌بینی‌پذیر و منعطف در برابر خطاها داشته باشد. در PHP، ابزار قدرتمند Exception Handling به ما اجازه می‌دهد این بحران‌ها را به شکلی زیبا و حرفه‌ای مدیریت کنیم.

۱. ساختار پایه Try-Catch

مکانیزم مدیریت استثنا در PHP شامل سه بخش اصلی است: بلاک try (کدی که احتمال بروز خطا در آن وجود دارد)، بلاک catch (جایی که خطا را دریافت و مدیریت می‌کنیم) و دستور throw (برای پرتاب کردن یک استثنا).

try {
    $age = -5;
    if ($age < 0) {
        throw new Exception("سن کاربر نمی‌تواند منفی باشد.");
    }
    echo "سن تایید شد.";
} catch (Exception $e) {
    echo "خطایی رخ داد: " . $e->getMessage();
}

در مثال فوق، زمانی که سن کمتر از صفر باشد، بلافاصله اجرای کدهای درون بلاک try متوقف شده و کنترل برنامه به بلاک catch منتقل می‌شود تا پیغام خطای مناسب نمایش داده شود.

۲. استفاده از بلاک Finally

بلاک finally کدهایی را در بر می‌گیرد که در هر شرایطی (چه خطا رخ دهد و چه رخ ندهد) باید اجرا شوند. این بلاک معمولاً برای کارهایی مثل بستن اتصالات دیتابیس یا آزاد کردن منابع سیستم کاربرد دارد.

try {
    $file = fopen("data.txt", "r");
    // انجام عملیات روی فایل
} catch (Exception $e) {
    echo "خطا در خواندن فایل: " . $e->getMessage();
} finally {
    if (isset($file)) {
        fclose($file);
        echo "اتصال فایل با موفقیت بسته شد.";
    }
}

۳. مدیریت چندین استثنا (Multiple Catch Blocks)

در پروژه‌های واقعی، یک بلاک کد ممکن است خطاهای متفاوتی ایجاد کند. PHP به شما اجازه می‌دهد چندین بلاک catch را برای انواع مختلف استثناها تعریف کنید. این کار به شما امکان می‌دهد برای هر نوع خطا، واکنش مناسبی نشان دهید.

try {
    $db = new PDO("mysql:host=localhost;dbname=test", "user", "pass");
    $email = "invalid-email";
    
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        throw new InvalidArgumentException("فرمت ایمیل نامعتبر است.");
    }
} catch (PDOException $e) {
    echo "خطای پایگاه داده: " . $e->getMessage();
} catch (InvalidArgumentException $e) {
    echo "خطای ورودی کاربر: " . $e->getMessage();
} catch (Exception $e) {
    echo "خطای عمومی: " . $e->getMessage();
}

۴. ساخت Exception سفارشی (Custom Exceptions)

گاهی اوقات نیاز است که کلاس‌های استثنای اختصاصی خود را بسازید تا کنترل دقیق‌تری روی خطاهای بیزینس‌لاژیک برنامه‌تان داشته باشید. برای این کار کافیست کلاس خود را از کلاس پایه Exception ارث‌بری کنید.

class InsufficientFundsException extends Exception {
    public function errorMessage() {
        return "خطا در خط " . $this->getLine() . " رخ داده است: موجودی حساب شما کافی نیست.";
    }
}

try {
    $balance = 5000;
    $withdraw = 10000;
    if ($withdraw > $balance) {
        throw new InsufficientFundsException();
    }
} catch (InsufficientFundsException $e) {
    echo $e->errorMessage();
}

۵. بهترین الگوهای مدیریت خطا طبق استاندارد گوگل

• هرگز بلاک catch را خالی نگذارید: نادیده گرفتن استثناها (Silent Catching) دیباگ کردن برنامه را غیرممکن می‌کند. حداقل خطا را لاگ کنید.
• استفاده از کلاس‌های استثنای تخصصی: به جای پرتاب کردن استثنای عمومی Exception، از کلاس‌های توکار PHP مانند InvalidArgumentException یا RuntimeException استفاده کنید.
• جدا کردن لاگ‌ها از لایه نمایش: جزئیات خطا (مانند مسیر فایل یا کوئری‌های دیتابیس) را هرگز به کاربر نهایی نشان ندهید؛ این اطلاعات باید در فایل لاگ ذخیره شوند و به کاربر صرفاً یک پیام مودبانه نمایش داده شود.

پیشنمایش