Comment ajouter ~/.composer/vendor/bin à votre PATH ?

Publié 17 octobre 2024

Problème : Accéder aux exécutables installés par Composer

Ajouter le répertoire bin de Composer à la variable d'environnement PATH vous permet d'accéder facilement aux exécutables installés via Composer. Sans cette configuration, vous devez spécifier le chemin complet pour exécuter ces outils à chaque fois, ce qui peut être lent et peu pratique.

Ajouter ~/.composer/vendor/bin au PATH

Solution temporaire

Pour ajouter le répertoire bin de Composer à votre PATH pour la session de terminal en cours :

  1. Ouvrez votre terminal.
  2. Exécutez cette commande :

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

Cela ajoute le répertoire bin de Composer à votre PATH uniquement pour la session en cours.

Conseil: Vérifier l'ajout au PATH

Après avoir exécuté la commande export, vous pouvez vérifier que le répertoire bin de Composer a été ajouté à votre PATH en exécutant :

echo $PATH

Cela affichera votre PATH actuel, et vous devriez voir le répertoire bin de Composer inclus.

Solution permanente pour les utilisateurs de Bash

Pour rendre le changement permanent pour les utilisateurs de Bash :

  1. Ouvrez votre fichier ~/.bashrc avec un éditeur de texte.

  2. Ajoutez cette ligne à la fin du fichier :

    export PATH="$PATH:$HOME/.composer/vendor/bin"
  3. Sauvegardez et fermez le fichier.

  4. Pour appliquer les changements sans vous déconnecter, exécutez :

    source ~/.bashrc

Emplacements alternatifs pour d'autres systèmes

  • Si votre système n'a pas de fichier ~/.bashrc, vous pouvez ajouter la ligne export à ~/.bash_profile.
  • Pour les versions plus récentes de Laravel, vous pourriez avoir besoin d'utiliser $HOME/.config/composer/vendor/bin au lieu de $HOME/.composer/vendor/bin.
  • Pour rendre le changement effectif à l'échelle du système, y compris pour les applications GUI, ajoutez la ligne export à ~/.profile.

Exemple: Utilisation de ~/.profile pour l'ajout du PATH à l'échelle du système

Pour ajouter le répertoire bin de Composer à votre PATH à l'échelle du système :

  1. Ouvrez votre fichier ~/.profile avec un éditeur de texte :
    nano ~/.profile
  2. Ajoutez la ligne suivante à la fin du fichier :
    export PATH="$PATH:$HOME/.composer/vendor/bin"
  3. Sauvegardez et fermez le fichier.
  4. Déconnectez-vous et reconnectez-vous pour que les changements prennent effet.

Vérifier la mise à jour du PATH

Après avoir ajouté le répertoire bin de Composer à votre PATH, vous devez vérifier si les changements ont été appliqués correctement. Voici deux façons de vérifier si la mise à jour a fonctionné :

Déconnectez-vous et reconnectez-vous :

  1. Sauvegardez votre travail et fermez toutes les fenêtres de terminal.
  2. Déconnectez-vous de votre système Ubuntu.
  3. Reconnectez-vous à votre compte.
  4. Ouvrez une nouvelle fenêtre de terminal.
  5. Tapez cette commande pour afficher votre PATH actuel :
    echo $PATH
  6. Cherchez le répertoire ~/.composer/vendor/bin dans la sortie.

Utilisez la commande source pour appliquer les changements :

  1. Si vous ne voulez pas vous déconnecter, utilisez la commande source pour recharger vos paramètres de shell :
    source ~/.bashrc

    (Utilisez ~/.bash_profile ou ~/.profile si vous avez ajouté le PATH là-bas)

  2. Après avoir exécuté la commande source, vérifiez votre PATH :
    echo $PATH
  3. Cherchez le répertoire ~/.composer/vendor/bin dans la sortie.

Si vous voyez le répertoire bin de Composer dans votre PATH, la mise à jour a réussi. Vous pouvez maintenant exécuter les commandes Laravel sans taper le chemin complet vers l'exécutable.