Das Konvertieren von umfangreichen Word‑Dokumenten in web‑bereites HTML ist ein häufiger Bedarf für moderne PHP‑Anwendungen. GroupDocs.Conversion Cloud SDK for PHP bietet eine leistungsstarke API, die die schwere Arbeit in der Cloud übernimmt. In diesem Tutorial demonstrieren wir die Konvertierung von DOCX zu HTML in PHP mithilfe des SDK. Sie lernen, wie Sie die Bibliothek einrichten, ein vollständiges Codebeispiel ausführen und dieselbe Konvertierung mit cURL‑Aufrufen durchführen.

Wie man DOCX in HTML in PHP - Schritt für Schritt

  1. Installieren Sie das SDK über Composer: Fügen Sie die Bibliothek zu Ihrem Projekt mit dem offiziellen Composer‑Befehl hinzu.
composer require groupdocs-conversion-cloud
  1. Initialisieren der Konfiguration: Erstellen Sie ein Configuration‑Objekt und setzen Sie Ihre App‑SID und den App‑Key.
$config = new GroupDocs\Conversion\Cloud\Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');
  1. HTML-Konvertierungsoptionen konfigurieren: Passen Sie Einstellungen wie die Bildextraktion und die Behandlung von Seitenzahlen an.
$htmlOptions = new GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions();
$htmlOptions->setExtractImages(true);
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);
  1. Erstellen Sie Konvertierungseinstellungen: Definieren Sie die Quelldatei, das Zielformat und fügen Sie die HTML-Optionen hinzu.
$convertSettings = new GroupDocs\Conversion\Cloud\Model\ConvertSettings();
$convertSettings->setFilePath('sample.docx');
$convertSettings->setOutputPath('output.html');
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);
  1. Führen Sie die Konvertierung aus: Rufen Sie die Methode convertDocument auf und verarbeiten Sie das Ergebnis.
$convertApi = new GroupDocs\Conversion\Cloud\Api\ConvertApi($config);
try {
    $result = $convertApi->convertDocument($convertSettings);
    echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}

Weitere Details zu jeder Klasse und Methode finden Sie in der API‑Referenz.

Vollständiges Codebeispiel: HTML aus DOCX in PHP generieren

Das folgende Beispiel demonstriert eine vollständige End‑zu‑End‑Konvertierung mit dem SDK.

<?php
require __DIR__ . '/vendor/autoload.php';

use GroupDocs\Conversion\Cloud\Configuration;
use GroupDocs\Conversion\Cloud\Api\ConvertApi;
use GroupDocs\Conversion\Cloud\Model\ConvertSettings;
use GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions;

$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

$convertApi = new ConvertApi($config);

$inputFilePath  = 'sample.docx';
$outputFilePath = 'output.html';

$htmlOptions = new HtmlConvertOptions();
$htmlOptions->setExtractImages(true);               // extract images to separate files
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);                  // generate plain HTML, not a zip archive
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);

$convertSettings = new ConvertSettings();
$convertSettings->setFilePath($inputFilePath);
$convertSettings->setOutputPath($outputFilePath);
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);

try {
    $result = $convertApi->convertDocument($convertSettings);
    echo "Conversion succeeded. HTML file saved to: " . $result->getPath() . PHP_EOL;
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . PHP_EOL;
}

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (sample.docx, output.html) an Ihre tatsächlichen Speicherorte anpassen, überprüfen Sie, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind, und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Konvertieren von DOCX-Dateien zu HTML mit cURL und der REST-API

Das SDK bietet außerdem einen REST‑Endpunkt, der mit cURL aufgerufen werden kann. Nachfolgend ist der typische Arbeitsablauf dargestellt.

  1. Ein Zugriffstoken erhalten
    Ersetzen Sie YOUR_CLIENT_ID und YOUR_CLIENT_SECRET durch Ihre Anmeldeinformationen.

    curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

  2. DOCX-Datei hochladen
    Verwenden Sie das Token aus dem vorherigen Schritt.

    curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/storage/file/sample.docx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.docx"

  3. Start der Konvertierung
    Anfrage zur Konvertierung in HTML.

    curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.docx",
           "outputPath": "output.html",
           "format": "html",
           "options": {
               "extractImages": true,
               "zipOutput": false
           }
         }'

  4. Laden Sie das resultierende HTML herunter

    curl -X GET "https://api.groupdocs.cloud/v2.0/conversion/storage/file/output.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.html

