coolms/core-bundle

Symfony integration for the CoolMS platform kernel. The bundle base class every module extends, the DI extension and compiler passes, the install and secret console commands, and the platform's HTTP plumbing.

Notably it contains no persistence. Which storage backs the kernel's contracts is decided by whichever adapter package is installed — see coolms/core-doctrine.

Installation

composer require coolms/core-bundle coolms/core-doctrine

Name the adapter, or Composer installs the wrong thing and says it worked. This bundle pulls in coolms/core-module, which requires the virtual coolms/core-persistence-implementation. With no adapter that requirement cannot be satisfied — and instead of failing, Composer backtracks to a release of this bundle from before it declared coolms/core-module at all, then reports success.

Measured at the time of writing: composer require coolms/core-bundle alone resolved to v1.0.1 and pulled coolms/dtmpl 1.0.0 with it. Which older version it lands on is not the point; that it exits 0 is.

coolms/core-doctrine is the adapter that exists today; substitute another if you write one.

// config/bundles.php
CoolMS\CoreBundle\CoreBundle::class => ['all' => true],

What is in here

Extending the platform

A module's bundle extends AbstractCoolmsBundle, and its DI extension extends AbstractExtension:

use CoolMS\CoreBundle\AbstractCoolmsBundle;
use CoolMS\CoreBundle\DependencyInjection\AbstractExtension;

final class MyModuleBundle extends AbstractCoolmsBundle
{
    public function getContainerExtension(): Extension
    {
        return new MyModuleExtension();
    }
}

AbstractExtension provides setResolveTargetEntities(), which accumulates the interface-to-concrete map the platform resolves at compile time.

Declare getAlias() explicitly in every extension. Symfony derives the alias from the class short name, and Extension minus the Extension suffix is the empty string — so two modules that both omit it silently collide on every service id built from the alias.

Related packages

License

MIT. See LICENSE.