آموزش رایگان PHP

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

1405/05/01 20:26 محراب حسن زاده
آموزش جامع مدیریت خطا با 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 استفاده کنید.
  • جدا کردن لاگ‌ها از لایه نمایش: جزئیات خطا (مانند مسیر فایل یا کوئری‌های دیتابیس) را هرگز به کاربر نهایی نشان ندهید؛ این اطلاعات باید در فایل لاگ ذخیره شوند و به کاربر صرفاً یک پیام مودبانه نمایش داده شود.

پیشنمایش

پرسش و پاسخ

نظری یافت نشد

مطالب مشابه

آموزش کامل Super Global ها در PHP (متغیرهای سراسری)
1405/05/01 19:58

آموزش کامل Super Global ها در PHP (متغیرهای سراسری)

مطالعه بیشتر
آموزش کامل توابع سازنده (Constructors) و پروتوتایپ‌ها (Prototypes) در جاوا اسکریپت: راهنمای جامع
1403/07/28 21:41

آموزش کامل توابع سازنده (Constructors) و پروتوتایپ‌ها (Prototypes) در جاوا اسکریپت: راهنمای جامع

مطالعه بیشتر
آموزش تگ‌های زمان و مکان در HTML: استفاده از time و location در صفحات وب
1402/05/29 21:13

آموزش تگ‌های زمان و مکان در HTML: استفاده از time و location در صفحات وب

مطالعه بیشتر
آموزش طراحی و استایل‌دهی جدول‌ها در CSS: راهنمای ساده و کاربردی
1402/06/10 18:00

آموزش طراحی و استایل‌دهی جدول‌ها در CSS: راهنمای ساده و کاربردی

مطالعه بیشتر
مدیریت خطاها در Async/Await و Promises در جاوا اسکریپت: راهنمای کامل با مثال‌های عملی
1403/07/30 20:59

مدیریت خطاها در Async/Await و Promises در جاوا اسکریپت: راهنمای کامل با مثال‌های عملی

مطالعه بیشتر
آموزش استفاده از position در CSS: نحوه موقعیت‌دهی عناصر در صفحات وب
1403/08/09 20:59

آموزش استفاده از position در CSS: نحوه موقعیت‌دهی عناصر در صفحات وب

مطالعه بیشتر
آموزش کامل ارسال درخواست HTTP با cURL در PHP (مطابق استاندارد گوگل)
1405/08/02 15:53

آموزش کامل ارسال درخواست HTTP با cURL در PHP (مطابق استاندارد گوگل)

مطالعه بیشتر
آموزش جامع و کاربردی توابع رشته‌ای در PHP (توابع strlen، str_replace و strpos)
1405/04/27 21:43

آموزش جامع و کاربردی توابع رشته‌ای در PHP (توابع strlen، str_replace و strpos)

مطالعه بیشتر
آموزش گام به گام اتصال به دیتابیس با MySQLi در PHP (امن و استاندارد)
1405/05/04 23:40

آموزش گام به گام اتصال به دیتابیس با MySQLi در PHP (امن و استاندارد)

مطالعه بیشتر
مقدمه‌ای به template و دیتابایندینگ در Vue.js: نحوه مدیریت داده‌ها و رندرینگ پویا
1402/06/28 00:49

مقدمه‌ای به template و دیتابایندینگ در Vue.js: نحوه مدیریت داده‌ها و رندرینگ پویا

مطالعه بیشتر
آموزش مفاهیم اولیه CSS Grid Layout: طراحی شبکه‌های پیچیده و واکنش‌گرا راهنمای کامل
1402/06/06 23:24

آموزش مفاهیم اولیه CSS Grid Layout: طراحی شبکه‌های پیچیده و واکنش‌گرا راهنمای کامل

مطالعه بیشتر
آموزش جامع توابع بازگشتی (Recursion) و کاربردهای آن در جاوا اسکریپت: مثال‌ها و مفاهیم
1403/07/29 20:15

آموزش جامع توابع بازگشتی (Recursion) و کاربردهای آن در جاوا اسکریپت: مثال‌ها و مفاهیم

مطالعه بیشتر

تمامی حقوق معتلق به ناشر سایت است و کپی از آن پیگرد قانونی دارد