fabianogaldino/pdf-version-converter

PHP library for converting the version of PDF files (for compatibility purposes).

dev-master 2025-07-24 06:37 UTC

Requires

• php: ^7.2.5 || ^8.0
• symfony/filesystem: ^5.0
• symfony/process: ^5.4

Requires (Dev)

• phpspec/prophecy-phpunit: ^2.0
• phpunit/phpunit: ^9.0

MIT

• Thiago Rodrigues

• pdf
• converter
• version converter
• pdf version converter
• pdf version

README

PHP library for converting the version of PDF files (for compatibility purposes).

Requirements

• PHP 7.2+
• Ghostscript (gs command on Linux)

Installation

The package can be installed via composer:

composer require fabianogaldino/pdf-version-converter

Usage

Using simplified class PdfVersionConvert:

$contentConverted = (new \FabianoGaldino\PDFVersionConverter\PdfVersionConverter)->convertTo14(file_get_contents($filename));

$version = (new \FabianoGaldino\PDFVersionConverter\PdfVersionConverter)->guess(file_get_contents($filename));

Guessing a version of PDF File:

<?php

// import the composer autoloader
require_once __DIR__.'/vendor/autoload.php'; 

// import the namespaces
use FabianoGaldino\PDFVersionConverter\Guesser\RegexGuesser;
// [..]

$guesser = new RegexGuesser();
echo $guesser->guess('/path/to/my/file.pdf'); // will print something like '1.4'

Converting file to a new PDF version:

<?php

// import the composer autoloader
require_once __DIR__.'/vendor/autoload.php'; 

// import the namespaces
use Symfony\Component\Filesystem\Filesystem,
    FabianoGaldino\PDFVersionConverter\Converter\GhostscriptConverterCommand,
    FabianoGaldino\PDFVersionConverter\Converter\GhostscriptConverter;

// [..]

$command = new GhostscriptConverterCommand();
$filesystem = new Filesystem();

$converter = new GhostscriptConverter($command, $filesystem);
$converter->convert('/path/to/my/file.pdf', '1.4');

Contributing

Is really simple add new implementation of guesser or converter, just implement GuessInterface or ConverterInterface.

Running unit tests

Run phpunit -c tests.