IBX-11939: Doctrine migrations (6.0)

[Steveb-p]

Warning

#1 (4.6) and #2 (5.0) have both landed (#1 merged, #2 closed after landing directly on 5.0), so this PR's base is now the real 6.0 branch itself rather than the temporary base/ibx-11939-4.6-5.0-merged-6.0 scaffold.

Warning

This is the 6.0 follow-up to #2 (5.0). Review that PR first — this carries the same migration forward onto this branch.

🎫 Issue	IBX-11939

Related PRs:

Package	4.6	5.0	6.0
ibexa/activity-log	#166	#167	#168 ⏭️
ibexa/cart	#172	#173 🔄	#174
ibexa/collaboration	–	#115	#116
ibexa/connector-ai	–	#198	#199
ibexa/connector-payum ⚠️	#39	#40 ⏭️	#41
ibexa/core	#785 🩹	#787 🔄 🩹	#788 🩹
ibexa/corporate-account	#369	#370 🔄	#371
ibexa/discounts	–	#341 🩹	#342 🩹
ibexa/discounts-codes	–	#50	#51
ibexa/doctrine-migrations	#1	#2	#3 ← this PR
ibexa/doctrine-schema	#41	#42	#43
ibexa/fieldtype-page	#208 🩹	#209 🔄 🩹	#210 🩹
ibexa/form-builder	#240 🩹	#241 🔄 🩹	#242 🩹
ibexa/measurement	#133	#134 🔄	#135
ibexa/messenger	–	#22	#23
ibexa/migrations	#438	#439	#440
ibexa/order-management	#188	#189 🔄	#190
ibexa/payment	#204	#205 🔄	#206
ibexa/product-catalog	#1543	#1544 🔄	#1545
ibexa/product-catalog-date-time-attribute	–	#53	#54
ibexa/product-catalog-symbol-attribute	–	#17	#18
ibexa/scheduler	#168	#169 🔄	#170
ibexa/segmentation	#186	#187 🔄	#188
ibexa/share	–	#190	#191
ibexa/shipping	#154	#155 🔄	#156
ibexa/site-context	–	–	#121
ibexa/site-factory	#172	#173 🔄 🩹	#174 🩹
ibexa/taxonomy ⚠️	#431	#432	#433
ibexa/translations-management	–	#174	#175
ibexa/user	#128	#129 🔄	#130
ibexa/workflow	#191 🩹	#192 🔄 🩹	#193 🩹

