持续集成,使用Propel ORM将实际测试数据输入数据库的最佳实践

时间:2015-01-18 00:46:24

标签: phpunit continuous-integration database-schema propel

我使用Propel ORM来复制表模式,以便进行持续集成,但Propel只让我得到一个完全充实的模式,它不会让我获得测试数据(或基本必需的数据)。

如何从具有版本控制propel-gen Propel ORM生态系统的实时/测试数据库中获取数据?

1 个答案:

答案 0 :(得分:7)

他们说"最佳实践"在任何事情都不存在 - 它是如此主观,以至于人们应该适应几种形式的良好实践和#34;代替。我认为以下符合该标签的资格 - 最终它对我有用。我已经使用PHPUnit大约一年了,也许我的项目从头开始使用了六个月。

这是我在PHPUnit引导阶段(在phpunit.xml中指定)所做的概要:

  • 删除并创建myproject_test数据库
  • 在生成的SQL
  • 的迁移前副本上调用insert-sql Propel命令
  • 调用migrate推进命令
  • 扫描我的测试文件夹以查找构建类以设置测试,并依次运行每个测试

手动插入SQL然后运行迁移的好处是迁移得到了非常彻底的测试。这特别方便,因为在开发中我有时会做down,修改一个迁移类,然后执行up重新运行它:因此可以放心地知道它将按顺序运行。目前我计划永久保留我的所有移民历史;虽然它会给测试和新版本带来非常小的延迟,但升级部署不会受到影响。

由于我的构建依赖于具有旧的SQL文件,因此我避免使用sql生成命令;如果意外发出,修改后的SQL文件可以在版本控制中轻易恢复。

目前,我只是在myproject_test上使用localhost的数据库名称,因此无论运行哪个测试,其他数据库都不会受到影响。在构建服务器上,您可能需要使用不同的凭据进行连接:请考虑在switch()语句中检测计算机名称,并相应地选择连接详细信息。

为了给您测试数据,我一般倾向于建议您不要使用实时系统中的数据导出。对于其中一个,通常太多了,而且您通常也希望每次测试创建数据片段,以便测试完全隔离。我认为这是一个好主意有两个原因:

  • 您可以并行化独立的测试。因此,当您的浏览器测试套件运行需要五个小时(!)时,您可以设置更多构建服务器以更快地获得绿色构建。
  • 您可能希望本地运行测试套件,或者自己进行测试,或者匹配某个字符串的一组测试,如果一个测试依赖于另一个测试,这可能不起作用。

这是我的构建器类的用武之地。我在bootstrap.php中使用它并在包含测试类的每个文件夹上调用它:

function runBuilders($buildFolder, $namespace)
{
    // I use ! to mark common builders that need to be run first.
    // Since this confuses autoloader, I load that manually.
    $commonBuilder = $buildFolder . '/!CommonBuild.php';
    if (file_exists($commonBuilder))
    {
        require_once $commonBuilder;
    }

    foreach(glob($buildFolder . '/*Build.php') as $class)
    {
        $matches = array();
        $found = preg_match('#/([!a-zA-Z]+)\.php#', $class, $matches);
        if ($found)
        {
            echo '.';

            // Don't use ! characters when creating the class
            $className = str_replace('!', '', $matches[1]);
            call_user_func($namespace . "\\{$className}::build");
        }
    }
}

!CommonBuild.php中,我添加了不会被测试修改的只读数据,因此只有一个副本是安全的。

每个PHPUnit测试类都有一个构建类:对于我拥有的每个*Test.php文件,我都会有一个相应的*Build.php。在每个构建器中,调用build静态方法,并在其中为每个需要构建的测试手动运行方法。这是一个简单的:

public static function build()
{
    self::buildWriteVarToFieldSuccessfully();
    self::buildWriteVarToFieldUsingFailedMatch();
    self::buildWriteVarToFieldUsingFoundMatch();
    self::buildFailIfVariableIsAnArray();
}

在将来的某个时候,我可能会使用Reflection来自动运行这些,就像PHPUnit用于测试一样,但现在还可以。

现在,在我的引导脚本中,我使用测试连接完全初始化Propel,因此可以使用普通的Propel语句。因此,我将创建我需要的数据,如下所示:

protected static function buildWriteVarToFieldUsingFoundMatch()
{
    // Save an item in the holding table
    $employer = self::createEmployer();
    $job = new \Job\Model\JobHolding();
    $job->setReference('12345');
    $job->setLocationAlias('Rhubarb patch');
    $job->setEmployerId($employer->getPrimaryKey());
    $job->save();

    $process = self::createProcessingUsingRowMatching($employer);
    $process->createSource('VarToFieldTest_buildWriteVarToFieldUsingFoundMatch');
}

我有一个命名约定,即测试类中的testWriteVarToFieldUsingFoundMatch测试会在相应的构建类中获得一个名为buildWriteVarToFieldUsingFoundMatch的构建器。它没有在代码中强制执行,但是这个命名有助于轻松找到另一个(我将经常使用我的IDE的分屏功能同时编辑两个)。

因此,在上面的示例中,我只需要一个雇主记录,一个作业记录,一个流程记录和一个源记录来运行此特定测试(而不是整个实时导出)。源记录有一个与测试名称相关的唯一名称,因此它只会用于此测试(我发现我必须注意这里的复制和粘贴错误 - 这很容易在测试中使用错误的数据!)。

创建此类测试数据非常简单,无论您拥有何种类型的数据库:user.name字段,address.line1字段等通常都可以创建,包含唯一标识符,以便在您修改时在测试中的这些数据,你知道只有那个测试会使用它,因此它与其他测试隔离开来。

为了简单起见,我选择在引导程序中运行所有构建器,而不管正在运行什么测试。因为这只需要15秒,在我的情况下,它可能不值得做一些更复杂的事情。但是,如果您愿意,可以使用每个PHPUnit测试中的setUp方法做一些聪明的事情,检测当前测试(如果可能),然后运行相应的构建类。