Personnaliser les paramètres PHP

Dans l’interface Plesk, vous et vos clients pouvez ajuster les paramètres PHP pour des packs de services individuels, des packs d’add-ons, des abonnements, des sites Web et des sous-domaines. Il est possible de modifier les valeurs de certains paramètres PHP utilisés le plus fréquemment. Pour cela, vous pouvez sélectionner la valeur souhaitée depuis une liste ou saisir une valeur personnalisée. Lorsque vous éditez le fichier panel.ini vous pouvez appliquer les modifications suivantes à ce scénario :

  • 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"

image-79193.png

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"

image-79195.png

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