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

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

كيف تقرأ خطأ PHP؟

الرسالة تحمل ثلاثة أجزاء مهمّة: نوع الخطأ (Parse error / Warning / Fatal error)، الوصف، ورقم السطر واسم الملف. ابدأ دائمًا برقم السطر — هو أسرع طريق للمشكلة الفعلية.

1) Parse error — خطأ في الصياغة

<?php
function greet($name) {
    echo "أهلًا يا $name"
}   // ❌ Parse error: syntax error, unexpected '}'
?>

الحلّ: فاصلة منقوطة ناقصة بعد echo. راجع الأقواس {} () والفواصل المنقوطة قرب رقم السطر المذكور — والسطر الفعلي أحيانًا يكون قبل رقم السطر في الرسالة، لأن PHP تكتشف الخطأ عند وصولها للسطر التالي:

<?php
function greet($name) {
    echo "أهلًا يا $name";   // ✅
}
?>

2) Undefined variable / Undefined array key

<?php
echo $usernme;   // ❌ Warning: Undefined variable $usernme

$user = ["name" => "سارة"];
echo $user["age"];   // ❌ Warning: Undefined array key "age"
?>

الحلّ: خطأ إملائي في الاسم، أو مفتاح لم يُرسَل أصلًا (مثل حقل نموذج اختياري). تحقّق قبل الاستخدام:

<?php
echo $user["age"] ?? "غير محدّد";   // null coalescing — آمن دائمًا

if (isset($user["age"])) {
    echo $user["age"];
}
?>

3) Call to a member function ... on null

<?php
$user = findUser($id);   // ترجع null لو لم يوجد المستخدم
echo $user->name;        // ❌ Fatal error: Call to a member function on null
?>

الحلّ: الدالة رجعت null بدل كائن، غالبًا لأن البحث لم يجد نتيجة. تحقّق أولًا أو استخدم العامل الآمن الفارغ ?->:

<?php
$user = findUser($id);

if ($user !== null) {
    echo $user->name;
}

// أو أقصر:
echo $user?->name ?? "مستخدم غير موجود";
?>

4) Headers already sent

<?php
echo "مرحبًا";        // ❌ أي إخراج قبل header() يسبّب المشكلة
header("Location: /login.php");
?>

الحلّ: HTTP يشترط إرسال الترويسات (headers) قبل أي محتوى. ضع كل استدعاءات header() وsetcookie() وsession_start() في أول الملف قبل أي echo أو حتى مسافة خارج وسم <?php:

<?php
// أول سطر في الملف — لا شيء قبله، ولا مسافة بعد ?> في نهاية الملف
session_start();
header("Location: /login.php");
exit;
?>

💡 احفظ الملفّات بترميز UTF-8 بدون BOM — علامة BOM نفسها تُحسَب إخراجًا خفيًّا قبل <?php وتسبّب هذا الخطأ رغم أن الكود يبدو سليمًا.

5) Class "X" not found

<?php
$user = new User();   // ❌ Fatal error: Class "User" not found
?>

الحلّ: الملف المحتوي على الصنف لم يُضمَّن، أو الـ namespace غير مطابق، أو Composer autoload لم يُحمَّل:

<?php
require_once "vendor/autoload.php";   // لو تستخدم Composer
require_once "models/User.php";       // أو تضمين يدوي

use App\Models\User;

$user = new User();   // ✅
?>

جدول الأخطاء السريع

الخلاصة

معظم أخطاء PHP واضحة بمجرّد قراءة نوع الخطأ ورقم السطر بعناية. تعامل مع null بحذر دائمًا (?? و?->)، وضع منطق الترويسات في أول الملف، وستحلّ أغلب المشاكل الشائعة بسرعة.

ابدأ مسار PHP من الصفر.