آموزش رفع خطای upload_max_filesize در وردپرس

خیلی وقت‌ها وقتی میخوای تو وردپرس یک فایل بزرگ، مثل قالب یا ویدئو یا عکس‌ با کیفیت بالا آپلود کنی، ناگهان با پیغام خطای upload_max_filesize روبه‌رو می‌شی و نمی‌دونی چرا درست کار نمی‌کنه. نگران نباش! در این مقاله از سایت رامون طالع ، قدم‌به‌قدم با هم بررسی می‌کنیم که این خطا چیه، چرا رخ میده و چه راه‌های ساده‌ای برای رفعش وجود داره.

چرا اصلاً این اتفاق می‌افتد؟

در وردپرس و اساساً PHP، یه سری محدودیت تعریف شده تا سرور خسته نشه و امنیت بالا بمونه. یکی از این محدودیت‌ها، حداکثر حجمی هست که می‌تونی آپلود کنی همون upload_max_filesize. وقتی فایلت از این عدد بزرگ‌تر باشه، PHP اجازه ادامه نمی‌ده و به‌جاش پیغام خطا می‌ده:

The uploaded file exceeds the upload_max_filesize directive in php.ini

در نتیجه، وردپرس نمی‌تونه فایل رو دریافت کنه و شما خطای upload_max_filesize رو می‌بینی.

راه‌های درست شدن خطای upload_max_filesize

برای رفع خطای upload_max_filesize چهار روش اصلی وجود داره که در ادامه به توضیح هر کدوم می‌پردازیم:

توضیح کوتاه:
این روش‌ها بسته به نوع دسترسی شما به هاست یا سرور متفاوت عمل می‌کنن. اول ببین چه دسترسی‌هایی داری، بعد مناسب‌ترین روش رو انتخاب کن.

ویرایش فایل .htaccess

وقتی‌هاست شما از وب‌سرور آپاچی (Apache) استفاده می‌کند، امکان این وجود دارد که با ویرایش فایل .htaccess در پوشه اصلی وردپرس، محدودیت‌های PHP را برای آپلود تنظیم کنید. برای این کار ابتدا با FTP یا از طریق کنترل پنل هاست وارد فولدر ریشه سایت شوید، جایی که فایل‌های wp-config.php و index.php قرار دارند. فایل .htaccess را با ویرایشگر متن باز کرده و در انتهای آن خطوط زیر را اضافه کنید:

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300
php_value max_input_time 300

با این تنظیمات، شما مقدار مجاز برای آپلود فایل را به ۶۴ مگابایت افزایش می‌دهید و به PHP می‌گویید که برای پردازش درخواست‌های پست و اجرای اسکریپت‌ها زمان بیشتری اختصاص دهد. سپس فایل را ذخیره کرده و صفحه مدیریت وردپرس را رفرش کنید. اگر پس از این کار با خطای Internal Server Error (۵۰۰) مواجه شدید، سریعاً این کدها را پاک کنید؛ زیرا برخی سرویس‌دهنده‌ها اجازه دستورهای php_value در .htaccess را نمی‌دهند. اما در صورت موفقیت، دیگر با خطای upload_max_filesize مواجه نمی‌شوید و می‌توانید بدون مشکل فایل‌های بزرگ را آپلود کنید.

ویرایش فایل wp-config.php

اگر به هر دلیلی دسترسی یا مجوز ویرایش .htaccess را ندارید، ساده‌ترین راه بعدی تغییر مستقیم تنظیمات PHP با تابع ini_set در فایل پیکربندی وردپرس است. برای این کار وارد پنل FTP یا فایل منیجر هاست شوید و فایل wp-config.php را باز کنید. درست بالای خطی که نوشته شده:

/* That's all, stop editing! Happy blogging. */

کد زیر را اضافه کنید:

@ini_set( 'upload_max_filesize' , '64M' );
@ini_set( 'post_max_size', '64M' );
@ini_set( 'max_execution_time', '300' );
@ini_set( 'max_input_time', '300' );

