- What is leo-moshko/gotenberg-bundle and what does it do?
- It is a Symfony bundle that integrates the Gotenberg document-conversion API into a PHP application. It offers a simple wrapper for sending HTML, Markdown and Office files over HTTP and receiving clean, print-ready PDFs back with minimal setup. The Composer package name is leo-moshko/gotenberg-bundle and the source lives at github.com/LeoMoshko/GotenbergBundle.
- Does leo-moshko/gotenberg-bundle work with Laravel, or is it Symfony only?
- The package is described as Gotenberg support for Symfony, so its container bindings and configuration are Symfony-oriented rather than Laravel-native. The available documentation does not mention a Laravel service provider, facade or auto-discovery. In a Laravel app you can still target the same Gotenberg HTTP API with the built-in HTTP client, or reuse the bundle's request logic as a reference. Check the README before assuming Laravel support.
- How do I install leo-moshko/gotenberg-bundle with Composer?
- Install it with composer require leo-moshko/gotenberg-bundle. In a Symfony application you then register the bundle in your kernel or bundles.php as described in the README. Look at the repository documentation for the exact configuration keys, environment variables and the service ID to inject.
- Do I need a running Gotenberg server to use this package?
- Yes. Gotenberg is a separate service, usually run from its official Docker image, that performs the actual document conversion. This package is only a client wrapper that sends documents to that API over HTTP. You need a reachable Gotenberg endpoint configured before any conversion will succeed.
- Which file formats can the bundle convert to PDF?
- The package description lists HTML, Markdown and Office files as inputs, with PDF as the output. Gotenberg itself exposes different routes per input type, so which route the wrapper targets depends on the method you call. Confirm the exact method names and supported options in the repository README.
- How does it compare to calling the Gotenberg API directly with Guzzle or Laravel's HTTP client?
- Calling the API directly means hand-building multipart requests against Gotenberg routes, which is flexible but repetitive across a codebase. The bundle packages that request building plus Symfony configuration so you can inject a single service. If you only need one endpoint and want zero extra dependencies, direct HTTP calls are a reasonable alternative.
- Is this package safe to use in production?
- Run Gotenberg as a dedicated service rather than inside your web process, and set HTTP timeouts that match the largest documents you convert. Office and large HTML conversions can take several seconds, so configure sane timeouts and handle non-2xx responses explicitly. Keep the Gotenberg base URL in environment configuration so staging and production can point at different instances.
- How do I test PDF generation without a real Gotenberg instance?
- Fake the HTTP layer in your application tests so no live Gotenberg container is required, and assert on the request your code builds. For end-to-end coverage, run the Gotenberg Docker image as a service container in CI. Check the README for any test helpers the bundle itself ships.
- Which PHP and Symfony versions does the bundle support?
- The available package metadata does not state explicit PHP or Symfony version constraints, so review composer.json on the repository before adding it to a project. Also check the tags and commit history to judge ongoing maintenance. Because it is a small wrapper, pinning a version in composer.json is a sensible precaution.
- What alternatives exist for Laravel developers who need HTML to PDF conversion?
- You can call the Gotenberg REST API directly with Guzzle or Laravel's HTTP client, which keeps dependencies minimal. Other options include wkhtmltopdf-based wrappers, Dompdf, or managed PDF APIs, each with different CSS and JavaScript support. If you want a Laravel-specific integration, look for a maintained Gotenberg client package or write a thin service class around the API using this bundle as a reference for the request format.