coolms/core-bundle

Symfony bundle wiring for coolms/core: the module bundle base class, DI extension and compiler passes, install/secret console commands, config cache warmer and the platform's HTTP plumbing

Maintainers

Package info

github.com/coolms/core-bundle

Type:symfony-bundle

pkg:composer/coolms/core-bundle

Transparency log

Statistics

Installs: 11

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.3 2026-08-17 18:06 UTC

This package is auto-updated.

Last update: 2026-08-17 18:21:51 UTC


README

CI Latest Version PHP License

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
// config/bundles.php
CoolMS\CoreBundle\CoreBundle::class => ['all' => true],

What is in here

Area What it does
AbstractCoolmsBundle the base class every platform module's bundle extends
DependencyInjection/ the Core extension, AbstractExtension for module extensions, and the platform compiler passes
Console/ coolms:install and the coolms:secret:* commands
Secret/ the env, encrypted-file and Vault secret stores
Controller/, EventListener/, Http/ the base controller, RFC 7807 exception rendering, page-cache directives
Config/, Json/, Option/, Webhook/ the config cache warmer, JSONC decoding, option sources, webhook signature verification

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

Package Role
coolms/core kernel contracts
coolms/core-module application services
coolms/core-doctrine persistence adapter

License

MIT. See LICENSE.