kurl / silex-doctrine-migrations-provider
A doctrine migrations provider for silex
Installs: 149 744
Dependents: 1
Suggesters: 1
Security: 0
Stars: 21
Watchers: 4
Forks: 11
Open Issues: 4
Requires
- php: ^5.6|^7.0
- doctrine/dbal: ^2.2
- doctrine/migrations: ^1.5
- pimple/pimple: ^3.0
- silex/api: ^2.0
- symfony/console: ^2.3 | ^3.0
- symfony/http-foundation: 3.4.35
Requires (Dev)
- doctrine/orm: ^2.2
- phpunit/phpunit: ^5.7
- silex/silex: ^2.0
This package is auto-updated.
Last update: 2024-09-30 01:19:43 UTC
README
A doctrine migrations service provider for Silex 2.x or Pimple 3.x.
Installation
Install the provider through Composer:
composer require kurl/silex-doctrine-migrations-provider
Usage
Parameters
These are the configuration parameters you could configure for the provider:
migrations.directory
: The directory with migrations. Required.migrations.namespace
: The namespace for the migration classes. Required.migrations.name
: The name of the migrations suite. Defaults to "Migrations".migrations.table_name
: The database migrations table. Defaults tomigration_versions
.
Services
The service provider registers the following services which you could use:
migrations.em_helper_set
: The Doctrine ORM Entity Manager helper set. It would be registered if you have registered theorm.em
service supposedly from the `DoctrineServiceProvider.migrations.commands
: An array of Symfony command instances. You could use them to add to your own Console application.
There are also a few other services which the provider uses internally and they are exposed so you could extend or override them with the lazy loading of Pimple:
migrations.output_writer
:Doctrine\DBAL\Migrations\OutputWriter
instance used in the Doctrine migrations configuration.migrations.configuration
:Doctrine\DBAL\Migrations\Configuration\Configuration
instance used in the console commands.migrations.command_names
: Array of command names. You could add your own here to be lazy loaded intomigrations.commands
.
You can register the provider and configure it like so:
<?php $app->register( new \Kurl\Silex\Provider\DoctrineMigrationsProvider(), array( 'migrations.directory' => __DIR__ . '/../path/to/migrations', 'migrations.name' => 'Acme Migrations', 'migrations.namespace' => 'Acme\Migrations', 'migrations.table_name' => 'acme_migrations', ) );
Silex
You can pass an optional instance of Symfony\Component\Console\Application
to the constructor of the provider. Alternatively you can set the instance of your Console application to $app['console']
. If the provider can find the Console application instance it is able to register the commands and helper set for you.
The provider implements `Silex\Api\BootableProviderInterface, so if you use the provider with Silex, booting the application would register the commands for you:
<?php $console = new \Symfony\Component\Console\Application(); $app->register( new \Kurl\Silex\Provider\DoctrineMigrationsProvider($console), array( 'migrations.directory' => __DIR__ . '/../path/to/migrations', 'migrations.namespace' => 'Acme\Migrations', ) ); $app->boot(); $console->run();
Pimple
If you use the provider with Pimple without using Silex, then you'd need to register the helper set and the commands to your Console application yourself. This is made very easy by the provider as it already registered all the needed services:
<?php $console = new \Symfony\Component\Console\Application(); $app->register( new \Kurl\Silex\Provider\DoctrineMigrationsProvider(), array( 'migrations.directory' => __DIR__ . '/../path/to/migrations', 'migrations.namespace' => 'Acme\Migrations', ) ); // Register helper set and commands from the `DoctrineMigrationsProvider` $console->setHelperSet($app['migrations.em_helper_set']); $console->addCommands($app['migrations.commands']); $console->run();
Code coverage reports
$ bin/phpunit --coverage-html build/coverage --coverage-clover build/logs/clover.xml --log-junit build/logs/phpunit.xml