«فشلت معالجة الصورة» عند الرفع في ووردبريس: الأسباب والحل
باختصار: رسالة «فشلت معالجة الصورة بعد رفعها» في ووردبريس تعني أن الملف وصل إلى الخادم، لكن ووردبريس لم يكمل إنشاء النسخ المصغرة منه، وغالباً لأن الصورة كبيرة جداً بالبكسل على ذاكرة الخادم أو وقته، أو لأن مكتبة معالجة الصور تواجه مشكلة. الحل الأسرع تصغير الصورة قبل الرفع. والحل الدائم أن تعرف أي مكتبة يستخدمها موقعك من «صحة الموقع»، وأن تراجع حد الذاكرة ووقت التنفيذ، وأن تبقي ميزة تصغير الصور الكبيرة في ووردبريس مفعلة.
كيف تظهر المشكلة
معرض أثاث في عمّان يصور منتجاته الجديدة بكاميرا احترافية أو بهاتف حديث، ثم يرفع الصور إلى مكتبة الوسائط. بعض الصور تُرفع بنجاح، وأخرى تتوقف عند نهاية شريط التقدم، ثم تظهر رسالة تقول إن معالجة الصورة فشلت، وغالباً لأن الخادم مشغول أو لا يملك موارد كافية، مع اقتراح رفع صورة أصغر.
اللافت أن الصورة قد تظهر في المكتبة رغم الرسالة، لكن دون نسخ مصغرة، فتبدو كبيرة جداً في صفحة المنتج أو لا تظهر في المعرض كما يجب.
ماذا يحدث بعد الرفع
رفع الصورة نفسه ليس آخر خطوة. يشرح مرجع ووردبريس الدالة wp_create_image_subsizes، ويقول إنها تنشئ النسخ المصغرة للصورة وتضيف بياناتها إلى معلومات الصورة، وإنها مخصصة للاستخدام بعد رفع الصورة، وتحفظ البيانات بعد إنشاء كل نسخة، وإذا حدث خطأ يُضاف إلى البيانات المعادة.
أي أن ووردبريس بعد الرفع يفتح الصورة الأصلية في الذاكرة، ويصنع منها عدة نسخ بأحجام مختلفة: صورة مصغرة، ومتوسطة، وكبيرة، وأحجام يضيفها القالب أو ووكومرس. كل نسخة تحتاج إلى فك الصورة الأصلية كاملة في الذاكرة. وهنا تأتي المشكلة مع الصور الكبيرة جداً.
لماذا تفشل الصور الكبيرة تحديداً
حجم الملف بالميغابايت لا يعبر عن حجم الصورة في الذاكرة. صورة JPEG مضغوطة قد تكون بضعة ميغابايتات على القرص، لكن إذا كانت أبعادها كبيرة جداً بالبكسل، فإن فكها في الذاكرة يحتاج مساحة أكبر بكثير، لأن كل بكسل يُخزن بقيمه اللونية كاملة. وكاميرات الهواتف الحديثة تنتج صوراً بأبعاد كبيرة.
لذلك قد ترفع صورة حجمها صغير نسبياً فتفشل، وترفع صورة أكبر حجماً بأبعاد أقل فتنجح.
الخطوة الأولى: الحل الفوري
قبل أي إعداد، صغّر الصورة على جهازك ثم ارفعها. لصور المنتجات في موقع، نادراً ما تحتاج إلى أبعاد أكبر من حدود الشاشات الكبيرة. أي برنامج تحرير صور، حتى أدوات الهاتف، يستطيع تغيير الأبعاد قبل الرفع. هذا يحل المشكلة لهذه الصورة، ويجعل الموقع أسرع أيضاً.
الخطوة الثانية: اعرف مكتبة المعالجة
يستخدم ووردبريس مكتبة في PHP لمعالجة الصور. يذكر مرجع ووردبريس للفلتر wp_image_editors أن القائمة الافتراضية لمكتبات التحرير هي WP_Image_Editor_Imagick ثم WP_Image_Editor_GD، أي أن ووردبريس يجرب Imagick أولاً إن كانت متوفرة.
ولمعرفة أيها يعمل في موقعك، افتح «الأدوات» ثم «صحة الموقع» ثم تبويب «المعلومات» وقسم «التعامل مع الوسائط». يشرح دليل صحة الموقع أن هذا القسم يعرض المحرر النشط لتحرير الصور وتحسينها، وأن مكتبة GD مضمنة في PHP منذ زمن طويل فهي متوفرة في أغلب الاستضافات، بينما توفر Imagick يعتمد على شركة الاستضافة. ويعرض القسم أيضاً إصدار ImageMagick وإصدار Imagick، وهذا يساعد في تشخيص المشاكل التي تحدث عند توليد الصور في PHP.
الخطوة الثالثة: جرّب المكتبة الأخرى
أحياناً تكون Imagick مثبتة لكن بإعدادات حدود صارمة، أو بإصدار فيه مشكلة، فتفشل في معالجة صور معينة. في صفحة الفلتر wp_image_editors ملاحظة من المستخدمين تعرض طريقة لإجبار ووردبريس على استخدام مكتبة محددة، وتقول إنها مفيدة للاختبار. مثال توضيحي يوضع في إضافة صغيرة خاصة بالموقع:
add_filter( 'wp_image_editors', function () {
return array( 'WP_Image_Editor_GD' );
} );
جرّب رفع الصورة نفسها بعد التعديل. إذا نجحت، فالمشكلة في Imagick على خادمك، واطلب من الاستضافة مراجعتها، أو أبقِ GD إن كانت النتيجة مقبولة. وإذا فشلت أيضاً، فالمشكلة غالباً في الموارد لا في المكتبة. وفي الحالتين، أزل هذا التعديل بعد الاختبار إن لم تكن تحتاجه.
الخطوة الرابعة: الموارد
إذا كانت المشكلة في الموارد، فالأسباب المعتادة:
- حد الذاكرة في PHP منخفض: فك صورة كبيرة قد يتجاوزه. راجع حد الذاكرة الظاهر في صحة الموقع.
- وقت التنفيذ: إنشاء نسخ كثيرة لصورة كبيرة قد يتجاوز الوقت المسموح.
- أحجام كثيرة: كل قالب أو إضافة تضيف حجماً جديداً تزيد العمل. بعض المواقع تنشئ أكثر من عشر نسخ لكل صورة دون أن تستخدم نصفها.
- خادم مشغول: رفع عشرات الصور دفعة واحدة على استضافة صغيرة قد يستنفد الموارد. ارفعها على دفعات.
لا تعطل تصغير الصور الكبيرة
يشرح مرجع ووردبريس الفلتر big_image_size_threshold، ويقول إنه إذا كان عرض الصورة الأصلية أو ارتفاعها أكبر من الحد فستُصغَّر، وإن الحد يُستخدم كأقصى عرض وأقصى ارتفاع، والقيمة الافتراضية 2560 بكسل. وتصبح الصورة المصغرة هي أكبر حجم متاح، وإعادة false من الفلتر تعطل هذا التصغير.
بعض النصائح في المنتديات تقترح تعطيله للحفاظ على «الجودة الأصلية». لكن لموقع متجر أو معرض، الصور الأكبر من هذا الحد لا تفيد الزائر عادة، وتعطيل التصغير يجعل كل صورة ضخمة تبقى ضخمة في كل مكان. أبقِه مفعلاً إلا إذا كان لديك سبب واضح، مثل موقع مصور يبيع صوراً بدقة عالية.
اجعل الرفع عادة صحيحة
أفضل علاج هو ألا تصل الصور الضخمة إلى الموقع أصلاً. اتفق مع من يرفع الصور في فريقك على أبعاد قصوى، أو استخدم أداة على الجهاز تصغر الصور دفعة واحدة قبل الرفع. هذا يقلل الفشل، ويقلل مساحة الاستضافة، ويجعل صفحات المنتجات أسرع.
مثال توضيحي: معرض أثاث يرفع صور الكتالوج
هذا مثال توضيحي لطريقة المعالجة، وليس حالة حقيقية. معرض الأثاث يرى الرسالة مع صور الكاميرا الاحترافية فقط. يفتح صحة الموقع فيجد أن Imagick هي المكتبة النشطة. يجرب GD مؤقتاً فتفشل أيضاً، فيعرف أن المشكلة في الموارد. يصغر الصور على الجهاز قبل الرفع، ويرفعها على دفعات صغيرة، ويطلب من المطور إزالة ثلاثة أحجام صور لا يستخدمها القالب، فتتوقف الرسالة.
أسئلة شائعة
ليش ووردبريس بقول فشلت معالجة الصورة مع إنها انرفعت؟
لأن الرفع نجح، لكن إنشاء النسخ المصغرة فشل، غالباً بسبب أبعاد الصورة الكبيرة أو موارد الخادم.
كيف بعرف أي مكتبة صور بستخدم موقعي؟
من «صحة الموقع» ثم «المعلومات» ثم قسم «التعامل مع الوسائط»، حيث يظهر المحرر النشط.
هل بلغي تصغير الصور الكبيرة عشان الجودة؟
لا ننصح بذلك لموقع متجر أو معرض. الحد الافتراضي 2560 بكسل كافٍ للعرض، والصور الأكبر تبطئ الموقع.
رفعت صور كثيرة مرة وحدة وفشل نصها، ليش؟
لأن معالجة صور كثيرة معاً تستنفد موارد الاستضافة الصغيرة. ارفعها على دفعات، وصغرها قبل الرفع.
إذا كانت صور منتجاتك تفشل عند الرفع أو تظهر بأحجام غريبة، راسلنا ونراجع إعدادات الصور في موقعك حتى يصبح الرفع سلساً.