ما هي أنواع الأخطاء والاستثناءات في PHP؟

Question

Accepted Answer

يوفر PHP نظامين متوازيين للمشاكل: **الأخطاء** التقليدية (تحذيرات، إشعارات، أخطاء مميتة) و**الاستثناءات** (قائمة على الكائنات، يمكن التقاطها باستخدام try/catch). يوحّد PHP الحديث الكثير من هذا تحت تسلسل هرمي `Throwable`، والممارسات الجيدة تفضل الاستثناءات.

## مستويات الأخطاء التقليدية

```text
E_NOTICE   → minor issues (e.g. using an undefined variable) — script continues
E_WARNING  → non-fatal problems (e.g. include of a missing file) — continues
E_ERROR / Fatal → serious errors (e.g. calling an undefined function) — script HALTS
E_DEPRECATED → use of deprecated features
```

هذه هي أخطاء PHP الكلاسيكية القائمة على المستويات. تسمح الإشعارات والتحذيرات للسكريبت بالمتابعة (لكنها تشير إلى مشاكل)؛ الأخطاء المميتة توقفه.

## التسلسل الهرمي Throwable (حديث، قائم على الكائنات)

```text
Throwable (interface)
  ├── Error      → internal PHP/engine errors (TypeError, DivisionByZeroError, ...)
  │                 — typically PROGRAMMING bugs
  └── Exception  → application-level exceptions (the ones you throw and catch)
        ├── RuntimeException, LogicException
        ├── InvalidArgumentException, etc.
        └── your custom exceptions
```

يمثل PHP الحديث المشاكل الخطيرة ككائنات تطبق `Throwable`، منقسمة إلى `Error` (مستوى المحرك، عادة أخطاء برمجية مثل `TypeError`) و`Exception` (أخطاء التطبيق التي تطرحها وتتعامل معها).

## التقاط باستخدام try/catch

```php
try {
    $result = riskyOperation();
} catch (InvalidArgumentException $e) {     // catch a SPECIFIC type
    echo "Bad argument: " . $e->getMessage();
} catch (Throwable $e) {                     // catch anything (Error OR Exception)
    log($e);
} finally {
    cleanup();                                // always runs
}
```

منذ PHP 7، حتى `Error` (مثل `TypeError`) يمكن التقاطها كـ `Throwable` — بحيث يمكنك التقاط الأخطاء والاستثناءات معاً.

## رفع الاستثناءات

```php
function divide(int $a, int $b): float {
    if ($b === 0) {
        throw new InvalidArgumentException("Cannot divide by zero");   // raise
    }
    return $a / $b;
}
```

## تكوين معالجة الأخطاء

```php
error_reporting(E_ALL);         // report ALL errors (development)
ini_set('display_errors', '0'); // production: DON'T show errors to users (log them instead)
set_error_handler(...);          // convert errors to exceptions, custom handling
```

## لماذا يهمّ هذا

فهم نظام الأخطاء والاستثناءات في PHP مهم لكتابة تطبيقات قوية وتصحيح الأخطاء بكفاءة.

معرفة **مستويات الأخطاء** التقليدية (إشعار/تحذير/مميت) تساعدك على تفسير رسائل PHP والتعرف على خطورة المشاكل، بينما فهم **التسلسل الهرمي `Throwable`** الحديث (الفصل بين `Error` على مستوى المحرك — عادة أخطاء برمجية — و`Exception` التطبيق التي ترفعها وتتعامل معها) هو المفتاح لمعالجة الأخطاء الحديثة في PHP.

المهارات العملية — استخدام `try/catch/finally` للتعامل مع الاستثناءات، والتقاط أنواع محددة، ورفع استثناءات ذات معنى، وأن `Error` قابلة للالتقاط كـ `Throwable` (منذ PHP 7) — هي معرفة يومية لبناء كود موثوق.

من المهم معرفة ممارسة الإنتاج المتمثلة في **تسجيل الأخطاء بدلاً من عرضها للمستخدمين** (لأن الأخطاء المعروضة تسرب معلومات حساسة — مخاوف أمنية) ضروري للنشر الآمن.

يفضل PHP الحديث النهج القائم على الاستثناءات والموجه نحو الكائنات، لذا فإن فهم أنواع الأخطاء والاستثناءات، وكيفية التعامل معها بشكل صحيح، وتكوين الأخطاء الآمن هو معرفة أساسية لكتابة تطبيقات PHP قوية وقابلة للتصحيح وآمنة.