The document provides details about how PhpSpec works under the hood and describes extension points that allow customizing PhpSpec's behavior. The key points are: 1. PhpSpec is a Symfony console application that initializes a service container and loads configuration from phpspec.yml. 2. The service container is used to register core services like IO, event dispatchers, generators, and commands. 3. Extensions can customize PhpSpec by registering additional services using common prefixes, replacing existing services, or adding new commands/formatters. 4. Examples describe object behavior in specifications, which are grouped into suites that are then located, loaded, and executed when running Php

1. PhpSpec extension points
for version 2.0.0

2. About me
PHP Software engineer
KrakDevs meetups organizer
Huge fan of BDD/TDD
Part of Coduo
Web:
https://github.com/norzechowicz
https://twitter.com/norzechowicz
http://coduo.pl
http://krakdevs.pl
Norbert Orzechowicz

5. This is everything you
need. Trust me ;)

6. Ok, so how PhpSpec
works?

7. Just like a regular
Symfony2 console
application
Read more
http://symfony.com/doc/current/components/console/index.html

8. Ok, but what happens
when user execute „run”
command?

9. $ bin/phpspec run

10. #!/usr/bin/env php!
<?php!
//bin/phpspec!
!
$app = new PhpSpecConsoleApplication(PHPSPEC_VERSION);!

11. Initialize console application
<?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
/**!
* The command line application entry point!
*/!
class Application extends BaseApplication!
{!
public function __construct($version)!
{!
}!
}!

12. Create service container
<?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
/**!
* The command line application entry point!
*/!
class Application extends BaseApplication!
{!
public function __construct($version)!
{!
$this->container = new ServiceContainer;!
parent::__construct('phpspec', $version);!
}!
}!
In the name of dependency injection!

13. Service Container
<?php!
///phpspec/src/PhpSpec/ServiceContainer.php!
namespace PhpSpec;!
!
class ServiceContainer!
{!
// Sets a object or a callback for the object creation. !
// A new object will be created every time!
public function set($id, $value);!
!
// Sets a object or a callback for the object creation. !
// The same object will be returned every time!
public function setShared($id, $callable);!
!
// Retrieves a service from the container!
public function get($id);!
!
// Retrieves a list of services of a given prefix!
public function getByPrefix($prefix);!
}!
Explanation of the most important methods

14. Register service example
<?php!
///phpspec/src/Acme/MyClass.php!
namespace Acme;!
!
class MyClass!
{!
public function setup(ServiceContainer $container)!
{!
$container->set('acme.service.foo', function ($c) {!
return new Foo();!
});!
!
$container->setShared('acme.service.bar', function ($c) {!
return new Bar();!
});!
!
$container->getByPrefix('acme.service');!
// will return acme.service.foo as Foo incance &
! ! ! // acme.service.bar as Bar instance!
}!
}!

15. #!/usr/bin/env php!
<?php!
//bin/phpspec!
!
$app = new PhpSpecConsoleApplication(PHPSPEC_VERSION);!
$app->run();!

16. Run!
<?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
/**!
* The command line application entry point!
*/!
class Application extends BaseApplication!
{!
public function doRun(InputInterface $input, OutputInterface $output)!
{!
$this->setupContainer($this->container); !
}!
}!
Not so fast, setup service container first

17. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
}!
}!

18. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
}!
}!

19. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
}!
}!

20. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
}!
}!

21. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
$this->setupLocator($container);!
}!
}!

22. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
$this->setupLocator($container);!
$this->setupLoader($container);!
}!
}!

23. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
$this->setupLocator($container);!
$this->setupLoader($container);!
$this->setupFormatter($container);!
}!
}!

24. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
$this->setupLocator($container);!
$this->setupLoader($container);!
$this->setupFormatter($container);!
$this->setupRunner($container);!
}!
}!

25. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
$this->setupLocator($container);!
$this->setupLoader($container);!
$this->setupFormatter($container);!
$this->setupRunner($container);!
$this->setupCommands($container);!
}!
}!

26. <?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
$this->setupIO($container);!
$this->setupEventDispatcher($container);!
$this->setupGenerators($container);!
$this->setupPresenter($container);!
$this->setupLocator($container);!
$this->setupLoader($container);!
$this->setupFormatter($container);!
$this->setupRunner($container);!
$this->setupCommands($container);!
!
$this->loadConfigurationFile($container);!
}!
}!