Für eine vollständige Liste der Parameter siehe die offizielle API‑Dokumentation.

Installation und Konfiguration des GroupDocs.Conversion Cloud SDK für PHP

composer require groupdocs-conversion-cloud

Laden Sie das neueste Paket von der Release‑Seite herunter. Das SDK erfordert PHP 7.4 oder höher und ein aktives GroupDocs Cloud‑Konto mit gültigen Anmeldeinformationen.

require __DIR__ . '/vendor/autoload.php';

use GroupDocs\Conversion\Cloud\Configuration;

$config = new Configuration();
$config->setAppSid('YOUR_APP_SID');   // obtain from your GroupDocs Cloud dashboard
$config->setAppKey('YOUR_APP_KEY');

GroupDocs.Conversion Cloud SDK for PHP Funktionen für DOCX zu HTML

  • Bildextraktion - extractImages ermöglicht das Herausziehen eingebetteter Bilder in separate Dateien, wobei die Layouttreue erhalten bleibt.
  • Seitenzahlsteuerung - preserveOriginalPageNumbers kann deaktiviert werden, um einen durchgängigen HTML-Fluss zu erzeugen.
  • Klares HTML-Ausgabe - Das Setzen von zipOutput auf false erzeugt eine einzelne HTML-Datei anstelle eines ZIP Archivs, was die nachgelagerte Verarbeitung vereinfacht.
  • Verarbeitung versteckten Textes - showHiddenText bestimmt, ob versteckter Inhalt im finalen HTML erscheint.
  • Einseitiges Rendering - renderToSinglePage kann alle Seiten zu einem HTML-Dokument zusammenfassen, um das Einbetten zu erleichtern.

Alle Funktionen werden in der Dokumentation beschrieben.

Fazit

Die Konvertierung von DOCX zu HTML in PHP wird mit dem GroupDocs.Conversion Cloud SDK for PHP unkompliziert. Die Bibliothek verarbeitet komplexe Formatierungen, Bildextraktion und Seitenverwaltung, ohne dass Microsoft Office auf dem Server erforderlich ist. Nachdem Sie die oben genannten Schritte befolgt haben, können Sie die DOCX‑zu‑HTML‑Konvertierung in jeden PHP‑basierten Workflow integrieren, egal ob Sie native SDK‑Aufrufe oder REST‑cURL‑Anfragen bevorzugen. Denken Sie daran, für den Produktionseinsatz eine gültige Lizenz zu erwerben; Preisinformationen finden Sie auf der temporäre Lizenzseite. Beginnen Sie noch heute mit der Konvertierung und liefern Sie Ihren Benutzern reichhaltige, web‑fertige Inhalte.

Häufig gestellte Fragen

  • Wie implementiere ich DOCX zu HTML in PHP, ohne zusätzliche Software zu installieren?
    Das cloudbasierte SDK führt die gesamte Verarbeitung auf den GroupDocs-Servern durch, sodass Sie nur die PHP-Bibliothek und Ihre Zugangsdaten benötigen.

  • Kann ich mehrere DOCX-Dateien in einer einzigen Anfrage konvertieren?
    Die API unterstützt die Stapelkonvertierung, indem Sie in Ihrem Code über die Dateien iterieren; jeder Aufruf gibt sein eigenes HTML-Ergebnis zurück.

  • Was passiert mit Bildern innerhalb der DOCX-Datei?
    Mit aktiviertem extractImages werden Bilder als separate Dateien gespeichert und im erzeugten HTML referenziert, sodass Sie sie direkt bereitstellen können.

  • Gibt es eine Möglichkeit, das generierte HTML‑Layout anzupassen?
    Sie können die HTML‑Ausgabe nachbearbeiten oder Konvertierungsoptionen wie renderToSinglePage anpassen, um die Struktur zu beeinflussen.

Weiterlesen