rbone/phactory

A PHP library for generating data for tests

1.4.0 2014-11-05 01:57 UTC

Requires

• php: >=5.3

Requires (Dev)

• phpunit/phpunit: 3.7.*

MIT

• Richard Bone
• Alan Willms

• data
• test

README

(ver documentação em português)

A PHP library for creating data for tests. Designed for simplicity and extensibility.

Usage

Define factories like so:

<?php

class UserPhactory
{
	public function blueprint()
	{
		return array(
			'name' => 'User #{sn}',
			'activated' => true,
		);
	}

	public function admin()
	{
		return array(
			'isadmin' => true,
		);
	}
}

Then use them:

<?php

$user = Phactory::user();

echo $user->name; // 'User 0001'
echo $user->activated ? 'true' : 'false'; // 'true'

$admin = Phactory::user('admin');

echo $user->name; // 'User 0002'
echo $user->activated ? 'true' : 'false'; // 'true'
echo $user->isadmin ? 'true' : 'false'; // 'true'

That's just the basics of what Phactory allows you to do, fixtures, dependencies and relationships are also supported, read the wiki documentation for more information.

What it doesn't do

Phactory doesn't know about your database or ORM, this is by design. Rather than trying to support every ORM out there Phactory is designed to be easily extended to support whatever it needs to. e.g. using our above UserPhactory

<?php

class User {}

class MyCustomBuilder extends \Phactory\Builder
{
	protected function toObject($name, $values)
	{
		$object = new $name;

		foreach ($values as $key => $value) {
            $object->$key = $value;
        }

		return $object;
	}
}

Phactory::builder(new MyCustomBuilder);

$user = Phactory::user();

echo get_class($user); // 'User'

Status

Up to v1.3.0

Installing

Via composer:

{
  "require-dev": {
    "rbone/phactory": "1.3.*"
  }
}

Via GIT:

git clone git://github.com/rbone/phactory.git

<?php

require 'phactory/bootstrap.php';