Convert PDFs to JPEG images like a charm!
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is even with guillaumepotier:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


PdfXtractor is a PHP class that relies on GhostScript. This is a handy wrapper that allows PDF conversion to JPEG files.

Build Status


The recommended way to install PdfXtractor is through composer.

Just create a composer.json file for your project:

    "require": {
        "guillaumepotier/PdfXtractor": "*"

And run these two commands to install it:

$ wget
$ php composer.phar install

Now you can add the autoloader, and you will have access to the library:


require 'vendor/autoload.php';

If you don't use neither Composer nor a ClassLoader in your application, just require the provided autoloader:


require_once 'src/autoload.php';

Be sure to give permissions to the GhostScript binary you'll use:

chmod 777 bin/gs-905-osx

You're done!


You'll just need to specify the pdf you want to convert, where you want to dump the .jpg files generated and under which name:


$pdfXtractor = new PdfXtractor\PdfXtractor();
$pdfXtractor->load(__DIR__.'/file.pdf')->set(__DIR__.'/output', 'extract');

Unit Tests

To run unit tests, set your proper phpunit.xml file by doing:

cp phpunit.xml.dist phpunit.xml
vi phpunit.xml

Set the GS_BIN you'll use in your environement. Save and launch then the following command:



Need to better rationalize the GhostScript binary used in function of the user OS. Maybe integrate a shell script to build gs properly for the user os, because the 3 gs bin provided here are a little heavy (~100Mb) and still no better than a proper build.


Guillaume Potier. @guillaumepotier


PdfXtractor is released under the MIT License for the PHP Wrapper. Unfortunately, GhostScript is under GPL license. Which makes this whole project under GPL license. See the bundled LICENSE file for more details.