This document contains information for an outdated version and may not be maintained any more. If some of your projects still use this version, consider upgrading as soon as possible.

How to use a FixtureFactory

The FixtureFactory is used to manually create data structures for use with tests. For more information on fixtures see the Fixtures documentation.

In this how to we'll use a FixtureFactory and a custom blue print for giving us a shortcut for creating new objects with information that we need.

class MyObjectTest extends SapphireTest {

    protected $factory;

    function __construct() {

        $factory = Injector::inst()->create('FixtureFactory');

        // Defines a "blueprint" for new objects
        $factory->define('MyObject', array(
            'MyProperty' => 'My Default Value'

        $this->factory = $factory;

    function testSomething() {
        $MyObjectObj = $this->factory->createObject(
            array('MyOtherProperty' => 'My Custom Value')

        echo $MyObjectObj->MyProperty;
        // returns "My Default Value"

        echo $myPageObj->MyOtherProperty;
        // returns "My Custom Value"

API Documentation

Was this article helpful?