samburns / pimple3-containerinterop
Installs: 7 022
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 3
Forks: 2
Open Issues: 2
Requires
- php: >=5.5.0
- container-interop/container-interop: ~1.1.0
- pimple/pimple: ^3.0
Requires (Dev)
- phpspec/phpspec: 2.4.0
- phpunit/phpunit: >=4.8.0 <5.1.0
README
Pimple3-ContainerInterop
Introduction
Pimple 3 is a fast, lightweight, popular Dependency Injection container for PHP. ContainerInterop is an open-source standard for interoperability between Dependency Injection containers. This tool is a standards-compliant ContainerInterop wrapper for Pimple 3.
It works in PHP 5.5, 5.6 and 7.0.
User - Direct Pimple Access
The wrapper allows full access to all Pimple functionality, via a __call()
method, and ArrayAccess
implementation. This allows you to call any method that exists in Pimple, directly on the wrapper. You can also add
services using $container['service-id'] = //something
, as array access is supported.
Use - Service Retrieval
As per the standard, $container->has($serviceId)
will tell you if a service is configured in the container. $container->get($serviceId)
will retrieve the service. An implementation of Interop\Container\Exception\NotFoundException
is thrown if you call get()
and the service doesn't exist. All other errors from Pimple result in an instance of Interop\Container\Exception\ContainerException
being thrown.
Use - Installation
It is recommended to install this via composer:
composer require samburns/pimple3-containerinterop
Use - Configuration
You can configure the Pimple container before wrapping it in a standards-compliant adapter:
use Pimple\Container as PimpleContainer; use SamBurns\Pimple3ContainerInterop\ServiceContainer; $rawPimpleContainer = new PimpleContainer(); $rawPimpleContainer['service-id'] = function () {return new \Whatever();}; $container = ServiceContainer($rawPimpleContainer);
Or you can pass your own Pimple\ServiceProviderInterface
implementions into the wrapper, to be applied to the inner Pimple container:
use SamBurns\Pimple3ContainerInterop\ServiceContainer; use My\ServiceProvider; $container = new ServiceContainer(); $container->addConfig(new ServiceProvider());
There is even a named constructor you can use, if you want to spin up a ServiceContainer
and configure it with a ServiceProviderInterface
all in one line:
use SamBurns\Pimple3ContainerInterop\ServiceContainer; use My\ServiceProvider; $container = ServiceContainer::constructConfiguredWith(new ServiceProvider());
Similar Projects
PimpleInterop and Acclimate provide excellent alternatives if you don't like this library. Although using Pimple v1 and not v3, they do offer the 'delegate lookup' feature described as optional in the standard, allowing you to combine multiple containers.
Contributions
Contributions welcome. Fork the repo, make your changes, and create a pull request. To run the tests, type ./bin/test
. PHPUnit integration tests and PHPSpec unit tests will run.