Jak przekonwertować DOCX na HTML w PHP - krok po kroku

1. Zainstaluj SDK za pomocą Composer: Dodaj bibliotekę do swojego projektu przy użyciu oficjalnego polecenia Composer.

composer require groupdocs-conversion-cloud

2. Zainicjalizuj konfigurację: Utwórz obiekt Configuration i ustaw swój App SID oraz App Key.

$config = new GroupDocs\Conversion\Cloud\Configuration();
$config->setAppSid('YOUR_APP_SID');
$config->setAppKey('YOUR_APP_KEY');

3. Skonfiguruj opcje konwersji HTML: Dostosuj ustawienia, takie jak wyodrębnianie obrazów i obsługa numerów stron.

$htmlOptions = new GroupDocs\Conversion\Cloud\Model\HtmlConvertOptions();
$htmlOptions->setExtractImages(true);
$htmlOptions->setPreserveOriginalPageNumbers(false);
$htmlOptions->setZipOutput(false);
$htmlOptions->setShowHiddenText(false);
$htmlOptions->setRenderToSinglePage(false);

4. Utwórz ustawienia konwersji: Zdefiniuj plik źródłowy, format docelowy i dołącz opcje HTML.

$convertSettings = new GroupDocs\Conversion\Cloud\Model\ConvertSettings();
$convertSettings->setFilePath('sample.docx');
$convertSettings->setOutputPath('output.html');
$convertSettings->setFormat('html');
$convertSettings->setOptions($htmlOptions);

5. Wykonaj konwersję: Wywołaj metodę convertDocument i obsłuż wynik.

$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;
}

Aby uzyskać więcej informacji o każdej klasie i metodzie, odwołaj się do referencji API.

Pełny przykład kodu: Generowanie HTML z DOCX w PHP

Poniższy przykład demonstruje pełną konwersję end‑to‑end przy użyciu 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;
}

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś ścieżki do plików (sample.docx, output.html), aby odpowiadały rzeczywistym lokalizacjom, sprawdź, czy wszystkie wymagane zależności są poprawnie zainstalowane, i dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Konwertowanie plików DOCX do HTML przy użyciu cURL i interfejsu REST API

SDK udostępnia również punkt końcowy REST, który można wywołać za pomocą cURL. Poniżej przedstawiono typowy przepływ pracy.

1. Uzyskaj token dostępu
   Zastąp YOUR_CLIENT_ID i YOUR_CLIENT_SECRET swoimi danymi uwierzytelniającymi.

   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. Prześlij plik DOCX
   Użyj tokenu z poprzedniego kroku.

   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. Rozpocznij konwersję
   Poproś o konwersję do 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. Pobierz wynikowy HTML

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

Aby uzyskać pełną listę parametrów, zobacz oficjalną dokumentację API.

Instalowanie i konfigurowanie GroupDocs.Conversion Cloud SDK dla PHP

composer require groupdocs-conversion-cloud

Pobierz najnowszy pakiet ze strony wydań. SDK wymaga PHP 7.4 lub nowszego oraz aktywnego konta GroupDocs Cloud z prawidłowymi poświadczeniami.

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 Możliwości konwersji DOCX do HTML

• Ekstrakcja obrazów - extractImages pozwala wyodrębnić osadzone obrazy do osobnych plików, zachowując wierność układu.
• Kontrola numeracji stron - preserveOriginalPageNumbers można wyłączyć, aby uzyskać ciągły przepływ HTML.
• Czysty wynik HTML - Ustawienie zipOutput na false generuje pojedynczy plik HTML zamiast archiwum ZIP , upraszczając dalsze przetwarzanie.
• Obsługa ukrytego tekstu - showHiddenText określa, czy ukryta treść pojawia się w ostatecznym HTML.
• Renderowanie jednej strony - renderToSinglePage może połączyć wszystkie strony w jeden dokument HTML, ułatwiając osadzanie.

Wszystkie funkcje są opisane w dokumentacji.

Podsumowanie

Konwertowanie DOCX do HTML w PHP staje się proste dzięki GroupDocs.Conversion Cloud SDK for PHP. Biblioteka obsługuje złożone formatowanie, wyodrębnianie obrazów i zarządzanie stronami bez konieczności instalacji Microsoft Office na serwerze. Po wykonaniu opisanych powyżej kroków możesz zintegrować konwersję DOCX do HTML w dowolnym przepływie pracy opartym na PHP, niezależnie od tego, czy wolisz natywne wywołania SDK, czy żądania RESTful cURL. Pamiętaj, aby uzyskać odpowiednią licencję do użytku produkcyjnego; szczegóły cenowe są dostępne na stronie tymczasowej licencji. Rozpocznij konwersję już dziś i dostarczaj swoim użytkownikom bogatą, gotową do publikacji w sieci treść.

FAQs

• Jak zaimplementować konwersję DOCX do HTML w PHP bez instalowania dodatkowego oprogramowania?
  SDK działające w chmurze wykonuje wszystkie operacje na serwerach GroupDocs, więc potrzebujesz tylko biblioteki PHP i swoich danych uwierzytelniających.

• Czy mogę konwertować wiele plików DOCX w jednym żądaniu?
  API obsługuje konwersję wsadową poprzez iterację po plikach w kodzie; każde wywołanie zwraca własny wynik HTML.

• Co się dzieje z obrazami wewnątrz pliku DOCX?
  Z włączonym extractImages obrazy są zapisywane jako osobne pliki i odwoływane w wygenerowanym HTML, co pozwala serwować je bezpośrednio.

• Czy istnieje sposób na dostosowanie wygenerowanego układu HTML?
  Możesz przetworzyć wynikowy HTML w fazie post‑processingu lub dostosować opcje konwersji, takie jak renderToSinglePage, aby wpłynąć na strukturę.

Czytaj więcej

• Kompletny samouczek konwersji JSON do HTML w PHP
• Szczegółowy samouczek konwersji HTML do XLSX w PHP
• Szczegółowy samouczek konwersji HTML do DOCX w Node.JS