---
type: WebPage
title: Snappy and laravel-snappy without wkhtmltopdf | Marqius
description: KnpLabs Snappy and laravel-snappy run the wkhtmltopdf program.
  Point them to Marqius, keep your views, and compare the output on a real PDF.
resource: https://marqius.com/wkhtmltopdf/laravel-php/
tags:
  - marqius
  - products-and-guides
status: stable
sources:
  - id: official-page
    resource: https://marqius.com/wkhtmltopdf/laravel-php/
generated:
  by: process:marqius-site-build
  at: 2026-11-20T10:17:10.036Z
x_marqius:
  language: en
  source_sha256: 9d0071a24835dfcc2e7806ad7af376a4af42e02014c27a9febc5b8b8e74a176d
  extraction: public-main-content
---

PHP · LARAVEL · SNAPPY

# Keep Snappy.  
_Replace wkhtmltopdf._

Snappy and laravel-snappy hand HTML to a wkhtmltopdf executable. Set its path to Marqius and keep your Blade views and PDF calls.

```
curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash
```

[Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf)

wkhtmltopdf (current) Marqius (Snappy)

**A simple, drop-in migration** Keep your PHP & Laravel workflow Install in minutes Compare your own PDFs

1

### Install

Install the compatible program alongside your current wkhtmltopdf.

```
curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash
```

2

### Laravel configuration

Set the two binary paths in the environment used by config/snappy.php.

```
WKHTML_PDF_BINARY=/usr/local/bin/wkhtmltopdf
WKHTML_IMG_BINARY=/usr/local/bin/wkhtmltoimage
```

3

### Compare output

Render a representative document and check the PDF before switching production.

```
marqius wkhtmltopdf invoice.html new.pdf
marqius compare old.pdf new.pdf
```

**Switching manual**

Examples and troubleshooting for PHP & Laravel and related stacks.

[Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples)

[Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial)

PRACTICAL DETAILS

## What to check before you switch.

### Symfony and plain PHP

```
use Knp\Snappy\Pdf;
$snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
$snappy->generateFromHtml($html, '/tmp/invoice.pdf', ['page-size' => 'A4']);
```

### Compare your output

Keep a known invoice or report PDF. Generate it with Marqius, then compare it before moving the server path.

Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides.

QUESTIONS & ANSWERS

## PHP & Laravel questions

### Do my Blade views change?

No when Snappy runs a wkhtmltopdf executable. Keep your views and PDF calls, then point the binary setting to the installed program.

### Do header and footer views still work?

Test your existing header and footer HTML with the familiar command options and inspect the rendered pages before rollout.

### What if Snappy reports exit code 1?

Read the converter output for the missing input, asset or other specific error. Reproduce it with one HTML document before changing a production worker.

### What about Browsershot or spatie/laravel-pdf?

Those can use a browser-based rendering path rather than the wkhtmltopdf executable. Check the package integration before replacing a binary.

Source for this page [^official-page].

[^official-page]: https://marqius.com/wkhtmltopdf/laravel-php/

[Browse this section](index.md) · [Knowledge index](../index.md)
