Zobrazte dokument Word na stránce HTML pomocí PHP.

Můžeme snadno vykreslit soubory DOC nebo DOCX na webových stránkách HTML programově v cloudu. To může být užitečné při prohlížení dokumentů aplikace Word v libovolném prohlížeči bez sdílení původních souborů. V tomto článku se naučíme, jak zobrazit dokument aplikace Word na stránce HTML pomocí REST API v PHP.

V tomto článku se budou zabývat následujícími tématy:

Word to HTML Viewer REST API a PHP SDK

Pro vykreslování dokumentů Wordu v HTML budeme používat PHP SDK of GroupDocs.Viewer Cloud API. Umožňuje vykreslování a prohlížení podporované formáty dokumentů a obrazových souborů programově. Nainstalujte jej pomocí následujícího příkazu v konzole:

composer require groupdocscloud/groupdocs-viewer-cloud

Po instalaci použijte autoload skladatelů k použití sady SDK, jak je uvedeno níže:

require_once('vendor/autoload.php');

Před provedením uvedených kroků získejte své ID klienta a tajný klíč z řídicího panelu. Jakmile budete mít své ID a tajemství, přidejte kód, jak je uvedeno níže:

// Tento příklad kódu ukazuje, jak do kódu přidat ID klienta a tajný klíč.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';

static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// Inicializace konfigurace
$configuration = new GroupDocs\Viewer\Configuration();

// Nastavení konfigurací
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);

Zobrazte dokument Word na stránce HTML pomocí REST API v PHP

Obsah dokumentu aplikace Word můžeme zobrazit v HTML pomocí následujících jednoduchých kroků:

  1. Nahrajte soubor DOCX do cloudu
  2. Zobrazit dokument aplikace Word na stránce HTML
  3. Stáhnout vykreslený soubor

Nahrajte dokument

Nejprve nahrajeme soubor DOCX do cloudu pomocí níže uvedeného příkladu kódu:

// Tento příklad kódu ukazuje, jak nahrát soubor DOCX do cloudu.
// Inicializujte rozhraní API
$apiInstance = new GroupDocs\Viewer\FileApi($configuration);

// Vstupní cesta k souboru
$file = "C:\\Files\\Viewer\\input.docx";

// Žádost o nahrání souboru
$request = new GroupDocs\Viewer\Model\Requests\uploadFileRequest("input.docx", $file);

// Nahrát soubor
$response = $apiInstance->uploadFile($request);

V důsledku toho bude nahraný soubor dostupný v sekce souborů řídicího panelu v cloudu.

Zobrazte dokument Word na stránce HTML pomocí PHP

Nyní vykreslíme nebo zobrazíme obsah nahraného dokumentu aplikace Word na stránkách HTML podle následujících kroků:

  1. Nejprve vytvořte instanci ViewAPI.
  2. Dále vytvořte instanci ViewOptions.
  3. Poté zadejte cestu k vstupnímu souboru.
  4. Nastavte také ViewFormat jako „HTML“.
  5. Dále inicializujte objekt HtmlOptions.
  6. Poté nastavte různé vlastnosti, jako je IsResponsive, ForPrinting atd.
  7. Poté vytvořte CreateViewRequest s ViewOptions jako argumentem.
  8. Nakonec vykreslete Word do HTML pomocí metody createView().

Následující ukázka kódu ukazuje, jak zobrazit soubor aplikace Word v HTML pomocí REST API v PHP.

// Tento příklad kódu ukazuje, jak vykreslit DOCX do HTML.
// Inicializujte rozhraní API
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);

// Definujte možnosti zobrazení
$viewOptions = new Model\ViewOptions();

// Vstupní cesta k souboru
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");	
$viewOptions->setFileInfo($fileInfo);

// Nastavte ViewFormat
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);

// Definujte možnosti HTML
$renderOptions = new Model\HtmlOptions();

// Nastavte jej tak, aby byl responzivní
$renderOptions->setIsResponsive(true);

// Sada pro tisk
$renderOptions->setForPrinting(true);

// Přiřadit možnosti vykreslení
$viewOptions->setRenderOptions($renderOptions);

// Vytvořit požadavek na zobrazení
$request = new Requests\CreateViewRequest($viewOptions);

