viterbit/liboffice-converter

PHP wrapper over LibreOffice converter

v2.0.0 2023-08-17 09:48 UTC

Requires

• php: ^8.1
• psr/log: ^1.0
• symfony/process: ^3.1|^4.1|^5.0|^6.0

Requires (Dev)

• php-parallel-lint/php-var-dump-check: ^0.5.0
• phpstan/phpstan: ^1.4
• phpunit/phpunit: ^8.0
• rector/rector: ^0.17
• squizlabs/php_codesniffer: ^3.3
• symplify/easy-coding-standard: ^10.1

MIT

• excel
• xls
• xlsx
• word
• pdf
• docx
• converter
• LibreOffice

README

Simple way for documents conversion into various formats.

For example: html -> docx, html -> pdf, docx -> html and many more.

Usage

use Viterbit\LibOfficeConverter\Converter;
use Viterbit\LibOfficeConverter\Parameters;
use Viterbit\LibOfficeConverter\Format;

// Create converter
$converter = new Converter();

// Describe parameters for converter
$parameters = (new Parameters())
    // HTML document
    ->setInputFile('test.html')
    // Format of result document is docx
    ->setOutputFormat(Format::TEXT_DOCX)
    // Result file name
    ->setOutputFile('path-to-result-docx.docx');

// Run converter
$converter->convert($parameters);

Requirements

• PHP 7+
• libreoffice-core

Installation

sudo add-apt-repository ppa:libreoffice/ppa
sudo apt-get update
sudo apt-get install default-jdk -y
sudo apt-get install python-software-properties  -y
sudo apt-get install software-properties-common -y
sudo apt-get install libreoffice-core --no-install-recommends
sudo apt-get install libreoffice-writer
composer require viterbit/liboffice-converter

Example of installation libreoffice into docker container:

FROM php:7.2-fpm

WORKDIR /var/www/html

# Install libreoffice headless
RUN apt update -y \
    && mkdir -p /usr/share/man/man1 \
    && apt -y install default-jdk-headless libreoffice-core libreoffice-writer libreoffice-calc
RUN mkdir -p /var/www/.cache/dconf \
    && mkdir -p /var/www/.config/libreoffice \
    && chmod -R ugo+rwx /var/www/.cache \
    && chmod -R ugo+rwx /var/www/.config

Example of installation libreoffice into mac:

brew cask install libreoffice

note: bin located at /usr/local/bin/soffice

Run tests

./vendor/bin/phpunit

Contribute

First install check tools before commit. Node is required.

npm install

License

Released under the MIT license