Skip to content

Latest commit

 

History

History
49 lines (33 loc) · 2.22 KB

README.md

File metadata and controls

49 lines (33 loc) · 2.22 KB

Flowder PHPUnit Latest Stable Version Build Status codecov

Flowder PHPUnit is a PHPUnit Test Listener for integrating the Flowder fixture loader into PHPUnit test suites.

Usage

  1. Install Flowder PHPUnit as a development dependency through Composer

    $ composer install imjoehaines/flowder-phpunit --dev
  2. Enable Flowder PHPUnit as a test listener in your phpunit.xml file (PHPUnit documentation)

    <listeners>
      <listener class="\Imjoehaines\Flowder\PhpUnit\FlowderListener"></listener>
    </listeners>
  3. Bootstrap Flowder PHPUnit by calling FlowderListener::bootsrap in your PHPUnit bootstrap.php file, passing in an instance of \Imjoehaines\Flowder\Flowder (see the Flowder documentation for more information).

    This is only necessary until PHPUnit #1873 is fixed. After this, you can configure Flowder PHPUnit through your phpunit.xml file instead.

    A simple SQLite example might look like this:

    <?php
    
    require __DIR__ . '/../vendor/autoload.php';
    
    use Imjoehaines\Flowder\PhpUnit\FlowderListener;
    
    use Imjoehaines\Flowder\Loader\PhpFileLoader;
    use Imjoehaines\Flowder\Truncator\SqliteTruncator;
    use Imjoehaines\Flowder\Persister\SqlitePersister;
    
    $db = new PDO(...);
    $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    
    FlowderListener::bootstrap(
        __DIR__ . '/_data/example.php',
        new PhpFileLoader(),
        new SqliteTruncator($db),
        new SqlitePersister($db)
    );
  4. That's it! Before any test file runs, Flowder will load your fixture data for you