electonのアプリをビルドするためにelectron-builderを利用しています。
Windows版のインストーラの作成はNSISというスクリプト型のインストールシステムで作ります。

色々と調べてなんとなく全体を把握できたので、まとめて紹介します。

## 動作確認環境

electron-builderがそれなりに新しければ特に問題はないと思います。

確認しているのはElectron + Vuejsのちょっと特殊な環境です。

- Windows 10 Home
- [vue-cli-plugin-electron-builder](https://nklayman.github.io/vue-cli-plugin-electron-builder/): ~2.0.0-rc.5
 - electronでVueが使えるプラグイン
 - electron-builder: ^21.2.0 -> 22.2.0　に依存しています。

vue-cli-plugin-electron-builderの内部でelectron-builderを利用してます。
electron-builderの最新も`v22.11.7`ですのでそこまで古いわけではなさそう。

## electron-builderの設定

インストーラの設定は基本的に`package.json`の`build`オプションにelectron-builderの設定を書いていきます。
（vue-cli-plugin-electron-builderの場合はvue.config.jsの`builderOptions`に書く）

▼ 配布用のWindowsアプリを作る場合は大体こんな感じになっていると思います。
コメントを書きたいのでjsoncで書いていますがJSONに読み替えてください。
```json
"build": {
 "appId": "jp.example.myapp",
 "productName": "アプリの名前（日本語OK）",
 "mac": {/* Macの設定 */},
 "dmg": {/* Macの設定 */},
 // Windowsの設定
 "win": {
 "icon": "path/to/icon256.png",
 "target": {
 // Windowsインストーラー
 "target": "nsis",
 "arch": ["x64"]
 },
 // Windowsアプリのコード証明
 "certificateFile": "./path/to/コード証明書.pfx",
 "publisherName": "SUZU6",
 "certificatePassword": "xxxxxxxxx",
 // インストーラのアップ先
 "publish": {
 // https://www.electron.build/configuration/publish#s3options
 "provider": "s3",
 "bucket": "bucket",
 "region": "ap-northeast-1",
 "storageClass": "STANDARD",
 "path": "/installer"
 }
 },
 // インストーラの設定
 "nsis": {
 // https://www.electron.build/configuration/nsis
 // インストーラの名前
 "artifactName": "${productName}_setup_${version}.${ext}",
 // 設定スクリプトのパス
 "include": "build/installer.nsh",
 "oneClick": false,
 "allowToChangeInstallationDirectory": false,
 "createDesktopShortcut": false,
 },
}
```

NSISを使うため`build.win.target.target: nsis`としてください。
そして、`build.nsis`に設定を書いていきます。

## electron-builderのnsisの設定

- https://www.electron.build/configuration/nsis.html
こちらはelectron-builderでのNSISの設定のドキュメントです。

利用したり調べて分かった項目を紹介します。


|key|type|default|discription|
|--|--|--|--|
|`artifactName`|string|`${productName} Setup ${version}.${ext}`|インストーラのファイル名 変数については[File Macros](https://www.electron.build/file-patterns#file-macros)を参照|
|`include`|string|`build/installer.nsh`|NSISスクリプトのパス `build/installer.nsh`といったファイルを用意してインストーラを拡張できる。|
|`script`|string|`build/installer.nsi`|NSISスクリプトのパス 拡張子が`.nsi`|
|`allowToChange` `Installation` `Directory` 長いので分割|boolean|false|ユーザーがインストールディレクトリを変更できるようにするかどうか。|
|`installerIcon`|string|アプリのアイコン（`build.win.icon`）と同じ|画像のパス|
|`uninstallerIcon`|string|アプリのアイコン（`build.win.icon`）と同じ|画像のパス|
|`installerIcon`|string||
|`oneClick`|boolean|true|ワンクリックインストーラを利用するか。インストーラを拡張しない場合は利用した方が分かりやすいと思う。|
|`createStartMenuShortcut`|boolean|true|スタートメニューのショートカットを作成するかどうか|
|`createDesktopShortcut`|boolean|true|デスクトップにショートカットを作るか|
|`shortcutName`|string|アプリ名|すべてのショートカットの名前|

## ファイル名などで利用できるマクロ

ファイル名などの文字列には[File Macros](https://www.electron.build/file-patterns#file-macros)が使えます。

|key|discription|
|--|--|
|`${arch}`|`ia32`, `x64`|
|`${os}`|ターゲットプラットフォームに応じて`mac`、`linux`または`win`|
|`${platform}`|`darwin`、`linux`または`win32`といった`process.platform`のプロパティ|
|`${name}`|`package.json`の`name`|
|`${productName}`|製品名|
|`${version}`|バージョン|
|`${channel}`|バージョンからプレリリースコンポーネントが検出されました（例 `beta`）|
|`${env.ENV_NAME}`|任意の環境変数|

他に[AppInf](https://www.electron.build/api/electron-builder#AppInfo)oの任意のプロパティが利用できます（例 `buildVersion`、`buildNumber`）。

## NSISスクリプト

インストーラをもっと拡張したい場合はNSISスクリプトで細かく設定できる。

[Custom NSIS script - www.electron.build](https://www.electron.build/configuration/nsis.html#custom-nsis-script)

electronのnsisプロパティの`script`と`include`でスクリプトのファイルパスを渡して読み込むことができます。


インストーラにスタートアップのチェックボタンをつけて、スタートアップに登録させることができたのでそのスクリプトを次の記事で紹介しています。

私は正直いまいち書き方を理解していない。
下のリンクを読んでスタートアップ


### NSISで使える変数

ちょっとしたTips。

NSISスクリプトで適当な変数を書いてビルドするとその変数は定義されていないとエラーが出る。
その際に、定義されている変数が一覧で出てくるので確認しておくと自由度が上がると思う。

ただし、NSISはShift-jisでエラーが出るため日本語は文字化けする。

下記のように出てくる。
```bash
# ビルドに失敗した
ExecError: C:\Users\user\AppData\Local\electron-builder\Cache\nsis\nsis-3.0.4.1\Bin\makensis.exe exited 
with code ERR_ELECTRON_BUILDER_CANNOT_EXECUTE
Output:

Output:
Command line defined: "APP_ID=jp.example.myapp"
Command line defined: "APP_GUID=xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Command line defined: "UNINSTALL_APP_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Command line defined: "PRODUCT_NAME=�J��@�|@�|�b�v��A�b�v" # 文字化け
Command line defined: "PRODUCT_FILENAME=�J�C�@�|�b��N�b�v" # 文字化け
Command line defined: "APP_FILENAME=myapp"
Command line defined: "APP_DESCRIPTION=My electron app"
Command line defined: "VERSION=1.0.0"
Command line defined: "PROJECT_DIR=C:\git\myapp"
Command line defined: "BUILD_RESOURCES_DIR=C:\git\myapp\build"
Command line defined: "APP_PACKAGE_NAME=myapp"
Command line defined: "MUI_ICON=C:\git\myapp\dist_electron\.icon-ico\icon.ico"
Command line defined: "MUI_UNICON=C:\git\myapp\dist_electron\.icon-ico\icon.ico"
Command line defined: "APP_64=C:\git\myapp\dist_electron\myapp-1.0.0-x64.nsis.7z"
Command line defined: "APP_64_NAME=myapp-1.0.0-x64.nsis.7z"
Command line defined: "APP_64_HASH=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
Command line defined: "COMPANY_NAME=SUZU6"
Command line defined: "APP_PRODUCT_FILENAME=�J�C�N���@�|�b�v�A�b�v"
Command line defined: "COMPRESSION_METHOD=7z"
Command line defined: "MULTIUSER_INSTALLMODE_ALLOW_ELEVATION"
Command line defined: "INSTALL_MODE_PER_ALL_USERS_REQUIRED"
Command line defined: "SHORTCUT_NAME=�J�C�N���@�|�b�v�A�b�v"
Command line defined: "UNINSTALL_DISPLAY_NAME=�J�C�N���@�|�b�v�A�b�v 1.0.0"
Command line defined: "MUI_WELCOMEFINISHPAGE_BITMAP=${NSISDIR}\Contrib\Graphics\Wizard\nsis3-metro.bmp" 
Command line defined: "MUI_UNWELCOMEFINISHPAGE_BITMAP=${NSISDIR}\Contrib\Graphics\Wizard\nsis3-metro.bmp" 
Command line defined: "ESTIMATED_SIZE=18823"
Command line defined: "COMPRESS=auto"
Command line defined: "UNINSTALLER_OUT_FILE=C:\git\myapp\dist_electron\__uninstaller-nsis-myapp.exe" 
Processing config: C:\Users\user\AppData\Local\electron-builder\Cache\nsis\nsis-3.0.4.1\nsisconf.nsh 
Processing script file: "<stdin>" (ACP)
warning 6000: unknown variable/constant "APP_NAME.lnk" detected, ignoring (C:\git\myapp\build\installer.nsh:10)

```

## 参考
- [electron-builder による Windows インストーラー (NSIS) 作成でやりたかったことの実現方法まとめ](https://techracho.bpsinc.jp/kawawa/2020_12_09/101448)
- [【NSIS】Windows向けインストーラーの作成方法：Modern UIを使用](https://office54.net/python/nsis-make-installer)
- [Electron Builder NSIS Create a shortcut in startup](https://stackoverflow.com/questions/48422871/electron-builder-nsis-create-a-shortcut-in-startup)
- [Reading and Writing the Registry - NSIS makes it easy](https://nsis.sourceforge.io/Reading_and_Writing_the_Registry_-_NSIS_makes_it_easy)
- [NSISで作るインストーラーのチートシート](https://qiita.com/logue/items/f8b622d53705471ef037)

electron-builderとnsisでWindowsアプリのインストーラの設定まとめ

Rustの数値型のベクトルをスペースやカンマなどの区切り文字を挟んだ文字列に変換(join)する書き方です。
Rustで競技プログラミングを始めたので必要としました。

`vec![1, 2, 3]`を`1 2 3`と出力させます。
イメージはPythonの`list.join(" ")`。

[playground](https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&gist=09f79ca9485db69ad1b98a822ab4e5da)でコードを実行確認できます。

## Contents

## 構文

```rust
// to_string
Vec<T>.iter().map(|x| x.to_string()).collect().join(" ")

// format!
Vec<T>.iter().map(|x| format!("{}", x)).collect().join(",")
```

この構文でベクトルを区切り文字で結合した文字列へ変換できる。
`format!("{}", x)`は応用が利くため便利。

以下で例と解説をする。

### 整数型

整数型のベクトルの例です。

```rust:rust
// 整数型
let src: Vec<i32> = vec![-3, -2, -1, 0, 1, 2, 3];

// 要素を整数型から文字列型変換
let dst: Vec<String> = src.iter().map(|x| x.to_string()).collect();
// 文字列型vectorを区切り文字で結合
println!("{}", dst.join(" "));
```

```txt:出力
-3 -2 -1 0 1 2 3
```

要素が文字列の`Vec<String>`では区切り文字を指定して結合する`.join(" ")`が利用できます。
そのため、`Vec<i32>`を`.map()`で要素ごとに文字列へ変換して`Vec<String>`にしています。
区切り文字は`.join(",")`などと変更できます。

- `iter().map(|x| x.to_string())`は要素ごとに文字列へ変換する処理です。Rust版のラムダ式ですかね。
 - [std::iter](https://doc.rust-lang.org/std/iter/)
 - [std::iter::Map](https://doc.rust-lang.org/std/iter/struct.Map.html)
- `.collect()`は`Map`を`Vec<T>`に直すことができる。
 - [std::iter.collect](https://doc.rust-lang.org/std/iter/trait.Iterator.html#method.collect)
 - `std::iter::Map`は`std::iter`を継承しているっぽい。

### 浮動小数点型

浮動小数点型も同じです。

```rust:rust
// 浮動小数点型
let src: Vec<f32> = vec![-3.3, -2.2, -1.1, 0.0, 1.1, 2.2, 3.3];

let dst: Vec<String> = src.iter().map(|x| x.to_string()).collect();
println!("{}", dst.join(" "));
```

```txt:出力
-3.3 -2.2 -1.1 0 1.1 2.2 3.3
```

`.0`は省略されるようです。

### 論理値型

浮動小数点型は`true`, `false`を出力できます。

```rust
 // 論理値型
 let src: Vec<bool> = vec![true, false];

 let dst: Vec<String> = src.iter().map(|x| x.to_string()).collect();
 println!("{}", dst.join(" "));
```

```txt:出力
true false
```

## format

`format!`で要素を文字列にするときのカスタマイズが容易になります。

- [std::fmt](https://doc.rust-lang.org/std/fmt/)に例がたくさんあります。

### 0埋め, パディング

[std::fmt#sign0](https://doc.rust-lang.org/std/fmt/#sign0)

```rust
// 浮動小数点型 0パディング
let src: Vec<f32> = vec![-3.3, -2.2, -1.1, 0.0, 1.1, 2.2, 3.3];

let dst: Vec<String> = src.iter().map(|x| format!("{:05}", x)).collect();
println!("{}", dst.join(" "));
```

```txt:出力
-03.3 -02.2 -01.1 00000 001.1 002.2 003.3
```

`format!("{:05}", x)`が5桁の0埋めです。

その他のサイン。

```rust
assert_eq!(format!("Hello {:+}!", 5), "Hello +5!");
assert_eq!(format!("{:#x}!", 27), "0x1b!");
assert_eq!(format!("Hello {:05}!", 5), "Hello 00005!");
assert_eq!(format!("Hello {:05}!", -5), "Hello -0005!");
assert_eq!(format!("{:#010x}!", 27), "0x0000001b!");
```

### fillalignment

[std::fmt#fillalignment](https://doc.rust-lang.org/std/fmt/#fillalignment)

```rust
assert_eq!(format!("Hello {:<5}!", "x"), "Hello x !");
assert_eq!(format!("Hello {:-<5}!", "x"), "Hello x----!");
assert_eq!(format!("Hello {:^5}!", "x"), "Hello x !");
assert_eq!(format!("Hello {:>5}!", "x"), "Hello x!");
```

## 文字列型

文字列型の場合は既に要素が文字列であるため、変換が不要です。

```rust
let months = vec!["January", "February", "March", "April", "May", "June", "July",
 "August", "September", "October", "November", "December"];
println!("{}", months.join(", "));
```

```txt:出力
January, February, March, April, May, June, July, August, September, October, November, December
```

## タプルの場合

Rustのタプルは異なる型を納められます。
`map()`はジェネリックだったのと、整数型と浮動小数点型は`to_string()`を持つため混合していても良いかと考えてましたが、エラーが出ました。

```rust
let src = (500, 6.4, 1);
let dst: Vec<String> = src.iter().map(|x| x.to_string()).collect();

println!("{}", dst.join(" "));
```

```txt:出力
error[E0599]: no method named `iter` found for tuple `({integer}, {float}, {integer})` in the current scope
 --> src/main.rs:41:32
 |
41 | let dst: Vec<String> = src.iter().map(|x| x.to_string()).collect();
 | ^^^^ method not found in `({integer}, {float}, {integer})`

error: aborting due to previous error
```

型を混合したものは`iter`で扱えないようです。

## おわり

- [playground](https://play.rust-lang.org/?version=stable&mode=debug&edition=2018&gist=09f79ca9485db69ad1b98a822ab4e5da)

【Rust】数値型のベクトルをスペース区切りの文字列に変換(join)する


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

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の設定。コンテナ間通信はホスト名＝コンテナ名でした


MySQLでリストアをしていた際に`ERROR 2006 (HY000) at line 566: MySQL server has gone away`とエラーが出た。
結果的に`max_allowed_packet`を1MBから4MBへ増やしたことで解決しました。

そのメモ。

## 環境

- CentOS 6.6
- MySQL 5.1

## MySQL server has gone away

調べると[こちら](https://qiita.com/RyutaKojima/items/3772d695db5e2342ab47)の記事に行き当たりました。
このエラーがでる原因を３つ示しています。

1. サーバータイムアウト
2. 接続をcloseしている
3. クエリが大きすぎる or クエリの最大サイズの設定が小さい

この中からクエリサイズが設定よりも大きいためと考え、クエリの最大サイズの設定を変更する。


## max_allowed_packet

クエリの最大サイズは`max_allowed_packet`の設定です。

確認から設定までは[](https://qiita.com/_am_/items/91824da643256d46b847)を参考にしました。

まずは現在の設定を確認します。

```sh
mysql> show variables like 'max_allowed_packet';
+--------------------+---------+
| Variable_name      | Value   |
+--------------------+---------+
| max_allowed_packet | 1048576 |
+--------------------+---------+
1 row in set (0.00 sec)
```

単位はバイトで、設定は1MBでした。
`my.conf`を変更して4MBにします。

`/etc/my.conf`
```conf
max_allowed_packet = 4194304
```
（MySQLのバージョンが古いためか、`max_allowed_packet = 4MB`とすると変更できなかった）

サーバを再起動して設定を反映後もう一度確認します。

```sh
mysql> show variables like 'max_allowed_packet';
+--------------------+---------+
| Variable_name      | Value   |
+--------------------+---------+
| max_allowed_packet | 4194304 |
+--------------------+---------+
1 row in set (0.00 sec)
```

OK!!


## 補足など

### サーバを再起動
CentOS6です

```sh
$ sudo service mysql restart
Shutting down MySQL.... SUCCESS! 
Starting MySQL.. SUCCESS! 
```

### my.confの場所の確認

```sh
$ mysql --help | grep my.cnf
                      order of preference, my.cnf, $MYSQL_TCP_PORT,
/etc/my.cnf /etc/mysql/my.cnf /usr/local/mysql/etc/my.cnf ~/.my.cnf
```

## ERROR 2006 (HY000)について

[MySQL 5.6 リファレンスマニュアル](https://dev.mysql.com/doc/refman/5.6/ja/error-messages-server.html)より

> エラー: 2006 (CR_SERVER_GONE_ERROR)
> メッセージ: MySQL Server が存在しなくなりました
> 
> [B.4 クライアントのエラーコードおよびメッセージ](https://dev.mysql.com/doc/refman/5.6/ja/error-messages-client.html)

> 5 文字の SQLSTATE 値 ('42S02')。この値は、ANSI SQL および ODBC から採用されており、より標準化されています。すべての MySQL エラー番号に、対応する SQLSTATE 値があるわけではありません。それらの場合は、'HY000' (一般エラー) が使用されます。
> 
> [B.3 サーバーのエラーコードおよびメッセージ](https://dev.mysql.com/doc/refman/5.6/ja/error-messages-server.html)

うん、そのままですね。参考になる記事が見つかって良かったです。

## 参考

- [MySQLのエラーと対策まとめ - Qiita](https://qiita.com/RyutaKojima/items/3772d695db5e2342ab47)
  - `MySQL server has gone away`が出る原因を3パターン示している
  - ※参照されているMySQL 4.1 リファレンスマニュアルがリンク切れでした。
- [mysql max_allowed_packetを変更する - Qiita](https://qiita.com/_am_/items/91824da643256d46b847)

MySQL server has gone awayがmax_allowed_packetを変更して解決した

MySQLのアップグレードドキュメントのリンクのまとめです。
ざっと検索したけど5.5以下はほぼ残っていないかも。

## リンク
| Ver. | Links |
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 5.7 to 8.0 | 日本語 [英語](https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html) |
| 5.6 to 5.7 | 日本語 [英語](https://dev.mysql.com/doc/refman/5.7/en/upgrading-from-previous-series.html) |
| 5.5 to 5.6 | [日本語](https://dev.mysql.com/doc/refman/5.6/ja/upgrading-from-previous-series.html) [英語](https://dev.mysql.com/doc/refman/5.6/en/upgrading-from-previous-series.html) |
| 5.1 to 5.5 | 日本語 [英語PDF](https://downloads.mysql.com/docs/mysql-5.5-relnotes-en.a4.pdf) もしくは[公式外のリリースノート](https://www.s-style.co.jp/mysql_news/mysql/20091215.html) |
| 5.0 to 5.1 | [日本語](http://download.nust.na/pub6/mysql/doc/refman/5.1/ja/upgrading-from-5-0.html) 英語 |

### 補足
- MySQL5.5はHTMLでドキュメントがあったようだが、全て8.0にリダイレクトされる。無くなったのかもしれない。
- 番号がとびとびで奇妙に思う方は[MySQLの歴史が面白い - Qiita](https://qiita.com/nom_bom/items/75d409b303f4814143c8)を読むと理由が分かるかと。
- [MySQL Documentation Archive](https://dev.mysql.com/doc/index-archive.html)に古いバージョンのアーカイブがPDF形式で載っている。

MySQLのアップグレードドキュメントのリンク


開発サーバに相乗りするために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を使うための設定


SSHの接続先でdumpを取っていたら、SSH接続がタイムアウトしてdumpも途中で止まってしまった。

```
Terminal close -- exit!
```

この悲しみは２度と起こしてはならないため、SSHが切れてもバックグラウンドジョブで実行させる。

## nohupコマンド

SSH接続がタイムアウトするとSIGHUPが送られ実行中のジョブが停止する。
**nohup**を使って実行したジョブはこのSIGHUPを無視して継続してくれる。

方法は`nohup コマンド &`で最後に`&`を付ける。
実行したディレクトリに`nohup.out`が作られ、標準出力はそこに追加保存される。

せっかくなので、シェルを組んで動かす。

```sh
# 作ったシェルスクリプト
$ cat dump.sh
#!/bin/bash

echo -n "START:"
date
# ダンプの処理
mysqldump -u user -ppasswd -h localhost -B database > dump-$(date "+%Y%m%d").sql

echo -n "END:"
date

# バックグラウンドジョブで実行
$ nohup ./dump.sh&
```

`nohup.out`の結果
```log
START:Thu Dec 26 10:36:54 JST 2019
Warning: Using a password on the command line interface can be insecure.
./dump.sh: line 5:  7332 Terminated              mysqldump -u user -ppasswd -h localhost -B database > dump-$(date "+%Y%m%d").sql
END:Thu Dec 26 10:57:43 JST 2019
```

コマンドラインにパスワードを書いているので警告が出ているが、ダンプ完了まで実行できたので良い。

## 参考

- [nohupを使ってsshログアウト後もシェルスクリプトを動かす - Qiita](https://qiita.com/toshihirock/items/4a6b17a38f9b6e5e7116)
- [HUPシグナルとnohupとdisownとバック/フォアグラウンドジョブの理解 - Qiita](https://qiita.com/yushin/items/732043ee23281f19f983)

nohupを使ってmysqldumpをバックグラウンドで実行する


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

```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     |
+------+-----------------------------------------------------------+-------+
```

Ver.	Links
5.7 to 8.0	日本語英語
5.6 to 5.7	日本語英語
5.5 to 5.6	日本語英語
5.1 to 5.5	日本語英語PDF もしくは公式外のリリースノート
5.0 to 5.1	日本語英語