PhpWeasyPrint
PhpWeasyPrint is a PHP library allowing PDF generation from an URL or an HTML page. It's a wrapper for WeasyPrint, a smart solution helping web developers to create PDF documents, available everywhere Python runs.
You will have to download and install WeasyPrint to use PhpWeasyPrint (version 53 or greater is recommended).
This library is massively inspired by KnpLabs/snappy, of which it aims to be a one-to-one substitute (GeneratorInterface is the same). See "Differences with Snappy" section to see how the two differs
Installation using Composer
$ composer require pontedilana/php-weasyprint
Usage
Initialization
<?php
require __DIR__ . '/vendor/autoload.php';
use Pontedilana\PhpWeasyPrint\Pdf;
$pdf = new Pdf('/usr/local/bin/weasyprint');
// or you can do it in two steps
$pdf = new Pdf();
$pdf->setBinary('/usr/local/bin/weasyprint');
Display the pdf in the browser
$pdf = new Pdf('/usr/local/bin/weasyprint');
header('Content-Type: application/pdf');
echo $pdf->getOutput('http://www.github.com');
Download the pdf from the browser
$pdf = new Pdf('/usr/local/bin/weasyprint');
header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="file.pdf"');
echo $pdf->getOutput('http://www.github.com');
Generate local pdf file
$pdf = new Pdf('/usr/local/bin/weasyprint');
$pdf->generateFromHtml('<h1>Bill</h1><p>You owe me money, dude.</p>', '/tmp/bill-123.pdf');
Pass options to PhpWeasyPrint
// Type weasyprint -h to see the list of options
$pdf = new Pdf('/usr/local/bin/weasyprint');
$pdf->setOption('encoding', 'utf8');
$pdf->setOption('media-type', 'screen');
$pdf->setOption('presentational-hints');
$pdf->setOption('optimize-size', 'all');
$pdf->setOption('stylesheet', ['/path/to/first-style.css', '/path/to/second-style.css']);
$pdf->setOption('attachment', ['/path/to/image.png', '/path/to/logo.jpg']);
Reset options
Options can be reset to their initial values with resetOptions() method.
$pdf = new Pdf('/usr/local/bin/weasyprint');
// Set some options
$pdf->setOption('media-type', 'screen');
// ..
// Reset options
$pdf->resetOptions();
Differences with Snappy
Although PhpWeasyPrint and Snappy are interchangeable, there are a couple of differences between the two, due to WeasyPrint cli API:
- WeasyPrint doesn't support multiple sources to be merged in one single output pdf, so only one input source (string or URL) is accepted in PhpWeasyPrint;
- WeasyPrint version >= 53 doesn't generate images, so image generation from HTML tring or URL is possible only with WeasyPrint lower versions (
Pontedilana\PhpWeasyPrint\Imagehas been successfully tested with Weasyprint 52.5).
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.
- OS and its version
- WeasyPrint, 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.
Credits
PhpWeasyPrint has been originally developed by the Pontedilana dev team.
Snappy has been originally developed by the KnpLabs team.
13k Jan 9, 2023
2 Mar 24, 2022
3.6k Jan 6, 2023
335 Nov 26, 2022
1.9k Jan 2, 2023
1.6k Jan 2, 2023
16 Aug 24, 2022
4.1k Dec 30, 2022
7 Dec 30, 2022
90 Nov 14, 2022
64 Oct 18, 2021
3.8k Jan 2, 2023
9.3k Jan 1, 2023
2 Jan 23, 2022
13k Jan 4, 2023
4.1k Jan 1, 2023
11 Feb 15, 2022