php-unoconv/php-unoconv

Unoconv PHP, an Object Oriented library for easy file conversion with LibreOffice's unoconv

Monday, April 23, 2018
by romain
Repository
7 Watchers
42 Stars
120,994 Installations

PHP
2 Dependents
0 Suggesters
14 Forks
3 Open issues
7 Versions
4 % Grown

The README.md

PHP Unoconv

, _(*1)

An Object Oriented library which allow easy to use file conversion with Unoconv., _(*2)

Install

The recommended way to install PHP-Unoconv is through composer., _(*3)

{
    "require": {
        "php-unoconv/php-unoconv": "~0.2"
    }
}

Documentation

Documentation available at http://php-unoconv.readthedocs.org/, _(*4)

API Usage

To instantiate Unoconv driver, the easiest way is :, _(*5)

$unoconv = Unoconv\Unoconv::create();

You can customize your driver by passing a Psr\Log\LoggerInterface or configuration options., _(*6)

Available options are :, _(*7)

timeout : the timeout for the underlying process.
unoconv.binaries : the path (or an array of paths) for a custom binary.

$unoconv = Unoconv\Unoconv::create(array(
    'timeout'          => 42,
    'unoconv.binaries' => '/opt/local/unoconv/bin/unoconv',
), $logger);

To transcode a file, use the transcode method. For the complete format list supported by unoconv, refer to the unoconv CLI., _(*8)

$unoconv->transcode('document.docx', 'pdf', 'document.pdf');

You can optionaly transcode a given page range using the fourth argument :, _(*9)

// pages 1 to 14
$unoconv->transcode('document.docx', 'pdf', 'document.pdf', '1-14');

Silex Service Provider

A Silex Service Provider is available, all parameters are optionals :, _(*10)

$app = new Silex\Application();
$app->register(new Unoconv\UnoconvServiceProvider(), array(
    'unoconv.configuration' => array(
        'unoconv.binaries' => '/opt/local/unoconv/bin/unoconv',
        'timeout'          => 42,
    ),
    'unoconv.logger'  => $app->share(function () {
        return $app['monolog']; // use Monolog service provider
    }),
));