الأخطاء والاستثناءات

١حين تفشل العملية

في الدرس السابق أوقفنا التنفيذ بـ exit عند مخالفة القاعدة. لكن ماذا لو كانت القاعدة داخل دالة تستدعيها دالة أخرى؟ الدالة العميقة لا تعرف هل نحن في صفحة HTML أم في API، ولا يصح أن تطبع أو تقرر رمز الحالة. الحل: أن ترمي استثناءً Exception يقول «فشلت ولهذا السبب»، ويقرر من استدعاها كيف يرد.

<?phpfunction withdraw(float $balance, float $amount): float{    if ($amount <= 0) {        throw new InvalidArgumentException('المبلغ يجب أن يكون موجبًا');    }    if ($amount > $balance) {        throw new RuntimeException('الرصيد غير كافٍ');    }    return $balance - $amount;} try {    echo withdraw(100, 30) . "\n";    echo withdraw(100, 500) . "\n";     // يرمي استثناءً    echo "لن يُطبع هذا السطر\n";} catch (RuntimeException $e) {    echo "فشلت العملية: " . $e->getMessage() . "\n";}echo "التطبيق مستمر";

٢الاستثناء غير الملتقط

إن لم يلتقط أحد الاستثناء يصعد حتى القمة، فيتوقف التطبيق بخطأ قاتل ورمز 500، ويرى المستخدم رسالة تقنية لا تعنيه:

<?phpfunction findCourse(string $code): string{    $courses = ['132' => 'الواجهات الخلفية', '131' => 'الواجهات الأمامية'];    if (!isset($courses[$code])) {        throw new RuntimeException("المقرر $code غير موجود");    }    return $courses[$code];} echo findCourse('999');

وكثير من أخطاء PHP 8 نفسها استثناءات يمكنك التقاطها، مثل DivisionByZeroError و TypeError، وكلها تحت النوع العام Throwable.

٣أنواع استثناءاتك الخاصة

بدل فحص نص الرسالة، أنشئ أصنافًا للاستثناءات تعبّر عن نوع المشكلة، ثم حوّل كل نوع إلى رمز HTTP مناسب في مكان واحد:

<?phpclass ValidationError extends Exception {}class NotFound extends Exception {}class Conflict extends Exception {} function reserve(string $course, int $seats): string{    $free = ['PHP' => 4, 'SQL' => 0];    if ($seats < 1 || $seats > 3) throw new ValidationError('عدد المقاعد من 1 إلى 3');    if (!isset($free[$course]))   throw new NotFound("لا توجد دورة $course");    if ($free[$course] < $seats)  throw new Conflict("المقاعد المتاحة في $course: {$free[$course]}");    return "تم حجز $seats مقعد في $course";} try {    $msg = reserve($_GET['course'] ?? '', (int) ($_GET['seats'] ?? 0));    http_response_code(201);    echo $msg;} catch (ValidationError $e) {    http_response_code(422);    echo $e->getMessage();} catch (NotFound $e) {    http_response_code(404);    echo $e->getMessage();} catch (Conflict $e) {    http_response_code(409);    echo $e->getMessage();}

٤ما يراه المستخدم وما يراه المطوّر

في بيئة التطوير نعرض تفاصيل الخطأ لنصلحه. أما على الخادم الحقيقي فعرض التفاصيل خطر (مسارات الملفات، وأسماء الجداول) ومنفّر للمستخدم. فنفعل شيئين: نسجّل التفاصيل في ملف للمطوّر، ونعرض رسالة لطيفة للمستخدم:

<?php// في أعلى التطبيق على الخادم الحقيقي (أو في php.ini)ini_set('display_errors', '0');      // لا تعرض الأخطاء للزوارini_set('log_errors', '1');          // سجّلهاini_set('error_log', __DIR__ . '/../logs/php-errors.log'); // شبكة أمان أخيرة لأي استثناء لم يُلتقطset_exception_handler(function (Throwable $e) {    error_log($e);                   // التفاصيل كاملة في ملف السجل    http_response_code(500);    echo 'حدث خطأ غير متوقع. حاول لاحقًا.';});