Optimización PHP-FPM  (Modo Avanzado) en Servidores WHM/cPanel

PHP-FPM (FastCGI Process Manager) es esencial para el rendimiento de sitios PHP en servidores modernos, y los entornos WHM/cPanel ofrecen herramientas para gestionarlo. Esta guía se enfoca en cómo optimizar PHP-FPM específicamente dentro de un servidor WHM, proporcionando configuraciones recomendadas y explicando cómo acceder y modificar estos ajustes para un rendimiento superior.

PHP-FPM en el Ecosistema WHM/cPanel

WHM (Web Host Manager) permite a los administradores de servidores gestionar múltiples cuentas de cPanel. PHP-FPM se integra en este ecosistema, usualmente creando un «pool» de procesos PHP-FPM separado para cada cuenta de cPanel o incluso para cada dominio que lo tenga habilitado. Esto mejora el aislamiento y la seguridad entre diferentes sitios en un servidor compartido.

La gestión de PHP-FPM en WHM se realiza principalmente a través de la interfaz MultiPHP Manager. Desde aquí, puedes habilitar o deshabilitar PHP-FPM para dominios específicos, seleccionar la versión de PHP y, crucialmente, ajustar la configuración del pool de PHP-FPM para cada dominio o para los valores predeterminados del sistema.

Accediendo a la Configuración de PHP-FPM en WHM

1. Inicia sesión en WHM como usuario root.
2. Navega a Software » MultiPHP Manager.
3. En la pestaña User Domain Settings, encontrarás una lista de dominios. Para los dominios con PHP-FPM habilitado, verás una opción para editar la configuración del pool (a menudo etiquetada como «PHP-FPM Settings», «Pool Options» o un botón «Edit PHP-FPM»).
4. También existe una pestaña de System PHP-FPM Configuration (o similar) donde puedes ajustar los valores por defecto que se aplicarán a los nuevos pools o a aquellos que no tengan configuraciones personalizadas.

WHM generalmente permite modificar las siguientes directivas clave directamente desde su interfaz para cada pool:

• Max Children (pm.max_children)
• Process Idle Timeout (pm.process_idle_timeout)
• Max Requests (pm.max_requests)

Además, puedes definir el Process Manager (pm) como dynamic, static, u ondemand, aunque esta opción podría estar en una sección más avanzada o requerir edición manual de archivos de configuración en algunos casos.

Directivas Clave para la Optimización (Contexto WHM)

Los principios de optimización de PHP-FPM son universales, pero su aplicación en WHM tiene matices específicos.

1. Gestión de Procesos (pm)

En WHM, al configurar un pool para un dominio específico o los valores del sistema:

• dynamic: Sigue siendo la opción más versátil y recomendada para la mayoría de las cuentas en un entorno de hosting compartido. Permite que los recursos se asignen según la demanda de cada cuenta.
• ondemand: Puede ser muy útil en servidores WHM con muchas cuentas de bajo tráfico. Ayuda a conservar memoria al crear procesos solo cuando son necesarios. Es una buena opción por defecto si la mayoría de tus sitios tienen tráfico esporádico.
• static: Generalmente menos recomendado para pools individuales en un servidor compartido a menos que una cuenta específica tenga un tráfico muy alto y predecible, y tengas suficientes recursos en el servidor para dedicarle procesos fijos sin afectar a otras cuentas. Podría ser más aplicable si el servidor aloja un único sitio de alto rendimiento.

La elección del modo pm puede estar disponible directamente en la UI de WHM para los pools, o podrías necesitar editar los archivos YAML de configuración del pool si deseas más control (ver sección de «Configuración Avanzada Manual»).

2. Número Máximo de Procesos Hijos (pm.max_children) en WHM

Esta es la configuración más crítica por cuenta. Un valor demasiado alto para una cuenta puede consumir una porción desproporcionada de la RAM del servidor, afectando a otras cuentas. Un valor demasiado bajo limitará el rendimiento de ese sitio específico.

Cálculo en un Entorno Compartido (WHM):

1. Estima la RAM total disponible en el servidor para PHP-FPM: (RAM total del servidor) – (RAM para OS, WHM/cPanel, MySQL, Apache/Litespeed, correo, etc.).
2. Estima el consumo promedio de memoria por proceso PHP: Esto puede variar mucho (20MB – 200MB+). Monitorea tus sitios más pesados.
3. Decide un `pm.max_children` base por cuenta: Para un entorno compartido, no puedes simplemente dividir la RAM total entre el consumo de un proceso. Debes asignar un límite razonable por cuenta, considerando el número total de cuentas y el tipo de planes que ofreces.
   • Sitios de bajo tráfico: Podrían empezar con pm.max_children = 5-10.
   • Sitios de tráfico medio: pm.max_children = 10-25.
   • Sitios de alto tráfico (en VPS o dedicados gestionados con WHM): Podrías permitir valores más altos (25-50+), siempre monitoreando el uso total de RAM del servidor.

