README

A little PHP wrapper around the Xpdf cli tool: pdfinfo.

Fetching the following informations and make them easy accessible:

• Producer
• Creation date
• Modified date
• Tagged
• Form
• Pages
• Encrypted
• Page size
  • Width as points
  • Height as points
  • Format
  • Rotated Degrees
• Box (Media, Crop, Bleed, Trim, Art)
  • X coordinate as points
  • Y coordinate as points
  • Width as points
  • Height as points
• File size
  • Bytes
• Optimized
• PDF version

Note: If you have a password protected pdf file, and not setting the password param, you will get a process failed exception.

Getting Started

PHP 7 or above and Composer is expected to be installed on your system.

Installing

composer require csoellinger/xpdf-cli-pdfinfo 

Usage

<?php use XpdfCliTools\PdfInfo\PdfInfo; use XpdfCliTools\PdfInfo\Model\PdfInfoModel; $pdfInfo = new PdfInfo(); // Optionally set a custom path to pdfinfo binary file: // $pdfInfo = new PdfInfo('<Path-To-Binary>'); /** @var PdfInfoModel $info */ $info = $pdfInfo->exec('<Path-To-Pdf>.pdf'); // If you have a passwort protected pdf file: // $info = $pdfInfo->exec('<Path-To-Pdf>.pdf', 'OwnerPassword'); // $info = $pdfInfo->exec('<Path-To-Pdf>.pdf', null, 'UserPassword'); // Access the pdf informations echo $info->Creator; // Creator echo $info->Producer; // Producer echo $info->CreationDate; // Creation date echo $info->ModDate; // Modification date echo $info->Tagged; // Tagged (true/false) echo $info->Form; // Form(s) echo $info->Pages; // Number of pages echo $info->PageSize->Width; // Page width as points echo $info->PageSize->Height; // Page height as points echo $info->PageSize->Format; // Page format (if found) echo $info->PageSize->RotatedDegrees; // Degrees if rotated echo $info->PageSize->raw; // Raw shell output for page size // Available boxes: MediaBox, CropBox, BleedBox, TrimBox, ArtBox echo $info->MediaBox->X; // X coordinate echo $info->MediaBox->Y; // Y coordinate echo $info->MediaBox->Width; // Box width as points echo $info->MediaBox->Height; // Box height as points echo $info->MediaBox->raw; // Raw shell output for box echo $info->FileSize->Bytes; // File size in bytes echo $info->FileSize->raw; // Raw shell output for file size echo $info->Encrypted; // Encrypted (true/false) echo $info->Optimized; // Optimized (true/false) echo $info->PDFVersion; // Version echo $info->raw; // Raw shell output from pdfinfo // Get page size as millimeter: echo $info->PageSize->Width / PdfInfo::MM_TO_PTS; // = Convert points to millimeter echo $info->PageSize->Height / PdfInfo::MM_TO_PTS; // = Convert points to millimeter

Example

See inside public dir for an example.

Running the Tests

All tests can be run by executing

vendor/bin/phpunit 

phpunit will automatically find all tests inside the tests directory and run them based on the configuration in the phpunit.xml file.

Running the Example

PHP has an in-built server for local development. To run this change into the directory public and run

php -S localhost:8000 

Then open your browser at http://localhost:8000/example.php

Built With

• PHP
• Composer
• PHPUnit
• Xpdf
• getOS
• Symfony Process

ToDo

• Add different encrypted informations: Encrypted: yes (print:yes copy:yes change:yes addNotes:yes)

License

This project is licensed under the MIT License - see the LICENCE.md file for details.