كيفية التقاط خطأ PHP الفادح (E_ERROR): الفخاخ والحلول

كيفية التقاط الخطأ الفادح في PHP (E_ERROR) دون أن تفقد صوابك

هل سبق لك أن رأيت هذا؟ موقعك على PHP يعرض صفحة بيضاء فارغة دون أي خطأ. أو الأسوأ من ذلك - رسالة مخيفة Fatal error: Uncaught Error.... إذا كنت مطوراً يعمل مع PHP، فمن المحتمل أنك واجهت E_ERROR - أكثر أنواع الأخطاء إزعاجاً. على عكس التحذيرات (Warnings) أو الإشعارات (Notices)، فإن الخطأ الفادح يوقف تنفيذ السكريبت تماماً. والأكثر إحباطاً: أن كتلة try...catch القياسية لا تلتقطه.

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

لماذا لا ينقذك try...catch من E_ERROR؟

دعنا نبدد الوهم فوراً: try...catch في PHP مصمم لمعالجة الاستثناءات (Exceptions). بينما E_ERROR هو خطأ (Error). هذان كيانان مختلفان. لم يسمح PHP قبل الإصدار 7.0 بالتقاط الأخطاء الفادحة على الإطلاق. بدءاً من PHP 7، ظهرت الفئة Error التي، مثل Exception، تطبق الواجهة Throwable. لكن هذا لا يعني أن أي E_ERROR يصبح تلقائياً استثناءً. على سبيل المثال، خطأ نفاد الذاكرة (Out of memory) أو استدعاء طريقة غير موجودة - لا تزال أخطاء فادحة لا يمكن دائماً اعتراضها عبر try...catch.

إليك مثال بسيط:

try {\n    $obj = new NonExistentClass(); // هذا سيسبب E_ERROR\n} catch (Throwable $e) {\n    echo 'التقطنا: ' . $e->getMessage();\n}

في PHP 7+ سيعمل هذا الكود، لأن Throwable يتضمن Error. لكن إذا حدث الخطأ في مرحلة التجميع (مثل خطأ نحوي) أو في مرحلة الإغلاق (shutdown)، فإن try...catch يصبح عديم الفائدة.

أهم 3 أخطاء فادحة في PHP وكيفية تجنبها

1. استدعاء طريقة أو فئة غير موجودة

الخطأ الفادح الأكثر شيوعاً هو Call to undefined method أو Class not found. يحدث عندما تحاول استدعاء طريقة غير موجودة، أو استخدام فئة غير محملة.

كيفية تجنبه:

\n
• استخدم دائماً التحميل التلقائي للفئات (spl_autoload_register أو Composer).
\n
• تحقق من وجود الطريقة باستخدام method_exists().
\n

if (method_exists($object, 'someMethod')) {\n    $object->someMethod();\n} else {\n    // معالجة\n}

2. استنفاد الذاكرة (Allowed memory size exhausted)

الخطأ Allowed memory size of X bytes exhausted هو خطأ فادح يحدث عندما يستهلك السكريبت ذاكرة أكثر من المسموح به. لا يمكن اعتراضه بالطريقة العادية.

كيفية تجنبه:

\n
• حسّن استعلامات قاعدة البيانات.
\n
• استخدم المولدات (yield) لمعالجة المصفوفات الكبيرة.
\n
• زد حد الذاكرة في php.ini أو عبر ini_set('memory_limit', '256M').
\n

3. تجاوز وقت التنفيذ (Maximum execution time exceeded)

على الرغم من أن هذا الخطأ ليس دائماً فادحاً، إلا أنه في بعض التهيئات يوقف تنفيذ السكريبت تماماً.

كيفية تجنبه:

\n
• استخدم set_time_limit(0) للسكريبتات الطويلة.
\n
• قسّم العمليات الثقيلة إلى أجزاء.
\n

كيفية التقاط الخطأ الفادح في PHP: 3 طرق مجربة

الآن ننتقل إلى الجزء الرئيسي. هناك عدة تقنيات تسمح باعتراض E_ERROR وتنفيذ كود قبل أن يموت السكريبت.

الطريقة 1. استخدام register_shutdown_function()