【エラー備忘録】laravelコマンドを使用するためのパスを通す -bash: laravel: command not found


状況

laravelをインストールし、プロジェクトを作成しようと以下のコマンドを実行したところ、エラーに。

$ laravel new laravel_app

エラー文

-bash: laravel: command not found

原因

パスが通っていないため、コマンドが見つからないという状況が起きている。

  • PATHとは
    環境変数。実行ファイル(アプリケーション)の格納場所をメモしたもの。

  • 「PATHを通す」の意味
    特定のプログラムを、フルパスを指定しなくても、プログラム名だけで実行できるようにすること。

対処方法

以下のコマンドを実行すると、PATHが通る。

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

※exportコマンドは、環境変数を表示・設定するコマンド。

変更状態を反映させるため、続けてsourceコマンドも実行する。

$ source ~/.bash_profile

これでlaravelコマンドが使えるようになる。



・・・と思ったが、問題発生。
ターミナルを一度閉じて再度起動すると、またlaravelコマンドが使えなくなっている。

.bash_profileに、通したいPATHを直接記入しておく必要があるらしい。


「.bash_profile」をターミナル上で開く。

$ vi ~/.bash_profile

iと入力して入力モードに移行し、以下を書き込む。

export PATH=$PATH:~/.composer/vendor/bin

escで入力モードを終了し、:wで保存、:qでviエディタを終了する。

.bash_profileを更新する。

$ source ~/.bash_profile

これで、ターミナルを一旦閉じて再度起動しても、どこからでもlaravelコマンドが使えるようになりました。