Download the PHP package olvlvl/symfony-dependency-injection-proxy without Composer
On this page you can find all versions of the php package olvlvl/symfony-dependency-injection-proxy. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download olvlvl/symfony-dependency-injection-proxy
More information about olvlvl/symfony-dependency-injection-proxy
Files in olvlvl/symfony-dependency-injection-proxy
Package symfony-dependency-injection-proxy
Short Description Generate super tiny proxies for Symfony's dependency injection
License BSD-3-Clause
Informations about the package symfony-dependency-injection-proxy
Proxy generator for Symfony's DIC
This package provides a proxy generator for Symfony's dependency injection component that generates super tiny, super simple proxies, especially when compared to Symfony's default implementation. Here are some differences:
- Can proxy
final
classes. - Can only proxy classes with interfaces.
- The generated proxies are self-contained.
- The package is ~10Kb and doesn't have dependencies.
- The package can be removed once the proxies have been generated.
If you're not familiar with proxy services, better have a look at Symfony's documentation before going any further.
Installation
How it works
The generator works with the following assumptions: the service we want to proxy implements an
interface, and services using that service expect that interface, following the dependency
inversion principle. Now, consider the following code, where an ExceptionHandler
service
requires a logger implementing LoggerInterface
:
Imagine we're using Monolog as logger, and we have an expansive stream to set up. Why waste time building the logger for every request when it's seldom used? That's when we mark our service as lazy.
The following example demonstrates how we can mark our Psr\Log\LoggerInterface
service as lazy (we
could use PHP code or XML just the same):
The service can also use a factory:
Note: We don't have to define our service with a class, we could use logger
instead of
Psr\Log\LoggerInterface
just > the same, except we would have to define class
for the factory
one.
Now let's see how to build our container.
Building the dependency injection container
The following code demonstrates how to build, compile, and dump a container:
There you have it. We can use our container as usual and everything is awesome.
What if my lazy service implements multiple interfaces?
The basic interface resolver will have a hard time figuring out which interface to implement if a
service implements many. For instance, if a service was an instance of ArrayObject
the following
exception would be thrown:
We can specify the interface to implement using the lazy
attribute:
Continuous Integration
The project is continuously tested by GitHub actions.
Code of Conduct
This project adheres to a Contributor Code of Conduct. By participating in this project and its community, you are expected to uphold this code.
Contributing
Please see CONTRIBUTING for details.
License
olvlvl/symfony-dependency-injection-proxy is released under the BSD-3-Clause.