Personnaliser les paramètres PHP
In the Plesk interface, you and your customers can fine-tune the PHP settings for individual service plans, add-on plans, subscriptions, websites, and subdomains. One can change the values of some of the most frequently used PHP parameters by selecting the desired value from a list or specifying a custom value. In Plesk Onyx 17.5 and later, you can make the following changes to this scenario by editing the panel.ini file:
- Déterminer les valeurs prédéfinies utilisables par un paramètre PHP.
- Modifier la valeur par défaut d’un paramètre PHP.
- Interdire la saisie de valeurs personnalisées pour des paramètres PHP.
Déterminer quelles valeurs prédéfinies peuvent être utilisées par un paramètre PHP.
Pour la plupart des paramètres PHP, il est possible de saisir une valeur unique depuis une liste de valeurs prédéfinies. Vous pouvez créer une liste de valeurs prédéfinies personnalisée qu’un paramètre PHP peut utiliser. Pour cela, ajoutez une ou plusieurs lignes au fichier panel.ini. Respectez la structure suivante :
[php]
settings.<parameter_group>.<parameter_name>.values[]=<value>
sachant que
-
<parameter_group>
correspond au groupe auquel le paramètre PHP choisi appartient. Pour en savoir plus sur les groupes de paramètres PHP, consultez la section « Paramètres PHP et groupes de paramètres » ci-dessous. -
<parameter_name>
correspond au nom du paramètre PHP choisi. Utilisez la même syntaxe que dans php.ini. -
<value>
correspond à la valeur prédéfinie du paramètre que vous voulez ajouter à la liste. Utilisez la même syntaxe que dans php.ini.
Vous devez ajouter une ligne pour chaque valeur prédéfinie que vous voulez afficher dans la liste.
Par exemple, le paramètre memory_limit
peut avoir l’une des valeurs suivantes : 8M
, 16M
, 32M
, 64M
ou 128M
. Si vous voulez restreindre le choix à 64M
et 128M
uniquement, vous devez ajouter les lignes suivantes au fichier panel.ini
:
[php]
settings.performance.memory_limit.values[]="64M"
settings.performance.memory_limit.values[]="128M"
Modification de la valeur par défaut d’un paramètre PHP
Pour la plupart des paramètres PHP, une valeur unique de la liste de valeurs prédéfinies est marquée comme valeur par défaut. La valeur par défaut est appliquée jusqu’à ce qu’un utilisateur sélectionne manuellement une autre valeur. Vous pouvez modifier la valeur par défaut d’un paramètre PHP en ajoutant une ligne au fichier panel.ini. Pour cela, respectez la structure suivante :
[php]
settings.<parameter_group>.<parameter_name>.default=<value>
sachant que
-
<parameter_group>
correspond au groupe auquel le paramètre PHP choisi appartient. Pour en savoir plus sur les groupes de paramètres PHP, consultez la section « Paramètres PHP et groupes de paramètres » ci-dessous. -
<parameter_name>
correspond au nom du paramètre PHP choisi. Utilisez la même syntaxe que dans php.ini. -
<value>
correspond à la valeur par défaut du paramètre choisi. Utilisez la même syntaxe que dans php.ini.
Par exemple, la valeur par défaut du paramètre open_basedir
est {WEBSPACEROOT}{/}{:}{TMP}{/}
. Pour passer cette valeur à none
, ajoutez la ligne suivante au fichier panel.ini
:
[php]
settings.general.open_basedir.default="none"
Dans cet exemple, none
est inclus par défaut dans la liste des valeurs prédéfinies pour open_basedir
. Il est possible que la valeur par défaut souhaitée pour un paramètre PHP ne soit pas incluse dans la liste par défaut des valeurs prédéfinies. Dans ce cas, vous devez d’abord créer une liste personnalisée de valeurs prédéfinies.
Par exemple, pour modifier la valeur par défaut du paramètre execution_time
et la remplacer par 180
, vous devez ajouter les lignes suivantes au fichier 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
Interdiction des valeurs personnalisées pour un paramètre PHP
Pour certains paramètres PHP, il est possible de saisir une valeur unique depuis une liste de valeurs prédéfinies. Vous pouvez interdire l’utilisation de valeurs personnalisées pour un paramètre PHP en ajoutant une ligne au fichier panel.ini. Pour cela, respectez la structure suivante :
[php]
settings.<parameter_group>.<parameter_name>.custom=false
sachant que
-
<parameter_group>
correspond au groupe auquel le paramètre PHP choisi appartient. Pour en savoir plus sur les groupes de paramètres PHP, consultez la section « Paramètres PHP et groupes de paramètres » ci-dessous. -
<parameter_name>
correspond au nom du paramètre PHP choisi. Utilisez la même syntaxe que dans php.ini.
Lorsque vous interdisez la saisie de valeurs personnalisées pour un paramètre PHP, les utilisateurs peuvent uniquement sélectionner les valeurs d’une liste de valeurs prédéfinies.
Par exemple, pour interdire la saisie d’une valeur personnalisée pour le paramètre error_reporting
, ajoute la ligne suivante au fichier panel.ini
:
[php]
settings.general.error_reporting.custom=false
Personnalisation des paramètres PHP-FPM
Pour personnaliser les paramètres PHP du groupe FPM, vous devez ajouter les lignes suivantes au fichier 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
Ceci est valide pour toute personnalisation des paramètres PHP-FPM : déterminer quelles valeurs prédéfinies un paramètre PHP-FPM peut utiliser, modifier la valeur par défaut ou interdire la saisie de valeurs personnalisées. Vous pouvez voir la liste complète des paramètres PHP-FPM dans le tableau ci-dessous, groupe de paramètres « fpm (Linux uniquement) ».
Par exemple, pour modifier la valeur par défaut du paramètre pm.max_children
et la remplacer par 20
, vous devez ajouter les lignes suivantes au fichier 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
Paramètres PHP et groupes de paramètres
Voici la liste complète des groupes de paramètres PHP et leurs paramètres correspondants :
Groupe de paramètres PHP | Nom du paramètre 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 (Linux uniquement) | pm.max_children |
pm.max_requests | |
pm | |
pm.start_servers | |
pm.min_spare_servers | |
pm.max_spare_servers | |
fastCgi (Windows uniquement) | maxInstances |
activityTimeout | |
requestTimeout | |
instanceMaxRequests | |
queueLength | |
rapidFailsPerMinute |