laravel-dompdf

by barryvdh

barryvdh / laravel-dompdf

A DOMPDF Wrapper for Laravel

4.2K Stars 653 Forks Last release: about 2 months ago (v0.8.7) 121 Commits 30 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

DOMPDF Wrapper for Laravel

Laravel wrapper for Dompdf HTML to PDF Converter

Require this package in your composer.json and update composer. This will download the package and the dompdf + fontlib libraries also.

composer require barryvdh/laravel-dompdf

Installation

Laravel 5.x:

After updating composer, add the ServiceProvider to the providers array in config/app.php

Barryvdh\DomPDF\ServiceProvider::class,

You can optionally use the facade for shorter code. Add this to your facades:

'PDF' => Barryvdh\DomPDF\Facade::class,

Lumen:

After updating composer add the following lines to register provider in

bootstrap/app.php
  $app->register(\Barryvdh\DomPDF\ServiceProvider::class);

To change the configuration, copy the config file to your config folder and enable it in

bootstrap/app.php
:
  $app->configure('dompdf');

Using

You can create a new DOMPDF instance and load a HTML string, file or view name. You can save it to a file, or stream (show in browser) or download.

$pdf = App::make('dompdf.wrapper');
$pdf->loadHTML('

Test

'); return $pdf->stream();

Or use the facade:

$pdf = PDF::loadView('pdf.invoice', $data);
return $pdf->download('invoice.pdf');

You can chain the methods:

return PDF::loadFile(public_path().'/myfile.html')->save('/path-to/my_stored_file.pdf')->stream('download.pdf');

You can change the orientation and paper size, and hide or show errors (by default, errors are shown when debug is on)

PDF::loadHTML($html)->setPaper('a4', 'landscape')->setWarnings(false)->save('myfile.pdf')

If you need the output as a string, you can get the rendered PDF with the output() function, so you can save/output it yourself.

Use

php artisan vendor:publish
to create a config file located at
config/dompdf.php
which will allow you to define local configurations to change some settings (default paper etc). You can also use your ConfigProvider to set certain keys.

Configuration

The defaults configuration settings are set in

config/dompdf.php
. Copy this file to your own config directory to modify the values. You can publish the config using this command:
php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"

You can still alter the dompdf options in your code before generating the pdf using this command:

PDF::setOptions(['dpi' => 150, 'defaultFont' => 'sans-serif']);

Available options and their defaults: * rootDir: "{appdirectory}/vendor/dompdf/dompdf" * _tempDir: "/tmp" (available in config/dompdf.php) * __fontDir: "{appdirectory}/storage/fonts/" _(available in config/dompdf.php) * fontCache: "{appdirectory}/storage/fonts/" _(available in config/dompdf.php) * chroot: "{appdirectory}" _(available in config/dompdf.php) * logOutputFile: "/tmp/log.htm" * defaultMediaType: "screen" (available in config/dompdf.php) * defaultPaperSize: "a4" (available in config/dompdf.php) * defaultFont: "serif" (available in config/dompdf.php) * dpi: 96 (available in config/dompdf.php) * fontHeightRatio: 1.1 (available in config/dompdf.php) * isPhpEnabled: false (available in config/dompdf.php) * isRemoteEnabled: true (available in config/dompdf.php) * isJavascriptEnabled: true (available in config/dompdf.php) * isHtml5ParserEnabled: false (available in config/dompdf.php) * isFontSubsettingEnabled: false (available in config/dompdf.php) * debugPng: false * debugKeepTemp: false * debugCss: false * debugLayout: false * debugLayoutLines: true * debugLayoutBlocks: true * debugLayoutInline: true * debugLayoutPaddingBox: true * pdfBackend: "CPDF" (available in config/dompdf.php) * pdflibLicense: "" * adminUsername: "user" * adminPassword: "password"

Tip: UTF-8 support

In your templates, set the UTF-8 Metatag:


Tip: Page breaks

You can use the CSS

page-break-before
/
page-break-after
properties to create a new page.

Page 1

Page 2

License

This DOMPDF Wrapper for Laravel is open-sourced software licensed under the MIT license

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.