Download the PHP package pontedilana/php-weasyprint without Composer
On this page you can find all versions of the php package pontedilana/php-weasyprint. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pontedilana/php-weasyprint
More information about pontedilana/php-weasyprint
Files in pontedilana/php-weasyprint
Package php-weasyprint
Short Description PHP library allowing PDF generation from an url or a html page. Wrapper for Kozea/WeasyPrint.
License MIT
Informations about the package php-weasyprint
PhpWeasyPrint
PhpWeasyPrint is a PHP library allowing PDF generation from a 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 60 or greater is required).
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
Usage
Initialization
Display the pdf in the browser
Download the pdf from the browser
Generate local pdf file
Pass options to PhpWeasyPrint
Reset options
Options can be reset to their initial values with resetOptions()
method.
Timeouts
A default timeout of 10 seconds is set for the WeasyPrint process to prevent orphaned or hanging processes.
This is a defensive measure that applies in most cases and helps ensure system stability.
You can change the timeout with the setTimeout()
method:
The timeout can be disabled entirely using either of the following:
This is especially useful if you're running inside a queue worker, job runner, or other environments that already handle timeouts (e.g. Symfony Messenger, Laravel Queue, Supervisor).
Disabling the internal timeout in those cases avoids conflicts with higher-level timeout strategies.
Note:
ThesetTimeout()
method affects both:
- how long the process is allowed to run before being forcibly stopped, and
- the
--timeout
option passed to the WeasyPrint command-line tool.If you only want to disable WeasyPrint's own timeout (while keeping the execution time limit), use:
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 string or URL is possible only with WeasyPrint lower versions and an unsupported PhpWeasyPrint version (
Pontedilana\PhpWeasyPrint\Image
has been successfully tested with Weasyprint 52.5 on PhpWeasyPrint 0.13.0).
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.
All versions of php-weasyprint with dependencies
psr/log Version ^1.1 || ^2.0 || ^3.0
symfony/process Version ^5.4.46 || ^6.4.14 || ^7.1.7