Migrate KnpLabs Snappy off wkhtmltopdf
Keep KnpLabs Snappy and your PHP invoice code. Give Snappy a new PDF program.
Marqius

Your PHP app uses Snappy to turn orders into PDFs. The order screen still works after a server move, but the printed invoice never arrives.
Marqius is a drop-in replacement for wkhtmltopdf. Your app can keep using KnpLabs Snappy to ask for a PDF.
Why this helps
Give the Snappy PDF object the path to Marqius. The order code can still ask Snappy for a PDF the same way, so you can test this change with a single order.
Make your first PDF
Start with Invoice 1001 for 120.00 EUR. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open START-HERE.html after unzipping. Download the library starter kit (ZIP) · Open the library example PDF
With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing examples/. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container.
1. Open a fresh test container
docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bashRun the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as /proof, so you can open the saved PDF after the test.
2. Install the tools and Marqius
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils php-cli composer
mkdir -p /work
cd /work
curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh
bash install-marqius.sh --version 0.12.8 --prefix /work/bin
export PATH="/work/bin:$PATH"
export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf
export COMPOSER_ALLOW_SUPERUSER=1
"$WKHTMLTOPDF_BINARY" --version
wkhtmltopdf --versionThe version output should include marqius-wkhtmltopdf 0.12.8. Marqius supplies the wkhtmltopdf command inside this test container.
3. Bring the demo project into the test container
cd /work
if [ -d /proof/examples/knplabs-snappy ]; then
cp -R /proof/examples .
else
curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip &&
unzip -oq wrapper-demos.zip
fi4. Install the PHP library
cd examples/knplabs-snappy
composer install --no-interaction --prefer-dist5. Make the invoice through PHP
php render.php /proof/invoice.pdf6. Check that the PDF contains the right invoice
pdfinfo /proof/invoice.pdf | grep '^Pages:'
pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001'
pdftotext /proof/invoice.pdf - | grep -F '120.00'
chmod a+r /proof/invoice.pdfLook for one page, the invoice number and the amount. Type exit to close the test container. Open invoice.pdf in the folder you created on your computer.
How to switch your own app to Marqius
Pass the new executable path to the Knp Snappy Pdf constructor where you build your PDF service. Keep the same getOutputFromHtml or generateFromHtml call.
Install Marqius alongside the original. Set WKHTMLTOPDF_BINARY in the application process to the new executable's full path unless the example specifies a framework-specific variable. The Debian APT package installs /usr/bin/marqius-wkhtmltopdf. Debian installation guide · Downloads for other environments
Apply the change in Your PHP factory or service definition for Knp\Snappy\Pdf. Retain the existing rendering options unless your comparison identifies a reason to change them.
$snappy = new \Knp\Snappy\Pdf(getenv('WKHTMLTOPDF_BINARY'));
$snappy->generateFromHtml($html, $outputPath, ['page-size' => 'A4']);Try it with a document you know
Render a multi-page PDF with your usual options and verify the invoice totals, A4 size and footer. Run under the same PHP worker user as the app so temp directory permissions and environment settings match production.
If the app uses Laravel's service provider or Symfony's bundle, change the framework setting in the corresponding guide. A standalone constructor change has no effect on a framework service supplied elsewhere.
Check the old and new PDFs
Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The runnable KnpLabs Snappy example exercises a sample PDF through the wrapper. The developer manual chapter records the test conditions and constraints. The public comparison scoreboard reports differences for the wkhtmltopdf and Marqius renderers.
All 14 library guides · Laravel Snappy · Symfony KnpSnappyBundle · Try Marqius for 30 days
Reader questions
Does the Snappy constructor take the binary or a directory?
Pass the executable's full path. Keep its parent directory accessible to the user running PHP.