Lorsque Valet cesse de fonctionner correctement, que faisons-nous ?

Je suis fan d’utiliser à la fois Homebrew et Valet lorsqu’il s’agit de mettre en place et de configurer un environnement de développement WordPress de base. Bien que l’utilisation de gestionnaires de paquets et de logiciels simples pour ce genre de choses devrait faciliter les choses, cela ne nous dispense pas des problèmes occasionnels.

Exemple concret : il peut arriver que nous devions mettre à jour notre TLD pour qu’il fonctionne correctement avec Chrome et d’autres navigateurs, ou même mettre à niveau l’ensemble de l’installation.

Malheureusement, ce n’est pas toujours aussi facile qu’il devrait l’être. Techniquement, nous devrions pouvoir désinstaller Valet et le mettre à jour via Composer. Mais j’ai personnellement rencontré des problèmes qui m’ont obligé à:

• désinstaller manuellement Valet,
• utilisez Homebrew pour désinstaller PHP et nettoyer complètement ce qui restait,
• réinstaller les packages Homebrew,
• installer Valet,
• vérifiez que le navigateur utilise la même version de PHP que l’installation de Valet.

Cela ressemble à beaucoup de travail pour quelque chose qui devrait plus ou moins "fonctionner" et il y a pas mal d’étapes, mais elles sont assez rapides à mettre en place.

Quand le voiturier cesse de fonctionner

Donc, si vous vous trouvez dans une situation où Valet ne fonctionne pas avec WordPress ou Homebrew ou l’un ou l’autre, les étapes suivantes vous aideront peut-être.

1 Supprimer manuellement Valet

D’après la documentation, nous devrions pouvoir lancer :

$ valet uninstall

Pour terminer, supprimez le logiciel, mais cela ne fonctionne pas. Au lieu de cela, nous devons le supprimer complètement en supprimant son répertoire et le binaire associé.

Si vous utilisez macOS, la méthode consiste à supprimer le répertoire .vendor et le binaire valet trouvé dans /usr/local/bin/valet.

Pour cela, entrez les commandes suivantes dans le terminal :

$ rm -rf ~/.valet
$ rm ~/usr/local/bin/valet

Bien que vous ne devriez recevoir aucun message d’erreur, vous devrez peut-être exécuter sudo pour supprimer le binaire (mais si tel est le cas, il a probablement été supprimé et installé de manière incorrecte la première fois.

2 Utilisez Homebrew pour supprimer PHP

L’un des avantages d’Homebrew est qu’il nous permet d’exécuter plusieurs versions de PHP et de basculer entre elles. Ceci est particulièrement utile si vous travaillez avec divers projets pour une utilisation généralisée ou des environnements spécialisés.

Pour voir quelles versions de PHP sont sur votre système, vous pouvez exécuter ce qui suit :

$ brew list

Et vous devriez voir quelque chose comme ça :

Ensuite, supprimez les packages suivants :

• dnsmasq
• nginx
• php

Et si vous avez plusieurs versions de PHP, vous devrez supprimer toutes les versions du logiciel. Pour ce faire, saisissez les commandes suivantes :

$ brew uninstall dnsmasq && brew uninstall nginx && brew uninstall php
$ brew cleanup

Vous devrez peut-être également exécuter la désinstallation de brew pour chaque version de PHP si vous avez plusieurs versions en cours d’exécution sur votre système.

Notez que si vous avez plusieurs versions de PHP en cours d’exécution, vous pouvez également rencontrer des problèmes pour supprimer chacune d’entre elles.

Si tel est le cas, vous devrez forcer la suppression (en utilisant la commande –force ), ou vous devrez peut-être supprimer de manière récursive un répertoire donné qui prépare des rapports. Cela devra être fait pour chacune des installations de PHP.

Une fois cela fait, n’oubliez pas de lancer cleanup.

Ensuite, vous voudrez peut-être aller de l’avant et consulter un médecin pour voir s’il y a des problèmes et les résoudre s’il y en a. Dans de nombreux cas, vous trouverez des liens symboliques rompus qui peuvent ensuite être supprimés en tapant brew prune.

Si vous faites cela et relancez brew doctor, alors tout devrait bien se passer :

Et vous serez prêt à commencer à réparer l’installation.

3 Réinstaller les packages Homebrew

Ensuite, installons la version la plus récente de PHP. Vous pouvez, bien sûr, choisir d’installer n’importe quelle version de PHP, mais c’est le contenu d’un autre article (ou vous pouvez voir ce qui est disponible sur cette page ).

Tout d’abord, vous devrez peut-être appuyer sur le référentiel homebrew/php s’il ne figure pas déjà dans votre liste de référentiels disponibles ; cependant, vous pouvez vérifier ce que vous avez en saisissant simplement

$ brew tap

Si vous voyez homebrew/php, vous êtes prêt à partir.

Alors, à partir de là, mettons à jour brew :

$ brew update

Installez ensuite la dernière version de PHP en saisissant :

$ brew install homebrew/core/php

Au moment d’écrire ces lignes, il s’agit de PHP 7.2.5.

Pour vérifier qu’il a été installé correctement, vous pouvez entrer quel php dans votre terminal et /usr/local/bin/php doit être renvoyé. Ensuite, si vous exécutez php -v, vous devriez voir 7.2.5 renvoyé comme version.

4 Réinstaller Valet

Il est maintenant temps de réinstaller Valet. Pour cela, entrez la commande suivante dans votre terminal :

$ composer global require laravel/valet

Ensuite, assurez-vous d’exécuter la commande suivante :

export PATH="$PATH:$HOME/.composer/vendor/bin"

Cela garantit que les fichiers binaires Composer globaux sont situés dans les variables d’environnement de votre système et sont disponibles n’importe où sur votre système.

Ensuite, exécutez valet install. Cela installera dnsmasq et nginx qui sont des composants nécessaires pour exécuter Valet.

5 Vérifiez que le navigateur fonctionne comme prévu

Avant de tester le navigateur, nous souhaitons envoyer un ping à l’environnement local pour nous assurer que le serveur Web fonctionne comme prévu. Pour ce faire, entrez ce qui suit dans le terminal :

$ ping foo.test

En supposant que tout est configuré correctement, vous devriez obtenir une réponse :

Il est maintenant temps de s’assurer que le navigateur utilise la même version de PHP que celle que nous avons installée à l’étape précédente. Pour ce faire, créez un répertoire n’importe où sur votre système, appelez index.php puis entrez ce qui suit dans le fichier :

<?php
phpinfo();

Ensuite, accédez au répertoire de votre terminal – j’ai appelé le mien bêta – puis entrez la commande suivante dans votre terminal :

$ valet link && valet secure

Ensuite, chargez https://beta.test dans votre navigateur. En supposant que tout se passe bien, voici ce que vous devriez voir :

Notez que la version de PHP utilisée est la même que celle que nous avons installée précédemment.

Pourquoi le faire manuellement ?

À ce stade, vous disposez d’une installation Valet entièrement fonctionnelle avec la dernière version de tous les packages nécessaires. Malheureusement, la commande de désinstallation ne fait pas ce que vous attendez et laisse quelques artefacts derrière.

Ainsi, c’est pourquoi je suis fan de tout supprimer manuellement, de faire une mise à jour, puis de réinstaller Valet.

Si vous rencontrez des problèmes avec votre installation – en particulier si vous utilisez BrowserSync, Yarn ou similaire – cela devrait résoudre ces problèmes (ainsi que tout autre que vous pourriez rencontrer).