Yii Framework 公式ガイド シリーズ 38 - 特定の状態 (フィクスチャ) の定義

テストプロセスが再現可能であることを保証するために、実際には、特定状態と呼ばれるいくつかの既知の状態でテストする必要があります。ブログ アプリケーションで投稿作成機能をテストする場合、テストを実行するたびに、投稿に関連するテーブル (Post テーブル、Comment テーブルなど) が復元される必要があります。特定の状態。PHPUnit のドキュメントには、特定の状態の一般的な構造について詳しく説明されています。このセクションでは、主に、先ほど説明した例のようなデータベースの特定の状態を構築する方法を紹介します。これは、データベース バックエンド サポートを使用したアプリケーションのテストでおそらく最も時間のかかる部分の 1 つです。Yii によって導入された CBbFixtureManager アプリケーション コンポーネントは、一連のテストを実行するときに、基本的に次のことを実行します。 ul class=" list-paddingleft-2">

Post 表 , Comment 表)应该被恢复到一个特定的状态下. PHPUnit 文档 已经很好的描述了一般的特定状态的构建. 而本节主要介绍怎样像刚才描述的例子那样构建数据库特定状态.

设置构建数据库的特定状态,这恐怕是测试以数据库为后端支持的应用最耗时的部分之一.Yii 引进的 CBbFixtureManager 应用组件可以有效的减轻这一问题.当进行一组测试的时候,它基本上会做以下这些事情:

• 在所有测试运行之前,它重置测试相关数据为可知的状态.

• 在单个测试运行之前, 它将特定的表重置为可知状态.

• 在一个测试方法执行过程中, 它提供了供给特定状态的行数据的访问接口.

请按如下使用我们在 应用配置 中配置的 CDbFixtureManager.

return array(
    'components'=>array(
        'fixture'=>array(
            'class'=>'system.test.CDbFixtureManager',
        ),
    ),
);

然后我们在目录 protected/tests/fixtures下提供一个特定状态数据. 这个目录可以通过配置应用配置文件中的 CDbFixtureManager::basePath 属性指定为其他目录.特定状态数据是由多个称之为特定状态文件的PHP文件组合而成.每个特定状态文件返回一个数组, 代表数据的一个特定表的初始行.文件名和表名相同.以下则是将 Post 表的特定状态数据存储于名为 Post.php 文件里的例子.

<?php
return array(
    &#39;sample1&#39;=>array(
        'title'=>'test post 1',
        'content'=>'test post content 1',
        'createTime'=>1230952187,
        'authorId'=>1,
    ),
    'sample2'=>array(
        'title'=>'test post 2',
        'content'=>'test post content 2',
        'createTime'=>1230952287,
        'authorId'=>1,
    ),
);

正如我们所见, 上面返回了两行数据. 每一行都表示一个数组,其键是表的字段名,其值则是对应的字段值.每行的索引都是称之为行别名的字符串(例如: simple1, simple2). 稍后当我们编写测试脚本的时候, 我们可以方便地通过它的别名调用这行数据.我们将在下节中详细的介绍这个.

你也许注意到了我们并未在上述特定状态中指定 id 字段的值. 这是因为 id 字段已经被定义为自增主键了,它的值也会在我们插入新数据的时候自动生成.

当 CDbFixtureManager 第一次被引用时, 它会仔细检查所有的特定状态文件然后使用他们重置对应的表.它通过清空表,重置表主键的自增序列值,然后插入来自特定状态文件的数据行到表中来重置表.

有时候,我们可能不想在一套测试前重置特定状态文件里描述的每一个表, 因为重置太多的特定状态文件可能需要很多时间.这种情况下,我们可以写一个PHP脚本来定制这个初始化过程.这个脚本应该被保存在存放特定状态文件的目录下,并命名为 init.php.当 CDbFixtureManager 检测到了这个脚本的存在, 它将执行这个脚本而不是重置每一个表.

