
migrateしたら`  SQLSTATE[HY000] [2006] MySQL server has gone away`が出ました。

結論としては、認証方式**mysql_native_password**を**caching_sha2_password**に変更したらMySQLに接続できるようになりました。環境と現象をまとめておきます。

## 環境
[こちら](https://www.suzu6.net/posts/254-laravel-docker-compose/)で構築したDocker環境でこの現象が起きました。

構成とバージョンはこのようになってます。アプリ(php)とDB(mysql)のコンテナは分かれています。
- php (php-fpm) 7.4.1
  - composer 1.10.13
  - nodejs v12.18.4
  - npm 6.14.6
- mysql 8.0
- nginx 1.19.2

docekr-compose.ymlの[mysql]()の記述。
```yml
version: '3'

略

  db:
    image: mysql:8.0
    container_name: db
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: database
      MYSQL_USER: docker
      MYSQL_PASSWORD: docker
      TZ: 'Asia/Tokyo'
    command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
    - ./docker/db/data:/var/lib/mysql
    - ./docker/db/my.cnf:/etc/mysql/conf.d/my.cnf
    - ./docker/db/sql:/docker-entrypoint-initdb.d
    ports:
    - 3306:3306
```
ここでデータベース、ユーザ、パスワードを設定しています。
ホストOSのSQLクライアント([HeidiSQL](https://www.heidisql.com/))からはDB接続を確認できた。

### エラー
```sh
# php artisan migrate

   Illuminate\Database\QueryException 

  SQLSTATE[HY000] [2006] MySQL server has gone away (SQL: select * from information_schema.tables where table_schema = database and table_name = migrations and table_type = 'BASE TABLE')

  at vendor/laravel/framework/src/Illuminate/Database/Connection.php:671
    667▕         // If an exception occurs when attempting to run a query, we'll format the error
    668▕         // message to include the bindings with SQL, which will make this exception a
    669▕         // lot more helpful to the developer instead of just the database's errors.
    670▕         catch (Exception $e) {
  ➜ 671▕             throw new QueryException(
    672▕                 $query, $this->prepareBindings($bindings), $e
    673▕             );
    674▕         }
    675▕ 

      +37 vendor frames
  38  artisan:37
      Illuminate\Foundation\Console\Kernel::handle(Object(Symfony\Component\Console\Input\ArgvInput), Object(Symfony\Component\Console\Output\ConsoleOutput))
```

一応試した、`composer dumpautoload`や`php artisan config:clear`では解消できなかった。

### mysqlのユーザを確認
dbコンテナでmysqlのユーザを確認する。
```sh
$ docker-compose exec db bash

# mysql -u root -p
mysql: [Warning] World-writable config file '/etc/mysql/conf.d/my.cnf' is ignored.
Enter password: 

mysql> SELECT user, host, plugin FROM mysql.user;
+------------------+-----------+-----------------------+
| user             | host      | plugin                |
+------------------+-----------+-----------------------+
| docker           | %         | mysql_native_password |
| root             | %         | mysql_native_password |
| mysql.infoschema | localhost | caching_sha2_password |
| mysql.session    | localhost | mysql_native_password |
| mysql.sys        | localhost | caching_sha2_password |
| root             | localhost | mysql_native_password |
+------------------+-----------+-----------------------+
```
dockerとrootがあり、それぞれhostが%になっているためコンテナの外からもアクセスできる。（localhostはローカルだけ）

pluginが認証方式で`mysql_native_password`になっている。
`caching_sha2_password`はmysql8.0から追加された認証方式で、デフォルトである。

Dockerでビルドした際に5.7までの`mysql_native_password`に切り替わったようです。

### 認証方式の変更
`ALTER USER '{ユーザ名}'@'{ホスト}' IDENTIFIED WITH {認証方式} BY '{パスワード}';`で変更できる。
```sh
mysql> ALTER USER 'docker'@'%' IDENTIFIED WITH mysql_native_password BY 'docker';
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT user, host, plugin FROM mysql.user;
+------------------+-----------+-----------------------+
| user             | host      | plugin                |
+------------------+-----------+-----------------------+
| docker           | %         | caching_sha2_password |
| root             | %         | mysql_native_password |
| mysql.infoschema | localhost | caching_sha2_password |
| mysql.session    | localhost | mysql_native_password |
| mysql.sys        | localhost | caching_sha2_password |
| root             | localhost | mysql_native_password |
+------------------+-----------+-----------------------+
```

`caching_sha2_password`に変更すると、接続できた！

```sh
$ php artisan migrate
Migration table created successfully.
...
```

### なぜ認証方式によっては接続できないのか？

PHPのバージョンによって対応する方式が異なる。

MySQL8.0が登場する以前のPHPは、`caching_sha2_password`に対応していない。
> PHP 7.1.16 より前のバージョン、もしくは PHP 7.2.4 より前の 7.2系の PHP では、 MySQL 8 サーバのデフォルトパスワードプラグインを mysql_native_password に設定するようにしてください。
> 
> http://0-oo.net/php-manual/ref.pdo-mysql.html

今回はPHP 7.4.1のpdo_mysqlを使っているためこれはOK。
しかし、なぜか認証方式`caching_sha2_password`にする必要がある。

### laravel
```env
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=database
DB_USERNAME=docker
DB_PASSWORD=docker
```

## その他考慮したことと確認方法

### pdo_mysqlがインストールできていないのでは？
phpコンテナのDockerfileの記述。
ビルドの際にpdo_mysqlをインストールしている。
```Dockerfile
# Install PHP Extensions
RUN apt install -y zlib1g-dev mariadb-client libzip-dev libonig-dev
RUN docker-php-ext-install -j$(nproc) zip pdo_mysql
```

pdo_mysqlがインストールできているか確認した。
拡張を有効にするコマンド`docker-php-ext-enable`を打ってみる。
```sh
$ docker-php-ext-enable pdo_mysql

warning: pdo_mysql (pdo_mysql.so) is already loaded!
```
インストール済で有効になっていました。

```sh
$ pecl search pdo_mysql
WARNING: channel "pecl.php.net" has updated its protocols, use "pecl channel-update pecl.php.net" to update
Retrieving data...0%
Matched packages, channel pecl.php.net:
=======================================
Package   Stable/(Latest) Local
PDO_MYSQL 1.0.2 (stable)        MySQL driver for PDO
```


mysql8とlaravel(php7.4 pdo_mysql)でSQLSTATE[HY000] [2006] MySQL server has gone away


## bash: laravel: command not found

[Laravel 8.x インストール | readouble.com](https://readouble.com/laravel/8.x/ja/installation.html)

Laravelインストーラをダウンロードしたが、`laravel new`コマンドで`bash: laravel: command not found`と出た。

```sh
$ composer global require laravel/installer
...
$ laravel new laravel
bash: laravel: command not found
```

`∼/.composer/vendor/bin`のパスを通す必要があるようです。[stackoverflow](https://stackoverflow.com/questions/35211862/laravel-command-not-found/35213546)

```sh
# パス追加
$ export PATH="$PATH:$HOME/.composer/vendor/bin"

# 確認 /root/.composer/vendor/bin
$ echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/root/.composer/vendor/bin

$ laravel new laravel

 _                               _
| |                             | |
| |     __ _ _ __ __ ___   _____| |
| |    / _` | '__/ _` \ \ / / _ \ |
| |___| (_| | | | (_| |\ V /  __/ |
|______\__,_|_|  \__,_| \_/ \___|_|
...
```


## 関連記事
- [Laravel + Nginx + MySQLのDocker開発環境](https://www.suzu6.net/posts/254-laravel-docker-compose/)

laravel newコマンドでbash:laravel:command not found


Laravel向けのDocker開発環境を整えたので共有します。

本番でもDockerが使えるように色々試しているとこですので、自分が把握できた範囲の構成です。

[github](https://github.com/suzu6/docker-laravel-nginx-php-fpm-mysql)に置いときます。

## 目標とミドルウェアの構成

目標はDockerを立ち上げて直ぐにLaravelの開発ができるようにすること。composerとnodejsも一緒に用意します。

構成とバージョン。最新になるようにしています。
- php (php-fpm) 7.4.1
  - composer 1.10.13
  - nodejs v12.18.4
  - npm 6.14.6
- mysql 8.0 (5.7も可能)
  - パスワードなど初期設定をする。
- nginx 1.19.2
  - Laravel向けのconfを用意する。

### ホスト環境
今回の趣旨に関係ありませんが、ホストOSはWindows10です。

- Windows 10 Home バージョン2004(OSビルド 19041.508)
- WSL2 (Ubuntu 20.04.1 LTS)
- Docker version 19.03.13, build 4484c46d9d
- docker-compose version 1.27.4, build 40524192

WSL2が出てWindows HomeでもDockerが使えるようになりました。
インストール方法は[Microsoftの手順](https://docs.microsoft.com/en-us/windows/wsl/install-win10#install-your-linux-distribution-of-choice)を解説した[Qiita @KoKeCross](https://qiita.com/KoKeCross/items/a6365af2594a102a817b)の記事の通り進めて行けばOKです。

### ディレクトリ構成 
```dir
/project
├─ /docker    # コンテナ内のデータ保存先
|  ├─ /db
|  |  ├─ /data           # データベース保存先
|  |  ├─ /sql
|  |  └─ /my.conf        # mysqlの設定(今回は空ファイル)
|  ├─ /nginx
|  |  └─ /default.conf   # Nginxの設定
|  └─ /php
|     ├─ /Dockerfile     # phpコンテナの設定
|     └─ /php.ini        # phpの設定
├─ /web       # アプリケーションコード
└─ docker-compose.yml
```

#### docker-compose.yml
php, nginx, dbのコンテナを作ります。mysqlはdb。

```yml
version: '3'

volumes:
  vendor-store:
  node_modules-store:

services:
  php:
    container_name: php
    build: ./docker/php
    volumes:
    - ./web:/var/www
    - vendor-store:/var/www/laravel/vendor
    - node_modules-store:/var/www/laravel/node_modules
    environment:
      TZ: Asia/Tokyo

  nginx:
    image: nginx
    container_name: nginx
    ports:
    - 80:80
    volumes:
    - ./web:/var/www
    - ./docker/nginx/default.conf:/etc/nginx/conf.d/default.conf
    depends_on:
    - php

  db:
    image: mysql:8.0
    container_name: db
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: database
      MYSQL_USER: docker
      MYSQL_PASSWORD: docker
      TZ: 'Asia/Tokyo'
    command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
    - ./docker/db/data:/var/lib/mysql
    - ./docker/db/my.cnf:/etc/mysql/conf.d/my.cnf
    - ./docker/db/sql:/docker-entrypoint-initdb.d
    ports:
    - 3306:3306
```

**image**は[Docker-Hub](https://hub.docker.com/)にあるビルド済みイメージを指定している。
有名なミドルウェアは公式のものがあります。
phpコンテナはNodejsやcomposerをインストールするため、Dockerfileからビルドします。

**volumes**はホストとコンテナのディレクトリとファイルを同期する。
ホストの`/web`をphp・nginxコンテナのエントリーポイント`/var/www`に指定しました。
Laravelプロジェクトは`/web`にクローンするか、phpコンテナの`/var/www`で新規作成して開発が可能です。

vendorとnode_modulesは名前付きボリュームに格納して、ホスト側とコンテナ側と分離して管理している。
同期処理が発生しないため、その分速くなる。

dbの**environment**に初期設定を渡せる。
これを.envに書いたり、ホストのSQLクライアントの接続にそのまま使えます。
その他の変数は[dockerhub mysql](https://hub.docker.com/_/mysql/)でご確認ください。

`mysql:8.0`を`mysql:5.7`にしても動作確認とれた。

#### php/Dockerfile
```Dockerfile
FROM php:7.4.1-fpm

COPY php.ini /usr/local/etc/php/

RUN apt update
RUN apt install -y wget git unzip libpq-dev

# Install Node.js 12
RUN apt install -y npm \
  && npm install n -g \
  && n 12

# Install PHP Extensions
RUN apt install -y zlib1g-dev mariadb-client libzip-dev libonig-dev \
  && docker-php-ext-install zip pdo_mysql

# Install Composer
RUN curl -sS https://getcomposer.org/installer | php \
  && mv composer.phar /usr/local/bin/composer \
  && composer self-update

WORKDIR /var/www

# php-fpmはデフォルトのユーザwww-dataで動く。https://stackoverflow.com/questions/48619445/permission-denied-error-using-laravel-docker
# 変更する場合は /usr/local/etc/php-fpm.d/www.conf でユーザー名を変える。
RUN chown -R www-data:www-data /var/www

RUN composer global require "laravel/installer"
```
`php:7.4.1-fpm`のイメージにNode.jsやComposerをインストールしていくDockerfileです。

aptだとNodejsは古いため、パッケージマネージャのnで新しいバージョンをインストールしています。
以下のようにスクリプトでインストールする方法もあります。
```Dockerfile
# Install Node.js 12
RUN curl -sL https://deb.nodesource.com/setup_12.x | bash - \
 && apt install -y nodejs
```

php 7.4ではビルド時にonigumaが見つからないとエラーが出ます。
aptでは`libonig-dev`（library onigumaかな?）をインストールすると回避できる。
[参考1](https://www.limstash.com/en/articles/202002/1539),[参考2](https://qiita.com/wolf25/items/74bb98bb3052de4c324d)

必要な拡張は**docker-php-ext-install**に追加していく。

nginxはphp-fpmを通してLaravelを実行します。
`/var/www`以下のファイルにユーザ**www-data**の実行権限を与えます。
www-dataはphp-fpmのデフォルトユーザです。
`/usr/local/etc/php-fpm.d/www.conf`を修正してユーザ名を変更できます。

[dockerhub php](https://hub.docker.com/_/php/)

#### /php/php.ini
```conf
[Date]
date.timezone = "Asia/Tokyo"
[mbstring]
mbstring.internal_encoding = "UTF-8"
mbstring.language = "Japanese"
```
cliもfpmのphpもこの設定を参照します。

#### /nginx/default.conf

```js
server {
  listen 80;
  // root /var/www/{Laravelプロジェクト名}/public;
  root /var/www/laravel/public;

  add_header X-Frame-Options "SAMEORIGIN";
  add_header X-XSS-Protection "1; mode=block";
  add_header X-Content-Type-Options "nosniff";

  index index.php;
  charset utf-8;

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }

  location = /favicon.ico { access_log off; log_not_found off; }
  location = /robots.txt  { access_log off; log_not_found off; }

  error_page 404 /index.php;

  // phpファイルはfastcgi(=php-fpm)で処理するよって書いてある
  location ~ \.php$ {
    try_files $uri =404;
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    // ホスト名(=コンテナ名):ポート
    fastcgi_pass php:9000;
    fastcgi_index index.php;
    include fastcgi_params;
      fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      fastcgi_param PATH_INFO $fastcgi_path_info;
  }
  location ~ /\.(?!well-known).* {
      deny all;
  }
 }
```

LaravelをNginxで動作させる設定です。
ApacheではLaravel同梱の.htaccessが設定してくれるが、Nginxでは.htaccessに当たるものがないためNginxのconfを修正する必要がある。（[.htaccessを極力使わないほうがいい](https://www.suzu6.net/posts/240-htaccess-apache-vs-nginx/)）

公式の設定[Nginx | laravel.com](https://laravel.com/docs/8.x/deployment#nginx)からphpコンテナのfpmを見るよう修正しています。
ネットワークはDockerに管理されており、ホスト名はコンテナ名と同等です。

ドキュメントルートを`/var/www/laravel/public`としています。
**プロジェクト名が変わるときはパスに注意。**

### docker-composeのコマンド
ホスト側でよく使うコマンドです。
```sh
# コンテナ起動
$ docker-compose up -d

# コンテナ削除
$ docker-compose down

# コンテナ、イメージ、ボリューム、ネットワークを一括完全消去
$ docker-compose down --rmi all --volumes

# phpコンテナに接続する（コンテナ名を変えて他のコンテナに接続できる）
$ docker-compose exec php bash
```
Dockerfileなど修正した場合は一括削除してから起動しなおすといい。

初回は[Laravel 8.x インストール](https://readouble.com/laravel/8.x/ja/installation.html)に従ってphpコンテナ内で作業するとプロジェクトを作成できます。
ログの書き込みなどで**permission denined**が出る場合は、`# chown -R www-data:www-data /var/www`を実行するとphp-fpmに権限が与えられて解消できます。（php-fpmユーザを変更した場合はそのユーザ名にする）

## 参考
#### DockerFile
- [Dockerを使ってLaravel開発環境構築](https://qiita.com/A-Kira/items/1c55ef689c0f91420e81)
- [Vue + Vue Router + Vuex + Laravelで写真共有アプリを作ろう (3) SPA開発環境とVue Router](https://www.hypertextcandy.com/vue-laravel-tutorial-setting-up-spa-project)

#### Dockerの操作
- [《滅びの呪文》Docker Composeで作ったコンテナ、イメージ、ボリューム、ネットワークを一括完全消去する便利コマンド](https://qiita.com/suin/items/19d65e191b96a0079417)

#### 書籍

<a href="https://www.amazon.co.jp/Docker%E5%AE%9F%E8%B7%B5%E3%82%AC%E3%82%A4%E3%83%89-%E7%AC%AC2%E7%89%88-impress-top-gear/dp/4295005525/ref=as_li_ss_il?adgrpid=52005894183&dchild=1&gclid=Cj0KCQjw5eX7BRDQARIsAMhYLP8Pg6ptqJp0zP8yZpQrHoRPGCvfYg0lpWHE5LbbLbrGj46tbiogBgAaAm5SEALw_wcB&hvadid=338517973140&hvdev=c&hvlocphy=1009414&hvnetw=g&hvqmt=e&hvrand=7690341243257993499&hvtargid=kwd-333055296139&hydadcr=27265_11561134&jp-ad-ap=0&keywords=docker%E5%AE%9F%E8%B7%B5%E3%82%AC%E3%82%A4%E3%83%89&qid=1601855634&sr=8-2&linkCode=li2&tag=suzu60c-22&linkId=090fb950c12f16b36c5148d8e6ea363e&language=ja_JP" target="_blank"><img border="0" src="//ws-fe.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=4295005525&Format=_SL160_&ID=AsinImage&MarketPlace=JP&ServiceVersion=20070822&WS=1&tag=suzu60c-22&language=ja_JP" ></a><img src="https://ir-jp.amazon-adsystem.com/e/ir?t=suzu60c-22&language=ja_JP&l=li2&o=9&a=4295005525" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />

[Docker実践ガイド 第2版 | amazon](https://amzn.to/30w5x7w)

Dockerって何？の状態で読むと難しすぎたが、Dockerの概念を他で学び試して遊んでからわかるようになった。
Dockerの運用管理向け、業務で何度も読み返しそうな良著。


Laravel + Nginx + MySQLのDocker開発環境を共有します


WSL2を導入してとうとうDockerが使えるようになりました！
[この記事](https://qiita.com/A-Kira/items/1c55ef689c0f91420e81)に沿ってLaravelの開発環境を作っているところです。

Laravelが動くコンテナからDBのコンテナに接続するホスト名がわからなかったのでメモします。
結論としては**コンテナ間通信はコンテナ名を使用することでできます**。

---
2021/11/16 追記

WindowsでのDocker環境の構築方法は次の記事にまとめました。

[WSL2とDocker Desktop on WindowsでDocker環境を構築する](https://www.suzu6.net/posts/337-windows11-docker-desktop-wsl2)

---

### 環境

- Windows 10 Home x64 
  - OS ビルド: 19041.450
- Docker version 19.03.12
- docker-compose version 1.26.2

`docker-compose.yml`と手順は[こちら](https://qiita.com/A-Kira/items/1c55ef689c0f91420e81)を参考にしました。
これでMySQLとphpが動くコンテナができます。

```yml
version: '3'

services:
  php:
    container_name: php
    build: ./docker/php
    volumes:
    - ./server:/var/www

  db:
    image: mysql:5.7
    container_name: db-host
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: laravel
      MYSQL_USER: docker
      MYSQL_PASSWORD: docker
      TZ: 'Asia/Tokyo'
    command: mysqld --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
    - ./docker/db/data:/var/lib/mysql
    - ./docker/db/my.cnf:/etc/mysql/conf.d/my.cnf
    - ./docker/db/sql:/docker-entrypoint-initdb.d
    ports:
    - 3306:3306
```

### ローカルPCからmysqlに接続する

`db`のポートフォワーディングを3306にしているため、ローカルPCのSQLクライアントからは
- host: localhost (or 127.0.0.1)
- port: 3306
で接続できました。

### phpコンテナからmysqlに接続する

ローカルPCからと同じくlocalhostでポートを指定すれば接続できるのかと勘違いしてました。
Dockerでは**Dockerネットワークを作成してコンテナ名で通信が可能**なようです。

詳しいことは[こちら](https://knowledge.sakura.ad.jp/16082/)を見てください。
あまり理解できてないです…

Dockerネットワークを確認する`docker network ls`をローカルPCで実行した結果です。
この中の`laradoc_default`が名前解決しているっぽいです。
```sh
>docker network ls                       
NETWORK ID          NAME                   DRIVER              SCOPE
f26fe47a0096        bridge                 bridge              local
8b3e919809cd        host                   host                local
ca6f7a9282e5        laradoc_default        bridge              local
3f97d25e5c4a        none                   null                local
```

dbのコンテナの`/etc/hosts`を見てみるとこうなっている。
```sh
root@728c68c615ef:/var/www/laravel# cat /etc/hosts
127.0.0.1       localhost
::1     localhost ip6-localhost ip6-loopback
fe00::0 ip6-localnet
ff00::0 ip6-mcastprefix
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters
172.19.0.2      728c68c615ef
```


### phpコンテナからmysqlに接続する

phpコンテナの.envは以下の設定で接続できました。
`DB_HOST`をコンテナ名にしてあります。
```conf
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=docker
DB_PASSWORD=docker
```
rootではなくユーザdockerに権限を与える`GRANT ALL ON laravel.* TO docker;`を実行してあります。

Dockerの仕組みの知識がふわふわしてるので勉強しないと。
とりあえず、ローカル開発環境は作ることができた。

## 参考

- [Docker入門（第五回）〜コンテナ間通信〜 - さくらのナレッジ](https://knowledge.sakura.ad.jp/16082/)
  - 参考にした記事。


DockerでのLaravel .envの設定。コンテナ間通信はホスト名＝コンテナ名でした


LaravelのUserモデルは`app/User.php`にある。
Artisanコマンドで追加したモデルも`app/`に作られていき収拾がつかなくなっていく。
整頓のため`app/Models/`ディレクトリを作って、そこにモデルを置くよう構成を変更していきます。

モデルが増えてから変更するのは大変なため、早めに構成を決めておいたほうが良いです。

## 環境

- Laravel 7.27.0

バージョン 5.x も同様な設定で可能かと。

## Userモデルを移動する

まずは`app/Models/`ディレクトリを作って、そこにUserモデルを移動します。
移動後に名前空間をパスに合わせ変更します。
変更するファイルは`app/User.php`だけでなく`auth.php`と`UserFactory.php`もです。

`app/User.php`は`app/Models/User.php`に移動させ、名前空間を変更する。
```diff
<php

-- namespace App;
++ namespace App/Models;
```

`config/auth.php`
```diff
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
--          'model' => App\User::class,
++          'model' => App\Models\User::class,
        ],
```

`database/factories/UserFactory.php`
```diff
<?php

/** @var \Illuminate\Database\Eloquent\Factory $factory */

-- use App\User
++ use App\Models\User
use Faker\Generator as Faker;
use Illuminate\Support\Str;
```

### キャッシュをクリアする

モデルのディレクトリを変更したらキャッシュをクリアします。

```sh
$ composer dump-autoload
$ php artisan cache:clear
$ php artisan config:clear
```

## モデルの生成先ディレクトリを指定する

artisanコマンドで生成する際にはモデルのディレクトリを指定できます。
```sh
# app/Hoge.phpができる 
$ php artisan make:model Hoge

# app/Models/Hoge.phpができる 
$ php artisan make:model Models/Hoge
```

こんな感じでモデルのディレクトリ構成を変更できます。

## 参考

- [【Laravel】Modelsのディレクトリをapp配下に作る時の注意点](https://tech.adseed.co.jp/Laravel)
  - 参考にした記事。
- [モデルの生成先ディレクトリ - ララ帳](https://laravel10.wordpress.com/2015/04/09/%E3%83%A2%E3%83%87%E3%83%AB%E3%81%AE%E7%94%9F%E6%88%90%E5%85%88%E3%83%87%E3%82%A3%E3%83%AC%E3%82%AF%E3%83%88%E3%83%AA/)

LaravelのModelsのディレクトリ構成を変更する


LaravelでガラケーのWEBページに対応した際のコードです。
middlewareでUserAgentを判別し、それを基にControllerでガラケー用のViewに切り替えました。
docomo, SoftBank, auの３キャリアに応じた`DOCTYPE`にします。

## 環境

- Laravel 6.x
- php 7.3

## ガラケーのUserAgentを判定するmiddleware

ガラケーのUserAgentを判定するmiddlewareを作ります。
PC/スマホとガラケーのViewの切り替えはControllerでおこなうため、判定結果をControllerに渡します。

middleware `SupportFeaturephone` を作成する。（名前は何でもいい）

```sh
$ php artisan make:middleware SupportFeaturephone
```

SupportFeaturephone.php

```php
<?php

namespace App\Http\Middleware;

use Closure;

class SupportFeaturephone
{
    public function handle($request, Closure $next)
    {
        $user_agent = $request->userAgent();
        // $requestにキャリアの文字列を渡す
        $request->merge([
            'mobile_carrier' => $this->checkMobileCarrier($user_agent),
        ]);

        return $next($request);
    }

    private function checkMobileCarrier($user_agent)
    {
        if ($this->isDocomo($user_agent)) return "Docomo";
        if ($this->isSoftbank($user_agent)) return "Softbank";
        if ($this->isKDDI($user_agent)) return "KDDI";
        // スマホ・PCのブラウザ
        return null;
    }

    private function isDocomo($user_agent)
    {
        return preg_match("/^DoCoMo/i", $user_agent);
    }

    private function isSoftbank($user_agent)
    {
        return preg_match("/^(J\-PHONE|Vodafone|MOT\-[CV]|SoftBank)/i", $user_agent);
    }

    private function isKDDI($user_agent)
    {
        return preg_match("/^KDDI\-/i", $user_agent);
    }
}
```

$request->merge($arg);`でControllerに変数を渡せます。
（[Illuminate/Http/Request.phpの310行目](https://github.com/laravel/framework/blob/6.x/src/Illuminate/Http/Request.php)）

ガラケーのUserAgentの正規表現は以下を参考に作りました。

- [スマートフォン・携帯のユーザーエージェント](https://htaccess.cman.jp/useragent/smartphone/)
- [userAgent（ユーザーエージェント一覧）](http://www.openspc2.org/userAgent/)
  - ガラケーのUserAgentのまとめは、恐らくここが一番詳しい。無くなっていた場合は[魚拓](https://megalodon.jp/2020-0420-1237-17/www.openspc2.org/userAgent/)にあります。

## ControllerとView
ControllerでPC/スマホとガラケーのViewの切り替える。
ガラケーのViewで３つのキャリアに応じた`DOCTYPE`にします。

### Controller
```php
class IndexController extends Controller
{

      public function index(Request $request)
      {
          // ガラケーのページ
          if (isset($request->mobile_carrier)) {
              return view('m.index')->with([
                  'mobile_carrier' => $request->mobile_carrier,
              ]);
          }
          // PC/スマホのページ
          return view('index');
      }
}
```

### View

```sh
.
├── m
│   ├── index.blade.php # ガラケー用
└── index.blade.php     # PC/スマホ
```

```HTML
@if($mobile_carrier == "Docomo")
{{-- Docomo --}}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//JPHONE//DTD XHTML Basic 1.0 Plus//EN" "xhtml-basic10-plus.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja">
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8" />

@elseif($mobile_carrier == "KDDI")
{{-- KDDI --}}
<?xml version="1.0" encoding="Shift_JIS"?>
<!DOCTYPE html PUBLIC "-//OPENWAVE//DTD XHTML 1.0//EN" "http://www.openwave.com/DTD/xhtml-basic.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja">
<head>
<meta http-equiv="content-type" content="text/html;charset=Shift_JIS" />

@else
{{-- 【softbank】 --}}
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//i-mode group (ja)//DTD XHTML i-XHTML(Locale/Ver.=ja/1.1) 1.0//EN" "i-xhtml_4ja_10.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja">
<head>
<meta http-equiv="content-type" content="text/html;charset=utf-8" />
@endif

</head>
```

ガラケーのHTMLの参考: [ゼロから始めるガラケーコーディング DOCTYPEとCSS編](https://html-coding.co.jp/knowhow/tips/000284/)


【Laravel】UserAgentでガラケー用のViewを切り替えるためのmiddleware



この記事では`.htaccess`の設定内容を解説していきます。

## Laravelの.htaccessについて

Laravelのプロジェクトにアクセスがあると`public/index.php`を経由して`route`に振り分けられます。
その時、URIが画像やCSSなどpubilicディレクトリに存在するファイルを指している時はそのファイルを返し、それ以外は`route`に設定したページが返るような制御が行われています。
この制御部分を設定しているのが`public/.htaccess`です。

```sh
<IfModule mod_rewrite.c>
    <IfModule mod_negotiation.c>
        Options -MultiViews -Indexes
    </IfModule>

    RewriteEngine On

    # Handle Authorization Header
    RewriteCond %{HTTP:Authorization} .
    RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

    # Redirect Trailing Slashes If Not A Folder...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_URI} (.+)/$
    RewriteRule ^ %1 [L,R=301]

    # Send Requests To Front Controller...
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>
```
[Laravel github .htaccess](https://github.com/laravel/laravel/blob/master/public/.htaccess)

### mod_rewrite
`mod_rewrite`はPCRE正規表現パーサーに基づくルールベースの書き換えエンジンです。
アクセスしてきたURLやヘッダーを書き換えたり、リダイレクトしたりする機能です。
`RewriteEngine On`はこの機能を有効にします。
あとで説明しますが`RewriteCond`は条件を示し、それに合うものが`RewriteRule`によって書き換えられます。

[Apache Module mod_rewrite | httpd.apache.org](https://httpd.apache.org/docs/2.4/en/mod/mod_rewrite.html)

### mod_negotiation

`mod_negotiation`はURIと合うディレクトリ内のファイルを探して選択する機能です。
２つのオプションに`-`が付いており、それらの機能をオフにしています。

- [Multiviews](https://httpd.apache.org/docs/2.4/mod/mod_negotiation.html#multiviews)は、受け取ったURIのファイルがないときファイル拡張子を賢く探してくれるもの。
例えばURIに`/path/dir/foo`ときて`foo`が無かったら、`foo.*`となるファイルを探します。
- [Indexes](https://httpd.apache.org/docs/2.4/mod/core.html#options)はURLがディレクトリにマップするリクエストであって、 且つ`DirectoryIndex`で指定したファイルが ディレクトリ内に無ければ、ディレクトリ内の一覧を整形して返します。

`public/bar/index.html`みたいなHTMLやphpファイルがあるときに`/bar/`で返したいときは、`DirectoryIndex index.html index.php`の設定で可能です。
移行中や静的なページがある案件だとたまに設定します。

## RewriteCondとRewriteRule
細かく見ていく前に`RewriteCond`と`RewriteRule`について説明します。

`RewriteCond`はif文の条件みたいなもので、`RewriteCond <条件> [flags]`といった書き方です。
条件は正規表現で表します。
`RewriteCond`を続けて書くと`AND`になり、オプションに`[OR]`が付くと`OR`です。

`RewriteRule`は文字列を置換します。
書き方は`RewriteRule <検索文字列> <置換文字列> [flags]`です。

また、どちらも予約語があり`%{REQUEST_URI}`, `%{HTTP_USER_AGENT}`といったように使うことができます。

[mod_rewrite - Apache HTTP Server Version 2.4](https://www.google.com/search?q=RewriteRule&oq=RewriteRule&aqs=chrome..69i57j0l5j69i61l2.973j0j4&sourceid=chrome&ie=UTF-8)

### Handle Authorization Header
```conf
# Handle Authorization Header
RewriteCond %{HTTP:Authorization} .
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
```
HTTPヘッダーのAuthorizationを環境変数に代入しています。
`[E=foo:value]`とすると環境変数`foo`に値`value`を入れます。

[E|env](https://httpd.apache.org/docs/2.4/rewrite/flags.html#flag_e)の例をみると、画像ファイルのリクエストかどうかログに残したい場合にこのように書きます。
```conf
RewriteRule "\.(png|gif|jpg)$" "-" [E=image:1]
CustomLog "logs/access_log" combined env=!image
```

ただ、環境変数`HTTP_AUTHORIZATION`にいれるとアプリケーション側で利用できるのでしょうか？
末尾に乗せるNginxの書き方では書いていないようですので謎。
分かり次第追記します。

### Redirect Trailing Slashes If Not A Folder...
```conf
# Redirect Trailing Slashes If Not A Folder...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} (.+)/$
RewriteRule ^ %1 [L,R=301]
```
LaravelのDocumentootは`public`に向けます。
ここでは、(1行目)URIが`public`配下に実在するディレクトリを指しておらず、(2行目)URIの末尾にスラッシュがついていたら、(3行目)末尾のスラッシュを取ったURIへリダイレクトします。
オプション`-d`はディレクトリかどうかで`!`で反対を意味するためディレクトリじゃない場合となります。
`RewriteRule`の`%1`は、２行目の`RewriteCond`のかっこの中の文字列を指しています。

`[L,R=301]`は`L`がLastを表しこれ以降のRiwrite処理を行わない、`R`がRidirectでHTTPステータス301でリダイレクトするという意味になります。

まとめると、URIが`/foo/bar/`で`public/foo/bar/`ディレクトリがない場合は`/foo/bar`にリダイレクトします。

### Send Requests To Front Controller...
```conf
# Send Requests To Front Controller...
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]
```
ここも先ほどと似ています。
`!-d`は`public`配下にURIのディレクトリがない、かつ、`!-f`ファイルもない場合です。
その場合、`public/index.php`を実行します。

## おまけ：Nginxではどう書くのか？

Nginxでは`.htaccess`のようにディレクトリごとに設定ファイルがあることを認めていません。
そのため`.htaccess`は無く、Laravelのプロジェクトでは[Deployment #nginx | laravel.com](https://laravel.com/docs/7.x/deployment#nginx)にあるように設定をする必要があります。

```conf
## .htaccessのリダイレクト設定に似た箇所を抜粋
index index.html index.htm index.php;

location / {
    try_files $uri $uri/ /index.php?$query_string;
}
```

Nginxの方が後に出ただけあってスッキリ書ける印象。

## おわりに
まだ理解できていないこともありますが、結構Apacheの仕様を読み込めてきました。
Apacheについてはこんなのも書いているので良ければどうぞ。

- [以前のURLからもアクセスできるようにRewriteRuleを設定する](https://www.suzu6.net/posts/237-apache-redirect-uri)
- [htaccessを使わない方が良いとApacheとNginxの公式が言っている](https://www.suzu6.net/posts/240-htaccess-apache-vs-nginx)

## 参考

- [RewriteCondのANDとORの優先順位 - Qiita](https://qiita.com/kawaz/items/d3a7adc1445113141f3b)
  - `OR`の方が`AND`より強い。条件を`(A or B) and (C or D)`としたいときに参考になる。


Laravelの.htaccessの設定を読み解く


２台構成のサーバでLaravelを動かしている構成で`CSRF token mismatch`がランダムなタイミング起こった。

## 環境

- Laravel 5.8
- PHP 7.3
- Apache 2.4
- CentOS 7.7
このノードが２台ある構成、DBのMySQLが別のサーバで動いています。

`SESSION_DRIVER=database`としてあり、sessionテーブルでセッションを管理していることを確認している。
## CSRF token mismatchが起こる

主な現象は
1. 画面の遷移やフォームをポストするとたまに`CSRF token mismatch`
2. 別のブラウザから同じユーザにログインしようとすると`CSRF token mismatch`

Laravelではcookieで`XSRF-TOKEN`と`laravel_session`を保持しています。
1.が起きた前後を比較するとセッションの`laravel_session`の値が変わっていました。

複数台構成で`SESSION_DRIVER=file`にしているとサーバごとにsessionを発行してしまい、リクエストが前と違うサーバに振り分けられると、このようなことが起きます。
ただ、今回は`SESSION_DRIVER=database`にしてあり、共通のセッションテーブルで動いていることも確認している。

## 原因: APP_DEBUG=true
リリース前の本番環境を検証環境としていた。

デバックをしやすくするため`APP_DEBUG=true`にしていたことが原因だったようです。。。
`false`にしてデバックモードを切ると`CSRF token mismatch`が起こらなくなりました。

今回は2台構成でデバックモードにするとサーバ毎にセッションを作ろうとするようです。
それが何故かは調べても分かりませんが、もし同じようなことで悩まれたらデバックモードも確認してみて下さい。

複数ノードのLaravelでCSRF token mismatch.が頻発する


LaravelでCSRF保護からURIを除外する方法についてです。

## webのCSRF保護とエラー

`routes/web.php`に外部からのリクエストを想定して`/some/endpoint`のエンドポイントを作り、リクエストを投げると`CSRF token`についてのエラーが出る。

```sh
[2020-01-22 18:56:41] production.ERROR: EXCEPTION some/endpoint {"statuscode":500,"error_info":"Illuminate\\Session\\TokenMismatchException: CSRF token mismatch. in /var/www/app/vendor/laravel/framework/src/Illuminate/Foundation/Http/Middleware/VerifyCsrfToken.php:82
```
これは、デフォルトでmiddlewareにVerifyCsrfTokenが設定されているためです。
`routes/api.php`にはその設定がないためリクエストが通ります。

[app/Http/Kernel.php](https://github.com/laravel/laravel/blob/master/app/Http/Kernel.php)
```php
    /**
     * The application's route middleware groups.
     *
     * @var array
     */
    protected $middlewareGroups = [
        'web' => [
            \App\Http\Middleware\EncryptCookies::class,
            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
            \Illuminate\Session\Middleware\StartSession::class,
            // \Illuminate\Session\Middleware\AuthenticateSession::class,
            \Illuminate\View\Middleware\ShareErrorsFromSession::class,
            \App\Http\Middleware\VerifyCsrfToken::class,                    ←これ
            \Illuminate\Routing\Middleware\SubstituteBindings::class,
        ],

        'api' => [
            'throttle:60,1',
            \Illuminate\Routing\Middleware\SubstituteBindings::class,
        ],
    ];
```

## 特定のURIのCSRF保護を除く

VerifyCsrfTokenの$except`に追加したエンドポイントはCSRF保護から除かれます。

[app/Http/Middleware/VerifyCsrfToken.php](https://github.com/laravel/laravel/blob/master/app/Http/Middleware/VerifyCsrfToken.php)
```php
<?php

namespace App\Http\Middleware;

use Illuminate\Foundation\Http\Middleware\VerifyCsrfToken as Middleware;

class VerifyCsrfToken extends Middleware
{
    /**
     * The URIs that should be excluded from CSRF verification.
     *
     * @var array
     */
    protected $except = [
        'some/endpoint',
        'foo/*',
    ];
}
```

この例では、`some/endpoint`と`foo/`に続くURIがCSRF保護から除かれました。

LaravelでCSRF保護からURIを除外する


開発サーバに相乗りするためにMySQL5.5の環境にLaravel6.2を配置しました。
その際、SQLのエラーが出たのでそれを回避する設定について書きます。

デフォルトの設定を維持しつつ、他のプロジェクトへ影響も鑑みて`my.conf`は変更しないよう対応します。

## 環境

- CentOS 7
- PHP 7.3
- Laravel 6.2
- MySQL5.5

## 変更点

先に変更点を挙げます。
文字コードとstrictモードについてサーバ毎に変更できるようにしました。

**config/database.php**
```php
'mysql' => [
    // 文字コードを指定
    'charset' => env('DB_CHARSET', 'utf8mb4'),
    'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),

    // strictモードを指定
    'strict' => env('DB_STRICT', true),
],
```

**.env**
```conf
DB_CHARSET=utf8
DB_COLLATION=utf8_unicode_ci
DB_STRICT=false
```

MySQL 5.8以降の環境では **.env**に修正が不要です。

## 文字コードの対応

```sh
[previous exception] [object] (PDOException(code: 42000): SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes at /srv/samples.jp/app/vendor/laravel/framework/src/Illuminate/Database/Connection.php:463)"}
```
このエラーが出たので調べると次の記事に辿り着いた。
- [Laravel5.4以上、MySQL5.7.7未満 でusersテーブルのマイグレーションを実行すると Syntax error が発生する - Qiita](https://qiita.com/beer_geek/items/6e4264db142745ea666f)

原因について詳しくかかれているので引用させて頂きます。

> 1. Laravel5.4から標準charasetがutf8mb4に変わった
>    標準charasetがutf8mb4となったことで1文字あたりの最大byte数が4bytesに増えた。
> 2. MySQL5.7.7未満ではユニーク制約を付けたカラムは最大767bytes
>    マイグレーションファイルにvarcharカラムの大きさを指定しなかった場合、varchar(255) のカラムが作成される。
> ```php
>  $table->string('email')->unique();
> ```
> 一方、MySQL5.7.7以前のバージョンでは、PRIMARY_KEYおよびUNIQUE_KEYを付けたカラムには最大767bytesまでしか入らない。
> 
> 4bytes,255文字では767bytesを超えてしまう。これがエラーの原因。

また、`utf8`と`utf8mb4`の違いは以下のよう。

> MySQL の UTF-8 には歴史的事情により utf8 と utf8mb4 の二つあります。
> 
> UTF-8 は1バイト〜4バイトで1文字が構成される文字コードですが、MySQL の utf8 は4バイト文字を扱うことができません。ハマりたくなければ utf8mb4 を使いましょう。
> [MySQL で utf8 と utf8mb4 の混在で起きること - @tmtms のメモ](https://tmtms.hatenablog.com/entry/2016/09/06/mysql-utf8)

特に絵文字は4バイトであるためutf8だと使えない。



## strictモード

- [Laravel5 QueryBuilderでgroupByが動かない時の対応方法 - Qiita](https://qiita.com/hikarizm/items/b8d50ab2e6a55c2e5dae)
- [MySQL 5.6 リファレンスマニュアル 厳密な SQL モード](https://dev.mysql.com/doc/refman/5.6/ja/sql-mode.html#sql-mode-strict)




Laravel6.xでMySQL5.5を使うための設定


SQLで作成したり元から存在するテーブルにも今後のためにmigrateファイルを作っておく。
単純に作ると`SQLSTATE[42S01]: Base table or view already exists: 1050 Table 'users' already exists ...`とマイグレートできないため、既にテーブルがあればスキップするようにマイグレーションファイルを修正する。

```php
// 2015_12_12_000000_create_users_table.php
<?php

use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateUsersTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        if (Schema::hasTable('users')) {
            // テーブルが存在していればリターン
            return;
        }
        Schema::create('users', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name');
            $table->string('email')->unique();
            $table->string('password', 60);
            $table->rememberToken();
            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::drop('users');
    }
}
```

`if (Schema::hasTable('users'))`でテーブルが存在するか判定できる。
カラムが存在するかは`if (Schema::hasColumn('users', 'email')) `でOK。
存在したらリターンする。

これで、マイグレーションをエラーなく実行できる。

## 参考

- [Laravel 5.8 データベース：マイグレーション](https://readouble.com/laravel/5.8/ja/migrations.html)


【Laravel】migrateでテーブルが存在したらスキップする

PHP(5.6→7.3)とLaravel(5.1→5.8)のアップグレード作業の手順


マイグレーションのステータスを見ようとして表題のエラーが出た。

```sh
$ php artisan migrate:status
Migration table not found.
```

マイグレーションしたことのない新しいDBに繋いでいたため、
マイグレーションテーブルが無くてエラーになっただけ。

```sh
$ php artisan migrate
Migration table created successfully.
Migrating: 2014_10_12_000000_create_users_table
Migrated:  2014_10_12_000000_create_users_table (0.06 seconds)
Migrating: 2014_10_12_100000_create_temp_users_table
Migrated:  2014_10_12_100000_create_temp_users_table (0.08 seconds)
Migrating: 2019_08_19_000000_create_companies_table
Migrated:  2019_08_19_000000_create_companies_table (0.03 seconds)
```

`php artisan migrate`でテーブルを作成したので見られるようになった。

```
[vagrant@localhost app]$ php artisan migrate:status
+------+-----------------------------------------------------------+-------+
| Ran? | Migration                                                 | Batch |
+------+-----------------------------------------------------------+-------+
| Yes  | 2014_10_12_000000_create_users_table                      | 1     |
| Yes  | 2014_10_12_100000_create_temp_users_table                 | 1     |
| Yes  | 2019_08_19_000000_create_companies_table                  | 1     |
+------+-----------------------------------------------------------+-------+
```

【Laravel】Migration table not found.


CSV出力する際に、**値をダブルクォーテーションで囲う**に必要があった。  

PHP標準の[fputcsv](https://www.php.net/manual/ja/function.fputcsv.php)ではバグがありました。
$enclosure`に設定しても間に空白がある文字列しかダブルクォーテーションで囲んでくれない。
fputcsvを使う前に`"`を付けると`"""`と出力してしまう。
これはエスケープ`\"`しても起きる。

結局自作した。

## 動作確認環境

- PHP 7.3

## 値をダブルクォーテーションで囲ってCSV形式にする

下の関数で２次元配列のデータをCSV形式にして出力できる。

```php
/**
    * CSV形式に変換
    * @param array $data ２次元配列
    * @return string $csv
    */
function tocsv($data, $toEncoding='sjis-win', $srcEncoding='UTF-8') {
    $csv = '';
    foreach ($data as $row) {
        // ダブルクォーテーションで囲う
        $row = array_map(function($value){return "\"{$value}\"";}, $row);
        // カンマ区切り
        $row = implode(',', $row);
        $csv .= $row . "\r\n";
    }
    $csv = mb_convert_encoding($csv, $toEncoding, $srcEncoding);
    return $csv;
}
```

処理が簡潔になるよう行を一括して整形している。
- `array_map`で配列の値をダブルクォーテーションで囲う
- `implode`で１行をカンマ区切の文字列に結合する
- Windowsに対応した改行文字を末尾に付けて、$csv`に追加

また、Excelで開いたときに文字化けしないように`sjis-win`にエンコーディングしている。

この後、ファイルに保存するなり、ダウンロードのさせるなりしても値をダブルクォーテーションで囲ったCSVができる。

### LaravelでCSVダウンロード

Laravelの`\Illuminate\Http\Response`を使ってCSVダウンロードを実装した例。
これをControllerで返してあげる。

```php
    /**
     * CSVダウンロード
     * @param array $list
     * @param array $header
     * @param string $filename
     * @return \Illuminate\Http\Response
     */
    public function download($list, $header, $filename)
    {
        if (count($header) > 0) {
            array_unshift($list, $header);
        }
        $csv = $this->tocsv($list);
        $headers = array(
            'Content-Type' => 'text/csv',
            'Content-Disposition' => "attachment; filename=$filename",
        );
        return \Response::make($csv, 200, $headers);
    }
```

正直言うとExcelで見る際にダブルクォーテーションで囲う必要性は薄い。
ゼロ埋めした数値をそのまま表示したいときぐらい。


## 参考

- [fputcsv](https://www.php.net/manual/ja/function.fputcsv.php)
- [[PHP] fputcsv関数の問題点と解決方法 - TechRacho](https://techracho.bpsinc.jp/baba/2010_03_01/1172)
  - 同じようにfputcsvのバグに悩まされていた。
- [【PHP】csvを自前で作った話 | ダブルコーテーション問題でfputcsvは使わず実装](https://qiita.com/non0311/items/b812aff80213f627d36b)

【PHP】CSV出力で値をダブルクォーテーションで囲う


バーチャルホストで幾つかのバージョンが同居するサーバでLarabelの環境を構築中に、デフォルトのPHPと異なるバージョンでcomposerを実行する必要があった。

## 環境

- composer 1.9.1
- CentOS 7.4

異なるバージョンのPHPが同居するサーバです。
phpコマンドはデフォルトでPHP 5.5が、その他は`php73`のようにしてバージョンを指定して実行します。([Remiでインストールした](https://www.suzu6.net/posts/152-centos7-php-73/))

- php --version : PHP 5.5
- php72 --version : PHP 7.2
- php73 --version : PHP 7.3

また、PHP-FPMのポートを分けてバーチャルホスト別に異なるバージョンを利用しています。

今回このサーバにPHP7.3向けに作ったLaravelのプロジェクトを置く際にこの問題に行き当たりました。


## PHPのバージョンを指定して実行する

### composer

以下のように[Phar アーカイブ](https://www.php.net/manual/ja/phar.using.intro.php)を指定して実行しました。

```sh
$ php73 /path/to/composer.phar install

# もしくは
$ php72 /usr/local/bin/composer install  # PHP7.2で実行
$ php73 /usr/local/bin/composer install  # PHP7.3で実行
```

composerは[https://getcomposer.org/download/](https://getcomposer.org/download/ )の手順でインストールしています。
composerのインストール時にphpコマンドを使うが、この時もphpのバージョンを気にした方が良いのか？はよくわからない。

### artisan

artisanコマンドも同様に`php**`でバージョンごとにできます。

```sh
$ php72 artisan migrate  # PHP7.2で実行
$ php73 artisan migrate  # PHP7.3で実行
```

## 古いバージョンのPHPでcomposerコマンドを叩くと

PHPのバージョンが古いと`composer install`はできない。

```sh
$ composer install
Loading composer repositories with package information
Installing dependencies (including require-dev) from lock file
Warning: The lock file is not up to date with the latest changes in composer.json. You may be getting outdated dependencies. Run update to update them.
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - This package requires php ^7.1.3 but your PHP version (5.5.38) does not satisfy that requirement.
  Problem 2
    - beyondcode/laravel-dump-server 1.3.0 requires php ^7.1 -> your PHP version (5.5.38) does not satisfy that requirement.
    - beyondcode/laravel-dump-server 1.3.0 requires php ^7.1 -> your PHP version (5.5.38) does not satisfy that requirement.
    - Installation request for beyondcode/laravel-dump-server 1.3.0 -> satisfiable by beyondcode/laravel-dump-server[1.3.0].
```

[こちら](http://mugijiru.hateblo.jp/entry/2017/09/14/131139)のようにcomposer.jsonを修正してPHPのバージョンを指定できる。

## 参考

- [https://getcomposer.org/download/](https://getcomposer.org/download/ )
- [Phar アーカイブ](https://www.php.net/manual/ja/phar.using.intro.php)
- [composerでPHPのバージョンを指定する - YUTAKI.JP](http://mugijiru.hateblo.jp/entry/2017/09/14/131139)

別のバージョンのPHPでcomposerとartisanを実行する


Laravelの環境を作る中、`composer update`した際に以下のエラーが出た。

```sh
PHP Fatal error:  Allowed memory size of 1610612736 bytes exhausted (tried to allocate 32 bytes) in
phar:///usr/local/bin/composer/src/Composer/DependencyResolver/RuleWatchNode.php on line 40
```

## 環境

- PHP 5.6
- composer 1.9.1
- CentOS 7.6

## 原因

```
Allowed memory size of 1610612736 bytes exhausted
```
訳：1610612736バイト(≒1.6GB)の許容メモリサイズを使い果たしました

1.6GBもメモリ割り当てていた？かはよくわかりませんが、とにかくメモリサイズが足りないようです。

composerのドキュメントに[Memory limit errors](https://getcomposer.org/doc/articles/troubleshooting.md#memory-limit-errors)のトラブルシューティングがあります。また、エラーの後ろにもここのURLが載っているので参照してみます。

> この場合、PHPのmemory_limitを増やす必要があります。
> 注：Composerは、memory_limitを内部的に1.5Gに増やします。

php.iniのmemory_limitの設定値を出力するコマンドも載っているので実行してみます。

```sh
# php.iniのmemory_limitの設定値を出力する
$ php -r "echo ini_get('memory_limit').PHP_EOL;"
128MB
```
128MB割り当てられていました。
`memory_limit = -1`とするとメモリ割り当てを無制限にすることができます。

[php.net - memory_limit](http://php.net/memory-limit)

```sh
# php.iniを編集
$ sudo vi /etc/php.ini
; Maximum amount of memory a script may consume (128MB)
; http://php.net/memory-limit
memory_limit = -1  ; -1に変更
```

設定変更後、エラー箇所は乗り越えられました！

## 参考

- [composer doc - troubleshooting #Memory limit errors](https://getcomposer.org/doc/articles/troubleshooting.md#memory-limit-errors)
  - 解決方法がちゃんと載っていて有難い。
- [php.net](https://www.php.net/)
  - [memory_limit](http://php.net/memory-limit)

composer updateしたときのPHP Fatal error:Allowed memory size of xxx bytes exhausted


LAMP環境でLaravelを動かして`could not find driver`が出た時に、解決した方法についてです。

LaravelからMySQLに接続したときに、ドライバーがないためエラーになっています。

## 環境

- CentOS 7.6
- Apache 2.4
- MySQL 5.7.27
- PHP 7.3.10

## ドライバーを確認する

phpのモジュールにMySQLのドライバーが入っているか確認します。
PDOがSQLのドライバーにあたります。

```sh
$ php -m | grep pdo
pdo_sqlite
```

SQLite向けのドライバーしかありませんでした。
モジュールをまとめてインストールした際に、入れ忘れてたようです。

## ドライバーをインストールする

MySQLのドライバーは`php-mysqlnd`ですので、これをインストールしていきます。

PHP7.3はremiリポジトリを使っていたため以下のコマンドで`php-mysqlnd`をインストールします。

```sh
$ sudo yum -y install --enablerepo=remi,remi-php73 php-mysqlnd
```

remiリポジトリを使っていない場合（PHP 5.x）以下のコマンドでインストールできると思います。

```sh
# バージョンを確認
$ sudo yum info php-mysqlnd

# インストール
$ sudo yum install php-mysqlnd
```

インストールして`pdo_mysql`が追加されています。

```sh
$ php -m | grep pdo
pdo_mysql
pdo_sqlite
```

この後、Apacheを再起動するとエラーが解消されていました。

## おまけ：試行錯誤したときのログ

ドライバーがないことを知らず、パスが通ってないと考えていました。
`php.ini`に拡張モジュールを指定できる設定があり、これを変更したときのWarning。

`php.ini`に`extension=php_pdo_mysql.so`を加えました。

```sh
$ php -m | grep pdo
PHP Warning:  PHP Startup: Unable to load dynamic library 'php_pdo_mysql.so' (tried: /usr/lib64/php/modules/php_pdo_mysql.so (/usr/lib64/php/modules/php_pdo_mysql.so: cannot open shared object file: No such file or directory), /usr/lib64/php/modules/php_pdo_mysql.so.so (/usr/lib64/php/modules/php_pdo_mysql.so.so: cannot open shared object file: No such file or directory)) in Unknown on line 0
pdo_mysql
```

存在しないモジュールを指定すると、こういった警告が出るようです。
`php-mysqlnd`をインストールした後は、`extension`をコメントアウトに戻しておきました。

PHPモジュールは`/usr/lib64/php/modules/`にまとまっています。

【Laravel】CentOSのLAMP環境でcould not find driver


負荷試験中にLaravelのAPIから**429 Too Many Requests**が返るようになった。
当初、AWS EC2のt2.microの環境だったため負荷試験申請していないことが原因かと思い、はまってしまった。

原因を突き詰めると、Laravelのデフォルトでリクエスト数制限を掛ける処理になっているようです。

## 環境

- php 7.3
- Laravel 5.8

## 原因：ThrottleRequests

`\app\Http\Kernel.php`にあるmiddlewareGroupsの設定に、API数を制限する記述があります。
`'throttle:60,1'`が同一のIPアドレスとドメインから1分間に60回までのリクエスト数に制限しています。

```php
    protected $middlewareGroups = [
        // 省略
        // 40行目付近
        'api' => [
            'throttle:60,1', // 1分間に60回まで
            'bindings',
        ],
```

throttleは$routeMiddleware`の中でvendorにあるモジュールを定義していました。

```php
    protected $routeMiddleware = [
        // 省略
        'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
```

### x-ratelimit-limit

throttleが有効になっている場合、HTTP Response Headersに**x-ratelimit-limit**と**x-ratelimit-remaining**が付きます。

- x-ratelimit-limit : リクエスト数上限
- x-ratelimit-remainin : 残りのリクエスト数

### [ThrottleRequests - GitHub](https://github.com/illuminate/routing/blob/master/Middleware/ThrottleRequests.php)の処理

`\Illuminate\Routing\Middleware\ThrottleRequests::class`

リクエスト元は、IPアドレスとドメインのハッシュキーから識別しているようです。

```php
    protected function resolveRequestSignature($request)
    {
        if ($user = $request->user()) {
            return sha1($user->getAuthIdentifier());
        }
        if ($route = $request->route()) {
            // IPアドレスとドメインのハッシュ
            return sha1($route->getDomain().'|'.$request->ip()); 
        }
        throw new RuntimeException('Unable to generate the request signature. Route unavailable.');
    }
```
また、[RateLimiter](https://github.com/illuminate/cache/blob/master/RateLimiter.php)というキャッシュストアを使ってリクエスト数をカウントしていました。

## 解消法

`'throttle:60,1'`の数値を緩和するか、この行を削除したら制限がなくなります。

## 参考

- [429 Too Many Requests](https://developer.mozilla.org/ja/docs/Web/HTTP/Status/429)

このコードは初めて見た。。。
AWSのAPI Gatewayでもよくみられるようです。

- [Laravel / ThrottleRequests の云々とかオーバーライドとか](https://access-jp.co.jp/blogs/development/203)

ThrottleRequestsについてたくさんの検証をされています。
日本語記事があって有難い。

LaravelのAPIで429 Too Many Requestsが返る


APIのルーティングではGET, POST, PUT, DELETEといったHTTPリクエストに応じたコントローラーの関数を作ってくれるため、
Laravelでは統一感のあるRESTなAPIを手早く作れます。

exceptとonlyを指定することで、不要なリクエストは制限しておくべきです。

- Laravel 5.8で確認

## APIルーティングとアクション

**/routes/api.php**に以下のようなAPIを作ってみました。

```php
Route::resource('/user', 'Api\UsersController');
```

この状態でルーティングを表示するコマンド$ php artisan route:list -v`を叩くと以下のようになります。

```php
| Domain | Method    | URI                          | Name             | Action                                                  | Middleware |
+--------+-----------+------------------------------+------------------+---------------------------------------------------------+------------+
|        | GET|HEAD  | /                            |                  | App\Http\Controllers\Web\HomeController@index           | web        |
|        | POST      | api/user                     | user.store       | App\Http\Controllers\Api\UserController@store           | api        |
|        | GET|HEAD  | api/user                     | user.index       | App\Http\Controllers\Api\UserController@index           | api        |
|        | GET|HEAD  | api/user/create              | user.create      | App\Http\Controllers\Api\UserController@create          | api        |
|        | DELETE    | api/user/{user}              | user.destroy     | App\Http\Controllers\Api\UserController@destroy         | api        |
|        | PUT|PATCH | api/user/{user}              | user.update      | App\Http\Controllers\Api\UserController@update          | api        |
|        | GET|HEAD  | api/user/{user}              | user.show        | App\Http\Controllers\Api\UserController@show            | api        |
|        | GET|HEAD  | api/user/{user}/edit         | user.edit        | App\Http\Controllers\Api\UserController@edit            | api        |
+--------+-----------+------------------------------+------------------+---------------------------------------------------------+------------+
```

7つのアクションの関数が作成されました。
毎回すべて使うことはないため、onlyとexceptで制限します。

## only

onlyは利用するアクションだけ指定できます。
書き方は`['only' => [利用するアクション]]`です。

```php
// indexとstoreのみ利用する
Route::resource('/user', 'Api\UsersController', ['only' => ['store','index']]);
```

この場合のroute:listは以下のようになり、`store`と`index`に絞れました。

```php
| Domain | Method    | URI                          | Name             | Action                                                  | Middleware |
+--------+-----------+------------------------------+------------------+---------------------------------------------------------+------------+
|        | GET|HEAD  | /                            |                  | App\Http\Controllers\Web\HomeController@index           | web        |
|        | POST      | api/user                     | user.store       | App\Http\Controllers\Api\UserController@store           | api        |
|        | GET|HEAD  | api/user                     | user.index       | App\Http\Controllers\Api\UserController@index           | api        |
+--------+-----------+------------------------------+------------------+---------------------------------------------------------+------------+
```

## except

onlyとは逆に、除外するアクションを指定します。
書き方は`['only' => [除外するアクション]]`です。

```php
// editとcreateは不要
Route::resource('/user', 'Api\UsersController', ['except' => ['edit','create']]);
```

この場合のroute:listは以下のようになり、`edit`と`create`は除外されます。

```php
| Domain | Method    | URI                          | Name             | Action                                                  | Middleware |
+--------+-----------+------------------------------+------------------+---------------------------------------------------------+------------+
|        | GET|HEAD  | /                            |                  | App\Http\Controllers\Web\HomeController@index           | web        |
|        | POST      | api/user                     | user.store       | App\Http\Controllers\Api\UserController@store           | api        |
|        | GET|HEAD  | api/user                     | user.index       | App\Http\Controllers\Api\UserController@index           | api        |
|        | DELETE    | api/user/{user}              | user.destroy     | App\Http\Controllers\Api\UserController@destroy         | api        |
|        | PUT|PATCH | api/user/{user}              | user.update      | App\Http\Controllers\Api\UserController@update          | api        |
|        | GET|HEAD  | api/user/{user}              | user.show        | App\Http\Controllers\Api\UserController@show            | api        |
+--------+-----------+------------------------------+------------------+---------------------------------------------------------+------------+
```

## 参考

- [Laravel 5.8 コントローラ](https://readouble.com/laravel/5.8/ja/controllers.html)
- [Laravel5.7: usersのCRUD機能を実装する](https://qiita.com/sutara79/items/cd4371b246b44a2cf87f)

### 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を使う方法など）は載っていません。


APIルーティングでActionを制限する exceptとonly | Laravel5.8


既設のDBのテーブルを利用した場合、作成更新日時を記録するカラムとLaravelの標準なカラムと合わないことがあります。
LaravelのModeleに設定を加え**update_atとcreate_atと異なるカラム名にも対応させます**。

## Model

Mpdelでは**Illuminate\Database\Eloquent\Model**を継承している。
そこで、`CREATED_AT`と`UPDATED_AT`をオーバーライドすることで実現します。

`created`と`updated`に対応させてみます。

```php
<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    // テーブル名
    protected $table = 't_user';

    // プライマリーキー
    protected $primaryKey = 'user_id';

    // カラム名をオーバーライド
    const CREATED_AT = 'created';
    const UPDATED_AT = 'updated';

    // 日付フォーマット
    protected $dateFormat = 'Y-m-d H:i:s.u'; 

    // 属性の保護
    protected $guarded = ['user_id', 'created', 'updated'];
}
```
これで、作成更新日時がそれぞれ割り当てられました。
他のカラム名でも同様に変更できます。

### $dateFormat

関連する設定として$dateFormat`に日付のフォーマットを指定しています。

### $guarded

createメソッドで自動入力されるidと作成更新日時を操作しないよう保護することができます。
カラムに代入できないようにブラックリストとしての役割です。
(`user_id`は自動インクリメントする前提）

反対に、$fillable`はホワイトリストとして働きます。
どちらか片方しか使用できません。

### 参考

- [Laravel 5.8 Eloquent：利用の開始](https://readouble.com/laravel/5.8/ja/eloquent.html)

Modelのupdate_atとcreate_atをカラムに合わせる | Laravel5.8


Laravelから外部サーバーに立てたPostgreSQLに接続できないエラー`could not find driver`を解消した。

## 環境

- CentOS 7
- Laravel 5.8
- php7.3
- Nginx

php7.3はremiリポジトリのものを利用している。詳しくは下記の記事参照。

- [CentOS7にPHP7.3をインストールする](https://www.suzu6.net/posts/152-centos7-php-73/)

PostgreSQLに関して、`.env`と`\config\database.php`の設定をしてある。

`.env`

```
DB_CONNECTION=pgsql
DB_HOST=ホスト先のサーバIP
DB_PORT=5432
DB_DATABASE=db_name
DB_USERNAME=user_name
DB_PASSWORD=secret
```

`\config\database.php`

```php
'default' => env('DB_CONNECTION', 'pgsql'),
```

デフォルトをpgsqlに変更。

## 現象

コントローラー内でテーブルからデータを取得をする処理を実行した際に下記のエラー。

```log
[2019-05-15 04:58:19] local.ERROR: could not find driver (SQL: select * from "table_name") {"exception":"[object] (Illuminate\\Database\\QueryException(code: 0): could not find driver (SQL: select * from \"table_name\") at /srv/www/App/vendor/laravel/framework/src/Illuminate/Database/Connection.php:664, PDOException(code: 0): could not find driver at /srv/www/App/vendor/laravel/framework/src/Illuminate/Database/Connectors/Connector.php:70)
```

**要はPostgreSQLを操作するドライバーがないようです。**

### ドライバーのインストール

[こちら](https://qiita.com/SOJO/items/64bcc7954a32a5165498)の記事より、`php-pdo_pgsql`がPostgreSQLのドライバーみたいです。

その前に現在のphpのrpmを確認する。

```sh
$ rpm -qa | grep php
php-devel-7.3.4-1.el7.remi.x86_64
php-mbstring-7.3.4-1.el7.remi.x86_64
php73-php-json-7.3.4-1.el7.remi.x86_64
php-pecl-mcrypt-1.0.2-2.el7.remi.7.3.x86_64
php-pdo-7.3.4-1.el7.remi.x86_64
php73-php-common-7.3.4-1.el7.remi.x86_64
php-json-7.3.4-1.el7.remi.x86_64
php-cli-7.3.4-1.el7.remi.x86_64
php-gd-7.3.4-1.el7.remi.x86_64
php-common-7.3.4-1.el7.remi.x86_64
php-7.3.4-1.el7.remi.x86_64
php-xml-7.3.4-1.el7.remi.x86_64
php73-runtime-2.0-1.el7.remi.x86_64
php-fpm-7.3.4-1.el7.remi.x86_64
```

インストールする。

```sh
$ sudo yum install php-pdo_pgsql

インストール:
  php-pgsql.x86_64 0:7.3.5-1.el7.remi

依存性関連をインストールしました:
  oniguruma5.x86_64 0:6.9.2-1.el7.remi

依存性を更新しました:
  php.x86_64 0:7.3.5-1.el7.remi                      php-cli.x86_64 0:7.3.5-1.el7.remi
  php-common.x86_64 0:7.3.5-1.el7.remi               php-devel.x86_64 0:7.3.5-1.el7.remi
  php-fpm.x86_64 0:7.3.5-1.el7.remi                  php-gd.x86_64 0:7.3.5-1.el7.remi
  php-json.x86_64 0:7.3.5-1.el7.remi                 php-mbstring.x86_64 0:7.3.5-1.el7.remi
  php-pdo.x86_64 0:7.3.5-1.el7.remi                  php-xml.x86_64 0:7.3.5-1.el7.remi

完了しました!
```

無事、エラーが解消されました。

### 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を使う方法など）は載っていません。

LaravelでPostgreSQLに接続できないエラー|could not find driver


**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を使う方法など）は載っていません。