viterbit/liboffice-converter

PHP wrapper over LibreOffice converter

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

This package is auto-updated.

Last update: 2024-10-17 12:23:18 UTC


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