ordinary9843/ghostscript

Use Ghostscript to merge / split all PDF files or guess and convert PDF file version, and transform PDF into images. Fix FPDI error by Ghostscript: This document PDF probably uses a compression technique which is not supported by the free parser shipped with FPDI.

v2.2.4 2024-07-31 16:03 UTC

This package is auto-updated.

Last update: 2024-10-01 00:08:08 UTC


README

build codecov

If there are any features you desire, please open an issue, and I will do our best to meet your requirements!

Intro

Use Ghostscript to merge / split all PDF files or guess and convert PDF file version, and transform PDF into images. Fix FPDI error by Ghostscript: This document PDF probably uses a compression technique which is not supported by the free parser shipped with FPDI.

Cores

This library has the following features:

  • Full-featured: This library supports PDF version prediction, conversion, merger, and splitting.
  • Lower dependency on external libraries: Most Ghostscript libraries have too high a dependency on other libraries.
  • Compatible with multiple PHP versions: It can run properly on PHP 7.1 - 8.x.

Requirements

This library has the following requirements:

  • Ghostscript 9.50+

Installation

Install Ghostscript:

apt-get install ghostscript

Install ordinary9843/ghostscript:

composer require ordinary9843/ghostscript

Usage

Example usage:

<?php
require './vendor/autoload.php';

use Ordinary9843\Ghostscript;
use Ordinary9843\Constants\GhostscriptConstant;
use Ordinary9843\Constants\ImageTypeConstant;

$file = './files/gs_ -test/test.pdf';
$binPath = '/usr/bin/gs';
$tmpPath = sys_get_temp_dir();
$ghostscript = new Ghostscript($binPath, $tmpPath);

/**
 * This function sets the path for the Ghostscript binary, which will be used for PDF processing.
 */
$ghostscript->setBinPath($binPath);

/**
 * This function sets the path for storing temporary files created during the PDF processing in Ghostscript.
 */
$ghostscript->setTmpPath($tmpPath);

/**
 * This function analyzes the input PDF file and returns the guessed PDF version.
 *
 * Output: 1.5
 */
$ghostscript->guess($file);

/**
 * This function converts the version of the input PDF file to the specified PDF version.
 *
 * Output: './files/convert/test.pdf'
 */
$ghostscript->convert($file, GhostscriptConstant::STABLE_VERSION);

/**
 * This function merges multiple PDF files into a single PDF file.
 *
 * Output: './files/merge/res.pdf'
 */
$ghostscript->merge('./files/merge', 'res.pdf', [
    './files/merge/part_1.pdf',
    './files/merge/part_2.pdf',
    './files/merge/part_3.pdf'
]);

/**
 * This function splits a PDF file into individual pages, each saved as a separate PDF file.
 *
 * Output: [
 *   './files/split/parts/part_1.pdf',
 *   './files/split/parts/part_2.pdf',
 *   './files/split/parts/part_3.pdf'
 * ]
 */
$ghostscript->split('./files/split/test.pdf', './files/split/parts');

/**
 * This function converts each page of a PDF file into individual image files.
 *
 * Output: [
 *   './files/to-image/images/image_1.pdf',
 *   './files/to-image/images/image_2.pdf',
 *   './files/to-image/images/image_3.pdf'
 * ]
 */
$ghostscript->toImage('./files/to-image/test.pdf', './files/to-image/images', ImageTypeConstant::JPEG);

/**
 * This function calculates and returns the total number of pages in a PDF file.
 *
 * Output: 3
 */
$ghostscript->getTotalPages('./files/get-total-pages/test.pdf');

/**
 * Clear temporary files generated during the PDF processing.
 */
$ghostscript->clearTmpFiles();

Testing

Copy the .env.example to .env:

cp .env.example .env

Run the tests:

composer test

Licenses

(The MIT License)