Laravel PDF

https://spatie.be/docs/laravel-pdf/v1/
Admin
Laravel PDF is a package that provides a simple way to create PDF files in Laravel applications...
Tokens:7,046
Snippets:94
Trust Score:9.9
Update:2 months ago
Show doc for...
Tokens:
Raw
### Check installed package version

Source: https://spatie.be/docs/laravel-pdf/v1/alternatives

Use this command to verify the version of the spatie/laravel-pdf package currently installed in your project.

```bash
composer show spatie/laravel-pdf
```

--------------------------------

### Install Laravel PDF package

Source: https://spatie.be/docs/laravel-pdf/v1/installation-setup

Run this command to add the package to your Laravel project dependencies.

```bash
composer require spatie/laravel-pdf
```

--------------------------------

### Example footer view content

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Example of CSS and HTML content for a footer view, noting that main view CSS does not apply here.

```html
footer {
    font-size: 12px;
}

  This is the footer
```

--------------------------------

### Execute JavaScript in PDF

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/creating-pdfs

Example of JavaScript execution within the generated PDF context.

```javascript
    document.getElementById('target').innerHTML = 'hello';
```

--------------------------------

### Define PDF invoice view with Tailwind

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/using-tailwind

A Blade template example using Tailwind CSS classes and a CDN link to structure a PDF invoice.

```html
<!DOCTYPE html>
<html>
<head>
    <script src="https://cdn.tailwindcss.com"></script>
</head>
<body>
    <div class="p-8">
        <h1 class="text-2xl font-bold">Invoice</h1>
        <div class="flex justify-between">
            <div>
                <h2 class="text-xl">Your Company Name</h2>
            </div>
            <div>
                <h2 class="text-xl">Invoice</h2>
                <p>Date: 01/05/2023</p>
                <p>Invoice #: {{ $invoiceNumber }}</p>
            </div>
        </div>
        <div class="mt-8">
            <h3 class="font-bold">Bill To:</h3>
            <p>{{ $customerName }}</p>
            <p>123 Main St.</p>
            <p>Anytown, USA 12345</p>
            <p>johndoe@example.com</p>
        </div>
        <table class="w-full mt-8">
            <thead>
                <tr class="border-b">
                    <th class="text-left">Description</th>
                    <th class="text-right">Quantity</th>
                    <th class="text-right">Price</th>
                    <th class="text-right">Total</th>
                </tr>
            </thead>
            <tbody>
                <tr class="border-b">
                    <td>Product 1</td>
                    <td class="text-right">1</td>
                    <td class="text-right">$100.00</td>
                    <td class="text-right">$100.00</td>
                </tr>
                <tr class="border-b">
                    <td>Product 2</td>
                    <td class="text-right">2</td>
                    <td class="text-right">$50.00</td>
                    <td class="text-right">$100.00</td>
                </tr>
                <tr class="border-b">
                    <td>Product 3</td>
                    <td class="text-right">3</td>
                    <td class="text-right">$75.00</td>
                    <td class="text-right">$225.00</td>
                </tr>
            </tbody>
        </table>
        <div class="mt-8 text-right">
            <p>Subtotal: $425.00</p>
            <p>Tax: $25.50</p>
            <p class="font-bold">Total: $450.50</p>
        </div>
        <div class="mt-8 text-sm text-gray-600">
            <p>Payment is due within 30 days. Late payments are subject to fees.</p>
            <p>Please make checks payable to Your Company Name and mail to:</p>
            <p>123 Main St., Anytown, USA 12345</p>
        </div>
    </div>
</body>
</html>
```

--------------------------------

### Configure Binary Paths in Configuration File

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/configuration

Define paths for Node.js, npm, and Chrome within the configuration array.

```php
'browsershot' => [
    'node_binary' => env('LARAVEL_PDF_NODE_BINARY'),
    'npm_binary' => env('LARAVEL_PDF_NPM_BINARY'),
    'include_path' => env('LARAVEL_PDF_INCLUDE_PATH'),
    'chrome_path' => env('LARAVEL_PDF_CHROME_PATH'),
    'node_modules_path' => env('LARAVEL_PDF_NODE_MODULES_PATH'),
    'bin_path' => env('LARAVEL_PDF_BIN_PATH'),
    'temp_path' => env('LARAVEL_PDF_TEMP_PATH'),
    'write_options_to_file' => env('LARAVEL_PDF_WRITE_OPTIONS_TO_FILE', false),
    'no_sandbox' => env('LARAVEL_PDF_NO_SANDBOX', false),
],
```

