knplabs/knp-snappy

PHP5 library allowing thumbnail, snapshot or PDF generation from a url or a html page. Wrapper for wkhtmltopdf/wkhtmltoimage.

Monday, January 22, 2018
by Knplabs
Repository
136 Watchers
2856 Stars
7,751,666 Installations

PHP
41 Dependents
3 Suggesters
351 Forks
31 Open issues
25 Versions
7 % Grown

The README.md

Snappy

, _(*1)

Snappy is a PHP library allowing thumbnail, snapshot or PDF generation from a url or a html page. It uses the excellent webkit-based wkhtmltopdf and wkhtmltoimage available on OSX, linux, windows., _(*2)

You will have to download wkhtmltopdf 0.12.x in order to use Snappy., _(*3)

Please, check FAQ before opening a new issue. Snappy is a tiny wrapper around wkhtmltox, so lots of issues are already answered, resolved or wkhtmltox ones., _(*4)

Following integrations are available: * knplabs/knp-snappy-bundle, for Symfony * barryvdh/laravel-snappy, for Laravel * mvlabs/mvlabs-snappy, for Zend Framework, _(*5)

Installation using Composer

composer require knplabs/knp-snappy

Usage

Initialization

<?php

require __DIR__ . '/vendor/autoload.php';

use Knp\Snappy\Pdf;

$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');

// or you can do it in two steps
$snappy = new Pdf();
$snappy->setBinary('/usr/local/bin/wkhtmltopdf');

Display the pdf in the browser

$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
header('Content-Type: application/pdf');
echo $snappy->getOutput('http://www.github.com');

Download the pdf from the browser

$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="file.pdf"');
echo $snappy->getOutput('http://www.github.com');

Merge multiple urls into one pdf

$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="file.pdf"');
echo $snappy->getOutput(array('http://www.github.com','http://www.knplabs.com','http://www.php.net'));

Generate local pdf file

$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
$snappy->generateFromHtml('<h1>Bill</h1><p>You owe me money, dude.</p>', '/tmp/bill-123.pdf');

Pass options to snappy

// Type wkhtmltopdf -H to see the list of options
$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
$snappy->setOption('disable-javascript', true);
$snappy->setOption('no-background', true);
$snappy->setOption('allow', array('/path1', '/path2'));
$snappy->setOption('cookie', array('key' => 'value', 'key2' => 'value2'));
$snappy->setOption('post', array('key' => 'value'));
$snappy->setOption('cover', 'pathToCover.html');
// .. or pass a cover as html
$snappy->setOption('cover', '<h1>Bill cover</h1>');
$snappy->setOption('toc', true);
$snappy->setOption('cache-dir', '/path/to/cache/dir');

Reset options

Options can be reset to their initial values with resetOptions() method., _(*6)

$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
// Set some options
$snappy->setOption('copies' => 4);
// ..
// Reset options
$snappy->resetOptions();

wkhtmltopdf binary as composer dependencies

If you want to download wkhtmltopdf and wkhtmltoimage with composer you add to composer.json:, _(*7)

composer require h4cc/wkhtmltopdf-i386 0.12.x
composer require h4cc/wkhtmltoimage-i386 0.12.x

or this if you are in 64 bit based system:, _(*8)

composer require h4cc/wkhtmltopdf-amd64 0.12.x
composer require h4cc/wkhtmltoimage-amd64 0.12.x

And then you can use it, _(*9)

<?php

use Knp\Snappy\Pdf;

$myProjectDirectory = '/path/to/my/project';

$snappy = new Pdf($myProjectDirectory . '/vendor/h4cc/wkhtmltopdf-i386/bin/wkhtmltopdf-i386');

// or

$snappy = new Pdf($myProjectDirectory . '/vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64');

N.B. These static binaries are extracted from Debian7 packages, so it might not be compatible with non-debian based linux distros, _(*10)

Some use cases

If you want to generate table of contents and you want to use custom XSL stylesheet, do the following:, _(*11)

<?php
$snappy = new Pdf('/path/to/binary');

$snappy->setOption('toc', true);
$snappy->setOption('xsl-style-sheet', 'http://path/to/stylesheet.xsl') //or local file;

$snappy->generateFromHtml('

Some content, _(*12)

', 'test.pdf');

Bugs & Support

If you found a bug please fill a detailed issue with all the following points. If you need some help, please at least provide a complete reproducer so we could help you based on facts rather than assumptions., _(*13)

OS and its version
Wkhtmltopdf, its version and how you installed it
A complete reproducer with relevant php and html/css/js code

If your reproducer is big, please try to shrink it. It will help everyone to narrow the bug., _(*14)

Maintainers

KNPLabs is looking for maintainers (see why)., _(*15)

If you are interested, feel free to open a PR to ask to be added as a maintainer., _(*16)

We’ll be glad to hear from you :), _(*17)

Credits

Snappy has been originally developed by the KnpLabs team., _(*18)

The Versions

22/01 2018

dev-master

9999999-dev http://github.com/KnpLabs/snappy

PHP5 library allowing thumbnail, snapshot or PDF generation from a url or a html page. Wrapper for wkhtmltopdf/wkhtmltoimage.

library knp-snappy

PHP5 library allowing thumbnail, snapshot or PDF generation from a url or a html page. Wrapper for wkhtmltopdf/wkhtmltoimage.

knplabs/knp-snappy

The README.md

Snappy

Installation using Composer

Usage

Initialization

Display the pdf in the browser

Download the pdf from the browser

Merge multiple urls into one pdf

Generate local pdf file

Pass options to snappy

Reset options

wkhtmltopdf binary as composer dependencies

Some use cases

Bugs & Support

Maintainers

Credits

The Versions

dev-master

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

v1.0.4

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

2.0.x-dev

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

v1.0.3

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

v1.0.2

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

v1.0.1

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

v1.0

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

v0.5.0

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

0.4.3

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

dev-doc/locales

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

0.4.2

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team

0.4.1

The Requires

The Development Requires

by Symfony Community

by KnpLabs Team