Comment corriger l'erreur « PHP introuvable » sur macOS après l'installation de XAMPP

Lorsque les développeurs macOS utilisent XAMPP pour configurer un environnement de développement local, ils rencontrent souvent l'erreur frustrante « PHP introuvable ». Même si XAMPP est fourni avec PHP, il se peut que le terminal ne reconnaisse toujours pas la commande php.

Cet article vous guidera étape par étape pour résoudre ce problème et garantir que le système puisse trouver PHP.

Erreur de compréhension

Exécutez la commande suivante :

<code class="language-bash">php -v</code>

Si vous recevez un message d'erreur comme celui-ci :

<code>php not found</code>

Cela signifie que le shell de votre système (comme zsh ou bash) ne peut pas trouver l'exécutable PHP dans son environnement. Cela se produit même si XAMPP contient son propre binaire PHP, car le répertoire contenant PHP n'est pas inclus dans le $PATH du shell.

Résolvons ce problème !

Étape 1 : Trouvez PHP dans votre installation XAMPP

XAMPP contient sa propre installation PHP, généralement située dans le répertoire suivant :

<code class="language-bash">/Applications/XAMPP/xamppfiles/bin/php</code>

Pour vérifier que l'exécutable PHP existe à cet emplacement, exécutez :

<code class="language-bash">ls /Applications/XAMPP/xamppfiles/bin/php</code>

Si cette commande répertorie les fichiers PHP, vous êtes sur la bonne voie.

Étape 2 : ajoutez le PHP de XAMPP au PATH de votre shell

Pour rendre l'exécutable PHP disponible mondialement, vous devez ajouter le répertoire PHP XAMPP au $PATH de votre shell.

Utilisateurs Zsh (shell par défaut de macOS)

À partir de macOS Catalina, zsh est le shell par défaut. Veuillez suivre ces étapes pour mettre à jour votre $PATH :

1. Ouvrez votre fichier .zshrc :

<code class="language-bash">nano ~/.zshrc</code>

2. Ajoutez la ligne suivante à la fin du fichier :

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

3. Appuyez sur Ctrl O, puis Entrée et enfin Ctrl X pour enregistrer et fermer le fichier.

4. Appliquez les modifications immédiatement en exécutant la commande suivante :

<code class="language-bash">source ~/.zshrc</code>

Utilisateurs Bash

Si vous utilisez toujours bash comme shell, modifiez .bash_profile :

<code class="language-bash">nano ~/.bash_profile</code>

Ajouter la même ligne :

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

Enregistrez et appliquez les modifications en utilisant :

<code class="language-bash">source ~/.bash_profile</code>

Étape 3 : Vérifier l'installation de PHP

Après avoir mis à jour $PATH, testez si la commande php fonctionne :

<code class="language-bash">php -v</code>

Vous devriez voir la version de PHP fournie avec XAMPP, par exemple :

<code>PHP 8.2.4 (cli) (built: Apr  6 2023 04:12:41) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.4, Copyright (c) Zend Technologies</code>

Si ça marche, félicitations ! Votre système reconnaît maintenant la commande php.

Étape 4 : Redémarrez le terminal (facultatif)

Si les étapes ci-dessus ne prennent pas effet immédiatement, veuillez redémarrer le terminal et réessayer d'exécuter php -v. Parfois, les modifications apportées au fichier de configuration du shell nécessitent un redémarrage du terminal pour prendre effet.

Alternative : installer PHP en utilisant Homebrew

Si vous préférez une installation PHP à l'échelle du système plutôt que de compter sur la version fournie de XAMPP, vous pouvez installer PHP à l'aide de Homebrew :

1. Si Homebrew n’est pas encore installé, veuillez l’installer :

<code class="language-bash">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</code>

2. Installer PHP :

<code class="language-bash">brew install php</code>

3. Vérifier l'installation :

<code class="language-bash">php -v</code>

Cela installera la dernière version de PHP et configurera automatiquement votre $PATH.

Conclusion

Les erreurs « PHP introuvable » peuvent être rapidement corrigées une fois que vous avez compris comment fonctionne le $PATH du shell. Que vous ajoutiez le PHP de XAMPP à votre PATH ou que vous choisissiez Homebrew, ce guide garantira que vous êtes opérationnel en un rien de temps. Vous pouvez désormais vous concentrer sur ce qui compte le plus : développer de superbes applications !

Faites-nous savoir dans les commentaires si ce guide vous a été utile, ou partagez vos conseils pour gérer PHP sur macOS !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!