تنظیم پیش‌فرض حجم آپلود PHP در CloudLinux Selector

مقدمه

در بسیاری از سرورهای میزبانی وب، مقدار پیش‌فرض upload_max_filesize و post_max_size بسیار پایین است و ممکن است برای کاربران محدودکننده باشد، به‌خصوص وقتی بخواهند فایل‌های بزرگ‌تر را آپلود کنند. در محیط CloudLinux با PHP Selector، مدیر سرور می‌تواند این تنظیمات را برای همه نسخه‌های PHP (Alt‑PHP) به‌صورت پیش‌فرض تغییر دهد. این کار باعث می‌شود کاربران هنگام انتخاب نسخه PHP، به‌صورت پیش‌فرض مقادیر مناسب حجم آپلود داشته باشند و نیاز به تنظیم دستی برای هر کاربر به حداقل برسد.

دلیل انجام تنظیم پیش‌فرض

• کاهش نیاز به پیکربندی دستی برای هر کاربر
• جلوگیری از خطاهای آپلود (مثل «فایل بزرگ‌تر از حد مجاز»)
• تجربه کاربری بهتر برای وب‌سایت‌هایی که فایل بزرگ آپلود می‌کنند
• مدیریت آسان‌تر منابع سرور

مراحل تنظیم (upload_max_filesize) و (post_max_size) به (64M) پیش‌فرض

۱. شناسایی نسخه‌های Alt‑PHP نصب‌شده
ابتدا باید بفهمید کدام نسخه‌های Alt-PHP روی سرور شما نصب شده‌اند (مثلاً alt-php74, alt-php80 و غیره). مسیر فایل php.ini برای هر نسخه معمولاً چیزی شبیه /opt/alt/phpXX/etc/php.ini است، که در آن XX شماره نسخه را نشان می‌دهد. این را CloudLinux در مستندات خودش توضیح داده است. docs.cloudlinux.com+2cloudlinux.zendesk.com+2

2. ویرایش فایل php.ini برای هر نسخه Alt‑PHP
   برای هر نسخه PHP که روی سرورتان دارید، فایل php.ini مربوطه را باز کنید، مثلاً:

/opt/alt/php74/etc/php.ini
/opt/alt/php80/etc/php.ini

سپس مقادیر زیر را پیدا کرده و تغییر دهید:

upload_max_filesize = 64M  
post_max_size = 64M

این روش مطابق با راهنمای CloudLinux است که پیشنهاد می‌کند تنظیمات مورد نظر را مستقیماً در php.ini‌ نسخه‌های Alt‑PHP اعمال کنید. cloudlinux.zendesk.com

3.استفاده از فایل global برای تنظیمات PHP مشترک
اگر می‌خواهید تنظیم مشابهی را برای تمام نسخه‌های Alt‑PHP داشته باشید (یعنی یک مقدار پیش‌فرض واحد) می‌توانید از فایل /etc/cl.selector/global_php.ini استفاده کنید. در مستندات CloudLinux آمده است که این فایل وجود دارد و می‌تواند مقادیر عمومی PHP را برای تمام Alt‑PHPها تنظیم کند. cloudlinux.zendesk.com+1

در این فایل باید خط‌هایی شبیه به زیر اضافه یا تغییر دهید:

upload_max_filesize = 64M  
post_max_size = 64M

در صورت نیاز، تعریف گزینه‌های مجاز در تنظیمات Selector
اگر گزینه‌های upload_max_filesize و post_max_size در رابط کاربری PHP Selector (برای کاربران) ظاهر نمی‌شوند یا قابل ویرایش نیستند، ممکن است لازم باشد آن‌ها را در فایل پیکربندی /etc/cl.selector/php.conf اضافه یا مجاز کنید. در مستندات، CloudLinux اشاره می‌کند که برخی تنظیمات PHP باید در این فایل whitelisted شوند تا از طریق Selector قابل تنظیم باشند. app.readthedocs.org+1

مثال:

Directive = upload_max_filesize  
Type = value  
Default = 64M  
Remark = …  

Directive = post_max_size  
Type = value  
Default = 64M  
Remark = …  

2. اعمال تغییرات و ری‌استارت سرویس‌ها
   • بعد از ویرایش فایل‌ّهای php.ini یا global_php.ini، باید سرویس وب‌سرور (Apache، Nginx، یا هر چیز دیگر که استفاده می‌کنید) را ری‌استارت کنید تا تنظیمات جدید بارگذاری شوند.
   • همچنین اگر از PHP-FPM استفاده می‌کنید، باید سرویس FPM مرتبط با نسخه PHP را ری‌استارت کنید.
3. تأیید تنظیمات
   برای بررسی این که تنظیمات جدید اعمال شده‌اند، می‌توانید:
   • یک فایل PHP ساده (مثلاً phpinfo.php) بسازید که تابع phpinfo() را فراخوانی کند و در مرورگر بررسی کنید که upload_max_filesize و post_max_size مقدار ۶۴M را نشان می‌دهند.
   • از دستور CLI php -i (با مسیر به باینری Alt‑PHP مناسب) استفاده کنید تا مقادیر php.ini فعلی را ببینید.

نکات مهم و هشدارها

• مقدار post_max_size باید همیشه برابر یا بیشتر از upload_max_filesize باشد، چون داده‌های POST ممکن است شامل داده‌های فرم (مثل متن) به جز فایل آپلودی باشند.
• تغییرات زیادی در این تنظیمات ممکن است بر مصرف منابع سرور تأثیر بگذارد (به خصوص حافظه، زمان اجرایی و پهنای باند). بنابراین، افزایش زیاد این مقادیر باید با احتیاط انجام شود.
• اگر فقط تعدادی از کاربران نیاز دارند حجم آپلود بزرگ‌تر، ممکن است منطقی‌تر باشد که برای آن کاربران خاص با Selector یا دستورات CLI گزینه‌های سفارشی تنظیم کنید، به جای تغییر پیش‌فرض برای همه.
• پس از اعمال تنظیمات، باید نظارت (مانیتورینگ) انجام دهید تا مطمئن شوید که سرور بار زیادی نمی‌گیرد یا از منابع بیش از حد استفاده نمی‌شود.

جمع‌بندی

• CloudLinux اجازه می‌دهد که مقادیر upload_max_filesize و post_max_size را برای نسخه‌های Alt‑PHP به‌صورت پیش‌فرض تنظیم کنید. cloudlinux.zendesk.com+1
• این کار با ویرایش فایل‌های php.ini در مسیر /opt/alt/phpXX/etc/ یا با استفاده از فایل /etc/cl.selector/global_php.ini امکان‌پذیر است.
• پس از اعمال تغییرات باید سرویس‌های وب و PHP را ری‌استارت کنید و تنظیم جدید را با phpinfo یا ابزار CLI بررسی نمایید.
• چنین تنظیماتی باعث می‌شود کاربران بتوانند فایل‌های بزرگ‌تر را آپلود کنند بدون این که هر بار به صورت دستی مقادیر PHP را تغییر دهند، اما افزایش بیش از حد باید با دقت و نظارت انجام شود.