3. Número Máximo de Peticiones por Proceso (pm.max_requests)

WHM permite configurar esto por pool. Valores entre 200 y 1000 son comunes. Un valor más bajo (ej. 200-500) puede ayudar a mitigar fugas de memoria más rápidamente en un entorno compartido, a costa de una ligera sobrecarga por el reinicio de procesos.

4. Timeout de Procesos Inactivos (pm.process_idle_timeout)

Especialmente relevante si usas pm = ondemand. Un valor de 10s a 30s es un buen punto de partida. WHM permite ajustar este valor en la configuración del pool.

5. Timeout de Ejecución de Peticiones

• request_terminate_timeout: Configurable en el pool de PHP-FPM. En WHM, puedes encontrar esta opción en la configuración avanzada del pool o podría necesitar edición manual del archivo YAML. Es crucial para detener scripts descontrolados.
• max_execution_time (en php.ini): Puede ser ajustado a través del MultiPHP INI Editor en WHM. Recuerda que request_terminate_timeout de FPM tiene precedencia si es más corto.

6. Logs de Procesos Lentos (slowlog y request_slowlog_timeout)

WHM/cPanel configura automáticamente los logs de errores de PHP, pero el slowlog de FPM específico (que muestra backtraces) puede requerir configuración manual en los archivos YAML del pool si no está expuesto en la UI.

Ejemplo de directivas para el archivo YAML del pool (/var/cpanel/userdata/[user]/[domain].php_fpm.yaml):

---
_is_present: 1
# ... otras directivas pm ...
php_admin_value_request_slowlog_timeout: 10s # Log si tarda más de 10 segundos
php_admin_value_slowlog: /home/[user]/logs/[domain].php.slow.log # Asegúrate que la ruta sea escribible por el usuario
        

Luego, reconstruye la configuración con /scripts/php_fpm_config --rebuild.

Configuración Recomendada para WHM/cPanel

---
pm: dynamic
pm_max_children: 10
pm_max_requests: 300
pm_min_spare_servers: 1
pm_max_spare_servers: 3
pm_process_idle_timeout: 15s
php_admin_value_request_terminate_timeout: 90s
# También puedes añadir otros php_admin_value o php_flag aquí
# Ejemplo: php_admin_value_memory_limit: 128M
            

Monitoreo en Entornos WHM

El monitoreo es aún más crítico en un servidor WHM debido a la naturaleza compartida de los recursos.

• Utiliza las herramientas de monitoreo de WHM (ej. Server Status » Service Status, Process Manager).
• Observa el uso general de CPU y RAM del servidor. Herramientas como top, htop vía SSH son indispensables.
• Revisa los logs de Apache/Nginx y los logs de error de PHP-FPM para cada cuenta (generalmente en /home/username/logs/ o /var/log/php-fpm/, y los logs de error de cada versión de PHP en /opt/cpanel/ea-phpXX/root/var/log/php-fpm/error.log).
• Presta atención a los warnings de «server reached max_children setting» en los logs de FPM; esto indica que necesitas aumentar pm.max_children para ese pool específico o que el servidor está sobrecargado.

Configuración Avanzada Manual (Archivos YAML)

Si la interfaz de WHM es limitada o necesitas directivas no expuestas, puedes editar los archivos de configuración YAML de PHP-FPM directamente:

• Defaults del Sistema: /var/cpanel/ApachePHPFPM/system_pool_defaults.yaml
• Pool Específico de Dominio: /var/cpanel/userdata/[nombre_usuario_cpanel]/[nombre_dominio].php_fpm.yaml

Después de cualquier cambio manual en estos archivos, siempre ejecuta:

sudo /scripts/php_fpm_config --rebuild
sudo /scripts/restartsrv_apache_php_fpm # O el comando específico para tu servidor web y PHP-FPM
        

Consideraciones Adicionales en WHM

• OPcache: Asegúrate de que OPcache esté habilitado para todas las versiones de PHP en uso. Puedes configurar OPcache a través del MultiPHP INI Editor. Una configuración generosa de opcache.memory_consumption (ej. 128MB-512MB globalmente, dependiendo del número de scripts) y opcache.interned_strings_buffer (ej. 16MB-64MB) es vital.
• Versiones de PHP: Anima a los usuarios a utilizar versiones de PHP recientes y soportadas. Configúralas a través de MultiPHP Manager.
• Límites de php.ini: Ajusta directivas como memory_limit, upload_max_filesize, post_max_size a través del MultiPHP INI Editor según sea necesario para cada versión de PHP o incluso por dominio si usas configuraciones personalizadas.