🔄 = this branch adds an upgrade migration (renames/FK-retargets existing schema), not just a fresh baseline.
🩹 = this branch also received a backported delta migration, converted from a legacy ibexa/installer upgrade/db/*.sql script (4.6.0 or later) that the original baseline-only migration didn't cover. See IBX-11939 upgrade-scripts backport report or that package's own PR description for details.
⚠️ = fixes a different, related problem (missing SchemaBuilderEvent support for a plain Doctrine ORM entity/table) — not a Doctrine Migrations baseline/upgrade migration like the rest of this table. See that package's own PR description for details.

Description:

Adds a Doctrine Migrations integration for Ibexa-internal migrations, kept entirely separate
from the project's own migrations.

1. An independent, Ibexa-only migration set

IbexaOnlyMigrationsRepository/IbexaOnlyDependencyFactory provide a DependencyFactory that
behaves like the application's own doctrine.migrations.dependency_factory (same Configuration
and logger) except it always runs against the ibexa.persistence.connection service and only
ever sees migrations tagged with IbexaMigrationTag::TAG. RegisterMigrationsPass wires tagged
migration services into this repository at compile time and nothing else — the application's own
doctrine.migrations.dependency_factory is never touched, so Ibexa's migrations never appear in
the project's own doctrine:migrations:* commands.

2. Write a migration

Extend AbstractSqlMigration for per-platform SQL, and implement IbexaMigrationInterface so the
migration is ordered correctly (by target Ibexa version, then creation date) relative to other
Ibexa migrations:

<?php

namespace Ibexa\Bundle\Scheduler\Migration;

use DateTimeImmutable;
use Doctrine\DBAL\Schema\Schema;
use Ibexa\Contracts\DoctrineMigrations\Migrations\AbstractSqlMigration;
use Ibexa\Contracts\DoctrineMigrations\Migrations\IbexaMigrationInterface;
use Ibexa\DoctrineMigrations\Migration\SqlPlatform;

final class InstallSchemaMigration extends AbstractSqlMigration implements IbexaMigrationInterface
{
    public function getDescription(): string
    {
        return 'Creates the ibexa/scheduler database schema';
    }

    public static function getTargetVersion(): string
    {
        return '6.0.0';
    }

    public static function getCreationDate(): DateTimeImmutable
    {
        return new DateTimeImmutable('2026-07-20 00:00:00');
    }

    public function up(Schema $schema): void
    {
        $this->abortIfUnsupportedPlatform(SqlPlatform::MYSQL, SqlPlatform::POSTGRESQL, SqlPlatform::SQLITE);

        if ($schema->hasTable('ibexa_scheduler_scheduled_entry')) {
            return; // already present (e.g. legacy SchemaBuilderEvent install) — nothing to do
        }

        if ($this->isMySQL()) {
            $this->addSqlFile(__DIR__ . '/sql/install-schema-mysql.sql');
        } elseif ($this->isPostgreSQL()) {
            $this->addSqlFile(__DIR__ . '/sql/install-schema-postgresql.sql');
        } elseif ($this->isSqlite()) {
            $this->addSqlFile(__DIR__ . '/sql/install-schema-sqlite.sql');
        }
    }
}

AbstractSqlMigration (extends Doctrine's own AbstractMigration) provides:

• isMySQL() / isPostgreSQL() / isSqlite() / isPlatform(string $platform) — named checks
  instead of raw $this->platform instanceof ..., backed by SqlPlatform's string constants.
• addSqlFile(string $file, string $delimiter = self::DEFAULT_SQL_STATEMENT_DELIMITER) — loads
  one or more SQL statements from an external file (separated by a delimiter line) and queues each
  one via addSql(), so a platform's SQL can live in its own .sql file instead of a PHP heredoc.
• abortIfUnsupportedPlatform(string ...$supportedPlatforms) — aborts the migration with a clear
  message on any platform not listed, instead of silently queuing zero SQL and being recorded as
  successfully executed.

3. Register it

# services.yaml
Ibexa\Bundle\Scheduler\Migration\InstallSchemaMigration:
    autowire: true
    autoconfigure: false
    public: false
    arguments:
        $connection: '@ibexa.persistence.connection'
    tags:
        - { name: !php/const Ibexa\Contracts\DoctrineMigrations\Migrations\IbexaMigrationTag::TAG }

autoconfigure: false matters: if the application enables Doctrine's own
doctrine_migrations.enable_service_migrations option, an autoconfigured AbstractMigration
subclass gets auto-tagged doctrine_migrations.migration by Doctrine's own bundle — leaking it
into the project's own migration view regardless of the tag above.

4. ibexa:doctrine:migrations:* console commands

A full parallel copy of every doctrine:migrations:* command (migrate, status, execute,
generate, latest, up-to-date, diff, dump-schema, rollup, sync-metadata-storage,
version, current, versions), each constructed against IbexaOnlyDependencyFactory instead of
the application's own factory — so e.g. ibexa:doctrine:migrations:status reports only Ibexa's
tagged migrations, while doctrine:migrations:status continues to report only the project's own.
Every doctrine/migrations command class shares the same
DoctrineCommand::__construct(?DependencyFactory, ?string $name) constructor, so no new command
classes were needed — only new service definitions pointing at a different DependencyFactory.

For QA:

Run the existing suites: composer test, composer test-integration, composer phpstan, composer check-cs.

To verify the separation end-to-end in a real app:

bin/console ibexa:doctrine:migrations:status
bin/console doctrine:migrations:status

The first should list Ibexa's tagged migrations (e.g. this package's own test/fixture migrations,
or any real consumer package's migrations if installed); the second should show none of them.

Documentation:

See the usage examples in the Description above. AbstractSqlMigration's class docblock
(src/contracts/Migrations/AbstractSqlMigration.php) is the authoritative reference for its helper
methods.