27. RUN!
<?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
public function doRun(InputInterface $input, OutputInterface $output)!
{!
$this->setupContainer($this->container);!
!
foreach ($this->container->getByPrefix('console.commands') as $command) {!
$this->add($command);!
}!
!
return parent::doRun($input, $output);!
}!
}!
But first add commands.
By default „run” and „describe”.

28. Application is ready
what now?

29. Run command
<?php!
//phpspec/src/PhpSpec/Console/Command/RunCommand.php!
namespace PhpSpecConsoleCommand;!
!
class RunCommand extends Command!
{!
protected function configure()!
{!
// configure input options, arguments, command name!
}!
!
protected function execute(InputInterface $input, OutputInterface $output)!
{!
// run suite with runner.suite service!!
}!
}!
There is no magic here, just simple Symfony2 console
command.

30. Suite you say?

31. Space where specifications exists
Suite

32. Specifications?

33. Spaces where examples exists
Suite
FooClassSpec.php - Specification
BarClassSpec.php - Specification
FazClassSpec.php - Specification
BazClassSpec.php - Specification

34. Examples!?

35. Yes, functions that describe object behavior
(tests)
Suite
FooClassSpec.php - Specification
function it_is_awesome() - Example
function it_do_awesome_stuff() - Example
function it_is_famous() - Example

36. Make sense now!

37. Run command simplified algorithm
1. Localize suite - Locator
2. Load suite - Loader
3. Run suite - Suite Runner
4. Run specifications - Specification Runner
5. Run examples - Example Runner

38. And what about
extensions?

39. Remember container setup?
<?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupContainer(ServiceContainer $container)!
{!
// . . . !
$this->loadConfigurationFile($container);!
}!
}!

40. phpspec.yml
suites:
acme_suite:
namespace: AcmeTheLib
spec_prefix: acme_spec
!
# shortcut for
# my_suite:
# namespace: TheNamespace
my_suite: TheNamespace
!
extensions:!
- PhpSpecSymfony2ExtensionExtension

41. Extension interface
<?php!
//phpspec/src/PhpSpec/Extension/ExtensionInterface.php!
namespace PhpSpecExtension;!
!
use PhpSpecServiceContainer;!
!
interface ExtensionInterface!
{!
/**!
* @param ServiceContainer $container!
*/!
public function load(ServiceContainer $container);!
}!

42. That’s all?

43. Simply beautiful, right?

44. But what can I do with it?

45. But what can I do with it?
Register event listeners as a services
Replace existing services
Register custom example maintainers
Register new fomatters
Register new code generators
Replace suite locator
Register new matchers
Register new commands
!
And many many more…

46. How?

47. Let me show you how to
register an event listener.

48. Event subscriber class
<?php!
///src/Coduo/PhpSpec/Listener/DataProviderListener.php!
namespace CoduoPhpSpecListener;!
!
class DataProviderListener implements EventSubscriberInterface!
{!
public static function getSubscribedEvents()!
{!
return array(!
'beforeSpecification' => array('beforeSpecification'),!
);!
}!
!
public function beforeSpecification(SpecificationEvent $event)!
{!
// listener logic here !
}!
}!

49. PhpSpec extension class
<?php!
//src/Coduo/PhpSpec/DataProviderExtension.php!
namespace CoduoPhpSpec;!
!
class DataProviderExtension implements ExtensionInterface!
{!
public function load(ServiceContainer $container)!
{!
$container->set(!
'event_dispatcher.listeners.data_provider', !
function ($c) {!
return new DataProviderListener();!
}!
);!
}!
}!

50. And how PhpSpec know
that my service is an
event listener?

51. Just use proper prefix
<?php!
//phpspec/src/PhpSpec/Console/Application.php!
!
use SymfonyComponentConsoleApplication as BaseApplication;!
!
class Application extends BaseApplication!
{!
protected function setupEventDispatcher(ServiceContainer $container)!
{!
$container->setShared('event_dispatcher', function ($c) {!
$dispatcher = new EventDispatcher;!
!
array_map(!
array($dispatcher, 'addSubscriber'),!
$c->getByPrefix('event_dispatcher.listeners')!
);!
!
return $dispatcher;!
});!
}!
}!

52. Are there any other prefixes
that I can use?

53. List of prefixes that you can use by default.
event_dispatcher.listeners - EventSubscriberInterfac
code_generator.generators - GeneratorInterfac
formatter.presenter.differ.engines - DifferEngineInterface
locator.locators - ResourceLocatorInterface
runner.maintaners - MaintainerInterface
console.commands - Command

54. Thank you for your
attention

55. Coduo
behaviour driven developers
contact@coduo.pl
Hire us!

56. Questions?