Edit Dokumen menggunakan REST API di PHP.

Kita dapat menambah, mengedit, atau menghapus konten dokumen Word, spreadsheet Excel, atau file teks yang ada secara terprogram di cloud. Kami juga dapat menerapkan pemformatan teks dalam dokumen menggunakan PHP tanpa menginstal aplikasi eksternal apa pun. Pada artikel ini, kita akan mempelajari cara mengedit dokumen menggunakan REST API di PHP.

Topik-topik berikut akan dibahas dalam artikel ini:

Editor Dokumen REST API dan PHP SDK

Kami akan menggunakan PHP SDK of GroupDocs.Editor Cloud API untuk memodifikasi file DOCX, XLSX, dan TXT. Ini memungkinkan pengeditan dokumen dari format yang didukung. Silakan instal menggunakan perintah berikut di konsol:

composer require groupdocscloud/groupdocs-editor-cloud

Setelah penginstalan, harap gunakan autoload Komposer untuk menggunakan SDK seperti yang ditunjukkan di bawah ini:

require_once('vendor/autoload.php');

Harap dapatkan ID dan Rahasia Klien Anda dari dasbor sebelum mengikuti langkah-langkah yang disebutkan. Setelah Anda memiliki ID dan rahasia Anda, tambahkan kode seperti yang ditunjukkan di bawah ini:

// Contoh kode ini menunjukkan cara menambahkan id klien dan kode rahasia.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';
static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// menginisialisasi konfigurasi
$configuration = new GroupDocs\Editor\Configuration();

// Mengatur konfigurasi
$configuration->setAppSid(CommonUtils::$ClientId);
$configuration->setAppKey(CommonUtils::$ClientSecret);
$configuration->setApiBaseUrl(CommonUtils::$ApiBaseUrl);

Edit Dokumen Word menggunakan REST API di PHP

Kami dapat mengedit dokumen Word dengan mengikuti langkah-langkah sederhana yang disebutkan di bawah ini:

  1. Unggah file DOCX ke cloud
  2. Sunting dokumen Word yang diunggah
  3. Unduh file yang diedit

Unggah Dokumen

Pertama, kami akan mengunggah file DOCX ke cloud menggunakan contoh kode yang diberikan di bawah ini:

// Contoh kode ini menunjukkan cara mengunggah file DOCX ke cloud.
// Inisialisasi api
$apiInstance = new GroupDocs\Editor\FileApi($configuration);

// Jalur file masukan
$file = "C:\\Files\\Editor\\sample.docx";

// Unggah permintaan file
$request = new GroupDocs\Editor\Model\Requests\uploadFileRequest("sample.docx", $file, self::$MyStorage, null);

// Unggah data
$response = $apiInstance->uploadFile($request);

Akibatnya, file DOCX yang diunggah akan tersedia di bagian file dasbor di cloud.

Edit Dokumen Word di PHP

Sekarang, kami akan mengedit konten file DOCX yang diunggah dengan mengikuti langkah-langkah berikut:

  • Pertama, buat instance dari FileApi dan EditApi.
  • Selanjutnya, berikan jalur file DOCX yang diunggah.
  • Kemudian, unduh file sebagai dokumen HTML.
  • Selanjutnya, baca file HTML yang diunduh sebagai string.
  • Kemudian, edit HTML dan simpan dokumen HTML yang diperbarui.
  • Setelah itu, unggah file HTML yang diperbarui.
  • Terakhir, simpan kembali HTML ke DOCX menggunakan metode EditApi.save().

Contoh kode berikut menunjukkan cara mengedit dokumen Word menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara mengedit dokumen Word
// Buat instance API yang diperlukan
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// Muat file DOCX yang diunggah ke status yang dapat diedit
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.docx");

// Tetapkan kata sandi jika dilindungi kata sandi
// $fileInfo->setPassword("kata sandi");

// Tentukan pilihan beban
$loadOptions = new Model\WordProcessingLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// Unduh dokumen HTML
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

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

// Unggah HTML kembali ke penyimpanan
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// Simpan kembali HTML ke 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));

