You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Jean-Christophe Meillaud de03f49cfd Fix path for 1.x stable documentation (#289) 5 years ago
bin Add support for service factories (#283) 5 years ago
doc Add support for service factories (#283) 5 years ago
fixtures Delete cache files (#290) 5 years ago
resources/config Add support for service factories (#283) 5 years ago
src Fix fixtures disappearance when loading fixtures from several bundles (#288) 5 years ago
tests Fix fixtures disappearance when loading fixtures from several bundles (#288) 5 years ago
.editorconfig Travis improvements 6 years ago
.gitignore Merge 1.x to master (#270) 5 years ago
.scrutinizer.yml Enhance Travis (#226) 6 years ago
.travis.yml Add support for service factories (#283) 5 years ago
CHANGELOG.md Update CHANGELOG.md 6 years ago
LICENSE Move doc to the root (#246) 5 years ago
README.md Fix path for 1.x stable documentation (#289) 5 years ago
UPGRADE.md Update documentation (#273) 5 years ago
composer.json Add support for service factories (#283) 5 years ago
phpunit.xml.dist Harden tests for command (#269) 5 years ago

README.md

AliceBundle

A Symfony bundle to manage fixtures with nelmio/alice and fzaninotto/Faker.

The database support is done in FidryAliceDataFixtures. Check this project to know which database/ORM is supported.

Warning: this doc is behind updated for HautelookAliceBundle 2.0. If you want to check the documentation for 1.x, head this way.

Package version Build Status SensioLabsInsight Dependency Status Scrutinizer Code Quality Code Coverage Gitter

Documentation

  1. Install
  2. Basic usage
  3. Advanced usage
    1. Enabling databases
    2. Environment specific fixtures
    3. Fixtures parameters
      1. Alice parameters
      2. Application parameters
    4. Use service factories
  4. Custom Faker Providers
  5. Custom Alice Processors
  6. Resources

Other references:

Installation

Example of installation:

# If you are using Symfony standard edition, you can skip this step
composer require doctrine/doctrine-bundle doctrine/orm:^2.5

composer require --dev hautelook/alice-bundle:^[email protected] \
  nelmio/alice:^[email protected] \
  theofidry/alice-data-fixtures:^[email protected] \
  doctrine/data-fixtures

Explanation: HautelookAliceBundle uses FidryAliceDataFixtures for the persistence layer. As FidryAliceDataFixtures is compatible with different databases/ORM, one cannot be installed by default. In the example above, we are using Doctrine ORM which requires doctrine/orm doctrine/orm-bundle doctrine/data-fixtures.

Then, enable the bundle by updating your app/AppKernel.php file to enable the bundle:

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = [
        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
        // ...
        new Doctrine\Bundle\DoctrineBundle\DoctrineBundle(),
    ];
    
    if (in_array($this->getEnvironment(), ['dev', 'test'])) {
        //...
        $bundles[] = new Nelmio\Alice\Bridge\Symfony\NelmioAliceBundle;
        $bundles[] = new Fidry\AliceDataFixtures\Bridge\Symfony\FidryAliceDataFixturesBundle();
        $bundles[] = new Hautelook\AliceBundle\HautelookAliceBundle();
    }

    return $bundles;
}

Configure the bundle to your needs (example with default values):

# app/config/config_dev.yml

hautelook_alice:
    fixtures_path: 'Resources/fixtures/orm' # Path to which to look for fixtures relative to the bundle path.

Basic usage

Assuming you are using Doctrine, make sure you have the doctrine/doctrine-bundle and doctrine/data-fixtures packages installed.

Then create a fixture file in app/Resources/fixtures/orm:

# app/Resources/fixtures/orm/dummy.yml

AppBundle\Entity\Dummy:
    dummy_{1..10}:
        name: <name()>
        related_dummy: '@related_dummy*'
# app/Resources/fixtures/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 fixtures:load.

If you want to load the fixtures of a bundle only, do php app/console fixtures:load -b MyFirstBundle -b MySecondBundle.

See more.
Next chapter: Advanced usage

Resources

Credits

This bundle was originaly developped by Baldur RENSCH and HauteLook. It is now maintained by Théo FIDRY.

Other contributors.

License

license