Modification des paramètres PHP

ServBay intègre un environnement PHP et offre des options de configuration flexibles. Cet article explique en détail comment modifier les paramètres PHP dans ServBay, y compris l'emplacement des fichiers php.ini et php-fpm.conf, ainsi que les éléments de configuration courants. Selon la version de PHP, ces fichiers sont situés dans le répertoire /Applications/ServBay/etc/php/<version>. De plus, les fichiers de configuration pour le chargement des modules PHP (comme xdebug.ini) se trouvent dans le répertoire /Applications/ServBay/etc/php/<version>/conf.d.

Information importante

Ne modifiez pas manuellement les fichiers de configuration. Tous les fichiers de configuration sont générés automatiquement par ServBay, et toute modification manuelle risque d'être écrasée. Veuillez effectuer les modifications via l'interface utilisateur.

Vue d'ensemble

Dans ServBay, les fichiers de configuration PHP sont stockés dans différents répertoires selon leur version. Par exemple, les fichiers de configuration de PHP 8.3 se trouvent dans le répertoire /Applications/ServBay/etc/php/8.3. Vous trouverez ci-dessous les emplacements détaillés de ces fichiers de configuration :

• php.ini : /Applications/ServBay/etc/php/8.3/php.ini
• php-fpm.conf : /Applications/ServBay/etc/php/8.3/php-fpm.conf
• Fichiers de configuration du chargement des modules PHP : /Applications/ServBay/etc/php/8.3/conf.d/

Modification via l'interface utilisateur de ServBay

ServBay dispose d'une interface graphique de gestion puissante qui permet aux utilisateurs de modifier directement les différents paramètres de configuration dans cette interface. Après avoir cliqué sur enregistrer, les modifications sont automatiquement appliquées et prennent effet immédiatement, évitant ainsi à l'utilisateur de devoir éditer manuellement les paramètres.

Dans la navigation à gauche, ouvrez Langue, choisissez la version PHP à modifier, et le menu d'édition apparaîtra à droite. Un exemple d'interface typique est illustré ci-dessous.

Dans l'interface, trois différents éléments de configuration sont proposés, correspondant respectivement à la configuration de PHP-FPM, PHP, et des modules PHP. Ces éléments de configuration seront expliqués successivement ci-dessous.

PHP FPM

Astuce

Le fichier php-fpm.conf affecte le comportement du PHP exécuté dans le service Web, et toutes les configurations prendront le pas (écraseront) sur celles du fichier php.ini.

Cependant, ces réglages n'affecteront pas l'exécution du code en mode CLI.

Tout d'abord, l'interface de configuration de PHP FPM. Que ce soit avec Caddy ou NGINX, le PHP du service Web ServBay fonctionne en mode FPM. Dans cette interface, vous pouvez configurer le nombre de processus FPM, la limite de mémoire, le niveau d'erreur du log, l'affichage des erreurs dans le navigateur, etc.

Par exemple, si nous voulons modifier dans le Web la Memory Limit de 64M à 1G, il suffit de sélectionner 1G dans le menu déroulant de Memory Limit, puis d'enregistrer. Cette modification n'affectera pas la configuration php.ini, et l'exécution des scripts PHP en mode CLI continuera à être contrôlée par php.ini.

Supposons que la Memory Limit dans php.ini soit réglée sur 512M, et que la Memory Limit dans la configuration PHP FPM soit 128M. Dans ce cas, le même script exécuté en mode CLI pourra utiliser jusqu'à 512M de mémoire, et en mode Web, il pourra utiliser jusqu'à 128M de mémoire.

php.ini

Astuce

Les paramètres de php.ini sont globaux et affectent à la fois le mode CLI et le mode Web. Cependant, les paramètres de php.ini peuvent être écrasés par php-fpm.conf dans le mode Web.

La section de configuration PHP concerne les options de configuration dans le fichier php.ini, qui est le fichier de configuration principal de PHP.

Ici, vous pouvez configurer la plupart des options de php.ini, comme post_max_size qui influence le formulaire post et upload_max_filesize qui affecte la taille des fichiers téléversés. Vous pouvez aussi gérer les fonctions désactivées via disable_functions et les classes désactivées via disable_classes, entre autres.

Notez que comme les paramètres sont globaux, si vous souhaitez définir open_basedir, il est conseillé de placer tous les projets de site dans /Applications/ServBay/www, de manière à ne pas avoir à définir plusieurs répertoires lors de la configuration de open_basedir.