--------------------------------

### Publish configuration file

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/configuration

Run this command to generate the config/laravel-pdf.php file in your application.

```bash
php artisan vendor:publish --tag=pdf-config
```

--------------------------------

### Override global PDF defaults

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/setting-defaults

Demonstrates how to use global defaults and how to override them when generating specific PDF instances.

```php
// this PDF will use the defaults: it will be rendered in A3 format

Pdf::html('Hello world')
    ->save('my-a3-pdf.pdf')

// here we override the default: this PDF will be rendered in A4 format

Pdf::html('Hello world')
   ->format(Format::A4)
   ->save('my-a4-pdf.pdf')
```

--------------------------------

### Set header and footer with raw HTML

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Use headerHtml and footerHtml methods to provide raw string content for headers and footers.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->headerHtml('My header')
    ->footerHtml('My footer')
    ->save('/some/directory/invoice-april-2022.pdf');
```

--------------------------------

### Define Environment Variables

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/configuration

Set environment variables to configure PDF generation paths and options.

```text
LARAVEL_PDF_NODE_BINARY=/usr/local/bin/node
LARAVEL_PDF_NPM_BINARY=/usr/local/bin/npm
LARAVEL_PDF_INCLUDE_PATH=/usr/local/bin
LARAVEL_PDF_CHROME_PATH=/usr/bin/google-chrome-stable
LARAVEL_PDF_NODE_MODULES_PATH=/path/to/node_modules
LARAVEL_PDF_BIN_PATH=/usr/local/bin
LARAVEL_PDF_TEMP_PATH=/tmp
LARAVEL_PDF_WRITE_OPTIONS_TO_FILE=true
LARAVEL_PDF_NO_SANDBOX=true
```

--------------------------------

### Return a PDF response from a controller

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/responding-with-pdfs

Use the pdf() helper to render a view as a PDF. By default, the PDF is returned as an inline response.

```php
use function Spatie\LaravelPdf\Support\pdf;

class DownloadInvoiceController
{
    public function __invoke(Invoice $invoice)
    {
        return pdf()
            ->view('pdf.invoice', compact('invoice'))
            ->name('invoice-2023-04-10.pdf');
    }
}
```

--------------------------------

### Configure global PDF defaults

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/setting-defaults

Set default PDF options globally by calling the default method on the Pdf facade, typically within a service provider's boot method.

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\LaravelPdf\Enums\Format;

// in a service provider

Pdf::default()
    ->headerView('pdf.header')
    ->format(Format::A3);
```

--------------------------------

### Set header and footer with views

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Use headerView and footerView methods to define the HTML structure for PDF headers and footers.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->headerView('pdf.invoice.header')
    ->footerView('pdf.invoice.footer')
    ->save('/some/directory/invoice-april-2022.pdf');
```

--------------------------------

### List of Available Paper Formats

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Reference list of supported paper formats and their dimensions.

```text
Letter: 8.5in  x  11in
Legal: 8.5in  x  14in
Tabloid: 11in  x  17in
Ledger: 17in  x  11in
A0: 33.1in  x  46.8in
A1: 23.4in  x  33.1in
A2: 16.54in  x  23.4in
A3: 11.7in  x  16.54in
A4: 8.27in  x  11.7in
A5: 5.83in  x  8.27in
A6: 4.13in  x  5.83in
```

--------------------------------

### Generate PDF from HTML string

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/creating-pdfs

Creating a PDF directly from a raw string of HTML content.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::html('Hello world!!')->save('/some/directory/invoice.pdf');
```

--------------------------------

### Configure PDF Backgrounds

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Control background rendering using CSS print-color-adjust or by configuring Browsershot for transparent backgrounds.

```css
html {
    -webkit-print-color-adjust: exact;
}
```

```php
Pdf::view('test')
    ->withBrowsershot(function (Browsershot $browsershot) {
        $browsershot->transparentBackground();
    })
    ->save($this->targetPath);
```

--------------------------------

