pkj/minibase-plugin-doctrine

Doctrine plugin for minibase. Integrates doctrine with Minibase.

Doctrine ORM for Minibase

Enables you to integrate Doctrine to Minibase., _(*1)

Install

{
  "require":{
         "pkj/minibase-plugin-doctrine": "dev-master"
    }
}

Setup

Init the plugin, _(*2)

$mb->initPlugins(array(
    'Pkj\Minibase\Plugin\DoctrinePlugin\DoctrinePlugin' => array(
        'metadata' => 'annotation', // yaml,xml or annotation.
        'entityDirs' => [__DIR__ . '/Models'], // Entity dirs.
        'proxyDir' => __DIR__ . '/cache/proxies', // Cached proxies
        'connection' => array(
            'driver' => 'pdo_sqlite',
                'path' => __DIR__ . '/db.sqlite',
        ),
        // Optional callback to configure the Configuration object.
        setupCallback: function () {
            // $this = Doctrine Configuration object instance.
        }
    )
));

Use in controllers

The plugin makes "em" available as a plugin in your MB app., _(*3)

From any controller:, _(*4)

Using the doctrine CLI

See the Minibase CLI documentation on how you generate a php file that can run commands., _(*5)

This plugin injects All Doctrine Cli commands to the default minibase commands., _(*6)

$this->mb->em->persist(new SomeModel());

Events

plugin:doctrine:entityDirs (array &$entityDirs)

Listen to this event to add more entity dirs. Useful for other plugins that requires this plugin. Note that $entityDirs is a reference., _(*7)

plugin:doctrine:setup (Doctrine\ORM\Configuration $setup)

Listen to this event to configure the configuration for doctrine before entity manager is created., _(*8)

Migrations

The best way to keep in track with production database is migrations., _(*9)

Create migrations.xml where your cli.php binary is., _(*10)

Add this (configure it yourself):, _(*11)

<doctrine-migrations xmlns="http://doctrine-project.org/schemas/migrations/configuration"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://doctrine-project.org/schemas/migrations/configuration
                    http://doctrine-project.org/schemas/migrations/configuration.xsd">

    <name>App migrations</name>

    <migrations-namespace>app\migrations</migrations-namespace>

    <table name="doctrine_migration_versions" />

    <migrations-directory>app/migrations</migrations-directory>

</doctrine-migrations>

Create your first diff:, _(*12)

php cli.php migration:diff

Excecute migrations:, _(*13)

php cli.php migrations:migrate