coolms/dtmpl-bundle

Symfony integration for coolms/dtmpl. Registers the engine, assembles the loader chain, collects widgets and constant providers.

The engine is a separate package on purpose: it runs without an HTTP kernel or a DI container, and keeping this bundle out of it is what preserves that. If you are not on Symfony, install coolms/dtmpl alone and wire it yourself.

Installation

composer require coolms/dtmpl-bundle

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

Configuration

# config/packages/dtmpl.yaml
dtmpl:
    template_base_path: '%kernel.project_dir%/templates'
    extensions:
        html: 'html.dtmpl'
    widget_templates:
        comments: 'partials/widgets/comments.html.dtmpl'

Key	Purpose
`template_base_path`	root the filesystem loader resolves against
`extensions`	logical name to file extension map
`widget_templates`	which partial each widget renders through

widget_templates is the seam that keeps widget markup out of PHP: a theme repoints a widget at a different partial without touching the renderer.

What gets registered

Service	Notes
`DtmplEngine`	public; the entry point
`CompositeTemplateLoader`	aliased to `TemplateLoaderInterface`
`FilesystemTemplateLoader`	wired with `template_base_path`
`WidgetRegistry`	populated by the widget pass
`WidgetTemplateResolver`	aliased to its interface
`Lexer`, `Parser`, `FilterRegistry`, ...	the engine's internals

Extension points

Implement an interface; the bundle tags it.

Interface	Tag	Effect
`WidgetRendererInterface`	`dtmpl.widget`	adds `{widget:yourKey}`
`TemplateLoaderInterface`	`dtmpl.template_loader`	joins the loader chain
`ConstantProviderInterface`	`coolms.dtmpl.constant_provider`	adds `{const:YOURS}`

Loaders sort by getPriority() descending, with FallbackTemplateLoader pinned last. To fix a priority for your own loader class, call registerForAutoconfiguration on the concrete class in your bundle's build().

A note on the compiler passes

The loader chain, the widget registry and the constant providers are wired by compiler passes rather than by extension arguments. That is not stylistic: an application whose App\ glob re-registers a service would silently discard arguments an extension had set, because the glob loads after bundle extensions. A pass runs once every definition exists, so the wiring survives.

Dtmpl Bundle Laravel Package