// Vytvořit pohled
$response = $apiInstance->createView($request);

// Hotovo
echo "HtmlViewerResponsiveLayout completed: ", count($response->getPages());
echo "\n";
Zobrazte dokument Word na stránce HTML pomocí REST API v PHP

Zobrazte dokument Word na stránce HTML pomocí REST API v PHP.

Vykreslování Wordu do HTML můžeme přizpůsobit použitím následujících možností:

  • Vykreslit konkrétní rozsah stránek
// Pass specific range of page numbers to render. 
// This will render all pages from starting from page 1 to 3.
$renderOptions->setStartPageNumber(1);
$renderOptions->setCountPagesToRender(3);
  • Vykreslit pouze vybrané stránky
// Pass specific page numbers to render. 
// This will render only page number 1 and 3.
$renderOptions->setPagesToRender([1, 3]);
  • Zobrazte stránky v určitém pořadí
// Pass page numbers in the order you want to render them
$renderOptions->setPagesToRender([2, 1]);
  • Vykreslit dokument s komentáři
$renderOptions->setRenderComments(true);

Stáhnout HTML stránky

Výše uvedená ukázka kódu uloží vykreslené stránky HTML do cloudu. Lze jej stáhnout pomocí následující ukázky kódu:

// Tento příklad kódu ukazuje, jak stáhnout vykreslené stránky HTML z cloudu.
$fileApi = new GroupDocs\Viewer\FileApi($configuration);

// Získejte všechny stránky
$pages = $response->getPages();

// Ukládejte stránky jednu po druhé
foreach ($pages as $page)
{
    // Vytvořit požadavek na stažení souboru
    $downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");

    // Stáhnout soubor
    $file = $fileApi->DownloadFile($downloadFileRequest);
    echo "$page downloaded!";
    echo "\n"; 
}

Vložit dokument aplikace Word do existující stránky HTML

Dokument Word můžeme také vložit do existující stránky HTML podle následujících kroků:

  1. Nejprve vytvořte instance ViewAPI a FileAPI.
  2. Dále vytvořte instanci ViewOptions.
  3. Poté zadejte cestu k vstupnímu souboru.
  4. Nastavte také ViewFormat jako „HTML“.
  5. Dále inicializujte objekt HtmlOptions.
  6. Poté nastavte různé vlastnosti, jako je IsResponsive, ForPrinting atd.
  7. Poté vytvořte CreateViewRequest s ViewOptions jako argumentem.
  8. Poté vykreslete Word do HTML pomocí metody createView().
  9. Dále načtěte existující soubor HTML a získejte prvky značky body
  10. Poté si přečtěte HTML každé stránky a přidejte do značky body
  11. Poté uložte aktualizovaný HTML pomocí metody saveHTML().
  12. Nakonec uložte soubor HTML pomocí metody file\put\contents().

Následující ukázka kódu ukazuje, jak vložit dokument aplikace Word do existující stránky HTML pomocí rozhraní REST API v PHP.

// Tento příklad kódu ukazuje, jak vykreslit DOCX do HTML.
// Inicializujte rozhraní API
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);
$fileApi = new GroupDocs\Viewer\FileApi($configuration);

// Definujte možnosti zobrazení
$viewOptions = new Model\ViewOptions();

// Vstupní cesta k souboru
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");	
$viewOptions->setFileInfo($fileInfo);

// Nastavte ViewFormat
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);

// Definujte možnosti HTML
$renderOptions = new Model\HtmlOptions();

// Nastavte jej tak, aby byl responzivní
$renderOptions->setIsResponsive(true);

// Sada pro tisk
$renderOptions->setForPrinting(true);

// Přiřadit možnosti vykreslení
$viewOptions->setRenderOptions($renderOptions);

// Vytvořit požadavek na zobrazení
$request = new Requests\CreateViewRequest($viewOptions);

// Vytvořit pohled
$response = $apiInstance->createView($request);

// Načtěte existující soubor HTML
$domDoc = new DOMDocument();
$domDoc->loadHTMLFile("C:\Files\Viewer\Sample.html");
$body = $domDoc->GetElementsByTagName('body')->item(0);

