macOSに Laravel 5.6 をインストールする手順をまとめてみる

# はじめに
最近盛り上がっていると噂のWebフレームワーク、```Laravel```をMacのローカル環境で動かすまでの手順です。

ネット記事を参考にしながらインストールを進めたのですが、
細かなコマンドの違いなどで結構手こずってしまったので作業メモにしました。


## この記事でインストールするもの
- ```Laravel 5.6.33```<br>今回導入するフレームワーク

- ```PHP 7.2.9```<br>Laravelを動かすのに必要な言語環境

- ```Composer 1.7.2```<br>Laravelをインストールする際に用いるパッケージ管理システム

## 今回の環境
- ``` macOS High Sierra 10.13``` <br><br>
- ```Homebrew 1.7.1```<br>
    - 今やHomebrewはMacでスタンダードなパッケージ管理システムなので、インストールしていない人は下記コマンドでサクッとインストールしちゃいましょう。

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

 **Homebrewについて参考**

 - [MacにHomebrewを導入する方法＆使い方まとめ | vdeep](http://vdeep.net/intr-homebrew)
 - [homebrewとは何者か。仕組みについて調べてみた - Qiita](https://qiita.com/omega999/items/6f65217b81ad3fffe7e6)

# 手順

Macには標準でPHPがインストールされていますが、
バージョンが古いことが多いため、Homebrewで最新のPHPをインストールします。
(今回はPHP 7.2をインストールすることを前提にしていますが、適宜新しいものに読み替えてください)

## 1. PHPのインストール

### HomebrewでPHPをインストール
- 下記のコマンドを実行して、PHPをインストールします。<br>

```bash:bash
$ brew install php@7.2
```

### PHPのパスを通す
 - インストールが終わったら、```~/.bash_profile```を編集して、下記の行を追記してください。

```bash:~/.bash_profile
export PATH="$(brew --prefix php@7.2)/bin:$PATH"
```

 **Pathを通すことにについて参考**

 - [macでPATHを通す方法 - Qiita](https://qiita.com/oratnek/items/eb8cdbd8eba9da388def)
 - [MacでPATHを通す - Qiita](https://qiita.com/nbkn/items/01a11392921119fa0153)

 編集を保存したら、下記コマンドを実行して最新の設定を反映させましょう。

```bash:bash
$ source ~/.bash_profile
```


### PHPのインストール確認

```php -v```コマンドを実行してください。
導入したPHPのバージョン(今回は7.2)が表示されていれば、PHPのインストールは成功です。

```bash:bash
$ php -v
PHP 7.2.9 (cli) (built: Aug 16 2018 21:40:59) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.2.9, Copyright (c) 1999-2018, by Zend Technologies
```



## 2. Composerのインストール
### HomebrewでComposerのインストール

```bash:bash
$ brew install composer
```

### Composerのインストール確認
下記コマンドでバージョン情報が表示されれば、Composerのインストールは完了です。

```bash:bash
$ composer -V
Composer version 1.7.2 2018-08-16 16:57:12
```

## 3. Laravelのインストール

### インストール
インストールしたComposerでlaravelをインストールします。

```bash:bash
$ composer global require "laravel/installer"
```

### Laravelのパスを通す

- 下記の行を```~/.bash_profile```に追記してください。

```bash:~/.bash_profile
export PATH="$PATH:$HOME/.composer/vendor/bin"
```

 - 下記コマンドで変更を反映します。

```bash:bash
$ source ~/.bash_profile
```

## 4. Laravelで新規のアプリを作ってみる

### 新規プロジェクトの作成

``` laravel new (任意のアプリケーション名)```コマンドで、新しいプロジェクトを作成してみます。
初回は読み込みに時間がかかるので、のんびり待ちましょう。

```bash:bash
$ laravel new test_app
Crafting application...
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Package operations: 70 installs, 0 updates, 0 removals
  - Installing doctrine/inflector (v1.3.0): Loading from cache
  - Installing doctrine/lexer (v1.0.1): Loading from cache
  - Installing dragonmantank/cron-expression (v2.2.0): Loading from cache
  - Installing erusev/parsedown (1.7.1): Loading from cache
  - Installing vlucas/phpdotenv (v2.5.1): Loading from cache
  - Installing symfony/css-selector (v4.1.3): Loading from cache
  - Installing tijsverkoyen/css-to-inline-styles (2.2.1): Loading from cache
  - Installing symfony/polyfill-php72 (v1.9.0): Loading from cache
  - 
  〜〜〜後略〜〜〜
```

### ※ laravelコマンドでエラーが出る場合の対処方法

```laravel new```コマンドでエラーがでるようなら、
下記のようにcomposerコマンド経由でプロジェクトを作成してください。

```bash:bash
$ composer create-project --prefer-dist laravel/laravel test_app
```

## 5. Laravelの動作確認

### アプリケーションサーバーの起動

作成したアプリケーションのディレクトリーに移動して、
```php artisan serve```コマンドを実行すれば、Webサーバーが起動します。

```bash:bash
$ cd test_app
$ php artisan serve
Laravel development server started: <http://127.0.0.1:8000>
```

### インストール確認
ブラウザーで[http://127.0.0.1:8000](http://127.0.0.1:8000)にアクセスし、
以下のようなトップページが表示されれば、Laravelのインストールは成功です！


<img width="680" alt="スクリーンショット 2018-08-19 14.20.13.png" src="https://qiita-image-store.s3.amazonaws.com/0/246845/7ab20bb4-1e57-726b-1a78-486baaa4fa9e.png">

# 参考サイト

以下のサイトを参考にさせて頂きました。

 - [インストール 5.6 Laravel](https://readouble.com/laravel/5.6/ja/installation.html)
 - [Mac OSにLaravelローカル開発環境構築 - Qiita](https://qiita.com/da-sugi/items/7ee7a458aad4209bab01)
 - [macOSでValetを使ってLaravel 5.5の開発環境を整える - Qiita](https://qiita.com/zeriyoshi/items/f995668d435d3c7a7d9d)
 - [HomebrewでPHP7.2を導入する](https://qiita.com/saken649/items/b5830de62211b600f7ee)
 - [Mac へ MySQL を Homebrew でインストールする手順 - Qiita](https://qiita.com/hkusu/items/cda3e8461e7a46ecf25d)