不喜欢使用默认方式来重置表也是可以的,例如: 清空表然后插入特定状态数据. 如果是这种情况, 我们可以为指定的特定状态文件编写一个初始化脚本.这个脚本必须名称为表名+.init.php. 例如: Post 表的初始化脚本文件就是 Post.init.phpすべてのテストを実行する前に、テスト関連のデータを認識可能な状態にリセットします

単一のテストを実行する前に、特定のデータをリセットします。テーブルを既知の状態にします。

テスト メソッドの実行中、特定の状態の行データを提供するアクセス インターフェイスが提供されます。

アプリケーション設定で CDbFixtureManager を次のように設定しました。

rrreee

🎜 次に、ディレクトリ protected/tests/fixtures の下に特定のステータス データを提供します。このディレクトリは、Configure からアクセスできます。アプリケーション構成ファイルの CDbFixtureManager::basePath 属性で別のディレクトリを指定します。特定の状態データは、特定の状態ファイルと呼ばれる複数の PHP ファイルで構成され、特定のデータを表す配列を返します。ファイル名はテーブル名と同じです。 以下は、Post.php という名前のファイルに Post テーブルの特定のステータス データを保存する例です。 🎜🎜rrreee🎜🎜🎜 ご覧のとおり、上記では 2 行のデータが返されます。各行は配列を表し、そのキーはテーブルのフィールド名で、その値は対応するフィールド値です。これは 🎜line エイリアス🎜 の文字列です (例: simple1、simple2)。後でテスト スクリプトを作成するときに、エイリアス This を通じて簡単に呼び出すことができます。これについては次のセクションで詳しく説明します。🎜🎜上記の特定の状態で id フィールドの値を指定していないことに気づいたかもしれません。 >id code> フィールドは自動インクリメント主キーとして定義されており、新しいデータを挿入するときにその値も自動的に生成されます 🎜🎜 CDbFixtureManager が初めて参照されるとき、すべての特定のキーが注意深くチェックされます。テーブルをクリアし、テーブルの主キーの自動インクリメント シーケンス値をリセットし、特定の状態ファイルからテーブルにデータ行を挿入することで、対応するテーブルをリセットします。特定の状態ファイルに記述されているすべてのテーブルをリセットする前に、一連のテストでこれを実行したくない場合があります。これは、特定の状態ファイルのリセットが多すぎると時間がかかる可能性があるためです。この場合、PHP スクリプトを作成してカスタマイズできます。この初期化プロセスは、特定の状態ファイルをディレクトリに保存し、init.php という名前を付けて保存する必要があります。CDbFixtureManager は、このスクリプトの存在を検出すると、それぞれをリセットする代わりにこのスクリプトを実行します。 🎜🎜デフォルトを使用したくない場合は、テーブルをクリアして特定の状態データを挿入することによって、テーブルをリセットすることもできます。スクリプトの名前はテーブル名 + .init.php である必要があります。例: Post テーブルの初期化スクリプト ファイルは Post.init.php です。 CDbFixtureManager がこのスクリプトを見つけると、デフォルトのメソッドを使用してテーブルをリセットする代わりに、このスクリプトを実行します。🎜🎜🎜🎜ヒント:🎜 特定の状態ファイルが多すぎると、テスト時間が大幅に長くなります。そのため、特定の状態のみを提供する必要があります。テスト中にデータが変更されるテーブルのファイル。検索サービスに使用されるテーブルは変更されないため、特定の状態ファイルは必要ありません 🎜🎜🎜 次の 2 つのセクションでは、によって管理される特定の状態の使用方法について説明します。単体テストと機能テストにおける CDbFixtureManager 🎜🎜これは、Yii Framework 公式ガイド シリーズ 38 - 特定の状態の定義 (フィクスチャ) です。詳細については、PHP 中国語 Web サイト (www.php.cn) に注目してください。 🎜🎜🎜🎜