README

FactoryGirl 是一个为 Yii 框架提供的 fixtures 替换工具

类似于 Ruby gem factory_girl

安装

下载 factory_girl_0.1.0.phar

配置

在你的 bootstrap.php

require_once('/your/download/path/factory_girl_0.1.0.phar');
use FactoryGirl\Factory as FactoryGirl;
$factoryPaths = array('foo/bar/factories', 'bar/baz/factories');
FactoryGirl::setup($factoryPaths);

用法

FactoryGirl::build('User')

FactoryGirl::create('User')

FactoryGirl::attributes('User')

Factory 文件格式

<?php
// FileName UserFactory.php
return array(
  'class' => 'User', // -> new User
  'attributes' => array(
    'name' => 'xxxx', // $user->name = 'xxxx'
    'permission' => 'default', // $user->permission = 'default'
  ),
  'admin' => array(
    'name' => 'admin',
    'permission' => 'admin' // $user->permission = 'admin'
  )
);

?>

// In Your tests
$user = FactoryGirl::create('User')
$user->permission; // -> 'default'

$user = FactoryGirl::create('User', array('permission'->'admin'));
$user->permission; // -> 'admin'

$admin = FactoryGirl::create('User', array(), 'admin');
$admin->permission; // -> 'admin'

// after each test case
FactoryGirl::flush(); // remove created records

更多详情请查看 tests/FactoryGirl/FactoryTest.php

FactoryGirl 序列

<?php

return array(
  'class' => 'Foo',
  'attributes' => array(
    'name' => 'bar_{{sequence}}',
  ),
);
?>

FactoryGirl::build('Foo')->name // -> bar_0
FactoryGirl::build('Foo')->name // -> bar_1

// reset sequence number
FactoryGirl::resetSequence();
FactoryGirl::build('Foo')->name // -> bar_0

更多详情请查看 tests/FactorySequenceTest.php

提示

如果你无法使用 save 方法

// UserFactory.php
return array(
  'class' => 'User',
  'attributes' => array(),
  'save' => array('generate'),
);

// In your test
FactoryGirl::create('User');
// called `generate`, instead of `save`

如果你想要设置受保护的或私有变量

// UserFactory.php
return array(
  'class' => 'User',
  'attributes' => array(
    'setName' => 'foo',
    'generatePassword' => array('plain_password', 'seed'), 
  ),
);

// In your test
FactoryGirl::create('User');
// $user = new User;
// $user->setName('foo');
// $user->generatePassword('plain_password', 'seed');

已知问题：无法使用 FactoryGirl::attributes('User');

贡献

1. 创建一个分支
2. 创建你的功能分支 (git checkout -b my-new-feature)
3. 提交你的更改 (git commit -am 'Added some feature')
4. 推送到分支 (git push origin my-new-feature)
5. 创建新的 Pull Request