Команда doctrine:migrations:status

Команда doctrine:migrations:status показывает текущее состояние миграций Doctrine в проекте Symfony. Она выводит таблицу со всеми доступными версиями миграций и отмечает, какие из них уже применены к базе данных, а какие ещё нет. Это полезно для быстрой проверки синхронизации схемы БД с кодом приложения.

Синтаксис

php bin/console doctrine:migrations:status

Команда не принимает обязательных аргументов. Дополнительно можно передать опцию --show-versions, чтобы вывести полный список версий миграций, а не только сводку.

Пример

Давайте посмотрим статус миграций в проекте:

php bin/console doctrine:migrations:status

Результат выполнения команды:

== Configuration
	>> Name:											   Application Migrations
	>> Database Driver:									pdo_mysql
	>> Database Name:									  app_db
	>> Configuration Source:							   manually configured
	>> Version Table Name:								 doctrine_migration_versions
	>> Migrations Namespace:							   DoctrineMigrations
	>> Migrations Directory:							   /app/migrations
	>> Current Version:									2024-01-15 10:00:00 (20240115100000)
	>> Latest Version:									 2024-02-01 12:00:00 (20240201120000)
	>> Executed Migrations:								3
	>> Executed Unavailable Migrations:					0
	>> Available Migrations:							   4
	>> New Migrations:									 1

Пример

Давайте выведем полный список версий миграций с их статусом:

php bin/console doctrine:migrations:status --show-versions

Результат выполнения команды:

== Configuration
	>> Name:											   Application Migrations
	>> Database Driver:									pdo_mysql
	>> Database Name:									  app_db
	>> Current Version:									2024-01-15 10:00:00 (20240115100000)
	>> Latest Version:									 2024-02-01 12:00:00 (20240201120000)
	>> Executed Migrations:								3
	>> Available Migrations:							   4

== Migration Versions
	>> 20240101000000	Yes
	>> 20240115100000	Yes
	>> 20240120100000	Yes
	>> 20240201120000	No

В колонке статуса значение Yes означает, что миграция уже применена, а No - что она ещё ожидает выполнения.

Пример

Давайте создадим новую миграцию и проверим, как изменится статус:

php bin/console make:migration

После создания файла миграции запустим команду статуса:

php bin/console doctrine:migrations:status

Результат выполнения команды:

>> Current Version:									2024-01-15 10:00:00 (20240115100000)
>> Latest Version:									 2024-02-10 09:30:00 (20240210093000)
>> Executed Migrations:								3
>> Available Migrations:							   5
>> New Migrations:									 2

Количество новых миграций увеличилось, значит база данных отстаёт от текущего состояния кода.

Смотрите также

команда doctrine:migrations:migrate,
которая применяет ожидающие миграции к базе данных
команда doctrine:migrations:diff,
которая генерирует миграцию по разнице схемы
команда doctrine:migrations:generate,
которая создаёт пустой файл миграции
команда doctrine:schema:validate,
которая проверяет соответствие схемы БД сущностям