This project provides the ability to generate PDF with Puppeteer in PHP.
- PHP 5 Compatible
- No Dependent Package
- Easy to Use
To install Puppeteer and its dependencies, we recommend you take a look at Puppeteer's official installation guide as well as their official troubleshooting guide.
Here is a snippet for Ubuntu (tested on 20.04) that works well at the time of writing:
curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget libappindicator3-1 libatk-bridge2.0-0 libgbm1
sudo npm install --global --unsafe-perm puppeteer
sudo chmod -R o+rx /usr/lib/node_modules/puppeteer/.local-chromium
Install this package using Composer:
composer require eckinox/php-puppeteer
Check out the examples and the documentation below to learn how to use the library
Here are a few very basic examples to get started:
<?php
require_once "vendor/autoload.php";
use Eckinox\PhpPuppeteer\Browser;
$config = [
"url" => "https://github.com/eckinox/php-puppeteer"
];
$browser = new Browser();
$content = $browser->pdf($config);
header("Content-type:application/pdf");
echo $content
<?php
require_once "vendor/autoload.php";
use Eckinox\PhpPuppeteer\Browser;
$config = [
"html" => "<h1>Hello World!</h1>"
];
$browser = new Browser();
$content = $browser->pdf($config);
header("Content-type:application/pdf");
echo $content
There are two options to define the source of the content to render:
html
: Provide a HTML snippet as a string.url
: Provide a URL to a publicly available webpage.
launchArgs
allows you to add an array of additionnal flags to the Chromium launch arguments.cacheDir
allows you to provide the path to a directory that Chromium can use to store the cache files and other user data.
The viewport
option will be passed directly to Puppeteer's page.setViewport()
.
Refer to Puppeteer's page.setViewport()
docs for more information.
The goto
option will be passed directly as the option parameter to Puppeteer's page.goto()
.
Refer to Puppeteer's page.goto()
docs for more information.
The pdf
option will be passed directly to Puppeteer's page.pdf()
when rendering your PDF.
Refer to Puppeteer's page.pdf()
docs for more information.
The cookies
option can be set with an array of cookie, which will be set using Puppeteer's page.setCookie()
.
Refer to Puppeteer's page.setCookie()
docs for more information.
You can add following html code in the html where you'd like to start a new page for PDF.
<div style="page-break-after:always;"></div>
If you're having trouble loading fonts, check out the font-loading example.
This package is a fork of its404/php-puppeteer, with updates to allow usage on more modern operating systems and versions of NodeJS, as well as improved documentation.