sgh/pdfbox

PHP5 wrapper for the Apache PdfBox ExtractText utility.

v1.0.0 2015-06-25 06:10 UTC

This package is not auto-updated.

Last update: 2024-11-07 16:47:10 UTC


README

A PHP interface for the PdfBox ExtractText utility, useful to unit-test contents of generated PDFs.

Build Status Latest Stable Version Latest Unstable Version Total Downloads License

Requirements

  • PHP >=5.3 or HHVM
  • Java Runtime Environment
  • PdfBox JAR file
  • PHP needs permissions for shell execution

Install

To install with composer:

composer require sgh/pdfbox

Basic Usage

use SGH\PdfBox\PdfBox;

//$pdf = GENERATED_PDF;
$converter = new PdfBox;
$converter->setPathToPdfBox('/usr/bin/pdfbox-app-1.7.0.jar');
$text = $converter->textFromPdfStream($pdf);
$html = $converter->htmlFromPdfStream($pdf);
$dom  = $converter->domFromPdfStream($pdf);

If the source PDF is a file, use xxxFromPdfFile() instead xxxFromPdfStream() with the source path as parameter.

If you want to save the converted output to a file, specify the destination path as second parameter of the xxxFromPdfxxx() methods.

Advanced Usage

Convert a range of pages instead of the full document:

$converter->getOptions()
    ->setStartPage(2)
	->setEndPage(5);

Ignore corrupt objects in the PDF:

$converter->getOptions()
    ->setForce(true);

Sort text:

$converter->getOptions()
    ->setSort(true);

PHPUnit tests

To run the unit tests, change the environment variable PDFBOX_JAR to the full path of your PdfBox JAR file. See phpunit.xml.dist.