MacでLaravel5.8の開発環境を構築しよう（下準備）

環境構築ってわけわからんし、めんどくさい！

そう思ってプログラミングをやめた人は結構いるのではないでしょうか。勉強し始めて半年ぐらいたつ僕ですが、いまだに環境構築は苦手です。ですが、Laravel環境構築はなんとかできたので、その時の手順を出来るだけわかりやすく書いていこうと思います。長くなりそうなので下準備編と開発編で分けて解説していきます。基本的にはbashでやってますが、多分zshでも大丈夫です。その時は$を%に読み替えてください。

#手順
1.ターミナルを開く
2.homebrewのインストール
3.phpのインストール
4.composerのインストール
5.PATHを通す
6.Valetのインストール

#1.ターミナルを開く
それぐらいできるわ！って人も多いと思いますが、
プロゲートとかだけやってるとマジでちょっと戸惑います。

どうやって開くかというと、まずファインダーを開きます。
アプリケーションタブをクリックし、検索欄で
ターミナルと入力すると出てきます。

このターミナルを使って、次の項目から開発環境の構築を進めていきたいと思います。

#2.homebrewのinstall

homebrewってなんなの？って思う人も多いと思うのですが、
「様々なソフトを簡単に入れられるようにするツール」 というような認識で大丈夫です。

homebrewは下記のコードで入れられます。

$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

入っている場合には下記のように感じになると思います。

$ brew --version
Homebrew 2.1.12     #バージョンごとに異なる
Homebrew/homebrew-core (git revision 1089; last commit 2019-10-07)　　

#3.phpのinstall
Laravelはphpのフレームワークなので、当然phpをinstallする必要性があります。homebrewからphpは入れることができます。

今回はphpのバージョンを7.3に指定してinstallします。

$ brew install php@7.3      #@以下でバージョン指定

入っている場合には下記のようになるはずです。

$ php -v
PHP 7.3.9 (cli) (built: Sep 14 2019 18:07:55) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.9, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.3.9, Copyright (c) 1999-2018, by Zend Technologies

#4.composerのinstall
composerとは、phpのパッケージ管理システムです。なんでそんなものが必要なのか気になる人は、composerとはで詳しく説明されているので、そちらで確認してください。
調べてみたら、homebrewで入れる方法もあるようですが、自分は使わずに入れたので、その説明をしていきます。

homebrewで入れる手順については下記参照。
Mac に Homebrew で composer をインストールする (201808)

下記のリンクでcomposerのページにいけます。
composer

ここのDownloadボタンをクリックすると次のような画面になるので、上の線で囲まれているコードを実行してください。

で、installしたら、composerの保存場所をhomebrewを保存してるディレクトリ（わかりやすくいうとファイル）に移動しときましょう。

$ mv composer.phar /usr/local/bin/composer

#5.PATHを通す
この後のvaltetのinstallを行う前に~/.composer/vendor/binにpathを通しておく必要があります。初学者の方はなにそれ？って思うでしょう。僕も思いました。

このことについてを詳しく書かれている記事があったので参照しときます。
PATHを通すとは？

まず、コマンド検索PATHに~/.composer/vendor/binが通っていなかを確認します。

$ echo $PATH
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

通っていないようなので、PATHを通していきます。

では、具体的にどうやってPATHを通すかというと、
~/.bashrcもしくは~/.bash_profileに記述します。
PATHを通すために環境変数の設定を理解する

そもそも~/.bashrcと~/.bash_profileってなに？というのは下記参照。
本当に正しい .bashrc と .bash_profile の使ひ分け

まずは、存在するのか下記コードで見てみましょう。

$ find ~/.bashrc
$ find ~/.bash_profile

もしある場合はその保存場所が表示されるはずです。
ない場合はこんな感じで表示されるはずです。

find: ./bash_profile: No such file or directory

多分最初はどちらもないと思うので、作ってしまいましょう。
今回はexportを使用するので~/.bash_profileが好ましいでしょう。

$ touch ~/.bash_profile

