AxisServiceContainerPlugin
This plugin allows to add any amount of factories configuration to symfony factories.yml using Pimple as service container., (*1)
Also it adds a rich functionality for instantiating and configuring factories., (*2)
Installation
Composer way
-
Add axis/axis-service-container-plugin
dependency to your composer.json
:, (*3)
"require": {
"axis/axis-service-container-plugin": "dev-master"
}
- Enable
AxisServiceContainerPlugin
plugin in your ProjectConfiguration.class.php
.
- Include
lib/vendor/autoload.php
file generated by Composer if it wasn't included yet. ProjectConfiguration.class.php
:
include __DIR__.'/../lib/vendor/autoload.php';
Defining Services
Basic definition
You can define any services like the standard symfony factories.yml
does.
Assume that you have your service implemented in MyBasicServiceImplementation
class:, (*4)
class MyBasicServiceImplementation implements MyService
{
public function doSomething()
{
echo 'Yep. It works!';
}
}
And you want you define it using symfony context factories. So you need just to add its instantiation configuration to your factories.yml
:, (*5)
my_service:
class: MyBasicServiceImplementation
Now you can retrieve an instance of that class in your code:, (*6)
/** @var $myService MyService */
$myService = sfContext:getInstance()->get('my_service');
$myService->doSomething(); // echoes "Yep. It works!"
Note: all services are stored to Pimple service container using share
method. This means that each service is a shared objects instantiated only once it was requested first time., (*7)
Definition with parameters
Assume you want to instantiate a MyParamServiceImplementation
class that have a parameterized constructor., (*8)
class MyParamServiceImplementation implements MyService
{
protected $greating;
public funciton __construct($greating = 'Yep. It works!')
{
$this->greating = $greating;
}
public function doSomething()
{
echo $this->greating;
}
}
You can use parameters
configuration option listing all constructor parameters in any order but preserving exact names:, (*9)
my_service:
class: MyParamServiceImplementation
parameters:
greating: "Hooray!"
The usage is the same:, (*10)
/** @var $myService MyService */
$myService = sfContext:getInstance()->get('my_service');
$myService->doSomething(); // echoes "Hooray!"
Instant initialization
If your service should be instantiated (and thereby initialized) on startup you can use initialization
config parameter. The only value the plugin supports is instant
. Any other value is treated as undefined and meaningless., (*11)
my_service:
class: MyBasicServiceImplementation
initialization: instant
By defining initialization: instant
you tell that my_service
should be instantiated just after the symfony context is created., (*12)
Including file
If your service class is not loaded automatically with symfony autoloader or any other configured autoloaders you can use file
configuration option to tell symfony to include that file on context creation., (*13)
my_service:
class: MyServiceImplementation
file: %SF_ROOT_DIR%/lib/vendor/my_company/MyServiceImplementation.php
Tagging
You can mark your services with tags. This allows your to retrieve all defined services from context that have a specific tag assigned. Use tag
option., (*14)
my_service1:
class: MySimpleService
tag: greater
my_service2:
class: MyAdvancedService
tag: greater
After this you can retreive all services from context using a hash-prefixed tag name:, (*15)
/** @var $services array */
$services = sfContext:getInstance()->get('#greater');
var_dump(array_map('get_class', $services));
// will output "array('MySimpleService', 'MyAdvancedService')"
Service Parameters
When defining services sometimes you need to define constructor parameters values. Sometimes it is not enough to use just constant values. AxisServiceContainerPlugin allows you to use advanced parameter processing., (*16)
Config value
If you want instantiate a service with a config value passed as parameter you can use config
parameter processor:, (*17)
my_service:
class: MyParamServiceImplementation
parameters:
greating: config://app_my_service_greating
It will instantiate my_service
passing sfConfig::get('app_my_service_greating')
value as $greating
parameter., (*18)
Config value with default
Also you can use default value for config getter:, (*19)
my_service:
class: MyParamServiceImplementation
parameters:
greating: config://app_my_service_greating|Wow! It supports default value!
This code will instantiate my_service
passing sfConfig::get('app_my_service_greating', "Wow! It supports default value!")
value as $greating
parameter., (*20)
Defined service
Sometimes its handy to pass any other defined service to your service constructor as parameter., (*21)
my_service_transport:
class: SoapClient
parameters:
wsdl: http://services.mycompany.com/?WSDL
my_service:
class: MyRemoteService
parameters:
transport: context://my_service_transport
Now retrieving my_service
from context service container will return a my_service
service instance with my_service_transport
service instance passed as $transport
parameter to its constructor., (*22)
Defined services with a specific tag
Sometimes you may want to pass to service constructor a collection of services with a specific tag assigned. We can do that!, (*23)
my_service.extension.a:
class: MyServiceExtensionA
tag: my_service.extension
my_service.extension.b:
class: MyServiceExtensionA
tag: my_service.extension
my_service:
class: MyService
parameters:
extensions: tag://my_service.extension
Raw value
And if you want to pass actual string value prefixed with special words and leave it unprocessed use raw
prefix:, (*24)
my_service:
class: MyService
parameters:
greating: raw://config://This doesn't mean anything. It's just a string value
Parameters within arrays
You can use any smart parameters processing in arrays passed as parameter values. For example you can do this:, (*25)
my_service:
class: MyService
parameters:
options:
transport: context://my_service_transport
name: config://app_my_service_name|MyService
Declared services
Service container has declared services at the very beginning. They include standard symfony factories and
core context entities., (*26)
Standard symfony services
view_cache_manager
logger
i18n
controller
request
response
routing
storage
user
view_cache
mailer
All of this services can be used as initialization parameter using context:// parameter processor., (*27)
Additional plugin services
Additionally plugin appends to the service container next services:
* context
- symfony context instance
* configuration
- current application configuration
* dispatcher
- symfony event dispatcher
* config_cache
- symfony config cache manager. Useful when your service relies on .yml files caching
* service_container
- the service container instance itself (useful for using service container public API
inaccessible via sfContext instance), (*28)
Known issues
- You cannot configure standard symfony services using all plugin features.
Standard services are handled by default symfony
sfFactoryConfigHandler
.
What's new
1.1 - Output Service container generated config cache code before sfFactoryConfigHandler
code.
- Added config_cache
to predefined services
1.0.0 - First stable release, (*29)