Konwertowanie bogatych dokumentów Word na gotowy do sieci HTML jest częstą potrzebą współczesnych aplikacji PHP. GroupDocs.Conversion Cloud SDK for PHP zapewnia potężne API, które zajmuje się ciężką pracą w chmurze. W tym samouczku demonstrujemy konwersję DOCX do HTML w PHP przy użyciu SDK. Dowiesz się, jak skonfigurować bibliotekę, uruchomić kompletny przykład kodu oraz wykonać tę samą konwersję przy użyciu wywołań cURL.

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
  1. 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');
  1. 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);
  1. 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);
  1. 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