Personalización de los parámetros PHP
En la interfaz de Plesk, usted y sus clientes pueden modificar la configuración de PHP para determinados planes de servicio, planes complementarios, suscripciones, sitios web y subdominios. Pueden modificarse los valores de algunos de los parámetros de PHP usados con mayor frecuencia seleccionando el valor deseado en la lista o bien indicando otro valor. Mediante la edición del archivo panel.ini puede efectuar los siguientes cambios en este escenario:
- Determinar los valores predefinidos que puede adoptar un parámetro de PHP.
- Modificar el valor predeterminado de un parámetro de PHP.
- Prohibir la especificación de valores personalizados para parámetros de PHP.
Determinación de los valores predefinidos que puede adoptar un parámetro de PHP
En la mayoría de los parámetros de PHP, puede seleccionarse un único valor de la lista de valores predefinidos. Puede crear una lista personalizada de valores predefinidos que puede adoptar un parámetro de PHP añadiendo una o más líneas siguiendo el patrón que puede ver a continuación al archivo panel.ini:
[php]
settings.<parameter_group>.<parameter_name>.values[]=<value>
Aquí:
-
<parameter_group>
es el grupo de al que pertenece el parámetro de PHP escogido. Si desea más información acerca de los grupos de parámetros de PHP, consulte “Parámetros y grupos de parámetros de PHP” a continuación. -
<parameter_name>
es el nombre del parámetro de PHP escogido. Use la misma sintaxis que en php.ini. -
<value>
es el valor predefinido del parámetro que desea añadir a la lista. Use la misma sintaxis que en php.ini.
Añada una línea para cada uno de los valores predefinidos que desea que se muestren en la lista.
Por ejemplo, por defecto, el parámetro memory_limit
puede adoptar uno de los siguientes valores: 8M
, 16M
, 32M
, 64M
y 128M
. Si desea que sólo pueda escogerse 64M
y 128M
, añada las siguientes líneas al archivo panel.ini
:
[php]
settings.performance.memory_limit.values[]="64M"
settings.performance.memory_limit.values[]="128M"
Modificación del valor predeterminado de un parámetro de PHP
En la mayoría de los parámetros de PHP, se marca como predeterminado un único valor de la lista de valores predefinidos. A menos que el usuario indique otro valor de forma manual, se aplica el valor predeterminado. Puede cambiar el valor predeterminado para un parámetro de PHP añadiendo una línea siguiendo el patrón detallado a continuación al archivo panel.ini:
[php]
settings.<parameter_group>.<parameter_name>.default=<value>
Aquí:
-
<parameter_group>
es el grupo de al que pertenece el parámetro de PHP escogido. Si desea más información acerca de los grupos de parámetros de PHP, consulte “Parámetros y grupos de parámetros de PHP” a continuación. -
<parameter_name>
es el nombre del parámetro de PHP escogido. Use la misma sintaxis que en php.ini. -
<value>
es el valor predeterminado deseado para el parámetro escogido. Use la misma sintaxis que en php.ini.
Por ejemplo, el valor predeterminado del parámetro open_basedir
es {WEBSPACEROOT}{/}{:}{TMP}{/}
. Si desea cambiarlo a none
, añada la siguiente línea al archivo panel.ini
:
[php]
settings.general.open_basedir.default="none"
En este ejemplo, none
está incluido en la lista de valores predefinidos para open_basedir
de forma predeterminada. Es posible que el valor predeterminado deseado para un parámetro de PHP no esté incluido en la lista predeterminada de valores predefinidos. En este caso, en primer lugar deberá crear una lista de valores predefinidos.
Por ejemplo, para cambiar el valor predeterminado del parámetro execution_time
a 180
, añada las siguientes líneas a panel.ini
:
[php]
settings.performance.max_execution_time[]=30
settings.performance.max_execution_time[]=60
settings.performance.max_execution_time[]=90
settings.performance.max_execution_time[]=120
settings.performance.max_execution_time[]=180 ; adds 180 to the list of predefined values
settings.performance.max_execution_time.default=180
Prohibición de la especificación de valores personalizados para un parámetro de PHP
En el caso de algunos parámetros de PHP, un usuario puede especificar un valor personalizado en vez de seleccionar un valor de la lista de valores predefinidos. Puede prohibir la especificación de valores predeterminados para un parámetro de PHP añadiendo una línea siguiendo el patrón detallado a continuación al archivo panel.ini:
[php]
settings.<parameter_group>.<parameter_name>.custom=false
Aquí:
-
<parameter_group>
es el grupo de al que pertenece el parámetro de PHP escogido. Si desea más información acerca de los grupos de parámetros de PHP, consulte “Parámetros y grupos de parámetros de PHP” a continuación. -
<parameter_name>
es el nombre del parámetro de PHP escogido. Use la misma sintaxis que en php.ini.
Como ha prohibido la especificación de un valor personalizado para un parámetro de PHP, el usuario sólo podrá seleccionar valores presentes en la lista de valores predefinidos.
Por ejemplo, para prohibir la especificación de un valor personalizado para el parámetro error_reporting
, añada la siguiente línea al archivo panel.ini
:
[php]
settings.general.error_reporting.custom=false
Personalización de los parámetros PHP-FPM
Si desea personalizar los parámetros PHP que pertenecen al grupo fpm, añada las siguientes líneas al archivo panel.ini:
[php]
settings.fpm.pm.start_servers.custom=true
settings.fpm.pm.min_spare_servers.custom=true
settings.fpm.pm.max_spare_servers.custom=true
Esto es válido para cualquier personalización de los parámetros PHP-FPM: determinación de los valores predefinidos que puede obtener un parámetro PHP-FPM, cambio del valor predeterminado o prohibición de especificación de valores predeterminados¡. En el grupo de parámetros «fpm (sólo Linux)» de la tabla que aparece a continuación puede ver la lista completa de parámetros PHP-FPM.
Por ejemplo, para cambiar el valor predeterminado del parámetro pm.max_children
a 20
, añada las siguientes líneas a panel.ini
:
[php]
settings.fpm.pm.start_servers.custom=true
settings.fpm.pm.min_spare_servers.custom=true
settings.fpm.pm.max_spare_servers.custom=true
settings.fpm.pm.max_children[]=20
settings.fpm.pm.max_children.default=20
Parámetros y grupos de parámetros de PHP
A continuación puede ver una lista de grupos de parámetros de PHP y sus parámetros correspondientes.
Grupo de parámetros de PHP | Nombre del parámetro de PHP |
---|---|
performance | memory_limit |
max_execution_time | |
max_input_time | |
post_max_size | |
upload_max_filesize | |
opcache.enable | |
wincache.ocenabled | |
apc.enabled | |
xcache.cacher | |
disable_functions | |
general | safe_mode |
safe_mode_include_dir | |
safe_mode_exec_dir | |
include_path | |
session.save_path | |
mail.force_extra_parameters | |
register_globals | |
open_basedir | |
error_reporting | |
display_errors | |
log_errors | |
allow_url_fopen | |
file_uploads | |
short_open_tag | |
magic_quotes_gpc | |
fpm (sólo Linux) | pm.max_children |
pm.max_requests | |
pm | |
pm.start_servers | |
pm.min_spare_servers | |
pm.max_spare_servers | |
fastCgi (sólo Windows) | maxInstances |
activityTimeout | |
requestTimeout | |
instanceMaxRequests | |
queueLength | |
rapidFailsPerMinute |