README

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

Symfony bundle that converts Microsoft Word (.docx / .doc) to PDF using LibreOffice Writer (soffice headless) for print-quality layout fidelity:

named YAML profiles + default profile + deep merge with per-call options, or convertWithInlineProfile();
batch conversion via convertMany() with PdfNaming (keep / prefix / suffix / surround / fixed / callback, or path ⇒ filename map);
runtime check that LibreOffice Writer is installed (nowo:word-to-pdf:check); fails with install hints if missing;
works under PHP-FPM and FrankenPHP (Symfony Process / proc_open);
Symfony-friendly export: streamed/binary responses, local path, optional Flysystem.

This bundle does not fill Word templates (see WordTemplateBundle), convert HTML to Word (see HtmlToWordBundle), or use DomPDF (DomPDF cannot preserve Word styles).

Documentation

Additional documentation

GitHub Actions CI requirements
FrankenPHP / Docker demo — demo/symfony8 (see demo/README.md)

System requirement

LibreOffice Writer must be installed on the host / container (Composer cannot install it):

# Debian / Ubuntu
sudo apt-get install -y libreoffice-writer

# Alpine
apk add libreoffice

# Fedora / RHEL
sudo dnf install -y libreoffice-writer

Verify:

php bin/console nowo:word-to-pdf:check

Quick start

composer require nowo-tech/word-to-pdf-bundle
php bin/console nowo:word-to-pdf:check

# config/packages/nowo_word_to_pdf.yaml
nowo_word_to_pdf:
    default_profile: default
    profiles:
        default:
            timeout: 180
            export:
                filename: document.pdf

Prefer the shared Nowo env (demos and multi-bundle apps):

timeout: '%env(int:PROCESS_TIMEOUT)%'   # PROCESS_TIMEOUT=180 in .env

See docs/DEMO-FRANKENPHP.md.

use Nowo\WordToPdfBundle\Converter\WordToPdfConverterInterface;
use Nowo\WordToPdfBundle\Export\ExporterInterface;
use Nowo\WordToPdfBundle\Naming\PdfNaming;

public function download(WordToPdfConverterInterface $converter, ExporterInterface $exporter): Response
{
    $pdf = $converter->convert('/path/to/contract.docx');
    // Batch: $converter->convertMany([$pathA, $pathB], PdfNaming::suffix(' [converted]'));

    return $exporter->toBinaryResponse($pdf);
}

FrankenPHP worker mode

FrankenPHP worker mode: Supported (tested with LibreOffice conversion under FrankenPHP).

The demo runs under FrankenPHP. Conversion uses Symfony Process with a hard timeout (and idle timeout); on expiry the runner stops the process tree so workers are not left with orphaned LibreOffice children (REQ-RUNTIME-001). Align PHP / Caddy deadlines above the profile timeout.

Demos use FRANKENPHP_MODE (worker by default, or classic) on PHP 8.5 — see docs/DEMO-FRANKENPHP.md. Change mode in .env and recreate containers (docker compose up -d); no image rebuild.

cd demo/symfony8 && cp .env.example .env && make up   # Symfony 8, port 8022

Tests and coverage

Scope	Detail
PHPUnit	`composer test` — unit + integration (`@group libreoffice` skipped when `soffice` is absent).
PHP lines	`composer coverage-check` enforces 100% (PCOV). Latest measurement: PHP: 100%.
TS/JS	N/A (no frontend assets in this bundle).

composer test
composer coverage-check

Development

make up
make qa
make release-check

nowo-tech / word-to-pdf-bundle

Maintainers

Package info

Statistics

Security