karkowg/php-mupdf

Minimal PDF to image converter using MuPDF

Fund package maintenance!
karkowg

v3.0.0-rc23 2024-11-11 05:10 UTC

README

Package banner

php-mupdf

Minimal PDF to image converter using MuPDF. Heavily inspired by spatie/image-to-pdf.

Latest Version on Packagist GitHub Tests Action Status License Total Downloads

Install

Via Composer

$ composer require karkowg/php-mupdf

Usage

Convert all the pages to jpg

$pdf = new Karkow\MuPdf\Pdf('path/to/pdf/file');

$pdf->saveAllPagesAsImages('./images/', 'page-');

Convert a single page to png

$pdf = new Karkow\MuPdf\Pdf('path/to/pdf/file');

$pdf
    ->setPage(2)
    ->setOutputFormat('png')
    ->saveImage('./images/page-2.png');

Please refer to tests/PdfTest.php for other use cases.

mutool

A compiled binary (v1.20.0) is available at bin/mutool. If for any reason you want/need to use your own installation, you can do so by passing its path as a 2nd argument to the constructor.

$pdf = new Karkow\MuPdf\Pdf('path/to/pdf/file', 'path/to/mutool');

Change log

Please see CHANGELOG for more information on what has changed recently.

Testing

$ composer test

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please email karkowg@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.