Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/pontedilana/php-weasyprint

PHP library allowing PDF generation or snapshot from an URL or an HTML page. Wrapper for Kozea/WeasyPrint
https://github.com/pontedilana/php-weasyprint

pdf php weasyprint

Last synced: 13 days ago
JSON representation

PHP library allowing PDF generation or snapshot from an URL or an HTML page. Wrapper for Kozea/WeasyPrint

Host: GitHub
URL: https://github.com/pontedilana/php-weasyprint
Owner: pontedilana
License: mit
Created: 2021-07-15T07:20:19.000Z (almost 3 years ago)
Default Branch: develop
Last Pushed: 2024-05-21T15:01:53.000Z (about 1 month ago)
Last Synced: 2024-05-29T10:19:30.545Z (26 days ago)
Topics: pdf, php, weasyprint
Language: PHP
Homepage:
Size: 109 KB
Stars: 50
Watchers: 5
Forks: 11
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Lists

awesome-stars - php-weasyprint

README

        # PhpWeasyPrint

PhpWeasyPrint is a PHP library allowing PDF generation from a URL or an HTML page.

It's a wrapper for [WeasyPrint](https://weasyprint.org/), a smart solution helping web developers to create PDF documents, available everywhere Python runs.

You will have to download and install WeasyPrint to use PhpWeasyPrint (version 56 or greater is recommended).

This library is massively inspired by [KnpLabs/snappy](https://github.com/KnpLabs/snappy), of which it aims to be a one-to-one substitute (`GeneratorInterface` is the same).

See "[Differences with Snappy](#differences-with-snappy)" section to see how the two differs

## Installation using [Composer](https://getcomposer.org/)

```bash

$ composer require pontedilana/php-weasyprint

```

## Usage

### Initialization

```php

setBinary('/usr/local/bin/weasyprint');

```

### Display the pdf in the browser

```php

$pdf = new Pdf('/usr/local/bin/weasyprint');

header('Content-Type: application/pdf');

echo $pdf->getOutput('https://www.github.com');

```

### Download the pdf from the browser

```php

$pdf = new Pdf('/usr/local/bin/weasyprint');

header('Content-Type: application/pdf');

header('Content-Disposition: attachment; filename="file.pdf"');

echo $pdf->getOutput('https://www.github.com');

```

### Generate local pdf file

```php

$pdf = new Pdf('/usr/local/bin/weasyprint');

$pdf->generateFromHtml('
Bill
You owe me money, dude.', '/tmp/bill-123.pdf');

```

### Pass options to PhpWeasyPrint

```php

// Type weasyprint -h to see the list of options

$pdf = new Pdf('/usr/local/bin/weasyprint');

$pdf->setOption('encoding', 'utf8');

$pdf->setOption('media-type', 'screen');

$pdf->setOption('presentational-hints');

$pdf->setOption('optimize-size', 'all');

$pdf->setOption('stylesheet', ['/path/to/first-style.css', '/path/to/second-style.css']);

$pdf->setOption('attachment', ['/path/to/image.png', '/path/to/logo.jpg']);

```

### Reset options

Options can be reset to their initial values with `resetOptions()` method.

```php

$pdf = new Pdf('/usr/local/bin/weasyprint');

// Set some options

$pdf->setOption('media-type', 'screen');

// ..

// Reset options

$pdf->resetOptions();

```

## Differences with Snappy

Although PhpWeasyPrint and Snappy are interchangeable, there are a couple of differences between the two, due to WeasyPrint cli API:

* WeasyPrint doesn't support multiple sources to be merged in one single output pdf, so only one input source (string or URL) is accepted in PhpWeasyPrint;

* WeasyPrint version >= 53 doesn't generate images, so image generation from HTML string or URL is possible only with WeasyPrint lower versions and an unsupported PhpWeasyPrint version (`Pontedilana\PhpWeasyPrint\Image` has been successfully tested with Weasyprint 52.5 on PhpWeasyPrint 0.13.0).

## Bugs & Support

If you found a bug please fill a [detailed issue](https://github.com/pontedilana/php-weasyprint/issues) with all the following points.

If you need some help, please at least provide a complete reproducer, so we could help you based on facts rather than assumptions.

* OS and its version

* WeasyPrint, its version and how you installed it

* A complete reproducer with relevant PHP and html/css/js code

If your reproducer is big, please try to shrink it. It will help everyone to narrow the bug.

## Credits

PhpWeasyPrint has been originally developed by the [Pontedilana](https://www.pontedilana.it) dev team.  

Snappy has been originally developed by the [KnpLabs](https://knplabs.com) team.