Symfony 4：如何在测试前执行Doctrine迁移？

我来帮你梳理下这两个问题的解决方案——完全不用依赖exec(...)这种不够优雅的方式，而且SQLite的报错也有明确的解决路径：

一、替代exec的更优迁移执行方案 #

在Codeception和Symfony的组合中，有两种更贴合框架生态的方式来执行迁移，比直接调用shell命令靠谱得多：

• 利用Codeception Symfony模块的命令执行方法
  如果你已经启用了Symfony模块，可以直接在测试的前置方法或者用例中调用runSymfonyCommand()来执行迁移命令，完全不需要碰exec：

  public function _before(AcceptanceTester $I)
  {
      // 无交互模式执行迁移到最新版本
      $I->runSymfonyCommand('doctrine:migrations:migrate', ['--no-interaction' => true]);
  }
  

  这种方式直接通过Symfony的控制台组件执行命令，能自动继承测试环境的配置和依赖，避免了shell执行带来的路径、环境变量等潜在问题。

• 直接调用Doctrine迁移的PHP API
  如果你需要更精细的控制（比如在测试启动前全局初始化数据库），可以在测试的bootstrap文件（比如tests/_bootstrap.php）中直接调用Doctrine迁移的PHP API，完全脱离命令行：

  // 引入Symfony的EntityManager
  $entityManager = require dirname(__DIR__).'/config/bootstrap.php';
  
  // 初始化迁移依赖工厂
  $dependencyFactory = \Doctrine\Migrations\DependencyFactory::fromEntityManager(
      new \Doctrine\Migrations\Configuration\Configuration($entityManager->getConnection()),
      $entityManager
  );
  
  // 执行迁移
  $migrator = $dependencyFactory->getMigrator();
  $migrator->migrate();
  

  这种方式适合需要在所有测试前统一初始化数据库的场景，而且能直接捕获迁移过程中的异常，方便调试。

二、SQLite迁移报错"Migration can only be executed safely on mysql"的解决 #

这个错误一般有两种原因，对应不同的解决方法：

• 迁移文件里有MySQL专属的检查逻辑
  打开报错的迁移文件，看看是不是加了类似这样的代码：

  if ($this->connection->getDatabasePlatform()->getName() !== 'mysql') {
      throw new \RuntimeException('Migration can only be executed safely on mysql');
  }
  

  如果是测试环境用SQLite，你可以注释掉这个检查，或者改成多平台兼容的分支逻辑：

  $platform = $this->connection->getDatabasePlatform()->getName();
  if ($platform === 'mysql') {
      // 执行MySQL专属的SQL语句
      $this->addSql('ALTER TABLE my_table ADD COLUMN foo VARCHAR(255) ENGINE=InnoDB');
  } elseif ($platform === 'sqlite') {
      // 执行SQLite兼容的语句（去掉MySQL特有的部分）
      $this->addSql('ALTER TABLE my_table ADD COLUMN foo VARCHAR(255)');
  }
  

• 迁移使用了MySQL特有的SQL语法
  SQLite和MySQL的语法有不少差异，比如MySQL的ENGINE=InnoDB、AUTO_INCREMENT（SQLite用AUTOINCREMENT）、某些函数等。你需要检查迁移文件中的原生SQL，把MySQL专属的部分改成SQLite兼容的写法，或者尽量用Doctrine的Schema API来构建表结构，让Doctrine自动适配不同数据库：

  // 用Schema API替代原生SQL，自动兼容多数据库
  $schemaManager = $this->connection->createSchemaManager();
  $table = $schemaManager->listTableDetails('my_table');
  $table->addColumn('new_column', 'string', ['length' => 255]);
  $schemaManager->alterTable($table);
  

内容的提问来源于stack exchange，提问作者Jakub Saleniuk