يعني خطأ 413 أن إحدى طبقات مسار الطلب رفضت Body بسبب الحجم. الحل الصحيح يوازن حدود Nginx وPHP وووردبريس وأي CDN أو Load Balancer بدلاً من رفع قيمة واحدة عشوائياً.
حدد الطبقة التي أعادت 413
افحص Headers والسجلات. إذا لم يصل الطلب إلى PHP فلن يفيد تغيير upload_max_filesize.
curl -I https://example.com/upload
sudo tail -f /var/log/nginx/error.log
sudo nginx -T | grep -n client_max_body_size
اضبط client_max_body_size في نطاق محدود
ضع القيمة في server أو location الذي يحتاج الرفع الكبير فقط، ولا توسع الحد لكل Endpoint عام.
location /wp-admin/async-upload.php {
client_max_body_size 64m;
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
وازن حدود PHP
يجب أن تكون post_max_size أكبر من upload_max_filesize. تحقق من php.ini الذي يستخدمه PHP-FPM ومن مساحة التخزين المؤقت.
php --ini
php -i | grep -E "upload_max_filesize|post_max_size|memory_limit"
upload_max_filesize = 64M
post_max_size = 72M
اختبر ثم أعد التحميل
نفذ فحص Syntax واختبر ملفاً أصغر وآخر أكبر من الحد للتأكد من النجاح والمنع.
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl reload php8.3-fpm
احمِ السعة والأمان
تحقق من MIME والامتداد والمساحة والوقت، واستخدم Object Storage أو Multipart Upload للملفات الكبيرة جداً.
قائمة فحص 413
- حدد مصدر 413.
- استخدم Limit محدود النطاق.
- وازن حدود PHP والتطبيق.
- افحص التخزين المؤقت.
- اختبر جانبي الحد.
أسئلة شائعة
لماذا لم يعمل تعديل php.ini؟
قد يرفض Nginx الطلب أولاً أو يستخدم PHP-FPM ملف إعداد مختلفاً.
هل أضع client_max_body_size على صفر؟
هذا يلغي الحد ولا يناسب غالباً المواقع العامة. قيمة محددة أكثر أماناً.
لماذا يظهر 504 بعد قبول الملف؟
قد يتجاوز التخزين أو المعالجة مهلة Upstream منفصلة.
أدلة مرتبطة
المصادر الرسمية
آخر مراجعة للمصادر: ۳۰ سپتامبر ۲۰۲۶
كيف نتأكد من حل 413؟
اختبر ملفاً أصغر بقليل من الحد وآخر أكبر منه. يجب أن ينجح الأول وأن يعيد الثاني 413 من الطبقة المتوقعة، مع بقاء استخدام الذاكرة والقرص المؤقت ضمن Baseline.
sudo nginx -t
curl -F "file=@small.bin" https://example.com/upload
curl -F "file=@large.bin" https://example.com/upload
المخاطر والتراجع
رفع الحد بلا قيود قد يزيد استهلاك الذاكرة والقرص أو يسمح بإساءة الاستخدام. احتفظ بنسخة من إعداد Nginx وPHP وتراجع إلى القيم السابقة ثم Reload.
سيناريو مجهول
نجح رفع الصور الصغيرة وفشلت ملفات النسخ الاحتياطي. أظهر Log أن Nginx يرفض الطلب قبل PHP؛ تم ضبط Location الخاص بالرفع فقط بدل رفع الحد لكل الموقع.
