آموزش مدیریت دستورهای php.ini با PHP‑FPM و تنظیم نسخه‌های پیشنهادی PHP

این مقاله نحوه مدیریت دستورهای php.ini هنگام فعال بودن PHP‑FPM و همچنین نحوه تنظیم نسخه‌های پیشنهادی PHP در MultiPHP Manager را توضیح می‌دهد. شامل بررسی فعال بودن PHP‑FPM، ساخت phpinfo، مشاهده و ویرایش دستورها در سطح سیستم و دامنه، و تنظیم فایل JSON برای نسخه‌های پیشنهادی است.

PHP-FPM configurationphp.ini directivesPHP version recommendations

~3 min read • Updated Feb 21, 2026

1. مقدمه


این آموزش نحوه مدیریت دستورهای php.ini را هنگام فعال بودن PHP‑FPM توضیح می‌دهد. PHP‑FPM به‌صورت پیش‌فرض در cPanel & WHM فعال است.


نکته: می‌توانید دستورهای php.ini را در سطح دامنه و سیستم از طریق MultiPHP Manager ویرایش کنید.


2. مدیریت دستورهای php.ini


2.1 بررسی فعال بودن PHP‑FPM


  1. ورود به WHM به‌عنوان root.
  2. رفتن به مسیر:
    WHM » Home » Software » MultiPHP Manager
  3. در جدول دامنه‌ها، بررسی کنید که PHP‑FPM برای دامنه روشن باشد.

PHP‑FPM به‌صورت پیش‌فرض فعال است.


2.2 ساخت فایل phpinfo


برای مشاهده تنظیمات فعلی PHP دامنه:


  1. ورود به SSH به‌عنوان root.
  2. رفتن به Document Root دامنه.
  3. ساخت فایل phpinfo.php با محتوای زیر:



تنظیم دسترسی‌ها:


chmod 0644 /home/username/public_html/phpinfo.php
chown username.username /home/username/public_html/phpinfo.php

باز کردن آدرس:
https://example.com/phpinfo.php
اگر PHP‑FPM فعال باشد، مقدار ServerAPI برابر FPM/FastCGI خواهد بود.


2.3 مشاهده دستورهای php.ini


می‌توانید دستورها را در این مسیرها مشاهده کنید:

  • MultiPHP INI Editor در cPanel (سطح دامنه)
  • MultiPHP INI Editor در WHM (سطح سیستم)

دستورهای پیش‌فرض PHP‑FPM:

php_admin_flag[allow_url_fopen] = on
php_admin_flag[log_errors] = on
php_admin_value[disable_functions] = exec,passthru,shell_exec,system
php_admin_value[doc_root] = "/home/username/public_html"
php_admin_value[error_log] = /home/username/logs/domain_com.php.error.log
php_admin_value[short_open_tag] = on
php_value[error_reporting] = E_ALL & ~E_NOTICE

3. ویرایش دستورهای php.ini


3.1 ویرایش در سطح سیستم


برای ویرایش دستورهای php.ini در سطح سیستم، از MultiPHP INI Editor در WHM استفاده کنید.


برای ویرایش تنظیمات PHP‑FPM:

  1. ورود به SSH.
  2. ساخت مسیر:
    /var/cpanel/ApachePHPFPM
  3. ساخت فایل:
    /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml
  4. افزودن دستورها، مانند:

---
php_admin_value_memory_limit: { name: 'php_admin_value[memory_limit]', value: 120M }

بازسازی تنظیمات PHP‑FPM:


/usr/local/cpanel/scripts/php_fpm_config --rebuild

ری‌استارت سرویس‌ها:


/usr/local/cpanel/scripts/restartsrv_apache_php_fpm
/usr/local/cpanel/scripts/restartsrv_httpd

3.2 ویرایش برای یک دامنه خاص


  1. ورود به SSH.
  2. ساخت فایل:
    /var/cpanel/userdata/username/domain.com.php-fpm.yaml
  3. افزودن دستورهای موردنظر:

غیرفعال کردن passthru و system:

---
_is_present: 1
php_admin_value_disable_functions: { name: 'php_admin_value[disable_functions]', value: passthru,system }

فعال کردن همه توابع:

---
_is_present: 1
php_admin_value_disable_functions: { name: 'php_admin_value[disable_functions]', value: none }

بازسازی تنظیمات PHP‑FPM:


/usr/local/cpanel/scripts/php_fpm_config --rebuild

ری‌استارت سرویس‌ها:


/usr/local/cpanel/scripts/restartsrv_apache_php_fpm
/usr/local/cpanel/scripts/restartsrv_httpd



4. تنظیم نسخه‌های پیشنهادی PHP


نسخه‌های پیشنهادی PHP در MultiPHP Manager نمایش داده می‌شوند و از طریق یک فایل JSON مدیریت می‌شوند.


4.1 مسیر فایل تنظیمات


فایل زیر نسخه‌های پیشنهادی را ذخیره می‌کند:


/etc/cpanel/ea4/recommendations/custom_php_recommendation.json


نمونه محتوا:


{"versions":[ "php54", "php72", "php74" ]}

کلید versions شامل آرایه‌ای از نسخه‌های پیشنهادی PHP است.




نتیجه‌گیری


این مقاله نحوه مدیریت کامل دستورهای php.ini با PHP‑FPM و همچنین تنظیم نسخه‌های پیشنهادی PHP را توضیح داد. با استفاده از این روش‌ها می‌توانید کنترل دقیق‌تری بر عملکرد، امنیت و نسخه‌های PHP در سرور خود داشته باشید.


Written & researched by Dr. Shahin Siami