A PHP library for generating test data
PHP
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
lib
tests
.gitignore
.travis.yml
LICENSE
README.md
bootstrap.php
composer.json
composer.lock
phpunit.xml

README.md

Phactory

(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

Build Status

Installing

Via composer:

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

Via GIT:

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

<?php

require 'phactory/bootstrap.php';