guillaumepotier/pdfxtractor

Convert PDFs to JPEG images like a charm!

PdfXtractor

PdfXtractor is a PHP class that relies on GhostScript. This is a handy wrapper that allows PDF conversion to JPEG files., _(*1)

, _(*2)

Installation

The recommended way to install PdfXtractor is through composer., _(*3)

Just create a composer.json file for your project:, _(*4)

``` json { "require": { "guillaumepotier/PdfXtractor": "*" } }, <sub>(*5)</sub>

And run these two commands to install it:

``` bash
$ wget http://getcomposer.org/composer.phar
$ php composer.phar install

Now you can add the autoloader, and you will have access to the library:, <sub>(*6)</sub>

``` php <?php, <sub>(*7)</sub>

require 'vendor/autoload.php';, <sub>(*8)</sub>

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

``` php
<?php

require_once 'src/autoload.php';

Be sure to give permissions to the GhostScript binary you'll use:, <sub>(*9)</sub>

chmod 777 bin/gs-905-osx

You're done!, <sub>(*10)</sub>

Usage

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:, <sub>(*11)</sub>

``` php <?php, <sub>(*12)</sub>

$pdfXtractor = new PdfXtractor\PdfXtractor(); $pdfXtractor->load(DIR.'/file.pdf')->set(DIR.'/output', 'extract'); $pdfXtractor->extract();, <sub>(*13)</sub>

Unit Tests
----------

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

cp phpunit.xml.dist phpunit.xml vi phpunit.xml, <sub>(*14)</sub>

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

phpunit ```, <sub>(*15)</sub>

TODO

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., <sub>(*16)</sub>

Credits

Guillaume Potier. @guillaumepotier, <sub>(*17)</sub>

License

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., <sub>(*18)</sub>