أفضل ممارسات معالجة الأخطاء في PHP لكتابة كود قابل للصيانة

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

لماذا تهم معالجة الأخطاء في PHP

PHP متسامح افتراضيًا: غالبًا ما يستمر في التنفيذ بعد تحذير، ويمكن تجاهل الأخطاء بصمت. هذه المرونة سلاح ذو حدين. بدون معالجة مناسبة، يمكن أن تؤدي الأخطاء إلى:

• كشف معلومات حساسة للمستخدمين (مثل بيانات اعتماد قاعدة البيانات في تتبع المكدس).
• إتلاف البيانات أو ترك التطبيق في حالة غير متسقة.
• جعل التصحيح كابوسًا لأن الأخطاء مبعثرة أو مكبوتة.

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

1. تعيين مستويات الإبلاغ عن الأخطاء المناسبة

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

// Development
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

// Production
ini_set('display_errors', 0);
ini_set('log_errors', 1);
ini_set('error_log', '/path/to/php-error.log');
error_reporting(E_ALL & ~E_DEPRECATED & ~E_STRICT);

استخدم متغيرات البيئة أو ملفات التكوين للتبديل بين هذه الإعدادات تلقائيًا. لا تعتمد أبدًا على تحرير php.ini يدويًا على خوادم الإنتاج.

2. استخدم الاستثناءات بدلاً من رموز الأخطاء

إرجاع رموز الأخطاء (مثل false أو -1) هو نمط قديم يزدحم الكود ويجعل من السهل تجاهل حالات الفشل. تفرض الاستثناءات عليك التعامل مع الأخطاء بشكل صريح وتحافظ على مسارك السعيد نظيفًا.

// Bad: error code
function getUser($id) {
    $user = db_find($id);
    if (!$user) {
        return false; // caller must check
    }
    return $user;
}

// Good: exception
function getUser($id) {
    $user = db_find($id);
    if (!$user) {
        throw new UserNotFoundException("User $id not found");
    }
    return $user;
}

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

3. التقاط الاستثناءات في المستوى المناسب

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

try {
    $user = getUser($id);
    $order = createOrder($user, $items);
} catch (UserNotFoundException $e) {
    // Handle missing user specifically
    return response('User not found', 404);
} catch (PaymentFailedException $e) {
    // Handle payment failure
    return response('Payment failed: ' . $e->getMessage(), 400);
} catch (Throwable $e) {
    // Catch-all for unexpected errors
    log_error($e);
    return response('Something went wrong', 500);
}

استخدم Throwable (PHP 7+) لالتقاط كل من الاستثناءات والأخطاء. تجنب كتل catch الفارغة—إذا التقطت، افعل شيئًا ذا معنى.

4. سجل الأخطاء مع السياق

التسجيل هو أفضل صديق لك لتصحيح مشكلات الإنتاج. لكن رسالة سجل مثل "حدث خطأ" عديمة الفائدة. قم بتضمين السياق: معرف المستخدم، معلمات الطلب، تتبع المكدس، والطوابع الزمنية.

try {
    processPayment($order);
} catch (PaymentException $e) {
    error_log(sprintf(
        "Payment failed for order %d: %s in %s:%d\nStack trace: %s",
        $order->id,
        $e->getMessage(),
        $e->getFile(),
        $e->getLine(),
        $e->getTraceAsString()
    ));
    throw $e; // re-throw after logging
}

فكر في استخدام مكتبة تسجيل مثل Monolog للسجلات المنظمة. فهي تدعم معالجات مختلفة (ملف، syslog، Slack) ومستويات تسجيل (debug، info، warning، error).

5. أنشئ معالج أخطاء مخصص

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

set_error_handler(function ($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) {
        return false; // respect error_reporting settings
    }
    throw new ErrorException($message, 0, $severity, $file, $line);
});

set_exception_handler(function ($e) {
    log_error($e);
    http_response_code(500);
    include 'views/error.php';
});

register_shutdown_function(function () {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        log_error(new ErrorException($error['message'], 0, $error['type'], $error['file'], $error['line']));
    }
});

