La page PHP d'un serveur liste les versions de PHP qui y sont installées. Vimonto Deploy installe PHP depuis le dépôt ondrej/php : plusieurs versions peuvent donc tourner côte à côte. Chaque version a son propre service PHP-FPM et ses propres réglages, et chaque site choisit la version sur laquelle il tourne. Depuis cette page, vous installez et supprimez des versions, choisissez la version par défaut, modifiez les réglages PHP les plus courants et installez les versions correctives.
La page est disponible sur les serveurs d'application, les serveurs web et les serveurs worker, les types de serveurs qui font tourner PHP.
Quelles versions de PHP pouvez-vous installer ?
Vimonto Deploy propose PHP 8.5, 8.4, 8.3, 8.2 et 8.1. Un nouveau serveur reçoit la version choisie lors de sa création, et cette version est d'abord la version par défaut, à la fois en ligne de commande et pour les nouveaux sites.
Chaque version est installée avec le même ensemble d'extensions :
| Extensions |
|---|
| bcmath, cli, curl, fpm, gd, igbinary, imagick, intl, mbstring, memcached, msgpack, mysql, pgsql, readline, redis, soap, sqlite3, xml, zip |
La première installation place aussi Composer sur le serveur, après avoir vérifié l'installateur par rapport à sa signature publiée.
Installer une nouvelle version de PHP
- Ouvrez le serveur et choisissez PHP dans la barre latérale.
- Cliquez sur Installer une nouvelle version et choisissez une version dans le menu. Le menu ne liste que les versions qui ne sont pas encore sur le serveur.
- Confirmez avec Installer.
L'installation prend quelques minutes. La version affiche Ajout pendant l'exécution de la tâche, et vous pouvez la suivre sur la page Activité. Les sites existants continuent d'utiliser leur propre version : installer une nouvelle version ne change rien pour eux.
Si l'installation échoue, la ligne affiche Échoué et un bouton Réessayer. Chaque étape peut être relancée sans risque.
Que sont la version par défaut en ligne de commande et pour les nouveaux sites ?
Chaque serveur a deux valeurs par défaut, affichées sous forme de badges à côté de la version :
- Ligne de commande : la version qui s'exécute quand vous ou un script tapez
phpsur le serveur, par exemple dans le terminal, dans les tâches planifiées et dans les processus qui appellentphp. Vimonto Deploy la définit avecupdate-alternatives. - Nouveaux sites : la version présélectionnée quand vous créez un site sur ce serveur. Elle ne modifie pas les sites existants.
Pour changer une valeur par défaut, ouvrez le menu d'actions (⋯) d'une version et choisissez Par défaut en ligne de commande ou Par défaut pour les nouveaux sites. La valeur par défaut en ligne de commande lance une courte tâche sur le serveur ; celle des nouveaux sites est enregistrée immédiatement.
Pour passer un site existant sur une autre version, changez sa version de PHP dans les paramètres du site.
Modifier les réglages PHP
Cliquez sur Paramètres à côté d'une version pour modifier ses réglages les plus courants. Chaque version a ses propres valeurs, et Appliquer les écrit sur le serveur et recharge PHP-FPM.
| Réglage | Défaut | Plage | Effet |
|---|---|---|---|
| Limite de mémoire (Mo) | 512 | 64 à 16384 | La mémoire maximale qu'une requête peut utiliser (memory_limit). |
| Upload maximal (Mo) | 64 | 1 à 4096 | La taille maximale d'un upload et du corps d'une requête (upload_max_filesize et post_max_size). S'applique aussi à Nginx. |
| Temps d'exécution maximal (secondes) | 60 | 5 à 3600 | La durée maximale d'une requête (max_execution_time). Au-delà, PHP-FPM arrête la requête. |
| Nombre max. de variables d'entrée | 1000 | 1000 à 100000 | Le nombre de champs de formulaire qu'une requête peut contenir (max_input_vars). Les grands formulaires, comme dans WordPress ou Magento, en demandent plus. |
| Processus PHP-FPM | 5 | 2 à 500 | Le nombre de requêtes que PHP traite simultanément (pm.max_children). |
| OPcache | Activé | Activé ou désactivé | Met en cache le code PHP compilé. Plus rapide, et presque toujours souhaitable en production. |
Ces réglages s'appliquent à PHP-FPM, qui sert vos requêtes web. La ligne de commande utilise sa propre configuration avec une limite de mémoire de 1 Go : les longues commandes Artisan et les installations Composer ne sont donc pas limitées par la valeur web.
De combien de processus PHP-FPM avez-vous besoin ?
Chaque processus PHP-FPM traite une requête à la fois et peut utiliser jusqu'à la limite de mémoire. Une règle simple : le nombre de processus multiplié par la mémoire typique d'une requête doit tenir dans la mémoire libre du serveur, à côté de la base de données et des autres services. Si les requêtes s'accumulent alors que le serveur a encore de la mémoire et du CPU disponibles, augmentez le nombre ; si le serveur manque de mémoire, baissez-le ou baissez la limite de mémoire. La page monitoring affiche la mémoire et la charge dans le temps.
Les réglages de processus de réserve du pool suivent le nombre que vous choisissez : vous ne définissez que le maximum.
Les réglages s'appliquent-ils aux sites isolés ?
En partie. Un site isolé a son propre pool PHP-FPM, qui tourne sous son propre utilisateur Linux. La limite de mémoire, la taille d'upload, le temps d'exécution, les variables d'entrée et OPcache s'y appliquent aussi, car ce sont des réglages PHP de la version. Le nombre de Processus PHP-FPM ne s'applique qu'au pool partagé ; le pool d'un site isolé démarre des processus à la demande, jusqu'à 10.
Mettre à jour vers la dernière version corrective
Ouvrez le menu d'actions (⋯) d'une version et choisissez Mettre à jour vers le dernier patch. Vimonto Deploy met à jour uniquement les paquets de cette version (par exemple de 8.4.11 à 8.4.12), puis redémarre son service PHP-FPM. Les versions correctives contiennent des correctifs de sécurité et de bugs, pas de nouvelles fonctionnalités du langage.
Les serveurs installent aussi automatiquement les mises à jour de sécurité : cette action sert surtout quand vous avez besoin d'un correctif immédiatement.
Supprimer une version de PHP
Ouvrez le menu d'actions (⋯), choisissez Supprimer, puis confirmez. Vimonto Deploy arrête le service PHP-FPM de la version, supprime ses paquets et efface sa configuration.
Vous ne pouvez pas supprimer une version qui est la version par défaut en ligne de commande ou pour les nouveaux sites : faites d'abord d'une autre version la version par défaut.
Questions fréquentes
Comment augmenter la limite d'upload de PHP ?
Ouvrez PHP, cliquez sur Paramètres à côté de la version utilisée par votre site, augmentez Upload maximal (Mo) et cliquez sur Appliquer. Vimonto Deploy modifie à la fois les limites d'upload et de POST de PHP et la limite du corps de requête de Nginx.
Différents sites d'un même serveur peuvent-ils utiliser différentes versions de PHP ?
Oui. Installez chaque version nécessaire sur la page PHP, puis choisissez la version de chaque site à sa création ou plus tard dans ses paramètres.
Pourquoi php -v sur le serveur affiche-t-il une autre version que celle de mon site ?
La ligne de commande utilise la version par défaut Ligne de commande, tandis que chaque site utilise sa propre version via PHP-FPM. Faites de la version du site la version par défaut en ligne de commande, ou appelez directement la version, par exemple php8.4 artisan migrate.
Puis-je modifier php.ini à la main ?
Vimonto Deploy écrit ses réglages dans /etc/php/{version}/fpm/conf.d/99-vimonto.ini et écrase ce fichier quand vous cliquez sur Appliquer. Les modifications dans d'autres fichiers sous /etc/php sont laissées telles quelles, mais les réglages de 99-vimonto.ini priment sur la plupart d'entre elles.