作成して、もう一度ファイルが存在するか、findで確かめてみましょう。存在していたら下記コードを.bash_profileファイルに書いてください。

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

よし、わかったやってみる!

......ごめんこのファイル、存在するはずなんだけど、全然見当たらない。どうやって編集するの？って多分なります。それもそのはずです。このファイルは隠しファイルになっていて、通常は開けないようになっています。じゃあ、どうやって編集するの？って思うでしょうが、方法は大きく分けて二つあります。

１つは隠しファイルを表示させる方法、
２つめはvimを使う方法です。

1つ目の隠しファイルを表示させる方法については下記を参照してください。
Mac - Finderで隠しファイル・フォルダを表示する方法

２つ目のvimを使う方法については、ここで解説しときましょう。vimとは高性能なテキストエディタです。自分のMacには標準搭載されてました。ない場合には入れる方法もあります。Vim初心者に捧ぐ実践的入門

vimの詳しい使い方は下記参照。
Vimの使い方 基本操作まとめ

まずvimを開きましょう。

$ vim

するとターミナルがこんな感じになります。

~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              

最初はちょっと戸惑いますが、大丈夫です。

:e ファイル名で、そのファイルを開くことができます。

:e ~/.bash_profile

すると、こんな感じになります。
下の方にファイル名、行数(L)、文字数（C）が加わりました。

~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
~                                                                              
"~/.bash_profile" 0L, 0C

これで編集できる画面には来たのですが、この段階ではノーマルモードなので編集ができません。そこでiを押して入力モードに変えます。入力モードに変わっていれば下記のように一番下が--INSERT--になっているはずです。このモードだと普通に編集ができます。ここにPATHを通すコードを書きます。

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

で、保存をする時なのですが、一度ノーマルモードに戻る必要があります。戻るにはescタブを押します。その後にZZコマンドを入力すると、変更を保存して終了します。$ vimを入力したところに戻るはずです。ファイルの内容の確認はcatでできます。しっかり保存されていれば下記のようになるはずです。

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

で、変更自体はできていることは確認しましたが、まだこのファイルの内容は適用されていない(ログイン時に読み込まれる)ので、即時適用します。ログインし直しても多分適用されます

$ source ~/.bash_profile

このコードを実行して、コマンド検索PATHを確認すると~/.composer/vendor/binにPATHが通っているはずです。

$ echo $PATH
/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/ユーザー名/.composer/vendor/bin

#6.Valetのinstall
正確にはLaravel Valretと言います。Macでlaravelを入れる方法は、ValetとHomestendがあるんですが、Valetの方が簡単に実装できるので、こちらでやっていきます。まず、下記のコードでinstallします。

$ composer global require laravel/valet

次に下記コマンドでValetが起動します。

$ valet install

zshを使ってる方はもしかしたら、
下記のようなエラーが出るかも。

Homebrew PHP appears not to be linked. 

そしたら下記の方法を実行してみてからinstallしてみてください。

$ brew link php@7.3 --force

正しくインストールされていれば下記の通りになるはずです。pingコマンドはネットワーク上にある特定のパソコンやホストに対して信号の送受信がしっかりできているか確認するものです。下記では、127.0.0.1というホストと通信していることが確認できます。因みにこのコマンドは終了しないとずっと続きます。終了はcontrolとcの同時押しです。

$ ping foobar.test
PING foobar.test (127.0.0.1): 56 data bytes
64 bytes from 127.0.0.1: icmp_seq=0 ttl=64 time=0.030 ms
64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.092 ms
64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.087 ms
64 bytes from 127.0.0.1: icmp_seq=3 ttl=64 time=0.096 ms
64 bytes from 127.0.0.1: icmp_seq=4 ttl=64 time=0.092 ms

下準備はここまでで完了です。
開発編では、実際にlaravelでアプリを作り、mysqlと繋げる方法について解説していきます。

#大まかな流れで参考にしたサイト
Laravel 5.8 Laravel Valet
MacでLaravel開発するならローカルの環境構築はValetもオススメ