WordTemplateBundle

Found this useful? Install from Packagist (composer require nowo-tech/word-template-bundle) and consider starring WordTemplateBundle on GitHub.

Symfony bundle that fills Microsoft Word .docx templates (PHPWord TemplateProcessor) using a PHP context array:

• Scalars (strings, numbers, booleans, null) → setValue on placeholders such as ${client_name} or ${client.city} when you nest arrays (flattened to dot keys).
• TableRows → cloneRow + per-cell #1, #2, … replacements for repeating table lines.
• HtmlContent → rich fragments (paragraphs, bold/italic, tables inside HTML, etc.) via PHPWord Html::addHtml embedded as a complex block (lists <ul>/<ol> may require extra numbering setup in PHPWord; prefer plain paragraphs or combine with HtmlToWordBundle for full HTML pipelines).
• ImageSource → setImageValue with optional width/height.

This bundle does not execute Word VBA macros; “macros” here means template placeholders in the .docx compatible with PHPWord.

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development

Additional documentation

• FrankenPHP / Docker demos — demo/symfony7 and demo/symfony8 (see demo/README.md)

Requirements

• PHP 8.2+
• Symfony 6.4 / 7.x / 8.x (as in composer.json)
• Extensions: dom, json, libxml, zip

Quick start

composer require nowo-tech/word-template-bundle

Register Nowo\WordTemplateBundle\WordTemplateBundle if needed, then wire your templates and inject WordTemplateProcessorInterface:

use Nowo\WordTemplateBundle\Processor\WordTemplateProcessorInterface;

$doc = $this->wordTemplateProcessor->process(
    '/path/to/template.docx',
    [
        'title' => 'Contract #42',
        'client' => ['name' => 'ACME', 'city' => 'Madrid'],
    ],
);
$bytes = $doc->readContents();
$doc->dispose(); // if the processor used a temp file

Tests and coverage

Scope	Detail
PHPUnit	composer test — unit + integration (minimal kernel in tests/Fixtures/AppKernel.php).
Lines	composer coverage-check enforces ≥ 93% (PCOV). Última medición global: ~94%.

Development

make up
make qa
make release-check

Demos (FrankenPHP)

From the repository root:

cd demo/symfony7 && cp .env.example .env && make up   # Symfony 7, port 8020
cd demo/symfony8 && cp .env.example .env && make up   # Symfony 8, port 8021

Or from demo/: make up / make up8 (see demo/README.md).

Versioning

Semantic Versioning.

License

MIT License.