// Získejte stránky
$pages = $response->getPages();

// Vložte všechny vykreslené HTML stránky do značky body existujícího HTML
foreach ($pages as $page)
{
    // Vytvořit požadavek na stažení souboru
    $downloadFileRequest = new GroupDocs\Viewer\Model\Requests\DownloadFileRequest($page->getPath(), "");

    // Stáhnout převedenou stránku
    $file = $fileApi->DownloadFile($downloadFileRequest);

    // Přečtěte si HTML ze staženého souboru
    $html = file_get_contents($file->getRealPath());

    //Přidejte obsah do fragmentu
    $fragment = $domDoc->createDocumentFragment();
    $fragment->appendXML("<div>$html</div>");

    // Připojte prvek k tělu
    $body->appendChild($fragment);
}

// Uložit aktualizované HTML
$output = $domDoc->saveHTML();

// Uložte soubor
file_put_contents("C:\Files\Viewer\Sample.html", $output);
Vložit-Word-dokument do-existující-HTML-stránky

Vložení dokumentu aplikace Word do existující stránky HTML.

Zobrazte dokument Word v HTML s vodoznakem pomocí PHP

Při programovém vykreslování dokumentů Word na stránky HTML můžeme přidat text vodoznaku podle následujících kroků:

  1. Nejprve vytvořte instanci ViewAPI.
  2. Dále vytvořte instanci ViewOptions.
  3. Poté zadejte cestu k vstupnímu souboru.
  4. Nastavte také ViewFormat jako „HTML“.
  5. Dále vytvořte a přiřaďte instanci vodoznaku.
  6. Poté nastavte velikost a text vodoznaku.
  7. Poté vytvořte CreateViewRequest s ViewOptions jako argumentem.
  8. Nakonec vyrenderujte Word do HTML pomocí metody createView().

Následující ukázka kódu ukazuje, jak zobrazit dokument aplikace Word v HTML s vodoznakem pomocí REST API v PHP.

// Tento příklad kódu ukazuje, jak vykreslit Word v HTML s vodoznakem.
// Inicializujte rozhraní API
$apiInstance = new GroupDocs\Viewer\ViewApi($configuration);

// Definujte možnosti zobrazení
$viewOptions = new Model\ViewOptions();

// Vstupní cesta k souboru
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("input.docx");				
$viewOptions->setFileInfo($fileInfo);

// Nastavte ViewFormat
$viewOptions->setViewFormat(Model\ViewOptions::VIEW_FORMAT_HTML);

// Definujte vodoznak
$watermark = new Model\Watermark();
$watermark->setText("This is sample text watermark!");
$watermark->setSize(100);
$watermark->setColor("Red");
$viewOptions->setWatermark($watermark);

// Vytvořit požadavek na zobrazení
$request = new Requests\CreateViewRequest($viewOptions);

// Vytvořit pohled
$response = $apiInstance->createView($request);

// Hotovo
echo "AddWatermark completed: ", count($response->getPages());
echo "\n";
Zobrazte dokument Word v HTML s vodoznakem pomocí PHP.

Zobrazte dokument Word v HTML s vodoznakem pomocí PHP.

Vyzkoušejte online

Vyzkoušejte prosím následující bezplatný online vykreslovací nástroj DOCX, který je vyvinut pomocí výše uvedeného API. https://products.groupdocs.app/viewer/docx

Závěr

V tomto článku jsme se naučili, jak:

  • zobrazení dokumentu aplikace Word v prohlížeči podporované webové stránky HTML pomocí PHP;
  • přizpůsobit vykreslování Wordu do HTML;
  • vložit dokument aplikace Word do existující webové stránky HTML;
  • zobrazit obsah souboru aplikace Word v HTML s vodoznakem;
  • programově nahrát soubor DOCX do cloudu;
  • stáhnout vykreslené soubory HTML z cloudu.

Kromě toho se můžete dozvědět více o GroupDocs.Viewer Cloud API pomocí dokumentace. Poskytujeme také sekci API Reference, která vám umožní vizualizovat naše API a pracovat s nimi přímo prostřednictvím prohlížeče. V případě jakýchkoliv nejasností nás neváhejte kontaktovat na fóru.

Viz také