Alice is an awesome database fixtures library. It works with Doctrine out-of-the-box, but if you don't use the Doctrine ORM, you'll need custom persisters...

This is where Haigha comes in:

Haigha lets you use Alice directly with database tables!

• Supports all standard Alice functionality (ranges, optional data, references, inheritence, etc)
• Supports Faker data providers
• Supports any PDO connection
• No need to write classes, directly persist from yml to your sql database

Haigha uses Alice to load fixture files, so the format is identical (Details). The only thing to keep in mind is that you use tablenames instead of classnames. Prefix your tablenames with table.. For example, if your tablename is called user, you use it like this:

table.group:
  group_random_users:
    id: 1 # This is important for version ~2.0
    name: Random users

table.user:
  random_user{0..9}:
    group_id: @group_random_users
    username: <userName()>
    firstname: <firstName()>
    lastname: <lastName()>
    password: <password()>
    email: <email()>

Simply add the following to your require or require-dev section in your composer.json and run composer update:

"require": {
  "linkorb/haigha": "^2.0"
}

You can now use Haigha in your applications, or use the included command-line tool to load fixtures into your database:

The haigha command-line tool knows one sub-command: fixtures:load.

The first argument is the filename of your fixture definition (yaml).

The second argument is the (optional) database url. If no database url is specified, haigha used your PDO environment variable instead.

A full URL containing username, password, hostname and dbname. For example:

./vendor/bin/haigha fixtures:load examples/random_users.yml mysql://username:password@hostname/dbname

In this case linkorb/database-manager is used for loading database connection details (server, username, password, etc) from .conf files (read project readme for more details).

In a nutshell - you must have a database_name.conf file at /share/config/database/ as described at database-manager's documentation.

./vendor/bin/haigha fixtures:load examples/random_users.yml dbname

You can use Haigha in your own application like this:

// Instantiate a new Alice loader
$loader = new Nelmio\Alice\Fixtures\Loader();

// Add the Haigha instantiator
$instantiator = new Haigha\TableRecordInstantiator();
$loader->addInstantiator($instantiator);

// Load (Haigha) objects from a Alice yml file
$objects = $loader->load('examples/random_users.yml');

// Instantiate the Haigha PDO persister, and pass a PDO connection
$persister = new PdoPersister($pdo);

// Persist the Haigha objects on the PDO connection
$persister->persist($objects);

Customize phpunit.xml:

cp phpunit.xml.dist phpunit.xml

Run:

vendor/bin/phpunit

MIT (see LICENSE.md)

Check out our other projects at linkorb.com/engineering.

Btw, we're hiring!