Le remplaçant direct de wkhtmltopdf

Points forts

• Même ligne de commande Les 122 options de wkhtmltopdf 0.12.6, avec ses valeurs par défaut, ses messages et ses codes de sortie.
• Même nombre de pages 32 modèles réels sur 32 (Odoo, ERPNext, Sylius, pandoc), et 99,1 % des mots sur la même page, sous Linux.
• Testé par les bibliothèques pdfkit, knp-snappy, phpwkhtmltopdf et wicked_pdf passent leurs propres suites de tests avec pdfkiln.
• Mis à jour Le dernier Chromium stable dans chaque version ; sous Debian et Ubuntu, apt upgrade l’apporte.

Fonctionnement

• Un programme, deux noms Appelé wkhtmltopdf : la ligne de commande de wkhtmltopdf 0.12.6. Appelé pdfkiln : sa propre interface, avec les réglages d’impression du CSS de la page.
• Chromium dans sa sandbox Chaque conversion se fait sandbox active : lancez pdfkiln sous un utilisateur sans privilèges, pas en root.
• Un appel ou un serveur Un Chromium par appel, ou gardé ouvert par pdfkiln serve pour le volume.

Installer

curl -fsS https://apt.pdfkiln.org/pdfkiln-archive-keyring.asc | sudo tee /usr/share/keyrings/pdfkiln-archive-keyring.asc > /dev/null
printf 'Types: deb\nURIs: https://apt.pdfkiln.org\nSuites: stable\nComponents: main\nSigned-By: /usr/share/keyrings/pdfkiln-archive-keyring.asc\n' \
  | sudo tee /etc/apt/sources.list.d/pdfkiln.sources
sudo apt update && sudo apt install pdfkiln

curl -fsSO https://raw.githubusercontent.com/Jamalofski/pdfkiln/main/docker/seccomp.json
docker run --rm -i --security-opt seccomp=seccomp.json ghcr.io/jamalofski/pdfkiln wkhtmltopdf - - < page.html > page.pdf

composer require pdfkiln/pdfkiln

npx @pdfkiln/pdfkiln wkhtmltopdf page.html page.pdf
npm install -g @pdfkiln/pdfkiln    # pdfkiln, wkhtmltopdf and wkhtmltoimage

sudo apt install libasound2t64 libatk-bridge2.0-0t64 libatk1.0-0t64 libatspi2.0-0t64 libdbus-1-3 libexpat1 libgbm1 \
  libglib2.0-0t64 libnspr4 libnss3 libudev1 libx11-6 libxcb1 libxcomposite1 libxdamage1 libxext6 libxfixes3 \
  libxkbcommon0 libxrandr2 fontconfig fonts-liberation

Versions testées par l’intégration continue, avec sommes SHA-256 et attestations de provenance : gh attestation verify <fichier> --repo Jamalofski/pdfkiln.

Là où wkhtmltopdf ne s’installe plus : Ubuntu 24.04 et Debian 13, ARM64 et Apple Silicon, Docker.

Migrer en cinq minutes

Faites pointer la bibliothèque sur le wkhtmltopdf de pdfkiln, jamais sur pdfkiln, qui passe à sa propre interface. Le paquet Debian le place déjà dans le PATH.

• knp-snappy PHP

  La bibliothèque PHP des bundles Symfony et de laravel-snappy.

• laravel-snappy PHP, Laravel

  knp-snappy pour Laravel : deux lignes de .env.

• phpwkhtmltopdf PHP

  La bibliothèque de mikehaertl : une option, ou rien.

• pdfkit Python

  python-pdfkit : rien à changer s’il est dans le PATH.

• wicked_pdf Ruby on Rails

  Retirez la gem wkhtmltopdf-binary, réglez exe_path.

• imgkit Python

  Des captures avec le wkhtmltoimage de pdfkiln.

• Odoo ERP

  Les rapports gardent leur nombre de pages ; rien à configurer.

• Frappe et ERPNext ERP

  En-têtes et pieds de page HTML, avec leur JavaScript.

• Rotativa .NET

  Rotativa.AspNetCore et IIS, sous Windows.