Choosing an input

Every input method creates an OfficeDocument containing a snapshot of the accepted source. Later changes to the original path or upload do not change that snapshot.

Local absolute path

use Mattmy\OfficeConverter\Facades\Office;

$document = Office::fromPath(storage_path('app/private/report.docx'));

The path must be absolute and identify a readable, non-symbolic-link regular file. Relative paths, URLs, directories, Storage-relative paths, and Windows UNC paths are not accepted. Your application remains responsible for authorizing which local paths a caller may request.

The final filename extension selects the candidate InputFormat; matching is ASCII case-insensitive. .htm is accepted as HTML and .jpeg as JPEG. File contents are checked before LibreOffice starts.

Raw bytes

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

$document = Office::fromContent($bytes, InputFormat::DOCX);

Always provide an InputFormat; the package does not guess the format from bytes. The complete $bytes string already occupies PHP memory. TXT and CSV content must be UTF-8.

Laravel upload

use Mattmy\OfficeConverter\Facades\Office;

$document = Office::fromUploadedFile($request->file('document'));

The upload must be valid and readable. Its original filename supplies the candidate extension, but neither that extension nor the client MIME type proves the format; the package also validates the content.

Validate request authorization and application-specific upload limits before passing the file to the package.

Format checks

See Supported conversions for all accepted formats and their outputs. TXT and CSV must be UTF-8 regardless of the input method. Legacy DOC, XLS, and PPT are checked only for an OLE container signature; a wrong document family may be rejected later by LibreOffice as ConversionFailed.

One conversion attempt

Call convertTo() once on an OfficeDocument. The first attempt consumes it even when the target is not supported or LibreOffice fails:

use Mattmy\OfficeConverter\Enums\Format;

$result = $document->convertTo(Format::PDF);

Create a new input snapshot before retrying.