README

This repository contains the latest stable compiled binaries of wkhtmltopdf and wkhtmltoimage from the wkhtmltopdf project.

The binaries are built for Ubuntu 18.04 bionic, amd64 and i386 architectures are included.

Why

Because apt package is outdated.

$ sudo apt install wkhtmltopdf

will install wkhtmltopdf version 0.12.4

When it's not possible to install the latest version via .deb package with apt

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb
sudo apt install ./wkhtmltox_0.12.5-1.bionic_amd64.deb

Or sometimes you just want a quick solution for your dev environment ;)

Installation

This package is published on Packagist and should be installed with Composer.

The version of the binary is equal to the git tag. Composer will install the latest version by default.

$ composer require-dev michael-schaefer-eu/wkhtmltox

Note: you should not use this package (or any other of that kind) in production environments!

Composer will install the package in your project path into the vendor/michael-schaefer-eu/wkhtmltox/ directory.

The binaries are located in the vendor/michael-schaefer-eu/wkhtmltox/bin/ directory.

Composer will symlink them to the vendor/bin/ directory.

Optional: You can also symlink them to the /usr/local/bin/ directory, as apt would install normally there.

$ ln -s /absolute/path/to/your/project/vendor/michael-schaefer-eu/wkhtmltox/bin/wkhtmltopdf-bionic-amd64 /usr/local/bin/wkhtmltopdf
$ ln -s /absolute/path/to/your/project/vendor/michael-schaefer-eu/wkhtmltox/bin/wkhtmltoimage-bionic-amd64 /usr/local/bin/wkhtmltoimage

Check the Version:

$ wkhtmltopdf -V
wkhtmltopdf 0.12.5 (with patched qt)

Usage

With the KNP-Snappy package, you can now use the binaries to create PDFs or Images from HTML.

You can use the path constants from this project to easily locate the binary paths (with PSR 4 Autoloader):

<?php
use Knp\Snappy\Pdf;
use Knp\Snappy\Image;
use Wkhtmltox\Wkhtmltopdf;
use Wkhtmltox\Wkhtmltoimage;

$snappyPdf = new Pdf(Wkhtmltopdf::BIONICAMD64);
$snappyImage = new Image(Wkhtmltoimage::BIONICAMD64)

OR If you symlinked the binaries to /usr/local/bin:

<?php
use Knp\Snappy\Pdf;
use Knp\Snappy\Image;

$snappyPdf = new Pdf('/usr/local/bin/wkhtmltopdf');
$snappyImage = new Image('/usr/local/bin/wkhtmltoimage');

License

This package is published under the same GNU General Public License v3.0 LICENSE as the wkhtmltopdf project.