PHPackages                             lflores10/mpdf-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [PDF & Document Generation](/categories/documents)
4. /
5. lflores10/mpdf-laravel

ActiveLibrary[PDF & Document Generation](/categories/documents)

lflores10/mpdf-laravel
======================

Laravel Mpdf: Using Mpdf in Laravel to generate Pdfs.

v0.0.2(2y ago)05MITPHPPHP ^8.1

Since Feb 27Pushed 2y ago1 watchersCompare

[ Source](https://github.com/lflores10/mpdf-laravel)[ Packagist](https://packagist.org/packages/lflores10/mpdf-laravel)[ RSS](/packages/lflores10-mpdf-laravel/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (5)Used By (0)

Laravel Mpdf: Generate PDF Files with ease.
===========================================

[](#laravel-mpdf-generate-pdf-files-with-ease)

Easily generate PDF files using [Laravel's Blade templates](https://laravel.com/docs/blade) and the [MPDF library](https://mpdf.github.io/). This package has been tested since Laravel 5.4.

Installation
------------

[](#installation)

Run this composer command in your laravel application:

```
composer require lflores10/laravel-mpdf

```

Important Notes:
----------------

[](#important-notes)

- Always check the [official MPDF documentation](https://mpdf.github.io/)
- mPDF will timeout on [fetching external HTTP resources](https://github.com/mpdf/mpdf#known-server-caveats) when using single-threaded servers such as `php -S` or `artisan serve`. Use a proper webserver for full functionality.

To start using Laravel, add the Service Provider and the Facade to your `config/app.php`:

> **Note:** This package supports auto-discovery features of Laravel 5.5+, You only need to manually add the service provider and alias if working on Laravel version lower then 5.5.

```
'providers' => [
    // ...
    lflores10\LaravelMpdf\LaravelMpdfServiceProvider::class
]
```

```
'aliases' => [
    // ...
    'PDF' => lflores10\LaravelMpdf\Facades\LaravelMpdf::class
]
```

Basic Usage
-----------

[](#basic-usage)

To use Laravel Mpdf add something like this to one of your controllers. You can pass data to a view in `/resources/views`.

```
//....

use PDF;

class ReportController extends Controller
{
    public function viewPdf()
    {
        $data = [
            'foo' => 'bar'
        ];

        $pdf = PDF::loadView('pdf.document', $data);

        return $pdf->stream('document.pdf');
    }

}
```

Config
------

[](#config)

You can use a custom file to overwrite the default configuration. Just execute `php artisan vendor:publish --tag=mpdf-config` or create `config/pdf.php` and add this:

```
return [
    'mode'                       => '',
    'format'                     => 'A4',
    'default_font_size'          => '12',
    'default_font'               => 'sans-serif',
    'margin_left'                => 10,
    'margin_right'               => 10,
    'margin_top'                 => 10,
    'margin_bottom'              => 10,
    'margin_header'              => 0,
    'margin_footer'              => 0,
    'orientation'                => 'P',
    'title'                      => 'Laravel mPDF',
    'author'                     => '',
    'watermark'                  => '',
    'show_watermark'             => false,
    'show_watermark_image'       => false,
    'watermark_font'             => 'sans-serif',
    'display_mode'               => 'fullpage',
    'watermark_text_alpha'       => 0.1,
    'watermark_image_path'       => '',
    'watermark_image_alpha'      => 0.2,
    'watermark_image_size'       => 'D',
    'watermark_image_position'   => 'P',
    'custom_font_dir'            => '',
    'custom_font_data'           => [],
    'auto_language_detection'    => false,
    'temp_dir'                   => storage_path('app'),
    'pdfa'                       => false,
    'pdfaauto'                   => false,
    'use_active_forms'           => false,
];
```

To override this configuration on a per-file basis use the fourth parameter of the initializing call like this:

```
// ...

PDF::loadView('pdf', $data, [], [
    'title' => 'Another Title',
    'margin_top' => 0
])->save($pdfFilePath);
```

Get instance your Mpdf
----------------------

[](#get-instance-your-mpdf)

You can access all mpdf methods through the mpdf instance with `getMpdf` method.

```
use PDF;

$pdf = PDF::loadView('pdf.document', $data);
$pdf->getMpdf()->AddPage(/*...*/);
```

Headers and Footers
-------------------

[](#headers-and-footers)

If you want to have headers and footers that appear on every page, add them to your `` tag like this:

```

    Your Header Content

    Your Footer Content

```

Now you just need to define them with the name attribute in your CSS:

```
@page {
  header: page-header;
  footer: page-footer;
}
```

Inside of headers and footers `{PAGENO}` can be used to display the page number.

Included Fonts
--------------

[](#included-fonts)

By default you can use all the fonts [shipped with Mpdf](https://mpdf.github.io/fonts-languages/available-fonts-v6.html).

Custom Fonts
------------

[](#custom-fonts)

You can use your own fonts in the generated PDFs. The TTF files have to be located in one folder, e.g. `resources/fonts/`. Add this to your configuration file (`/config/pdf.php`):

```
return [
    'custom_font_dir'  => base_path('resources/fonts/'), // don't forget the trailing slash!
    'custom_font_data' => [
        'examplefont' => [ // must be lowercase and snake_case
            'R'  => 'ExampleFont-Regular.ttf',    // regular font
            'B'  => 'ExampleFont-Bold.ttf',       // optional: bold font
            'I'  => 'ExampleFont-Italic.ttf',     // optional: italic font
            'BI' => 'ExampleFont-Bold-Italic.ttf' // optional: bold-italic font
        ]
      // ...add as many as you want.
    ]
];
```

Now you can use the font in CSS:

```
body {
  font-family: 'examplefont', sans-serif;
}
```

Chunk HTML
----------

[](#chunk-html)

For big HTML you might get `Uncaught Mpdf\MpdfException: The HTML code size is larger than pcre.backtrack_limit xxx` error, or you might just get [empty or blank result](https://mpdf.github.io/troubleshooting/known-issues.html#blank-pages-or-some-sections-missing). In these situations you can use chunk methods while you added a separator to your HTML:

```
//....
use PDF;
class ReportController extends Controller
{
    public function generate_pdf()
    {
        $data = [
            'foo' => 'hello 1',
            'bar' => 'hello 2'
        ];
        $pdf = PDF::chunkLoadView('', 'pdf.document', $data);
        return $pdf->stream('document.pdf');
    }
}
```

```

    Hello World

        {{ $foo }}

        {{ $bar }}

```

Added Support for the Macroable Trait
-------------------------------------

[](#added-support-for-the-macroable-trait)

You can configure the macro in the `AppServiceProvider` provider file.

```
//...
use lflores10\LaravelMpdf\LaravelMpdf;

class AppServiceProvider extends ServiceProvider
{
  //...

    public function boot()
    {
        LaravelMpdf::macro('hello', function () {
            return "Hello, World!";
        });
    }

  //...
}
```

Now

```
PDF::loadView(/* ... */)->hello();
```

License
-------

[](#license)

Laravel Mpdf is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Total

2

Last Release

799d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/89d059557dc60bafc0ede44fa8639f82c69074cb9ae7e8828d45d7be6a258a98?d=identicon)[lflores10](/maintainers/lflores10)

---

Top Contributors

[![SolventaLuisFlores](https://avatars.githubusercontent.com/u/80709914?v=4)](https://github.com/SolventaLuisFlores "SolventaLuisFlores (2 commits)")[![lflores10](https://avatars.githubusercontent.com/u/5910874?v=4)](https://github.com/lflores10 "lflores10 (1 commits)")

---

Tags

laravelpdfmpdf

### Embed Badge

![Health badge](/badges/lflores10-mpdf-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/lflores10-mpdf-laravel/health.svg)](https://phpackages.com/packages/lflores10-mpdf-laravel)
```

###  Alternatives

[carlos-meneses/laravel-mpdf

Laravel Mpdf: Using Mpdf in Laravel to generate Pdfs.

4403.1M7](/packages/carlos-meneses-laravel-mpdf)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)