Spécifier la version de PHP pour un site ou un script dans ServBay
En tant que développeur web, il vous arrive souvent de gérer des projets utilisant différentes versions de PHP, ou de devoir tester la compatibilité du code sous une version précise. ServBay, un outil puissant pour l’environnement de développement local, propose des moyens flexibles pour gérer et changer la version de PHP. Cet article détaille la marche à suivre pour spécifier l’environnement d’exécution PHP de vos projets, scripts PHP ou de l’ensemble d’un site dans ServBay.
Spécifier une version PHP pour un projet
ServBay permet de définir l’environnement PHP au niveau d’un projet. Pour ce faire, il suffit de créer dans le répertoire racine du projet un fichier appelé .servbay.config
dans lequel vous indiquez la version de PHP à utiliser.
Exemple de contenu pour un fichier .servbay.config
afin de définir une version spécifique de PHP :
PHP_VERSION=8.0
Remarque : Le fichier .servbay.config
doit être placé à la racine de votre projet, c’est-à-dire dans le dossier que vous sélectionnez lors de la configuration de votre site sur ServBay. Par exemple, si la racine de votre site est /Applications/ServBay/www/my-project
, le fichier .servbay.config
doit se trouver à /Applications/ServBay/www/my-project/.servbay.config
.
Pour plus de détails sur la configuration et l’utilisation, veuillez consulter la documentation officielle de ServBay au sujet du fichier .servbay.config.
Exécuter un script PHP avec une version spécifique de PHP
Si vous ne souhaitez pas assigner une version de PHP à tout un projet ou site, mais simplement utiliser ponctuellement une version précise pour exécuter un script, ServBay vous offre une méthode rapide via la ligne de commande.
Dans le terminal intégré de ServBay, vous pouvez utiliser la commande php-<version>
pour exécuter un script PHP avec la version désirée. Cela est particulièrement utile pour tester rapidement un script sous plusieurs versions de PHP.
Par exemple, pour exécuter un script appelé version.php
avec PHP 5.6 :
$ php-5.6 version.php
Hello World
PHP Version: 5.6.40
$ php-7.3 version.php
Hello World
PHP Version: 7.3.33
2
3
4
5
6
7
Explications des exemples
php-5.6 version.php
: Exécute explicitement le scriptversion.php
avec la version 5.6 de PHP installée dans ServBay.php-7.3 version.php
: Exécute explicitement le même script avec la version 7.3 de PHP installée dans ServBay.
Avec cette méthode, vous disposez d’une grande flexibilité pour tester et exécuter vos scripts sur différentes versions de PHP sans devoir modifier la configuration globale du projet ou du site.
Fixer une version PHP pour un site web
Si vous souhaitez attribuer une version précise de PHP à l’ensemble de votre site (c’est-à-dire une instance de virtual host configurée dans ServBay), vous pouvez définir cela facilement depuis l’interface graphique ServBay.
Cette méthode est idéale pour un site devant obligatoirement fonctionner sur une version ancienne de PHP, ou lors de la migration pour tester la compatibilité avec une version plus récente.
Étapes à suivre
Ouvrir l’interface de gestion ServBay : Lancez l’application ServBay.
Accéder à la configuration des sites : Dans le menu latéral gauche, cliquez sur « Sites ».
Sélectionner le site concerné : Dans la liste de vos sites, trouvez celui que vous souhaitez configurer. Cliquez à droite de la ligne sur le menu déroulant « Version PHP ».
Choisir la version de PHP et sauvegarder : Dans le menu déroulant, sélectionnez la version de PHP à utiliser pour ce site. Assurez-vous que la version est déjà installée et en cours d’exécution dans ServBay. Enfin, cliquez sur le bouton pour enregistrer les modifications (généralement placé en haut ou en bas de la liste).
Points importants
- PHP doit être installé et en cours d’exécution : Avant de sélectionner une version PHP pour un site, vérifiez qu’elle est bien installée depuis la section « Packages » de ServBay, et que son statut indique « en fonctionnement ». Si la version n’est pas installée ou démarrée, réalisez d’abord ces opérations.
- Vérification de compatibilité : Après avoir changé la version PHP d’un site, il est fortement recommandé de tester immédiatement toutes les fonctionnalités clés de votre site pour s’assurer qu’elles fonctionnent convenablement sous la nouvelle version de PHP.
- Emplacement du répertoire du site : Il est conseillé d’organiser vos fichiers de sites dans le dossier
/Applications/ServBay/www/
, avec un sous-dossier dédié pour chaque site, par exemple/Applications/ServBay/www/servbay.demo
. Les exemples de cette documentation suivent cette convention.
Conclusion
ServBay offre aux développeurs plusieurs moyens flexibles et pratiques de gérer et de définir l’environnement d’exécution PHP. Vous pouvez :
- Verrouiller une version PHP sur un projet donné en ajoutant un fichier
.servbay.config
à la racine du projet. - Utiliser la commande
php-<version>
pour exécuter temporairement un script avec une version donnée de PHP. - Définir une version PHP pour tout un site web depuis l’interface graphique de ServBay.
Grâce à cette gestion multi-niveaux des versions PHP, ServBay répond parfaitement aux besoins variés des projets : maintenance de systèmes existants, développement de nouvelles fonctionnalités, ou tests de compatibilité. Cela permet d’accroître considérablement l’efficacité et la souplesse de votre environnement de développement local.