zalas / phpunit-injector
Injects services from a PSR-11 dependency injection container to PHPUnit test cases
Fund package maintenance!
jakzal
Installs: 246 845
Dependents: 1
Suggesters: 1
Security: 0
Stars: 62
Watchers: 4
Forks: 4
Open Issues: 1
Requires
- php: ~8.1.0 || ~8.2.0 || ~8.3.0
- phpunit/phpunit: ^9.0
- psr/container: ^1.0 || ^2.0
- zalas/injector: ^2.0
Requires (Dev)
- phpspec/prophecy: ^1.9
- phpspec/prophecy-phpunit: ^2.0
- symfony/config: ^4.4.12 || ^5.3 || ^6.0
- symfony/dependency-injection: ^4.4.12 || ^5.3 || ^6.0
- symfony/framework-bundle: ^4.4.12 || ^5.3 || ^6.0
- symfony/http-kernel: ^4.4.12 || ^5.3 || ^6.0
- zalas/phpunit-doubles: ^1.9.2
- zalas/phpunit-globals: ^2.0
This package is auto-updated.
Last update: 2024-10-07 09:41:08 UTC
README
Provides a PHPUnit listener to inject services from a PSR-11 dependency injection container to PHPUnit test cases.
Services are injected to test cases that implement Zalas\Injector\PHPUnit\TestCase\ServiceContainerTestCase
to any property tagged with @inject
.
Symfony DependencyInjection component integration is also provided.
Installation
Composer
composer require --dev zalas/phpunit-injector
Phar
The extension is also distributed as a PHAR, which can be downloaded from the most recent Github Release.
Put the extension in your PHPUnit extensions directory.
Remember to instruct PHPUnit to load extensions in your phpunit.xml
:
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/8.0/phpunit.xsd" extensionsDirectory="tools/phpunit.d" > </phpunit>
Configuration
Enable the service injector listener in the PHPUnit configuration file:
<?xml version="1.0" encoding="UTF-8"?> <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/8.0/phpunit.xsd"> <!-- ... --> <listeners> <listener class="Zalas\Injector\PHPUnit\TestListener\ServiceInjectorListener" /> </listeners> </phpunit>
Usage
To inject services using any PSR-11 service container, implement the Zalas\Injector\PHPUnit\TestCase\ServiceContainerTestCase
and tag selected properties with @inject
:
use PHPUnit\Framework\TestCase; use Psr\Container\ContainerInterface; use Psr\Log\LoggerInterface; use Symfony\Component\Serializer\SerializerInterface; use Zalas\Injector\PHPUnit\TestCase\ServiceContainerTestCase; class ServiceInjectorTest extends TestCase implements ServiceContainerTestCase { /** * @inject */ private SerializerInterface $serializer; /** * @inject logger */ private LoggerInterface $logger; public function testThatServicesAreInjected() { $this->assertInstanceOf(SerializerInterface::class, $this->serializer, 'The service is injectd by its type'); $this->assertInstanceOf(LoggerInterface::class, $this->logger, 'The service is injected by its id'); } public function createServiceContainer(): ContainerInterface { // create a service container here } }
The service is found by its type, or an id if it's given in the @inject
tag.
The createServiceContainer
method would be usually provided by a base test case or a trait.
In case of Symfony, such a trait is provided by this package (see the next section).
Symfony Test Container (Symfony >= 4.1)
The Zalas\Injector\PHPUnit\Symfony\TestCase\SymfonyTestContainer
trait provides
access to the test container (introduced in Symfony 4.1).
Including the trait in a test case implementing the ServiceContainerTestCase
will make that services are injected
into annotated properties:
use PHPUnit\Framework\TestCase; use Psr\Log\LoggerInterface; use Symfony\Component\Serializer\SerializerInterface; use Zalas\Injector\PHPUnit\Symfony\TestCase\SymfonyTestContainer; use Zalas\Injector\PHPUnit\TestCase\ServiceContainerTestCase; class ServiceInjectorTest extends TestCase implements ServiceContainerTestCase { use SymfonyTestContainer; /** * @inject */ private SerializerInterface $serializer; /** * @inject logger */ private LoggerInterface $logger; public function testThatServicesAreInjected() { $this->assertInstanceOf(SerializerInterface::class, $this->serializer, 'The service is injectd by its type'); $this->assertInstanceOf(LoggerInterface::class, $this->logger, 'The service is injected by its id'); } }
Note that test
needs to be set to true
in your test environment configuration for the framework bundle:
framework: test: true
Even though services are automatically made private by Symfony, the test container makes them available in your tests. Note that this only happens for private services that are actually used in your app (so are injected into a public service, i.e. a controller). If a service is not injected anywhere, it's removed by the container compiler.
The kernel used to bootstrap the container is created in a similar way to the KernelTestCase
known from the FrameworkBundle.
Similar environment variables are supported:
KERNEL_CLASS
required - kernel class to instantiate to create the service containerAPP_ENV
default: test - kernel environmentAPP_DEBUG
default: false - kernel debug flag
These could for example be configured in phpunit.xml
, or via global variables.
Symfony Container (Symfony 3.4 & 4.0)
The Zalas\Injector\PHPUnit\Symfony\TestCase\SymfonyContainer
trait gives access to the full Symfony Container
and can be used with any Symfony version.
Opposed to the Test Container approach for Symfony 4.1, this version provides access to each service even if it's
not used by your application anywhere and would normally be removed by the compiler.
This should be treated as a limitation rather than a feature.
use PHPUnit\Framework\TestCase; use Psr\Log\LoggerInterface; use Symfony\Component\Serializer\SerializerInterface; use Zalas\Injector\PHPUnit\Symfony\TestCase\SymfonyContainer; use Zalas\Injector\PHPUnit\TestCase\ServiceContainerTestCase; class ServiceInjectorTest extends TestCase implements ServiceContainerTestCase { use SymfonyContainer; /** * @inject */ private SerializerInterface $serializer; /** * @inject logger */ private LoggerInterface $logger; public function testThatServicesAreInjected() { $this->assertInstanceOf(SerializerInterface::class, $this->serializer, 'The service is injectd by its type'); $this->assertInstanceOf(LoggerInterface::class, $this->logger, 'The service is injected by its id'); } }
Since the test container is not available until Symfony 4.1,
you'll also have to register the Zalas\Injector\PHPUnit\Symfony\Compiler\ExposeServicesForTestsPass
compiler pass:
use Zalas\Injector\PHPUnit\Symfony\Compiler\ExposeServicesForTestsPass; class Kernel extends BaseKernel { // ... protected function build(ContainerBuilder $container) { if ('test' === $this->getEnvironment()) { $container->addCompilerPass(new ExposeServicesForTestsPass()); } } }
The compiler pass makes sure that even private services are available to be used in tests.
Contributing
Please read the Contributing guide to learn about contributing to this project. Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.