

PHP5.xをバージョン指定してCentOS7にインストールするコマンドです。
PHP7.xやPHP8.xも同様に可能です。
シェルスクリプトで自動化できるようにしたので、VMやDockerのイメージ作成にも使えます。

この記事にたどり着いた方の大半はレガシーな古いPHPのシステムを刷新しようと頑張る方だと思うので応援したい。
今更感もあるがちゃんと書く。

## Contents

## 環境

```bash
$ sudo cat /etc/redhat-release
CentOS Linux release 7.9.2009 (Core)
```

このサーバにPHP5.xをインストールします。

ここではPHP-FPMを利用しないApacheの構成を想定してます。

## php56をインストールするコマンド

例としてphp56といくつかのphpモジュールやPEARのパッケージをインストールする例を載せます。
一緒にhttpd24もインストールされます。

```bash
#!/bin/bash
yum update

## remi
yum install -y epel-release
yum install -y http://rpms.famillecollet.com/enterprise/remi-release-7.rpm

# デフォルトだと5.4をインストールしてしまう
# php5.6リポジトリの有効化
yum install -y yum-utils
yum-config-manager --enable remi-php56

# php5.6のインストール
yum -y install php
yum -y install php-mbstring \
    php-xml \
    php-pear

# 設定ファイルのバックアップ
cp /etc/php.ini /etc/php.ini.org
# /etc/php.ini.d/　にPHPモジュールの設定ファイルがある


# pear packages
pear install Mail
pear install Mail_Mime
```

### バージョンの指定について

`yum-config-manager --enable remi-php56`のバージョンを`remi-php54`や`remi-php73`などにしてあげるとPHPのバージョンを指定できる。

デフォルトではphp5.4がインストールされてしまいます。
`yum -y --enablerepo=remi,remi-php56 php`でphp56をphpとしてインストールする方法もありますが、なぜかphp5.4がインストールされてしまう問題が起きたため`yum-utils`をインストールして`yum-config-manager`コマンドで`remi-php56`を有効にしてからインストールする方法に落ち着きました。

`yum-config-manager --enable remi-php56`を実行すると`/etc/yum.repos.d/remi.repo`の設定ファイルを書き換えてremi-php56を有効化します。

バージョン確認。

```bash
# php -v
PHP 5.6.40 (cli) (built: Jun 28 2021 14:40:12)
Copyright (c) 1997-2016 The PHP Group
Zend Engine v2.6.0, Copyright (c) 1998-2016 Zend Technologies
```

### /etc/yum.repos.d/remi.repoについて

`yum-config-manager --enable remi-php56`を実行すると`/etc/yum.repos.d/remi.repo`の設定ファイルの`[remi-php56]`の`enabled=1`と書き換えてremi-php56を有効化します。

設定ファイルの中身はこんな感じです。

```bash
$ sudo cat /etc/yum.repos.d/remi.repo
# Repository: http://rpms.remirepo.net/
# Blog:       http://blog.remirepo.net/
# Forum:      http://forum.remirepo.net/

[remi]
name=Remi\'s RPM repository for Enterprise Linux 7 - $basearch
#baseurl=http://rpms.remirepo.net/enterprise/7/remi/$basearch/
#mirrorlist=https://rpms.remirepo.net/enterprise/7/remi/httpsmirror
mirrorlist=http://cdn.remirepo.net/enterprise/7/remi/mirror
enabled=0
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi

[remi-php55]
name=Remi\'s PHP 5.5 RPM repository for Enterprise Linux 7 - $basearch
#baseurl=http://rpms.remirepo.net/enterprise/7/php55/$basearch/
#mirrorlist=https://rpms.remirepo.net/enterprise/7/php55/httpsmirror
mirrorlist=http://cdn.remirepo.net/enterprise/7/php55/mirror
# NOTICE: common dependencies are in "remi-safe"
enabled=0
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi

[remi-php56]
name=Remi\'s PHP 5.6 RPM repository for Enterprise Linux 7 - $basearch
#baseurl=http://rpms.remirepo.net/enterprise/7/php56/$basearch/
#mirrorlist=https://rpms.remirepo.net/enterprise/7/php56/httpsmirror
mirrorlist=http://cdn.remirepo.net/enterprise/7/php56/mirror
# NOTICE: common dependencies are in "remi-safe"
enabled=1 #これが1になった
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-remi
```

remiリポジトリの設定はいくつかあるのでこれから有効にするPHPのバージョンを選べばよい。

```bash
$ sudo cat /etc/yum.repos.d/remi
remi-glpi91.repo   remi-glpi94.repo   remi-php70.repo    remi-php73.repo    remi.repo
remi-glpi92.repo   remi-modular.repo  remi-php71.repo    remi-php74.repo    remi-safe.repo
remi-glpi93.repo   remi-php54.repo    remi-php72.repo    remi-php80.repo
```

## リンク

この記事に関するリンクを挙げておきます。
疑問に思ったら一読をお勧めします。

- [CentOSなどで使う、Remi Repositoryってなんだ？](https://qiita.com/charon/items/6d34ae798e9b05e8bd0a)

よくわかんないよってなったらTwitterのDMしてくれたら何とかします。
PHPのレガシーシステムの刷新とか仕事につながったら嬉しいです。


PHP5.xをCentOS7にインストールする


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.が頻発する


PHPでWarningが出た時のメモです。

## Warning: Illegal string offset 'foo'

この警告は次のように文字列を代入した変数から配列のように値を取ろうとすると出ます。
```php
<?php
$foo = 'bar';
if($foo['foo']){ 
    echo 'true';
}else{
    echo 'false';
}
// Output for 5.4.0 - 7.4.2
// Warning: Illegal string offset 'foo' in /in/Ck5Qk on line 3
// true
```
[このコードを実行してみる 3v4l.org](https://3v4l.org/Ck5Qk)

PHP 5.4から警告が出るようになっています。

```php
// Output for 4.3.0 - 5.3.29
// true
```


これがよく出る多次元配列やオブジェクトにして配列と文字列が混雑してるとデバックが大変です。この場合は[gettype](https://www.php.net/manual/ja/function.gettype.php)等で型チェックが必要。

PHPは動的型付けなんで仕方ないですね。。。IDEで型のチェックもやってもらえると助かる。

## 型を宣言しよう

対処として、関数の引数には型宣言を行うと良い。ちゃんと`TypeError`が出てくれる。
```php
<?php

function hoge(array $foo){
    if($foo['foo']){
        return 'true';
    }else{
        return 'false';
    }
}
$foo = 'bar';
echo hoge($foo);
/*
Fatal error: Uncaught TypeError: Argument 1 passed to hoge() must be of the type array, string given, called in /in/fClmT on line 11 and defined in /in/fClmT:3
Stack trace:
#0 /in/fClmT(11): hoge('bar')
#1 {main}
  thrown in /in/fClmT on line 3

 Process exited with code 255.
*/
```
[このコードを実行してみる 3v4l.org](https://3v4l.org/fClmT)


また、調べているとWordPressでPHPのバージョンアップをしたときに多いみたい。
WordPressではプラグインのバージョンを対応させるか、問題無ければ[Warningの通知を切る](https://aristath.github.io/blog/wp-hide-php-errors)こともできるみたいです。