### Render view with JavaScript

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/creating-pdfs

Rendering a view that contains JavaScript logic.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('your-view')->save($pathToPdf);
```

--------------------------------

### Assert PDF response

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Verify that a PDF was generated and returned as a download response.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Route::get('download-invoice', function () {
    return pdf('pdf.invoice')->download('invoice-for-april-2022.pdf');
});
```

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\LaravelPdf\PdfBuilder;

it('can download an invoice', function () {
    $this
        ->get('download-invoice')
        ->assertOk();

    Pdf::assertRespondedWithPdf(function (PdfBuilder $pdf) {
        return $pdf->downloadName === 'invoice-for-april-2022.pdf'
            && $pdf->isDownload()
            && str_contains($pdf->html, 'Your total for April is $10.00');
    });
});
```

--------------------------------

### Using a custom macro

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/extending-with-macros

Invoke the registered macro as a method on the PdfBuilder instance.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('invoice')
    ->withCustomHeader('Invoice #123')
    ->save('invoice.pdf');
```

--------------------------------

### Adding a macro to PdfBuilder

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/extending-with-macros

Register custom methods on the PdfBuilder class within a service provider's boot method.

```php
use Spatie\LaravelPdf\PdfBuilder;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        PdfBuilder::macro('withCustomHeader', function (string $title) {
            $this->headerHtml = "{$title}";

            return $this;
        });
    }
}
```

--------------------------------

### Force a PDF download

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/responding-with-pdfs

Chain the download() method to the pdf() helper to force the browser to download the generated PDF file.

```php
use function Spatie\LaravelPdf\Support\pdf;

class DownloadInvoiceController
{
    public function __invoke(Invoice $invoice)
    {
        return pdf()
            ->view('pdf.invoice', compact('invoice'))
            ->name('invoice-2023-04-10.pdf')
            ->download();
    }
}
```

--------------------------------

### Pdf::fake()

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Call the fake method on the Pdf facade to mock PDF generation, which speeds up your tests.

```APIDOC
## Pdf::fake()

### Description
Fakes the PDF generation process to improve test performance.

### Usage
```php
use Spatie\LaravelPdf\Facades\Pdf;

beforeEach(function () {
    Pdf::fake();
});
```
```

--------------------------------

### Simple PDF assertions

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Use these methods to verify specific attributes of a generated PDF.

```php
Pdf::assertViewIs('pdf.invoice');
```

```php
Pdf::assertSee('Your total for April is $10.00');
```

```php
Pdf::assertSee([
    'Your total for April is $10.00', 
    'Your total for May is $20.00',
]);
```

```php
Pdf::assertViewHas('invoice');
```

```php
Pdf::assertViewHas('invoice', $invoice);
```

```php
Pdf::assertSaved(storage_path('invoices/invoice.pdf'));
```

--------------------------------

### Return PDF as a controller response

Source: https://spatie.be/docs/laravel-pdf/v1

Returns a generated PDF directly from a controller action, allowing for browser downloads.

```php
use Spatie\LaravelPdf\Facades\Pdf;

class DownloadInvoiceController
{
    public function __invoke(Invoice $invoice)
    {
        return Pdf::view('pdfs.invoice', ['invoice' => $invoice])
            ->format('a4')
            ->name('your-invoice.pdf');
    }
}
```

--------------------------------

### Test PDF generation

Source: https://spatie.be/docs/laravel-pdf/v1/introduction

Use the built-in testing helpers to fake PDF generation and assert that the response contains expected content.

```php
use Spatie\LaravelPdf\Facades\Pdf;

it('can render an invoice', function () {
    Pdf::fake();

    $invoice = Invoice::factory()->create();

    $this->get(route('download-invoice', $invoice))
        ->assertOk();

    Pdf::assertRespondedWithPdf(function (PdfBuilder $pdf) {
        return $pdf->contains('test');
    });
});
```

--------------------------------

### Simple Assertion Methods

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Utility methods for asserting properties of generated PDFs.

```APIDOC
## Simple Assertion Methods

### assertViewIs(string $view)
Asserts that a PDF was generated using a specific view.

### assertSee(string|array $text)
Asserts that the generated PDF contains the given string or array of strings.

### assertViewHas(string $key, mixed $value = null)
Asserts that the PDF view was passed a specific key, optionally checking the value.
```

