A Symfony bundle to manage fixtures with nelmio/alice and fzaninotto/Faker.
Currently supports Doctrine ORM, Doctrine ODM, Doctrine PHPCR ODM.
- Install
- Basic usage
- Advanced usage
- Custom Faker Providers
- Custom Alice Processors
- DoctrineFixturesBundle support
- Resources
Other references:
You can use Composer to install the bundle to your project:
composer require hautelook/alice-bundleThen, enable the bundle by updating your app/config/AppKernel.php file to enable the bundle:
<?php
// app/config/AppKernel.php
public function registerBundles()
{
//...
if (in_array($this->getEnvironment(), ['dev', 'test'])) {
//...
$bundles[] = new Hautelook\AliceBundle\HautelookAliceBundle();
}
return $bundles;
}Configure the bundle to your needs (example with default values):
# app/config/config_dev.yml
hautelook_alice:
db_drivers:
orm: ~ # Enable Doctrine ORM if is registered
mongodb: ~ # Enable Doctrine ODM if is registered
phpcr: ~ # Enable Doctrine PHPCR ODM if is registered
locale: en_US # Locale to used for faker; must be a valid Faker locale otherwise will fallback to en_EN
seed: 1 # A seed to make sure faker generates data consistently across runs, set to null to disable
persist_once: false # Only persist objects once if multiple files are passed
loading_limit: 5 # Maximum number of time the loader will try to load the files passedFore more information regarding the locale, refer to Faker documentation on localization.
Assuming you are using Doctrine, install
the doctrine/doctrine-bundle and doctrine/data-fixtures packages and register both bundles.
Then create a fixture file in AppBundle/DataFixtures/ORM:
# AppBundle/DataFixtures/ORM/dummy.yml
AppBundle\Entity\Dummy:
dummy_{1..10}:
name: <name()>
related_dummy: @related_dummy*# AppBundle/DataFixtures/ORM/related_dummy.yml
AppBundle\Entity\RelatedDummy:
related_dummy_{1..10}:
name: <name()>Then simply load your fixtures with the doctrine command php app/console hautelook_alice:doctrine:fixtures:load (or php app/console h:d:f:l).
If you want to load the fixtures of a bundle only, do php app/console h:d:f:l -b MyFirstBundle -b MySecondBundle.
See more.
Next chapter: Advanced usage
- Behat extension: AliceBundleExtension
- Upgrade guide
- Changelog
This bundle was originaly developped by Baldur RENSCH and HauteLook. It is now maintained by Théo FIDRY.
