mbezhanov / silex-alice-data-fixtures
A library providing simple integration of Alice and Doctrine Data Fixtures into Silex projects
Requires
- php: ^7.0
- dflydev/doctrine-orm-service-provider: ^2.0
- doctrine/data-fixtures: ^1.2
- nelmio/alice: ^3.0@RC
- silex/silex: ^2.1
- symfony/console: ^3.3
Requires (Dev)
- phpunit/phpunit: ^6.2
This package is auto-updated.
Last update: 2024-10-23 00:18:47 UTC
README
A library providing simple integration of nelmio/alice and doctrine/data-fixtures into Silex projects
Installation
Install the library through Composer:
composer require mbezhanov/silex-alice-data-fixtures
Usage
Configuration
To get up and running, register all necessary Service Providers with your Application by following the example below:
<?php use Bezhanov\Silex\AliceDataFixtures\FixturesServiceProvider; use Dflydev\Provider\DoctrineOrm\DoctrineOrmServiceProvider; use Silex\Application; use Silex\Provider\DoctrineServiceProvider; use Symfony\Component\Console\Application as Console; $app = new Application(); $app->register(new DoctrineServiceProvider(), array( 'db.options' => [ 'driver' => 'pdo_sqlite', 'path' => __DIR__ . '/sqlite.db', ], )); $app->register(new DoctrineOrmServiceProvider(), [ 'orm.em.options' => [ 'mappings' => [ [ 'type' => 'annotation', 'namespace' => 'App\Entity', 'path' => __DIR__ . '/src/App/Entity', 'use_simple_annotation_reader' => false, ], ], ], ]); $console = new Console(); $app->register(new FixturesServiceProvider($console)); $app->boot(); $console->run();
This will automatically register the fixtures:load
command with your Console application, and you will be able to call:
./bin/console fixtures:load
By default, the command will try to load the "fixtures.yml" file located in your current working directory. You can specify the full path to a fixtures file by issuing:
./bin/console fixtures:load --fixture="/path/to/fixture.yml"
If you'd like to append fixtures to your existing data, instead of truncating your database, you can use:
./bin/console fixtures:load --fixture="/path/to/fixture.yml" --append
Defining fixtures
The YML files follow the standard format recognized by Alice:
Bezhanov\Silex\AliceDataFixtures\Tests\Entity\Foo: foo{1..10}: name: '<name()>' Bezhanov\Silex\AliceDataFixtures\Tests\Entity\Bar: bar{1..5}: name: '<name()>'
Using custom Faker providers
Sometimes you may need more functionality than what Alice provides natively. Internally, Alice relies on Faker to generate fake data.
You can easily customize the Faker Generator instance that FixturesServiceProvider
works with (e.g. to add more providers to it) by following the example below:
<?php use Bezhanov\Silex\AliceDataFixtures\FixturesServiceProvider; $app = new Silex\Application(); $faker = Faker\Factory::create(); $faker->addProvider(new Bezhanov\Faker\Provider\Food($faker)); $app->register(new FixturesServiceProvider($console), [ 'fixtures.faker_generator' => $faker, ]);
Contributing
This library is in its early stages of development, and all contributions are welcome. Before opening PRs, make sure that all tests are passing, and that code coverage is satisfactory:
phpunit tests --coverage-html coverage