--------------------------------

### Override Configuration with withBrowsershot

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/configuration

Use the withBrowsershot method to apply custom settings to a specific PDF generation instance.

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\Browsershot\Browsershot;

// This PDF will use the configuration defaults plus the scale override
Pdf::view('invoice', ['invoice' => $invoice])
    ->withBrowsershot(function (Browsershot $browsershot) {
        $browsershot->scale(0.8);
    })
    ->save('invoice.pdf');
```

--------------------------------

### Generate PDF in controller

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/using-tailwind

Implementation of a controller action that renders the PDF view with provided data.

```php
namespace App\Http\Controllers;

use function Spatie\LaravelPdf\Support\pdf;

class DownloadInvoiceController
{
    public function __invoke()
    {
        return pdf('pdf.invoice', [
            'invoiceNumber' => '1234',
            'customerName' => 'Grumpy Cat',
        ]);
    }
}
```

--------------------------------

### Test PDF generation

Source: https://spatie.be/docs/laravel-pdf/v1

Uses the Pdf::fake() method to mock PDF generation in tests and verify the output.

```php
use Spatie\LaravelPdf\Facades\Pdf;

it('can render an invoice', function () {
    Pdf::fake();

    $invoice = Invoice::factory()->create();

    $this->get(route('download-invoice', $invoice))
        ->assertOk();
        
    Pdf::assertRespondedWithPdf(function (PdfBuilder $pdf) {
        return $pdf->contains('test');
    });
});
```

--------------------------------

### Generate PDF on AWS Lambda

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/generating-pdfs-on-aws-lambda

Usage of the onLambda method to offload PDF generation to an AWS Lambda function.

```php
Pdf::view('pdf.invoice', $data)
    ->onLambda()
    ->save('invoice.pdf');
```

--------------------------------

### Save PDF to a specific disk

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/saving-pdfs-to-disks

Use the disk() method to specify the target filesystem disk before calling save().

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('invoice')
   ->disk('s3')
   ->save('invoice-april-2022.pdf');
```

--------------------------------

### Generate PDF from Blade view

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/creating-pdfs

Basic usage for creating a PDF file from a specified Blade view template.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.invoice')->save('/some/directory/invoice.pdf');
```

--------------------------------

### Render PDF with footer

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/creating-pdfs-with-multiple-pages

Apply a footer view to the PDF generation process to include page numbering.

```php
Pdf::view('view-with-multiple-pages')->footerView('footer-view')->save($path);
```

--------------------------------

### Set Lambda as default PDF generator

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/generating-pdfs-on-aws-lambda

Configure the PDF generator to use Lambda by default, typically within a service provider.

```php
// typically, in a service provider

Pdf::default()->onLambda();
```

--------------------------------

### Render multi-page PDF

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/creating-pdfs-with-multiple-pages

Render a view containing page breaks and save it to a specified path.

```php
Pdf::view('view-with-multiple-pages')->save($path);
```

--------------------------------

### Pdf::assertRespondedWithPdf()

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Asserts that a PDF was generated and returned as a response.

```APIDOC
## Pdf::assertRespondedWithPdf()

### Description
Asserts that a PDF was generated and returned as a download response. Useful for testing controller actions that return a PDF.

### Parameters
- **callback** (callable) - Required - A closure receiving a PdfBuilder instance to perform assertions on the generated PDF.
```

--------------------------------

### Configure Browsershot globally via PdfFactory

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/customizing-browsershot

Bind a custom PdfFactory in your AppServiceProvider to apply specific Browsershot options to all generated PDFs.

```php
use Spatie\LaravelPdf\PdfFactory;

class AppServiceProvider extends ServiceProvider
{
    //...
    /**
     * Bootstrap any application services.
     */
    public function boot(): void
    {
        app()->bind(PdfFactory::class, function ($service, $app) {
            return (new PdfFactory())->withBrowsershot(
                function ($browserShot) {
                    $browserShot->setOption(
                        'args', [
                            '--disable-web-security',
                            '--allow-file-access-from-files',
                        ],
                    );
                }
            );
        });
    }
}
```

--------------------------------

### Assert saved PDF properties

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Verify that a PDF was saved with specific properties or to a specific path using a callback.

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\LaravelPdf\PdfBuilder;

Pdf::assertSaved(function (PdfBuilder $pdf) {
    return $pdf->downloadName === 'invoice.pdf'
        && str_contains($pdf->html, 'Your total for April is $10.00');
});
```

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\LaravelPdf\PdfBuilder;

