كل المقالات التقنية

أخطاء حجم الرفع في ووردبريس: upload_max_filesize وpost_max_size وclient_max_body_size

اعثروا على حد الرفع الحقيقي عبر عدة طبقات: PHP وخادم الويب وأي وكيل واضبطوا القيم الصحيحة وميّزوا الخطأ 413 من رسالة ووردبريس.

أخطاء حجم الرفع في ووردبريس: upload_max_filesize وpost_max_size وclient_max_body_size

حين يقول ووردبريس إن الملف يتجاوز الحد الأقصى للرفع فليست المسألة رقماً واحداً. يأتي الحد من عدة طبقات ويفوز الرقم الأدنى. يبيّن هذا الدليل أين كل طبقة وكيف تغيّرونها بشكل صحيح.

١. اعرفوا الحد الحالي

wp eval 'echo size_format(wp_max_upload_size());'
php -i | grep -E 'upload_max_filesize|post_max_size|max_execution_time|memory_limit'

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

٢. قيمتان في PHP

upload_max_filesize = 64M
post_max_size = 72M
max_execution_time = 120
memory_limit = 256M

يجب أن تكون post_max_size أكبر من upload_max_filesize أو مساوية لها لأنها تشمل جسم الطلب كله. وهذه الأرقام نماذج ويجب أن توافق حاجتكم وذاكرة الخادم. والرفع الأكبر يحتاج وقت تنفيذ أطول أيضاً.

٣. أين تُضبط

بحسب الاستضافة يكون الضبط في php.ini أو ملف .user.ini أو محرر MultiPHP INI في cPanel أو ملف pool في PHP-FPM. وبعد التغيير أعيدوا تحميل PHP-FPM. وإن استخدم الـ pool الأمر php_admin_value فلا تتغلب عليه إعدادات .user.ini.

٤. طبقة خادم الويب

client_max_body_size 64m;

في Nginx القيمة الافتراضية لـ client_max_body_size هي ميغابايت واحد، وما فوقها يعطي الخطأ 413. ويحدث هذا قبل وصول الطلب إلى PHP فلا ترون رسالة ووردبريس. وإن كان Nginx خلف وكيل أو CDN فافحصوا حد تلك الطبقة أيضاً. ولبنية الإعداد راجعوا دليل try_files.

٥. بعد التغيير

اختبروا PHP-FPM وNginx وأعيدوا تحميلهما ثم اقرأوا الحد من جديد. وللقيم الخاصة بـ PHP افحصوا سجل أخطاء PHP وراجعوا حالة الـ pool في PHP-FPM status. ولا ترفعوا الرقم إلا بقدر الحاجة.

٦. مثال توضيحي وليس قياساً حقيقياً

لنفترض أن رفع فيديو بحجم 50 ميغابايت فشل وأن ووردبريس أظهر حداً قدره 2 ميغابايت. بعد رفع upload_max_filesize وpost_max_size في PHP وإعادة التحميل صار الرقم 64 ميغابايت. لكن Nginx ظل يعيد الخطأ 413 حتى صُحّح client_max_body_size أيضاً. هذا سيناريو مختلق للتوضيح وليس قياساً حقيقياً.

٧. أخطاء شائعة

  • تغيير upload_max_filesize فقط ونسيان post_max_size.
  • عدم إعادة التحميل بعد التغيير.
  • تجاهل client_max_body_size في Nginx.
  • رفع الذاكرة ووقت التنفيذ دون حساب.

٨. أسئلة شائعة

لماذا لم يؤثر تعديل php.ini؟ قد يقرأ PHP الويب ملفاً آخر أو لم تُعد التحميل.

من أين يأتي الخطأ 413؟ عادة من خادم الويب أو وكيل قبل PHP.

هل يمكن الضبط لموقع واحد فقط؟ نعم، بـ .user.ini أو pool منفصل.

٩. قائمة تحقق سريعة

  1. قُرئ الحد الحالي.
  2. post_max_size أكبر من قيمة الرفع.
  3. أُجري الضبط في الطبقة الصحيحة.
  4. فُحص client_max_body_size.
  5. أُعيد تحميل الخدمات.

إذا احتجتم إلى مساعدة في مراجعة الأداء أو صيانة الخادم، فراجعوا خدمات إدارة الخوادم.

تجدون المزيد من أدلة الخوادم وووردبريس في أرشيف المقالات.

المراجع الرسمية

PHP manual: upload_max_filesize · PHP manual: file upload pitfalls · Nginx: client_max_body_size