roave / psr-container-doctrine
Doctrine Factories for PSR-11 Containers
Installs: 515 183
Dependents: 16
Suggesters: 2
Security: 0
Stars: 95
Watchers: 15
Forks: 33
Open Issues: 14
Requires
- php: ~8.3.0 || ~8.4.0
- doctrine/common: ^3.4.5
- doctrine/dbal: ^4.2.1
- doctrine/event-manager: ^2.0.1
- doctrine/migrations: ^3.8.2
- doctrine/orm: ^3.3.0
- doctrine/persistence: ^3.4.0
- psr/cache: ^2.0.0 || ^3.0.0
- psr/container: ^1.1.2 || ^2.0.2
Requires (Dev)
- doctrine/coding-standard: ^12.0.0
- phpunit/phpunit: ^10.5.38
- psalm/plugin-phpunit: ^0.19.0
- symfony/yaml: ^7.1.6
- vimeo/psalm: ^5.26.1
- 5.6.x-dev
- 5.5.x-dev
- 5.5.0
- 5.4.x-dev
- 5.4.0
- 5.3.x-dev
- 5.3.1
- 5.3.0
- 5.2.x-dev
- 5.2.2
- 5.2.1
- 5.2.0
- 5.1.x-dev
- 5.1.0
- 5.0.x-dev
- 5.0.0
- 4.2.x-dev
- 4.1.x-dev
- 4.1.0
- 4.0.x-dev
- 4.0.0
- 3.11.x-dev
- 3.10.x-dev
- 3.10.0
- 3.9.x-dev
- 3.9.0
- 3.8.x-dev
- 3.8.0
- 3.7.x-dev
- 3.7.0
- 3.6.x-dev
- 3.6.0
- 3.5.x-dev
- 3.5.0
- 3.4.x-dev
- 3.4.1
- 3.4.0
- 3.3.x-dev
- 3.3.0
- 3.2.x-dev
- 3.2.0
- 3.1.x-dev
- 3.1.1
- 3.1.0
- 3.0.x-dev
- 3.0.0
- 2.2.x-dev
- 2.2.0
- 2.1.x-dev
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.0
- dev-renovate/phpunit-phpunit-11.x
- dev-renovate/doctrine-persistence-4.x
- dev-renovate/php
- dev-renovate/all-minor-patch
- dev-5.3.x-merge-up-into-5.4.x_ZdwwmiKY
- dev-5.2.x-merge-up-into-5.3.x_mm3oYLTi
This package is auto-updated.
Last update: 2024-11-21 23:08:40 UTC
README
Doctrine factories for PSR-11 containers.
This package provides a set of factories to be used with containers using the PSR-11 standard for an easy Doctrine integration in a project. This project was originally written by @DASPRiD but maintenance has been taken over by Roave.
Installation
The easiest way to install this package is through composer:
$ composer require roave/psr-container-doctrine
Configuration
In the general case where you are only using a single connection, it's enough to define the entity manager factory:
return [ 'dependencies' => [ 'factories' => [ 'doctrine.entity_manager.orm_default' => \Roave\PsrContainerDoctrine\EntityManagerFactory::class, ], ], ];
If you want to add a second connection, or use another name than "orm_default", you can do so by using the static variants of the factories:
return [ 'dependencies' => [ 'factories' => [ 'doctrine.entity_manager.orm_other' => static fn (ContainerInterface $container) => (new EntityManagerFactory('orm_custom_key'))($container), ], ], ];
You can also define an alias to retrieve an entity manager instance using ::class
capability:
return [ 'aliases' => [ 'doctrine.entity_manager.orm_default' => Doctrine\ORM\EntityManagerInterface::class, ], ];
Each factory supplied by this package will by default look for a registered factory in the container. If it cannot find one, it will automatically pull its dependencies from on-the-fly created factories. This saves you the hassle of registering factories in your container which you may not need at all. Of course, you can always register those factories when required. The following additional factories are available:
\Roave\PsrContainerDoctrine\CacheFactory
(doctrine.cache.*)\Roave\PsrContainerDoctrine\ConnectionFactory
(doctrine.connection.*)\Roave\PsrContainerDoctrine\ConfigurationFactory
(doctrine.configuration.*)\Roave\PsrContainerDoctrine\DriverFactory
(doctrine.driver.*)\Roave\PsrContainerDoctrine\EventManagerFactory
(doctrine.event_manager.*)
Each of those factories supports the same static behavior as the entity manager factory. For container specific configurations, there are a few examples provided in the example directory:
Example configuration
A complete example configuration can be found in example/full-config.php. Please note that the values in there are the defaults, and don't have to be supplied when you are not changing them. Keep your own configuration as minimal as possible. A minimal configuration can be found in example/minimal-config.php
Migrations
If you want to expose the migration commands, you have to map the command name to CommandFactory
. This factory needs migrations config setup.
For ExecuteCommand
example:
return [ 'dependencies' => [ 'factories' => [ \Doctrine\Migrations\Tools\Console\Command\ExecuteCommand::class => \Roave\PsrContainerDoctrine\Migrations\CommandFactory::class, // Optionally, you could make your container aware of additional factories as of migrations release v3.0: \Doctrine\Migrations\Configuration\Migration\ConfigurationLoader::class => \Roave\PsrContainerDoctrine\Migrations\ConfigurationLoaderFactory::class, \Doctrine\Migrations\DependencyFactory::class => \Roave\PsrContainerDoctrine\Migrations\DependencyFactoryFactory::class, ], ], ];
You can find a full list of available commands in example/full-config.php.
Using the Doctrine CLI
In order to be able to use the CLI tool of Doctrine, you need to create a bin/doctrine
file in your project
directory. This sets up the command line application and enables you to add custom commands. It's nearly identical to
the file described in Setting Up the Console
but pulls EntityManagerInterface
from your container:
#!/usr/bin/env php <?php declare(strict_types=1); use Doctrine\ORM\EntityManagerInterface; use Doctrine\ORM\Tools\Console\ConsoleRunner; use Doctrine\ORM\Tools\Console\EntityManagerProvider\SingleManagerProvider; use Psr\Container\ContainerInterface; require 'vendor/autoload.php'; /** @var ContainerInterface $container */ $container = require 'config/container.php'; /** @var EntityManagerInterface $entityManager */ $entityManager = $container->get('doctrine.entity_manager.orm_default'); $commands = [ // If you want to add your own custom console commands, // you can do so here. ]; ConsoleRunner::run( new SingleManagerProvider($entityManager), $commands );
After that, invoke php bin/doctrine list
to see the available commands.
Multiple connections
It gets a little trickier when you have multiple entity managers. Doctrine itself has no way to handle that itself, so
a possible way would be to have two copies of the command above, named after the manager they work with and each pulling
different entity managers from the container - for instance bin/doctrine-default
and bin/doctrine-customer
.
The following code can be used for multiple connections, but it has a drawback: you won't see the --em=...
option
within the help section of each command.
#!/usr/bin/env php <?php declare(strict_types=1); use Doctrine\ORM\EntityManagerInterface; use Doctrine\ORM\Tools\Console\ConsoleRunner; use Doctrine\ORM\Tools\Console\EntityManagerProvider\SingleManagerProvider; use InvalidArgumentException; use Psr\Container\ContainerInterface; use Psr\Container\NotFoundExceptionInterface; use Symfony\Component\Console\Input\ArgvInput; require 'vendor/autoload.php'; /** @var ContainerInterface $container */ $container = require 'config/container.php'; $input = new ArgvInput(); /** @var string $em */ $em = $input->getParameterOption('--em', 'orm_default'); // hack to remove the --em option, cause it's not supported by the original ConsoleRunner. foreach ($_SERVER['argv'] as $i => $arg) { if (0 === strpos($arg, '--em=')) { unset($_SERVER['argv'][$i]); } } try { $entityManager = $this->container->get('doctrine.entity_manager.'.$em); } catch (NotFoundExceptionInterface $serviceNotFoundException) { throw new InvalidArgumentException(sprintf('Missing entity manager with name "%s"', $em)); } $commands = [ // If you want to add your own custom console commands, // you can do so here. ]; ConsoleRunner::run( new SingleManagerProvider($entityManager), $commands );
Multiple connections and migrations
There may be a requirement for a migration table in each connection. Whether its a different database entirely, or other another schema (PostgreSQL for example).
For this to work you must first ensure the service \Doctrine\Migrations\Configuration\Migration\ConfigurationLoader
is not set in the container.
This allows for the factory \Roave\PsrContainerDoctrine\Migrations\DependencyFactoryFactory
to create its
own ConfigurationLoader
by the key provided.
You first need to add additional config to the migrations in the doctrine config
return [ 'doctrine' => [ ... 'migrations' => [ 'orm_default' => [ 'table_storage' => [ 'table_name' => 'migrations_executed', 'version_column_name' => 'version', 'version_column_length' => 255, 'executed_at_column_name' => 'executed_at', 'execution_time_column_name' => 'execution_time', ], 'migrations_paths' => ['My\Migrations' => 'scripts/orm/migrations'], 'all_or_nothing' => true, 'check_database_platform' => true, ], 'orm_default2' => [ 'table_storage' => [ 'table_name' => 'migrations_executed', 'version_column_name' => 'version', 'version_column_length' => 255, 'executed_at_column_name' => 'executed_at', 'execution_time_column_name' => 'execution_time', ], 'migrations_paths' => ['My\Migrations2' => 'scripts/orm/migrations2'], 'all_or_nothing' => true, 'check_database_platform' => true, ], ], ... ], ];
Now the example bin/doctrine
script above can be extended to use the $em
variable along with the CommandFactory
.
$commandFactory = new \Roave\PsrContainerDoctrine\Migration\CommandFactory($em); $commands = [ $commandFactory($container, Command\GenerateCommand::class), ];