با این تغییر، به PHP می‌گویید که حین اجرای وردپرس، این پارامترها را تنظیم کند. در بیشتر موارد نیازی به ری‌استارت سرور یا پاک‌سازی کش نیست و تغییرات بلافاصله اعمال می‌شوند. اگرچه برخی سرویس‌ها این تابع را غیرفعال می‌کنند، اما معمولاً در هاست‌های اشتراکی و مدیریت‌شده وردپرس، این روش بدون مشکل کار می‌کند و به سرعت خطای upload_max_filesize را از بین می‌برد.

استفاده از افزونه افزایش حجم آپلود

برای کاربرانی که با ویرایش فایل راحت نیستند یا دسترسی فنی محدودی دارند، افزونه‌ها جایگزین بسیار خوبی‌اند. چندین افزونه در مخزن وردپرس وجود دارد که می‌توانند حجم آپلود فایل را بدون یک خط کد افزایش دهند. یکی از محبوب‌ترین آن‌ها Increase Maximum Upload File Size است. پس از نصب و فعال‌سازی افزونه، به صفحه تنظیمات آن بروید. معمولاً یک اسلایدر یا فیلد عددی خواهید دید که می‌توانید مقدار مورد نظر (مثلاً ۶۴M، ۱۲۸M یا بیشتر) را وارد کنید.

سپس تغییرات را ذخیره کنید. افزونه با اجرای همان دستورات ini_set یا تغییر موقت php.ini در سطح وردپرس، محدودیت مجاز آپلود را افزایش می‌دهد. مزیت این روش این است که بدون دخالت مستقیم در فایل‌های سرور انجام می‌شود و ریسک کاهش سرعت یا بروز خطاهای سروری به حداقل می‌رسد. تنها نقطه ضعف احتمالی، نصب یک افزونه اضافی است که بار کمی بر سایت تحمیل می‌کند، اما عملاً تأثیر قابل‌توجهی روی عملکرد ندارد.

ویرایش مستقیم php.ini یا تماس با پشتیبانی هاست

در مواقعی که به کنترل کامل سرور دسترسی دارید (مثلاً در VPS یا سرور اختصاصی) یا از طریق پنل مدیریتی هاست (مانند cPanel، Plesk یا DirectAdmin)، می‌توانید فایل php.ini را مستقیماً ویرایش کنید. در این فایل خطوط زیر را پیدا کرده یا در صورت نبود، اضافه نمایید:

upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_time = 300

پس از ذخیره تغییرات، معمولاً نیاز است سرویس PHP یا وب‌سرور را ری‌استارت کنید تا تنظیمات جدید بارگذاری گردد. اگر در هاست اشتراکی هستید و به php.ini دسترسی ندارید، کافی است یک تیکت کوتاه به تیم پشتیبانی ارسال کنید و این مقادیر را درخواست کنید. معمولاً کافی است بنویسید:

«لطفاً upload_max_filesize را به ۶۴M افزایش دهید.»

تیم پشتیبانی در کمتر از چند دقیقه این تغییر را اعمال می‌کند. مزیت این روش پایدار بودن آن تا سطح کل سرور است؛ اما ممکن است در محیط‌های اشتراکی نیاز به هماهنگی با پشتیبانی داشته باشید.

اگر هیچ‌کدام از روش‌ها جواب نداد چه کنیم؟

گاهی اوقات ممکن است با وجود انجام همه مراحل بالا، باز هم خطای upload_max_filesize برطرف نشود. در این حالت بهترین کار این است که با پشتیبانی هاست تماس بگیرید و از آن‌ها بخواهید مقدار upload_max_filesize را افزایش دهند.

🎯 کافیست به پشتیبانی بگویید:

“لطفاً مقدار upload_max_filesize را به 64M (یا هر مقدار که میخواهید) افزایش دهید تا بتوانم فایل‌های بزرگ را آپلود کنم.”

پشتیبانی‌ها معمولاً در چند دقیقه این کار را برای شما انجام می‌دهند.

نتیجه‌گیری

خب، حالا دیگه می‌دونی خطای upload_max_filesize چیه و چطور می‌تونی با چهار روش ساده ویرایش .htaccess، wp-config.php، استفاده از افزونه یا تغییر در php.ini اون رو رفع کنی. کافیه مناسب‌ترین روش رو برای دسترسی‌هات انتخاب کنی و بدون دردسر فایل‌های حجیم رو آپلود کنی.

سوالات متداول