Pdf::assertSaved(function (PdfBuilder $pdf, string $path) {
    return $path === storage_path('invoices/invoice.pdf');
});
```

--------------------------------

### Generate PDF from Blade view with data

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/creating-pdfs

Passing an array of data to the Blade view during PDF generation.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->save('/some/directory/invoice.pdf');
```

--------------------------------

### Customize Browsershot for a single PDF

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/customizing-browsershot

Use the withBrowsershot method to modify the Browsershot instance for an individual PDF generation task.

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\Browsershot\Browsershot;

Pdf::view('test')
    ->withBrowsershot(function (Browsershot $browsershot) {
        $browsershot->scale(0.5);
    })
    ->save($this->targetPath);
```

--------------------------------

### Configure PDF Paper Format

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Change the default paper format using the format method with the Format enum or a string identifier.

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\LaravelPdf\Enums\Format;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->format(Format::A3) // or you can pass a string like 'a3'
    ->save('/some/directory/invoice-april-2022.pdf');
```

--------------------------------

### Set PDF Page Orientation

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Configure the PDF orientation to landscape using either the landscape method or the Orientation enum.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->landscape()
    ->save('/some/directory/invoice-april-2022.pdf');
```

```php
use Spatie\LaravelPdf\Facades\Pdf;
use \Spatie\LaravelPdf\Enums\Orientation;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->orientation(Orientation::Landscape)
    ->save('/some/directory/invoice-april-2022.pdf');
```

--------------------------------

### Set PDF Page Margins

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Adjust document margins using the margins method, with an optional parameter to specify the unit of measurement.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->margins($top, $right, $bottom, $left)
    ->save('/some/directory/invoice-april-2022.pdf');
```

```php
use Spatie\LaravelPdf\Facades\Pdf;
use Spatie\LaravelPdf\Enums\Unit;

Pdf::view('pdf.invoice', ['invoice' => $invoice])
    ->margins($top, $right, $bottom, $left, Unit::Pixel)
    ->save('/some/directory/invoice-april-2022.pdf');
```

--------------------------------

### Define Custom Paper Size

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Use the paperSize method to define custom dimensions for the PDF document.

```php
use Spatie\LaravelPdf\Facades\Pdf;

Pdf::view('pdf.receipt', ['order' => $order])
    ->paperSize(57, 500, 'mm')
    ->save('/some/directory/receipt-12345.pdf');
```

--------------------------------

### Pdf::assertSaved()

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/testing-pdfs

Asserts that a PDF was saved with specific properties or to a specific path.

```APIDOC
## Pdf::assertSaved()

### Description
Asserts that a PDF was saved. You can pass a callable to inspect the PdfBuilder instance or a string path to verify the save location.

### Parameters
- **callback** (callable) - Optional - A closure receiving a PdfBuilder instance and optionally the path string.
- **path** (string) - Optional - The expected file path where the PDF was saved.
```

--------------------------------

### Add page numbers to PDF footers

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/creating-pdfs-with-multiple-pages

Use @pageNumber and @totalPages directives within a footer view to display dynamic pagination.

```blade

    This is page @pageNumber of @totalPages

```

--------------------------------

### Display Images in Headers and Footers

Source: https://spatie.be/docs/laravel-pdf/v1/basic-usage/formatting-pdfs

Use the @inlinedImage blade directive to include images in your PDF headers or footers. It supports both absolute and relative file paths.

```blade
// using relative path
@php $logo = public_path('assets/logo.png'); @endphp
@inlinedImage($logo)

// using absolute path
@inlinedImage('https://some-url/assets/some-logo.png')
```

--------------------------------

### Implement page breaks in Blade views

Source: https://spatie.be/docs/laravel-pdf/v1/advanced-usage/creating-pdfs-with-multiple-pages

Use the @pageBreak directive within a Blade view to force a new page in the generated PDF.

```blade

    Page 1

@pageBreak

    Page 2

```
Tokens:
Raw