همه مقالات تخصصی

خطای حجم آپلود در وردپرس: 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 را reload کنید. اگر 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 را تست و reload کنید و دوباره حداکثر را بخوانید. برای مقدارهای PHP، لاگ خطای PHP را بررسی کنید و صفحهٔ وضعیت pool را در PHP-FPM status ببینید. عدد را فقط تا حد نیاز بالا ببرید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید آپلود ویدیوی ۵۰ مگابایتی خطا می‌داد و سقف وردپرس ۲ مگابایت نشان داده می‌شد. با افزایش upload_max_filesize و post_max_size در PHP و reload، عدد به ۶۴ مگابایت رسید. اما در Nginx خطای 413 باقی ماند تا client_max_body_size هم اصلاح شد. این سناریو فقط برای توضیح است، نه اندازه‌گیری واقعی.

۷. اشتباه‌های رایج

  • تغییر فقط upload_max_filesize و فراموشی post_max_size.
  • نداشتن reload بعد از تغییر.
  • نادیده‌گرفتن client_max_body_size در Nginx.
  • بالا بردن بی‌حساب حافظه و زمان اجرا.

۸. پرسش‌های متداول

چرا بعد از تغییر php.ini اثری نداشت؟ شاید PHP وب فایل دیگری می‌خواند یا reload نشده است.

خطای 413 از کجاست؟ معمولاً از وب‌سرور یا پروکسی، پیش از PHP.

می‌شود برای یک سایت جدا تنظیم کرد؟ بله، با .user.ini یا pool جدا.

۹. چک‌لیست سریع

  1. حداکثر فعلی خوانده شد.
  2. post_max_size از upload بزرگ‌تر است.
  3. تنظیم در لایهٔ درست انجام شد.
  4. client_max_body_size بررسی شد.
  5. سرویس‌ها reload شدند.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

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