Pour des détails sur les champs de configuration, veuillez consulter la documentation officielle de php.ini.

Modules d'extension

ServBay inclus de nombreux modules d'extension PHP courants comme xDebug, OPcache, Image Magick, Redis, MongoDB, Phalcon, Swoole, etc. Pour la liste complète des modules, veuillez consulter la liste des modules d'extension PHP.

Activer un module d'extension PHP est très simple, il suffit de cliquer sur l'interrupteur, puis d'enregistrer. Pour les modules ayant des options de configuration supplémentaires comme xDebug, vous pouvez aussi facilement modifier ces options directement.

Modification via l'édition manuelle des fichiers de configuration

WARNING

Modifier manuellement les fichiers de configuration convient uniquement pour des changements temporaires sur certains éléments de configuration.

Nous déconseillons de modifier manuellement les fichiers de configuration PHP car toutes les modifications seront écrasées par ServBay.

Configuration de php.ini

Le fichier php.ini est le fichier de configuration principal de PHP, utilisé pour définir diverses options d'exécution de PHP.

Éléments de configuration courants

Voici quelques éléments de configuration courants dans php.ini et comment les modifier :

1. Modifier la limite de mémoire :

   memory_limit = 256M

2. Modifier la limite de taille des fichiers téléversés :

   upload_max_filesize = 50M
   post_max_size = 50M

3. Modifier le paramètre de fuseau horaire :

   date.timezone = "Asia/Hong_Kong"

4. Activer l'affichage des erreurs :

   display_errors = On
   error_reporting = E_ALL

5. Modifier le temps maximum d'exécution :

   max_execution_time = 300

Configuration de php-fpm.conf

Le fichier php-fpm.conf est utilisé pour configurer les paramètres d'exécution de PHP-FPM (FastCGI Process Manager).

Éléments de configuration courants

Voici quelques éléments de configuration courants dans php-fpm.conf et comment les modifier :

1. Modifier les paramètres du pool de processus :

   [www]
   listen = /Applications/ServBay/tmp/php-cgi-8.3.sock
   listen.backlog = -1
   listen.allowed_clients = 127.0.0.1
   ;listen.owner = www
   ;listen.group = www
   listen.mode = 0666
   ;user = www
   ;group = www
   pm = dynamic
   pm.max_children = 10
   pm.start_servers = 2
   pm.min_spare_servers = 1
   pm.max_spare_servers = 6
   pm.max_requests = 1024
   pm.process_idle_timeout = 10s

2. Activer le log des requêtes lentes :

   request_slowlog_timeout = 5s
   slowlog = /Applications/ServBay/logs/php/8.3/slow.log

3. Modifier le chemin du journal des erreurs :

   error_log = /Applications/ServBay/logs/php/8.3/errors.log

Configuration du chargement des modules PHP

Les fichiers de configuration pour le chargement des modules PHP sont situés dans le répertoire /Applications/ServBay/etc/php/8.3/conf.d/. Par exemple, le fichier xdebug.ini est utilisé pour configurer l'extension Xdebug.

Exemple de xdebug.ini

Voici un exemple de fichier xdebug.ini :

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so
xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

Redémarrer PHP

Après avoir modifié le fichier de configuration PHP, il est nécessaire de redémarrer le service PHP pour que les changements prennent effet. Vous pouvez le faire via l'interface de gestion ServBay ou en utilisant l'outil en ligne de commande servbayctl.

Redémarrer via l'interface de gestion de ServBay

1. Ouvrez l'interface de gestion de ServBay.
2. Accédez à Services.
3. Trouvez la version PHP correspondante et cliquez sur le bouton Redémarrer.

Redémarrer via servbayctl

L'outil en ligne de commande servbayctl permet de redémarrer facilement le service PHP :

servbayctl restart php 8.3

Résumé

Dans ServBay, les fichiers de configuration PHP sont situés dans le répertoire /Applications/ServBay/etc/php/<version>, comprenant php.ini et php-fpm.conf. Les fichiers de configuration pour le chargement des modules PHP se trouvent dans le répertoire /Applications/ServBay/etc/php/<version>/conf.d/. Après avoir modifié ces fichiers de configuration, vous pouvez redémarrer le service PHP via l'interface de gestion ServBay ou en utilisant l'outil en ligne de commande servbayctl pour que les changements prennent effet.