README

Ein Laravel-Package zur Integration mit der PDF REST API. Konvertieren Sie Dokumente verschiedenster Formate einfach in PDF-Dateien.

Installation

Sie können das Package via Composer installieren:

composer require hwkdo/pdf-rest-laravel

Konfiguration

Sie können die Konfigurationsdatei veröffentlichen mit:

php artisan vendor:publish --tag="pdf-rest-laravel-config"

Inhalt der Konfigurationsdatei:

return [
    'api_key' => env('PDF_REST_API_KEY'),
    'api_url' => env('PDF_REST_API_URL', 'https://eu-api.pdfrest.com/'),
];

Fügen Sie Ihren API-Key zu Ihrer .env Datei hinzu:

PDF_REST_API_KEY=your-api-key-here
PDF_REST_API_URL=https://eu-api.pdfrest.com/

Verwendung

Datei zu PDF konvertieren und URL erhalten

Konvertieren Sie eine Datei zu PDF und erhalten Sie die URL der konvertierten Datei:

use Hwkdo\PdfRestLaravel\Facades\PdfRestLaravel;

$url = PdfRestLaravel::convertToPdf('/path/to/document.docx');
// Gibt zurück: "https://eu-api.pdfrest.com/output/abc123.pdf"

Datei zu PDF konvertieren und lokal speichern

Im gleichen Verzeichnis wie die Originaldatei speichern

use Hwkdo\PdfRestLaravel\Facades\PdfRestLaravel;

$path = PdfRestLaravel::convertToPdfAndSave('/path/to/document.docx');
// Gibt zurück: "/path/to/document.pdf"

An einem benutzerdefinierten Ort speichern

use Hwkdo\PdfRestLaravel\Facades\PdfRestLaravel;

$path = PdfRestLaravel::convertToPdfAndSave(
    '/path/to/document.docx',
    '/custom/output/myfile.pdf'
);
// Gibt zurück: "/custom/output/myfile.pdf"

Fehlerbehandlung

Beide Methoden werfen Exceptions bei Fehlern:

use Hwkdo\PdfRestLaravel\Facades\PdfRestLaravel;
use InvalidArgumentException;
use RuntimeException;

try {
    $path = PdfRestLaravel::convertToPdfAndSave('/path/to/document.docx');
    echo "PDF erfolgreich gespeichert: {$path}";
} catch (InvalidArgumentException $e) {
    // Datei existiert nicht
    echo "Fehler: {$e->getMessage()}";
} catch (RuntimeException $e) {
    // API-Fehler oder Download-Fehler
    echo "Fehler: {$e->getMessage()}";
}

Unterstützte Dateiformate

Die PDF REST API unterstützt viele Dokumentformate, darunter:

• Microsoft Office: .docx, .doc, .xlsx, .xls, .pptx, .ppt
• Bilder: .jpg, .jpeg, .png, .gif, .bmp, .tiff
• Andere: .html, .txt, und viele weitere

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• hwkdo
• All Contributors

License

The MIT License (MIT). Please see License File for more information.