// Selesai.
echo "Document edited: " . $saveResult->getPath();
Edit Dokumen Word menggunakan REST API di PHP.

Edit Dokumen Word menggunakan REST API di PHP.

Unduh File yang Diperbarui

Contoh kode di atas akan menyimpan file Word yang diedit (DOCX) di cloud. Itu dapat diunduh menggunakan contoh kode berikut:

// Contoh kode ini menunjukkan cara mengunduh file DOCX dari cloud.
// Inisialisasi api
$apiInstance = new GroupDocs\Editor\FileApi($configuration);

// Unduh permintaan file
$request = new GroupDocs\Editor\Model\Requests\DownloadFileRequest("edited.docx", self::$MyStorage, null);

// Unduh berkas
$response = $apiInstance->downloadFile($request);

Modifikasi Excel Spreadsheets menggunakan REST API di PHP

Kita bisa mengedit isi lembar Excel dengan mengikuti langkah-langkah yang disebutkan sebelumnya. Namun, kami hanya perlu menyediakan jalur file XLSX yang diunggah.

Contoh kode berikut menunjukkan cara mengedit data sheet Excel menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara mengedit lembar Excel
// Buat instance API yang diperlukan
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// Muat file XLSX yang diunggah ke status yang dapat diedit
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.xlsx"); 

// Tentukan pilihan beban
$loadOptions = new Model\SpreadsheetLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadOptions->setWorksheetIndex(0);
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// Unduh dokumen HTML
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

// Mengedit sesuatu...
$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);

// Unggah HTML kembali ke penyimpanan
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// Simpan kembali HTML ke 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));

// Selesai.
echo "Document edited: " . $saveResult->getPath();
Modifikasi Excel Spreadsheets menggunakan REST API di PHP.

Modifikasi Excel Spreadsheet menggunakan REST API di PHP.

Perbarui File Teks menggunakan REST API di PHP

Kami juga dapat memperbarui konten file teks dengan mengikuti langkah-langkah yang disebutkan sebelumnya. Namun, kami hanya perlu menyediakan jalur file TXT yang diunggah.

Contoh kode berikut menunjukkan cara mengedit file teks menggunakan REST API di PHP.

// Contoh kode ini menunjukkan cara mengedit file teks
// Buat instance API yang diperlukan
$editApi = new GroupDocs\Editor\EditApi($configuration);
$fileApi = new GroupDocs\Editor\FileApi($configuration);

// Muat file TXT yang diunggah ke status dapat diedit
$fileInfo = new Model\FileInfo();
$fileInfo->setFilePath("sample.txt");        
$loadOptions = new Model\TextLoadOptions();
$loadOptions->setFileInfo($fileInfo);
$loadOptions->setOutputPath("");
$loadResult = $editApi->load(new Requests\loadRequest($loadOptions));

// Unduh dokumen HTML
$htmlFile = $fileApi->downloadFile(new Requests\downloadFileRequest($loadResult->getHtmlPath()));
$html = file_get_contents($htmlFile->getRealPath());

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

// Unggah HTML kembali ke penyimpanan
file_put_contents($htmlFile->getRealPath(), $html);
$uploadRequest = new Requests\uploadFileRequest($loadResult->getHtmlPath(), $htmlFile->getRealPath());
$fileApi->uploadFile($uploadRequest);

// Simpan HTML kembali ke 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));

// Selesai.
echo "Document edited: " . $saveResult->getPath();
Perbarui File Teks menggunakan REST API di PHP.

Perbarui File Teks menggunakan REST API di PHP.

Coba Daring

Silakan coba alat pengeditan dokumen online gratis berikut, yang dikembangkan menggunakan API di atas.

Kesimpulan

Dalam artikel ini, kita telah mempelajari cara:

  • mengedit atau memodifikasi konten file Word, Excel, atau Teks dalam PHP;
  • unggah file DOCX ke cloud;
  • unduh file Word yang diperbarui dari cloud.

Selain itu, Anda dapat mempelajari lebih lanjut tentang GroupDocs.Editor Cloud API menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.

Lihat juga