よく忘れるので自分用にメモしておく。
以下コマンドの前につけるphp bin/consoleは省略する。

1. 事前準備

.envファイルを設定する

./.env

DATABASE_URL="mysql://root:root@db:3306/db_name?serverVersion=13&charset=utf8"

DB作成

以下のコマンドを使うと .env の接続設定で指定した db_name のデータベースを作成する。

$ doctrine:database:create

collateの文字コードを繋いでるDBに合わせる

./config/packages/doctrine.yaml

default_table_options:
            collate: utf8_unicode_ci

Status表示

二つのコマンドが用意されているが、正直どっちを使ってもいいと思う。

$ doctrine:migrations:status
$ doctrine:migrations:list

個人的にはlistの方が簡潔で、かつgetDescriptionメソッドで返している値も表示しれくれるのでよく使っている。

2. 生成

方法１

現在のentityとdatabaseの状態を比べて差分のsqlのmigrationsファイルを生成

doctrine:migrations:diff

方法２

空のmigrationsファイルを生成

doctrine:migrations:generate

3. 実行

1. 全て実行

doctrine:migrations:migrate

2. ファイル指定して実行

ファイル指定してdownもできる

doctrine:migrations:excute --up 'DoctrineMigrations\Version20210103062456'
doctrine:migrations:excute --down 'DoctrineMigrations\Version20210103062456'

--dry-runオプションで実行されるSQL文が確認できるはずだが、なぜか確認されない。。。。
あとで時間ある際に調査、、、、

4. Tips

マイグレーションを実行せずに履歴情報のみを変更する。

doctrine:migrations:version {バージョン} (--add|--delete)

実行確認を出させないオプション

複数行のコマンドを一気に流す時によくつけるオプション

--no-interaction

全てのmigrationsファイルの状態を確認

doctrine:migrations:status --show-versions

*このオプションは最近のバージョンではなくなっているが、doctrine:migrations:listコマンドが対応していないバージョンではすごく助けられていた。