README

⭐ Found this useful? Install from Packagist (composer require nowo-tech/html-to-word-bundle) and consider starring HtmlToWordBundle on GitHub.

Symfony bundle that converts rich HTML (WYSIWYG output from TipTap, CKEditor, etc.—already rendered server-side) into a downloadable .docx using PHPWord, with:

named YAML profiles + default profile + deep merge with per-call options, or convertWithInlineProfile() for a full stored profile (no YAML merge);
sanitization and HTML5 parsing (masterminds/html5);
tagged transformers for block elements (p, headings, lists, tables, images, …);
remote & inline images — optional download of http(s):// <img src> to temp paths before PhpWord, with cleanup after DOCX save;
optional header/footer (logo, text, page numbers) per profile;
Symfony-friendly export: streamed/binary responses, local path, optional Flysystem.

This bundle does not render Twig, generate HTML, produce PDF, or edit existing Word files.

Documentation

Additional documentation

FrankenPHP demos — how demo/symfony7 runs in Docker.
Example YAML profiles are shipped as src/Resources/config/nowo_html_to_word.yaml (copy into your app’s config/packages/).

Requirements

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

Quick start

composer require nowo-tech/html-to-word-bundle

Register Nowo\HtmlToWordBundle\HtmlToWordBundle if Flex does not, then add config/packages/nowo_html_to_word.yaml (see Configuration).

use Nowo\HtmlToWordBundle\Converter\HtmlToWordConverterInterface;
use Nowo\HtmlToWordBundle\Export\ExporterInterface;

$doc = $converter->convert($html);
return $exporter->toStreamResponse($doc);

Tests and coverage

Scope	Detail
PHPUnit	`composer test` — unit tests under `tests/Unit`, integration tests under `tests/Integration` (minimal Symfony kernel in `tests/Fixtures/AppKernel.php`).
PHP lines	Run `composer test-coverage` for the console summary, or `composer coverage-check` (same report written to `coverage-output.txt`, fails below 93% global lines). Latest reported global line coverage: ~94% (PCOV; a few defensive branches in exporters / image temp paths are marked `@codeCoverageIgnore` where impractical to hit in CI).

CI runs tests, PHPStan, and PHP-CS-Fixer on push/PR (see .github/workflows/ci.yml).

Development

Use the root Makefile and docker-compose.yml:

make up
make qa
make release-check

The PHP Docker image installs extensions required by PHPWord (including GD). Demo apps live under demo/ (see docs/DEMO-FRANKENPHP.md).

Version information

Stable releases are tagged on GitHub; upgrade notes are in docs/UPGRADING.md and docs/CHANGELOG.md.

Versioning

This library follows Semantic Versioning.

License

Released under the MIT License.

nowo-tech/html-to-word-bundle

包简介

关键字：

README 文档