يضمن هذا الإعداد تسجيل جميع الأخطاء—بما في ذلك الأخطاء القاتلة—ومعالجتها بشكل سلس.

6. تحقق من المدخلات وافشل مبكرًا

تنبع العديد من الأخطاء من مدخلات غير صالحة. تحقق من البيانات عند حدود تطبيقك (وحدات التحكم، نقاط نهاية API) وارمِ استثناءات فورًا إذا فشل التحقق. هذا يمنع الأخطاء من الانتشار عميقًا في الكود الخاص بك.

function createUser(array $data) {
    if (empty($data['email'])) {
        throw new InvalidArgumentException('Email is required');
    }
    if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        throw new InvalidArgumentException('Invalid email format');
    }
    // ... proceed with confidence
}

استخدم دوال التصفية في PHP أو مكتبة تحقق (مثل Respect\Validation) للحفاظ على اتساق التحقق.

7. لا تكبت الأخطاء باستخدام @

عامل @ يسكت الأخطاء، مما يجعل التصحيح أكثر صعوبة. من المغري استخدامه عند استدعاء دوال قد تصدر تحذيرات (مثل file_get_contents)، لكنه يخفي مشكلات حقيقية. بدلاً من ذلك، تحقق من الشروط المسبقة أو استخدم try-catch مع الاستثناءات.

// Bad
$content = @file_get_contents($url);

// Good
if (!is_readable($url)) {
    throw new RuntimeException("Cannot read $url");
}
$content = file_get_contents($url);

إذا كان يجب عليك الكبت، فافعل ذلك فقط للحالات المفهومة جيدًا ووثق السبب.

8. استخدم برمجية وسيطة مركزية لمعالجة الأخطاء

في أطر العمل مثل Laravel أو Symfony، غالبًا ما تكون معالجة الأخطاء مركزية في برمجية وسيطة أو معالج استثناءات. إذا كنت تبني إطارك الخاص، فأنشئ نقطة دخول واحدة تلتقط جميع الاستثناءات وتحولها إلى استجابات HTTP.

// In your front controller (index.php)
try {
    $response = $router->dispatch($request);
} catch (HttpException $e) {
    $response = new Response($e->getMessage(), $e->getStatusCode());
} catch (Throwable $e) {
    log_error($e);
    $response = new Response('Internal Server Error', 500);
}
$response->send();

هذا يحافظ على منطق معالجة الأخطاء في مكان واحد ويضمن الاتساق.

مقارنة: نهج معالجة الأخطاء

الأسئلة الشائعة

ما الفرق بين الأخطاء والاستثناءات في PHP؟

الأخطاء هي مشكلات منخفضة المستوى مثل أخطاء الصياغة أو أخطاء النوع، بينما الاستثناءات هي كائنات يتم رميها تمثل ظروفًا استثنائية. في PHP 7+، كلاهما ينفذ واجهة Throwable، لذا يمكنك التقاط كليهما بكتلة catch واحدة.

هل يجب استخدام try-catch لكل استدعاء دالة؟

لا، فهذا يؤدي إلى كود دفاعي مفرط. التقط الاستثناءات فقط عندما يمكنك معالجتها بشكل مفيد—تسجيل، إعادة محاولة، أو عرض رسالة ودية للمستخدم. دع الاستثناءات تنتشر إلى معالج مركزي للحالات غير المتوقعة.

كيف أسجل الأخطاء دون كشف بيانات حساسة؟

قم بتنقية رسائل السجل عن طريق إزالة كلمات المرور والرموز والبيانات الشخصية. استخدم التسجيل المنظم مع حقول السياق، وقم بتكوين مكتبة التسجيل لديك لحجب المفاتيح الحساسة. أيضًا، تأكد من تخزين ملفات السجل بشكل آمن وتقييد الوصول إليها.

هل أنت مستعد لتبسيط معالجة الأخطاء في PHP؟ ابدأ بمراجعة إعدادات الإبلاغ عن الأخطاء الحالية وتنفيذ معالج أخطاء مخصص. لتصحيح سريع لحمولات JSON أو السجلات، جرب JSON Formatter للتحقق من بياناتك وتنسيقها بشكل جميل.