Getting started

Laravel Office Converter is powered by LibreOffice and converts supported documents, spreadsheets, presentations, drawings, and images. Start from a local file, raw content, or a Laravel upload, then retrieve the converted file or save it with Laravel Storage.

Requirements

Requirement	Supported versions or setup
PHP	8.2 or later in the PHP 8.x series, with DOM and ZIP
Laravel	12 with PHP 8.2+; 13 with PHP 8.3+
Operating system	Windows, Linux, or macOS
External command	LibreOffice installed on PATH or configured with LIBREOFFICE_BINARY

LibreOffice is installed separately. Compatibility is determined by whether its command and filters complete the requested conversion; the package does not require or inspect a numeric LibreOffice version.

Install the package

Install the package with Composer:

composer require mattmy/laravel-office-converter

Install LibreOffice

Use the commands below or download an installer from the LibreOffice website.

macOS

Install the Homebrew LibreOffice cask:

brew install --cask libreoffice

Without Homebrew, download the Apple Silicon or Intel .dmg from the LibreOffice website and move LibreOffice to Applications as described in the official instructions.

Ubuntu and Debian

Install the distribution package:

sudo apt update
sudo apt install libreoffice

RHEL and Fedora

Install from an enabled distribution repository when available:

sudo dnf install libreoffice

RHEL package availability depends on the release and enabled repositories. If unavailable, install the .rpm packages using the official instructions.

Windows

Download the Windows installer from the LibreOffice website and complete its installation wizard. The usual console executable location is:

C:\Program Files\LibreOffice\program\soffice.com

If it is not on PATH, set LIBREOFFICE_BINARY to that path in your Laravel environment.

Configuration

The package uses soffice.com on Windows and soffice elsewhere. If it is not on PATH, set its path in .env; publishing the config is not required:

LIBREOFFICE_BINARY=/usr/bin/soffice

See Configuration to change timeouts, size limits, or temporary storage.

Quick start

This example receives a valid Laravel upload, converts it to PDF, and streams it to the default Storage disk:

use Mattmy\OfficeConverter\Enums\Format;
use Mattmy\OfficeConverter\Facades\Office;

$path = Office::fromUploadedFile($request->file('document'))
    ->convertTo(Format::PDF)
    ->storeAs('converted-documents', 'report.pdf');

$path is the stored path or false when the selected Storage driver reports failure. The source document and converted result are one-time objects: a failed conversion or delivery must be started again.

Next steps

• Choose an input source.
• Check every supported input-to-output conversion.
• Read bytes or store the result.
• Handle errors.