Version 5 supported

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.

use SilverStripe\Dev\SapphireTest;
use SilverStripe\Core\Injector\Injector;

class MyObjectTest extends SapphireTest 

    protected $factory;

    function __construct() {

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

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

        $this->factory = $factory;

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

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

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

Related Documentation

API Documentation