شرح التعامل مع الأخطاء (Errors) في PHP

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

في هذا الدرس ستتعلم أنواع أخطاء PHP الأساسية وكيف تتعامل معها بطريقة عملية.

لماذا تظهر الأخطاء في PHP؟

• خطأ في الصياغة (Syntax) مثل نسيان ;.
• استدعاء دالة أو متغير غير معرف.
• مشاكل في الملفات أو المسارات أو البيانات.

أنواع الأخطاء الشائعة في PHP

مثال 1: Parse Error (خطأ صياغة)

الكود الخاطئ:

<?php
echo "Hello"
?>

هنا نسينا الفاصلة المنقوطة ;، فيتوقف الكود مباشرة بخطأ صياغة.

مثال 2: Fatal Error

الكود الخاطئ:

<?php
myCustomFunction();
?>

إذا كانت الدالة غير معرفة، PHP سترجع Fatal Error وتتوقف.

مثال 3: Warning / Notice

مثال Notice:

<?php
echo $username;
?>

إذا لم يتم تعريف $username مسبقاً، غالباً سترى Notice.

كيف تقرأ رسالة الخطأ بسرعة؟

مثال رسالة:

Fatal error: Uncaught Error: Call to undefined function myFunc() in /var/www/html/index.php on line 15

• نوع الخطأ: Fatal error.
• السبب: دالة غير معرفة myFunc().
• المكان: الملف index.php، السطر 15.

إعداد عرض الأخطاء: تطوير vs إنتاج

أثناء التطوير (Local):

<?php
error_reporting(E_ALL);
ini_set("display_errors", 1);
?>

في الإنتاج (Live):

<?php
error_reporting(E_ALL);
ini_set("display_errors", 0);
ini_set("log_errors", 1);
?>

أفضل ممارسات عند التعامل مع الأخطاء

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

أخطاء شائعة للمبتدئين

• تجاهل رسالة الخطأ والتركيز على التخمين فقط.
• إيقاف كل التقارير دون فهم السبب الحقيقي.
• العمل في الإنتاج مع display_errors=1.
• عدم تهيئة المتغيرات قبل استخدامها.

تمرين تطبيقي سريع

1. اكتب سطراً فيه خطأ صياغة بسيط وراقب رسالة Parse Error.
2. اكتب استدعاء دالة غير موجودة ولاحظ Fatal Error.
3. صحح الأخطاء ثم فعّل إعدادات عرض الأخطاء المناسبة للتطوير.

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

ما هي أنواع الأخطاء الشائعة في PHP؟

Parse وFatal وWarning وNotice هي الأكثر ظهوراً للمبتدئين.

كيف أقرأ رسالة الخطأ؟

ابدأ بنوع الخطأ، ثم السبب، ثم اسم الملف ورقم السطر.

هل أظهر الأخطاء في الموقع الحي؟

لا، الأفضل إخفاؤها عن المستخدم وتسجيلها في Logs.

ما الفرق بين Warning وFatal؟

Warning غالباً لا يوقف التنفيذ، بينما Fatal يوقف السكربت مباشرة.