Upravujte dokumenty pomocí REST API v PHP.

Můžeme přidávat, upravovat nebo mazat obsah existujících dokumentů Wordu, tabulek Excelu nebo textových souborů programově v cloudu. Můžeme také použít formátování textu v dokumentech pomocí PHP bez instalace jakékoli externí aplikace. V tomto článku se naučíme upravovat dokumenty pomocí REST API v PHP.

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

Editor dokumentů REST API a PHP SDK

K úpravě souborů DOCX, XLSX a TXT budeme používat PHP SDK of GroupDocs.Editor Cloud API. Umožňuje editaci dokumentů podporovaných formátů. Nainstalujte jej pomocí následujícího příkazu v konzole:

composer require groupdocscloud/groupdocs-editor-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 přidat ID klienta a tajný klíč do kódu.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';
static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// inicializace konfigurace
$configuration = new GroupDocs\Editor\Configuration();

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

Upravujte dokumenty Word pomocí REST API v PHP

Dokumenty aplikace Word můžeme upravovat podle jednoduchých kroků uvedených níže:

  1. Nahrajte soubor DOCX do cloudu
  2. Upravit nahraný dokument aplikace Word
  3. Stáhnout upravený 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\Editor\FileApi($configuration);

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

// Žádost o nahrání souboru
$request = new GroupDocs\Editor\Model\Requests\uploadFileRequest("sample.docx", $file, self::$MyStorage, null);

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

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

Upravit dokument Word v PHP

Nyní upravíme obsah nahraného souboru DOCX podle následujících kroků:

  • Nejprve vytvořte instance FileApi a EditApi.
  • Dále zadejte cestu k nahranému souboru DOCX.
  • Poté stáhněte soubor jako dokument HTML.
  • Dále načtěte stažený soubor HTML jako řetězec.
  • Potom upravte HTML a uložte aktualizovaný HTML dokument.
  • Poté nahrajte aktualizovaný soubor HTML.
  • Nakonec uložte HTML zpět do DOCX pomocí metody EditApi.save().

Následující ukázka kódu ukazuje, jak upravit dokument aplikace Word pomocí rozhraní REST API v PHP.

// Tento příklad kódu ukazuje, jak upravit dokument aplikace Word
// Vytvořte potřebné instance API
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// Načtěte nahraný soubor DOCX do upravitelného stavu
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.docx");

// Nastavte heslo, pokud je chráněno heslem
// $fileInfo->setPassword("heslo");

// Definujte možnosti zatížení
$loadOptions = new Model\WordProcessingLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// Stáhnout HTML dokument
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// Upravit text
$html = str_replace("Title of the document", "Welcome", $html);
$html = str_replace("Subtitle #1", "This is Subtitle", $html);

// Nahrajte HTML zpět do úložiště
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// Uložit HTML zpět do DOCX
$saveOptions = new Model\WordProcessingSaveOptions();
$saveOptions->setFileInfo($fileInfo);
$saveOptions->setOutputPath("edited.docx");
$saveOptions->setHtmlPath($loadResult->getHtmlPath());
$saveOptions->setResourcesPath($loadResult->getResourcesPath());
$saveResult = $editApi->save(new Requests\saveRequest($saveOptions));

// Hotovo.
echo "Document edited: " . $saveResult->getPath();
Upravujte dokumenty Word pomocí REST API v PHP.

Upravte dokument Word pomocí REST API v PHP.

Stáhněte si aktualizovaný soubor

Výše uvedená ukázka kódu uloží upravený soubor aplikace Word (DOCX) do cloudu. Lze jej stáhnout pomocí následující ukázky kódu:

// Tento příklad kódu ukazuje, jak stáhnout soubor DOCX z cloudu.
// Inicializujte rozhraní API
$apiInstance = new GroupDocs\Editor\FileApi($configuration);

// Žádost o stažení souboru
$request = new GroupDocs\Editor\Model\Requests\DownloadFileRequest("edited.docx", self::$MyStorage, null);

// Stáhnout soubor
$response = $apiInstance->downloadFile($request);

Upravte tabulky Excel pomocí REST API v PHP

Obsah listu aplikace Excel můžeme upravit podle výše uvedených kroků. Potřebujeme však poskytnout pouze cestu k nahranému souboru XLSX.

Následující ukázka kódu ukazuje, jak upravit data listu aplikace Excel pomocí rozhraní REST API v PHP.

// Tento příklad kódu ukazuje, jak upravit list aplikace Excel
// Vytvořte potřebné instance API
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// Načtěte nahraný soubor XLSX do upravitelného stavu
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.xlsx"); 

// Definujte možnosti zatížení
$loadOptions = new Model\SpreadsheetLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadOptions->setWorksheetIndex(0);
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// Stáhnout HTML dokument
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// Upravit něco...
$html = str_replace("Region", "Country", $html);
$html = str_replace("Europe", "France", $html);
$html = str_replace("Asia", "China", $html);
$html = str_replace("South America", "Argentina", $html);

// Nahrajte HTML zpět do úložiště
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// Uložit HTML zpět do XLSX
$saveOptions = new Model\SpreadsheetSaveOptions();
$saveOptions->setFileInfo($fileInfo);
$saveOptions->setOutputPath("edited.xlsx");
$saveOptions->setHtmlPath($loadResult->getHtmlPath());
$saveOptions->setResourcesPath($loadResult->getResourcesPath());
$saveResult = $editApi->save(new Requests\saveRequest($saveOptions));

// Hotovo.
echo "Document edited: " . $saveResult->getPath();
Upravte tabulky Excel pomocí REST API v PHP.

Upravte tabulku Excel pomocí REST API v PHP.

Aktualizujte textové soubory pomocí REST API v PHP

Podle výše uvedených kroků můžeme také aktualizovat obsah textového souboru. Potřebujeme však poskytnout pouze cestu k nahranému souboru TXT.

Následující ukázka kódu ukazuje, jak upravit textový soubor pomocí REST API v PHP.

// Tento příklad kódu ukazuje, jak upravit textový soubor
// Vytvořte potřebné instance API
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// Načtěte nahraný soubor TXT do upravitelného stavu
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.txt");        
$loadOptions = new Model\TextLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// Stáhnout HTML dokument
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// Upravit text
$html = str_replace("Title of the document", "Welcome", $html);
$html = str_replace("Subtitle #1", "This is Subtitle", $html);

// Nahrajte HTML zpět do úložiště
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// Uložit HTML zpět do TXT
$saveOptions = new Model\TextSaveOptions();
$saveOptions->setFileInfo($fileInfo);
$saveOptions->setOutputPath("edited.txt");
$saveOptions->setHtmlPath($loadResult->getHtmlPath());
$saveOptions->setResourcesPath($loadResult->getResourcesPath());
$saveResult = $editApi->save(new Requests\saveRequest($saveOptions));

// Hotovo.
echo "Document edited: " . $saveResult->getPath();
Aktualizujte textové soubory pomocí REST API v PHP.

Aktualizujte textový soubor pomocí REST API v PHP.

Vyzkoušejte online

Vyzkoušejte prosím následující bezplatné online nástroje pro úpravu dokumentů, které jsou vyvinuty pomocí výše uvedeného API.

Závěr

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

  • upravovat nebo upravovat obsah souborů Word, Excel nebo Text v PHP;
  • nahrát soubor DOCX do cloudu;
  • stáhnout aktualizovaný soubor aplikace Word z cloudu.

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

Viz také