linkorb / haigha
Alice fixtures for database tables
Installs: 11 122
Dependents: 3
Suggesters: 0
Security: 0
Stars: 24
Watchers: 11
Forks: 8
Open Issues: 1
Requires
- php: >=7.1
- linkorb/database-manager: ^2.0
- nelmio/alice: ^3.0
- ramsey/uuid: ^2.0|^3.0
- symfony/console: ^3.4|^4.3|^5.0
- symfony/dotenv: ^3.4|^4.3|^5.0
Requires (Dev)
- phpunit/phpunit: ^5
README
Tip
Haigha has been superseeded by the brand new Hatter - similar features, still application independant, but no longer trying to use Alice in a way that it wasn't designed for.
Haigha: Alice fixtures for tables
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!
Features
- 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
Example fixture file
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()>
How to use Haigha in your application
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:
Command-line usage
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.
Database URL
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
Just a 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
Library usage:
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);
Test
Customize phpunit.xml
:
cp phpunit.xml.dist phpunit.xml
Run:
vendor/bin/phpunit
License
MIT (see LICENSE.md)
Brought to you by the LinkORB Engineering team
Check out our other projects at linkorb.com/engineering.
Btw, we're hiring!