خطأ Allowed memory size exhausted: رفع ذاكرة PHP بحكمة
باختصار: رسالة «Allowed memory size of ... bytes exhausted» تعني أن سكربت PHP في موقعك طلب ذاكرة أكثر من الحد المسموح به في إعداد memory_limit، فتوقف التنفيذ وظهرت صفحة بيضاء أو خطأ قاتل. الحل السريع رفع الحد بقدر معقول: في php.ini أو إعدادات الاستضافة لـ PHP كلها، أو بـ WP_MEMORY_LIMIT وWP_MAX_MEMORY_LIMIT في wp-config.php لووردبريس. لكن رفع الحد لا يعالج السبب دائماً، فاقرأ اسم الملف في رسالة الخطأ أولاً لتعرف أي إضافة أو عملية تستهلك الذاكرة.
كيف تظهر المشكلة
متجر ملابس أطفال في الزرقاء يعمل على ووردبريس. صاحبه يحاول رفع صورة كبيرة أو تصدير قائمة الطلبات، فتظهر صفحة بيضاء، أو رسالة «حدث خطأ فادح في هذا الموقع». عند فتح سجل الأخطاء يجد سطراً طويلاً يبدأ بـ «PHP Fatal error: Allowed memory size of 134217728 bytes exhausted» ويليه اسم ملف ورقم سطر.
الرقم في الرسالة هو الحد الحالي بالبايت. الرقم 134217728 مثلاً يساوي 128 ميغابايت. أما اسم الملف فهو المكان الذي كان السكربت يعمل فيه لحظة نفاد الذاكرة، وهو أهم معلومة في الرسالة كلها.
ما هو memory_limit
بحسب دليل PHP الرسمي، يحدد memory_limit أقصى كمية ذاكرة بالبايت يُسمح لسكربت واحد بحجزها، والغرض منه منع السكربتات سيئة الكتابة من استهلاك كل ذاكرة الخادم. القيمة الافتراضية في الدليل هي 128M، ويمكن تغيير الإعداد من أي مكان تقريباً. ويذكر الدليل أن القيمة -1 تعني عدم وجود حد.
لا تضع -1 على موقع حقيقي. الحد موجود ليحمي الخادم: إذا علقت عملية في حلقة لا تنتهي وهي بلا حد، فقد تستهلك ذاكرة الخادم كله وتسقط معها مواقع أخرى أو قاعدة البيانات.
الخطوة الأولى: اقرأ الرسالة قبل أن ترفع الحد
قبل أن تغير أي رقم، انظر إلى مسار الملف في رسالة الخطأ:
- إذا كان المسار داخل wp-content/plugins/ متبوعاً باسم إضافة، فهذه الإضافة هي التي كانت تعمل.
- إذا كان داخل مجلد القالب، فالمشكلة في القالب أو في كود أضيف إليه.
- إذا كان داخل ملفات ووردبريس الأساسية، فالعملية نفسها ثقيلة، مثل معالجة صورة ضخمة أو استيراد ملف كبير.
وانظر متى يحدث الخطأ: في كل صفحة، أم في لوحة التحكم فقط، أم عند عملية واحدة محددة. الخطأ في كل الصفحات بعد تثبيت إضافة جديدة يختلف تماماً عن خطأ يظهر فقط عند تصدير تقرير ضخم مرة في الشهر.
أين تجد رسالة الخطأ كاملة
إذا رأيت صفحة بيضاء فقط ولا تظهر أي رسالة، فشغّل التسجيل بدل العرض. يعرض دليل ووردبريس إعداداً يكتب الأخطاء إلى ملف دون أن يعرضها على الزوار:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
ويذكر الدليل أن ملف السجل الافتراضي هو wp-content/debug.log، وينبه إلى أن وضع ملفات السجل في مكان يمكن الوصول إليه من المتصفح خطر أمني. لذلك أطفئ التسجيل بعد أن تجد الرسالة، واحذف الملف أو انقله.
رفع الحد لـ PHP كلها
إذا كان لديك وصول إلى إعدادات الخادم أو لوحة الاستضافة، فالمكان الطبيعي هو php.ini:
memory_limit = 256M
القيمة هنا مثال توضيحي، وليست توصية لكل موقع. في الاستضافة المشتركة تجد غالباً خياراً لتعديل إعدادات PHP من لوحة التحكم. وعلى خادم يعمل بـ PHP-FPM تحتاج إلى إعادة تحميل الخدمة بعد التعديل حتى يأخذ الإعداد الجديد مفعوله.
رفع الحد داخل ووردبريس
يشرح دليل إدارة ووردبريس الثابت WP_MEMORY_LIMIT، ويقول إنه قد يكون ضرورياً عندما تظهر رسالة مثل «Allowed memory size of xxxxxx bytes exhausted»، وإنه يرفع الذاكرة لووردبريس فقط لا لتطبيقات أخرى على الخادم. أضف السطر في wp-config.php:
define( 'WP_MEMORY_LIMIT', '256M' );
ويذكر الدليل أن ووردبريس يحاول افتراضياً رفع الذاكرة إلى 40MB للموقع الواحد و64MB للمواقع المتعددة، لذلك يجب أن تكون القيمة التي تكتبها أعلى من ذلك. ويتحقق ووردبريس تلقائياً إن كانت PHP تملك ذاكرة أقل من القيمة المكتوبة قبل أن يستخدمها، فإذا كان الحد في PHP أعلى أصلاً فلا داعي لكتابة رقم مساوٍ له.
ولأعمال لوحة التحكم، التي تحتاج عادة ذاكرة أكثر من الصفحات العادية، يوجد ثابت آخر:
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
وينبه الدليل إلى أن هذه الأسطر يجب أن توضع قبل سطر تضمين wp-settings.php في الملف، وإلا فلن تعمل.
لماذا لم يتغير شيء بعد التعديل
أحياناً تضيف السطر ويبقى الخطأ نفسه بالرقم نفسه. الأسباب الشائعة:
- الاستضافة تمنع الرفع: يذكر دليل ووردبريس أن بعض الاستضافات لا تسمح برفع حد ذاكرة PHP تلقائياً، وفي هذه الحالة تطلب الرفع من الاستضافة.
- السطر في المكان الخطأ: بعد wp-settings.php بدل أن يكون قبله.
- ملف إعدادات آخر يغلب: على بعض الخوادم توجد إعدادات PHP مختلفة للويب وللأوامر النصية، فتعدل واحداً وتختبر الآخر.
للتأكد من القيمة الفعلية، افتح أداة «صحة الموقع» في لوحة تحكم ووردبريس، وانظر في قسم المعلومات إلى حد الذاكرة في PHP.
رفع الحد قد يخفي المشكلة
يحذر دليل ووردبريس نفسه من أن رفع الحد قد يخفي أصل المشكلة لتظهر لاحقاً عند إضافة إضافات أو وظائف أخرى. وإذا استمرت مشاكل الذاكرة رغم رفع الحد، فالدليل يوصي بفحص التثبيت جيداً، ويقول إن السبب المحتمل وجود وظائف كثيرة تستهلك الذاكرة مرتبطة بحدث واحد، وإن الأفضل نقلها إلى مهمة مجدولة.
عملياً: إذا كان الخطأ يختفي عند 256M ثم يعود بعد شهر عند 512M، فهناك شيء يكبر مع الوقت، مثل استعلام يحمّل كل الطلبات دفعة واحدة، أو إضافة سجلات تجمع البيانات بلا حد. هنا عطّل الإضافات واحدة واحدة على نسخة تجريبية حتى يختفي الخطأ، أو اطلب من المطور تقسيم العملية إلى دفعات.
مثال توضيحي: متجر يصدّر الطلبات
هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. متجر ملابس الأطفال يرى الخطأ عند تصدير الطلبات فقط. يقرأ المسار في الرسالة فيجد أنه داخل إضافة التصدير. يرفع WP_MAX_MEMORY_LIMIT للوحة التحكم إلى قيمة أعلى، فينجح التصدير. لكنه يلاحظ أن التصدير يحمّل كل الطلبات منذ افتتاح المتجر، فيغير الإعداد ليصدّر شهراً واحداً في كل مرة، ويعيد الحد إلى قيمته السابقة.
أسئلة شائعة
شو معنى Allowed memory size exhausted بموقع ووردبريس؟
يعني أن سكربت PHP تجاوز حد الذاكرة المسموح به فتوقف. الرقم في الرسالة هو الحد الحالي بالبايت، والمسار يدلك على مصدر المشكلة.
وين بحط WP_MEMORY_LIMIT بالضبط؟
في ملف wp-config.php، قبل سطر تضمين wp-settings.php. إذا وضعته بعده فلن يكون له أي أثر.
زدت الذاكرة وما تغير إشي، ليش؟
قد تمنع الاستضافة رفع الحد، أو يكون السطر في المكان الخطأ. تحقق من القيمة الفعلية في أداة صحة الموقع واطلب الرفع من الاستضافة إن لزم.
هل بحط memory_limit على -1 وبرتاح؟
لا. القيمة -1 تلغي الحد كلياً، وأي عملية عالقة قد تستهلك ذاكرة الخادم كله وتوقف بقية الخدمات.
إذا كان موقعك يتوقف برسالة نفاد الذاكرة ولا تعرف أي إضافة السبب، تواصل معنا ونقرأ السجلات معك ونعالج المصدر لا العَرَض فقط.