factory

Factory is used to create objects in a standard way that allow for easy replacement with test double from unit tests. This has only been tested with phpunit, but there isn't a reason it should not be able to work with other unit testing frameworks., _(*1)

// This is equivalent to $newObject = new NewObjectClass(); in your normal code execution $newObject = Factory::createNewObject(NewObjectClass::class); $newObject->standardOperations();, _(*2)

Then when you are in a unit test, there is a simple method to replace $newObject with a test double., _(*3)

// $newObjectMock is already a mock object, and you want it to take the place of $newObject Factory::injectObject(NewObjectClass::class, $newObjectMock);, _(*4)

In many cases, your constructors will take parameters. With Factory, it is simple to pass parameters to object constructors., _(*5)

// This is equivalent to $newObject = new NewObjectClass($someOtherObject); $newObject = Factory::createNewObject(NewObjectClass::class, [$someOtherObject]); $newObject->standardOperations();, _(*6)

Then when you are in a unit test, everything works the same way. $newObjectMock is already a mock object. Factory::injectObject(NewObjectClass::class, $newObjectMock);, _(*7)

Factory also supports being able to create different instances of the same object. Many times you will need to create the same object in multiple methods., _(*8)

$newObject1 = Factory::createNewObject(NewObjectClass::class);, _(*9)

// a little while later 4newObject2 = Factory::createNewObject(NewObjectClass::class);, _(*10)

// In your test, assuming $newObject1Mock and $newObject2Mock are mock objects already. Use a zero-based index // to order the injections you want. Factory::injectObject(NewObjectClass::class, $newObject1Mock, 0); Factory::injectObject(NewObjectClass::class, $newObject2Mock, 1);, _(*11)