
**Laradockを利用してDocker上にLaravel環境を構築する手順**です。
NginxとPHP7.3の環境にします。

※ 多少抜け漏れがあります。GW中には修正します。

## 環境とバージョン

- Laradock
- PHP 7.3
- Laravel 5.3
- Nginx

DBの接続はまだ書けていません。
作業環境がWindows10 Homeであるため、DockerはDocker Tool Boxを利用しています。

### 準備

gitとDocker、docker-composeを用意してください。

- 公式：[Docker CE](https://docs.docker.com/install/)

また、当サイトではDockerの環境の構築手順は以下の記事を用意しています。

- Windows 10 HomeまたはWindows 7の場合
  - [Windows10にDockerToolboxでDocker環境を構築する](https://www.suzu6.net/posts/85-windows-10-docker-toolbox)
- Windows 10 Proの場合
  - [Windows10にWSLで作った環境にdockerをインストールするまで](https://www.suzu6.net/posts/129-docker-compose-at-ubuntu)

## Laravelの環境構築

今回は`project`ディレクトリを作ってその中で作業します。
最終的なLaradockとLaravelのアプリ`MyApp`の構成は以下のようになります。

```sh
project/
 ├─ laradock
 |   ├─ nginx
 |   ├─ php-fpm
 |   └─ .env
 └─ MyApp
     ├─ public          # nginxで通すパス
     └─ composer.json   # 依存するパッケージを定義するためのファイル
```

### laradockをインストールする

laradockを導入していきます。

[laradock/laradock](https://github.com/Laradock/laradock)

```sh
# projectに移動してclone
$ cd path/to/project
project$ git clone https://github.com/Laradock/laradock.git

# 設定ファイルをリネームする
project$ cd laradock
laradock$ cp env-example .env
```

`project/laradock/.env`には、Docker Imageの設定が入っています。

### .envの設定とPHPのバージョン変更

NginxでPHPを動かすためphp-fpmを使います。理由は[こちら](https://qiita.com/kotarella1110/items/634f6fafeb33ae0f51dc)。

`project/laradock/.env`にあるPHPのバージョンを変更します。

```diff
### PHP Version ###########################################

# Select a PHP version of the Workspace and PHP-FPM containers (Does not MyApply to HHVM). Accepted values: 7.3 - 7.2 - 7.1 - 7.0 - 5.6
- PHP_VERSION=7.2
+ PHP_VERSION=7.3
```

バージョンを変更したので、php-fpmのイメージを作り直します。

```sh
laradock$ docker-compose build php-fpm
```

他のバージョンについてはこちら。

[Laradockでphpのバージョンを変更する](https://www.suzu6.net/posts/139-laradock-switch-php-version/)


### コンテナの作成と開始

必要なコンテナを立ち上げます。

```sh
laradock$ docker-compose up -d nginx mysql workspace
```

立ち上がっているコンテナを確認します。

```sh
laradock$ docker-compose ps
指定されたパスが見つかりません。
           Name                          Command              State                     Ports
---------------------------------------------------------------------------------------------------------------
laradock_docker-in-docker_1   dockerd-entrypoint.sh           Up       2375/tcp
laradock_mysql_1              docker-entrypoint.sh mysqld     Exit 3
laradock_nginx_1              /bin/bash /opt/startup.sh       Up       0.0.0.0:443->443/tcp, 0.0.0.0:80->80/tcp
laradock_php-fpm_1            docker-php-entrypoint php-fpm   Up       9000/tcp
laradock_workspace_1          /sbin/my_init                   Up       0.0.0.0:2222->22/tcp
```

php-fpmコンテナも一緒に立ち上がります。

※ mysqlコンテナが立ち上がっていないため、いつか修正する。

## Laravelのセットアップ

workspaceコンテナにLaravelをインストールしていきます。

### コンテナの準備

workspaceのコンテナに入って、Laravelをインストールする準備をします。
`docker-compose exec {コンテナ名} bash`で立ち上げているコンテナに入ることができます。

```sh
laradock$ docker-compose exec workspace bash
/var/www#
```

イメージのOSディストリビューションは**Ubuntu 16.04 LTS**でした。
インストーラー`apt-get`の更新と作業用の`vim`を入れておきます。

```sh
/var/www# apt-get update
/var/www# apt-get install vim
```

### Laravel 5.8のインストール

Laravelのプロジェクト**MyApp**を作る。

```sh
/var/www# mkdir MyApp
/var/www# ls
MyApp
```

composerは既に入っています。
Laravel 5.8をインストールします。

```sh
/var/www# composer create-project "laravel/laravel=5.8.*" MyApp

# 中を確認します。
/var/www# ls MyApp/
MyApp      bootstrap      composer.lock  database      phpunit.xml  readme.md  routes      storage  vendor
artisan  composer.json  config         package.json  public       resources  server.php  tests    webpack.mix.js
```

アプリケーションキーの作成と`.env`ファイルを作成します。

```sh
/var/www# cd MyApp/
/var/www/MyApp# cp -p .env.example .env
/var/www/MyApp# php artisan key:generate
```

続いて、ファイルアップロードの機能用にディレクトリの権限を変更します。

```sh
/var/www/MyApp# chmod 766 storage
/var/www/MyApp# chmod 766 bootstrap/cache
```

workspaceのコンテナの作業は終わりです。
コンテナから出ます。

```sh
/var/www# exit
```

### アプリケーションのパスを通す

`project/MyApp`にアプリケーションのパスを通します。

**docker-compose.yml**
```diff
      volumes:
-        - ${APP_CODE_PATH_HOST}:${APP_CODE_PATH_CONTAINER}${APP_CODE_CONTAINER_FLAG}
+        - ${APP_CODE_PATH_HOST}/MyApp:${APP_CODE_PATH_CONTAINER}${APP_CODE_CONTAINER_FLAG}
```

Nginxのルートに`MyApp/public`を通します。

**laradock/nginx/sites/default.conf**

```diff
- root /var/www/public;
+ root /var/www/MyApp/public;
```

コンテナを再起動する。
```sh
$ docker-compose restart
```

[http://localhost/](http://localhost/)を開いてLaravelの画面が出たら完了です。
お疲れ様でした。

## 参考

### 公式

- [Laravel 5.8 Installation](https://laravel.com/docs/5.8)
- [Laradock](https://laradock.io/)
- [Docker CE](https://docs.docker.com/install/)

### 記事

- [nginx と PHP-FPM の仕組みをちゃんと理解しながら PHP の実行環境を構築する](https://qiita.com/kotarella1110/items/634f6fafeb33ae0f51dc)
- [Laradockを使ったLaravel開発環境構築](https://qiita.com/J_Shell/items/695a30fd38444d065ae5)

### Laravelのおすすめ参考書

こちらの書籍でLaravelの全体像が分かりやすいです。
MVCの概念の説明から開発環境の構築、Laravelの基本的な機能について学べます。

[PHPフレームワーク Laravel入門](https://amzn.to/2JVDkzI)

<a href="https://www.amazon.co.jp/PHP%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF-Laravel%E5%85%A5%E9%96%80-%E6%8E%8C%E7%94%B0%E6%B4%A5%E8%80%B6%E4%B9%83-ebook/dp/B07CLLW4MX/ref=as_li_ss_il?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&keywords=php7&qid=1558422296&s=books&sr=1-10&linkCode=li2&tag=suzu60c-22&linkId=619adb9f2b17c0e2847db78ab33c8e81" target="_blank"><img border="0" src="//ws-fe.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=B07CLLW4MX&Format=_SL160_&ID=AsinImage&MarketPlace=JP&ServiceVersion=20070822&WS=1&tag=suzu60c-22" ></a><img src="https://ir-jp.amazon-adsystem.com/e/ir?t=suzu60c-22&l=li2&o=9&a=B07CLLW4MX" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />

- バージョン：Laravel 5.4
- OS：Windows, Mac OS対応

注意：HTML/CSSが解かる人向けです。基本からちょっと外れたこと（既存のDBを使う方法など）は載っていません。

LaradockでPHP 7.3のLaravel環境構築


**404 not found**が出たときの対処法。

## 現象

[Laradock](https://laradock.io/)でnginxを立ち上げてから確認すると「404 not found」のページが出た。

![404](/images/posts/138/404.png)

### フォルダ構成

プロジェクト直下にlaradockとpublicを置く構成。

```sh
project
 ├─ laradock
 |   ├─ nginx
 |   └─ .env
 └─ public
     └─ index.html
```

### 手順

```sh
$ cd path/to/project
$ git clone https://github.com/Laradock/laradock.git
$ cd laradock
$ cp env-example .env
```

**./laradock/.env**を修正する。
```diff
- APP_CODE_PATH_HOST=../
+ APP_CODE_PATH_HOST=../public/
```

[http://localhost](http://localhost)を開くと「404 Not Found」。

![404](/images/posts/138/404.png)

## 原因と対処

`APP_CODE_PATH_HOST`だけでなく`APP_CODE_PATH_CONTAINER`もパスを変更する。


**./laradock/.env**

```diff
- APP_CODE_PATH_HOST=../
+ APP_CODE_PATH_HOST=../public/

- APP_CODE_PATH_CONTAINER=/var/www/
+ APP_CODE_PATH_CONTAINER=/var/www/public/
```

nginxのコンテナの中で、コードは`/var/www/public/index.hml`にあったが、nginxは`/var/www/index.hml`を見ていた。

### Laravelのおすすめ参考書

こちらの書籍でLaravelの全体像が分かりやすいです。
MVCの概念の説明から開発環境の構築、Laravelの基本的な機能について学べます。

[PHPフレームワーク Laravel入門](https://amzn.to/2JVDkzI)

<a href="https://www.amazon.co.jp/PHP%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF-Laravel%E5%85%A5%E9%96%80-%E6%8E%8C%E7%94%B0%E6%B4%A5%E8%80%B6%E4%B9%83-ebook/dp/B07CLLW4MX/ref=as_li_ss_il?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&keywords=php7&qid=1558422296&s=books&sr=1-10&linkCode=li2&tag=suzu60c-22&linkId=619adb9f2b17c0e2847db78ab33c8e81" target="_blank"><img border="0" src="//ws-fe.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=B07CLLW4MX&Format=_SL160_&ID=AsinImage&MarketPlace=JP&ServiceVersion=20070822&WS=1&tag=suzu60c-22" ></a><img src="https://ir-jp.amazon-adsystem.com/e/ir?t=suzu60c-22&l=li2&o=9&a=B07CLLW4MX" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />

- バージョン：Laravel 5.4
- OS：Windows, Mac OS対応

注意：HTML/CSSが解かる人向けです。基本からちょっと外れたこと（既存のDBを使う方法など）は載っていません。

Laradock nginxでの404 not found


Laradockでphpのバージョンを変更する手順です。
デフォルトが`php 7.2`でしたので、`php 7.3`に変更しました。
`php-fpm`を利用しています。

現在対応しているバージョンは以下の通り。

- 7.3 
- 7.2
- 7.1
- 7.0
- 5.6

## ディレクトリと構成

プロジェクト直下にlaradockとpublicを置く構成。
[http://localhost/info.php](http://localhost/info.php)でphpのバージョンを確認できるようにしてある。

```sh
project
 ├─ laradock
 |   ├─ nginx
 |   ├─ php-fpm
 |   └─ .env
 └─ public
     ├─ index.html
     └─ info.php
```

`./public/info.php`

```php
<?php
phpinfo();
```

`./laradoc/.env`

**./laradock/.env**の変更点。`public`を表示するようにしている。

```diff
- APP_CODE_PATH_HOST=../
+ APP_CODE_PATH_HOST=../public/

- APP_CODE_PATH_CONTAINER=/var/www/
+ APP_CODE_PATH_CONTAINER=/var/www/public/
```

## phpのバージョン

デフォルトのphpのバージョンは**7.2**でした。

**./laradock/.env**

```sh
# Select a PHP version of the Workspace and PHP-FPM containers (Does not apply to HHVM). Accepted values: 7.3 - 7.2 - 7.1 - 7.0 - 5.6
PHP_VERSION=7.2
```

### バージョンの設定とbuild

バージョンの変更は設定を変え、buildします。

#### 1. `PHP_VERSION`を変更する

**./laradock/.env**

```diff
# Select a PHP version of the Workspace and PHP-FPM containers (Does not apply to HHVM). Accepted values: 7.3 - 7.2 - 7.1 - 7.0 - 5.6
- PHP_VERSION=7.2
+ PHP_VERSION=7.3
```

5.6, 7.0, 7.1, 7.2, 7.3に変更できます。マイナーバージョンは各最新のものです。

#### 2. php-fpmをbuildする

```sh
$ docker-compose build php-fpm
```

#### 3. phpinfo()を確認する

Nginxとworkspaceを立ち上げる。

```sh
$ docker-compose up -d nginx workspace
```

[http://localhost/info.php](http://localhost/info.php)でphpのバージョンを確認する。

![phpinfo](/images/posts/139/phpinfo.png)

出来た！

## 参考

[Change php version in laradock](https://medium.com/@abdulwahabcomsi/change-php-version-in-laradock-6bdb4722d26b)

バージョンを変更して立ち上げるシェルスクリプトを公開しています。

```sh
#!/bin/bash
version=$1
echo 'changing Php Version to '$1;
###change version in env file                        
sed -i '.bak' "s/PHP_VERSION=.../PHP_VERSION=$1/g" '.env'                                               
### Build fpm and cli for new version                       
docker-compose build php-fpm                       
docker-compose build workspace                                               
### Restart Container to use new version of php
docker-compose down                       
docker-compose up -d nginx mysql workspace redis
```

### Laravelのおすすめ参考書

こちらの書籍でLaravelの全体像が分かりやすいです。
MVCの概念の説明から開発環境の構築、Laravelの基本的な機能について学べます。

[PHPフレームワーク Laravel入門](https://amzn.to/2JVDkzI)

<a href="https://www.amazon.co.jp/PHP%E3%83%95%E3%83%AC%E3%83%BC%E3%83%A0%E3%83%AF%E3%83%BC%E3%82%AF-Laravel%E5%85%A5%E9%96%80-%E6%8E%8C%E7%94%B0%E6%B4%A5%E8%80%B6%E4%B9%83-ebook/dp/B07CLLW4MX/ref=as_li_ss_il?__mk_ja_JP=%E3%82%AB%E3%82%BF%E3%82%AB%E3%83%8A&keywords=php7&qid=1558422296&s=books&sr=1-10&linkCode=li2&tag=suzu60c-22&linkId=619adb9f2b17c0e2847db78ab33c8e81" target="_blank"><img border="0" src="//ws-fe.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=B07CLLW4MX&Format=_SL160_&ID=AsinImage&MarketPlace=JP&ServiceVersion=20070822&WS=1&tag=suzu60c-22" ></a><img src="https://ir-jp.amazon-adsystem.com/e/ir?t=suzu60c-22&l=li2&o=9&a=B07CLLW4MX" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />

- バージョン：Laravel 5.4
- OS：Windows, Mac OS対応

注意：HTML/CSSが解かる人向けです。基本からちょっと外れたこと（既存のDBを使う方法など）は載っていません。