Cara Mengonversi DOCX ke HTML di PHP - Langkah demi Langkah

1. Instal SDK melalui Composer: Tambahkan pustaka ke proyek Anda dengan perintah Composer resmi.

composer require groupdocs-conversion-cloud

2. Inisialisasi Konfigurasi: Buat objek Configuration dan atur App SID serta App Key.

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

3. Konfigurasikan Opsi Konversi HTML: Sesuaikan pengaturan seperti ekstraksi gambar dan penanganan nomor halaman.

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

4. Buat Pengaturan Konversi: Tentukan file sumber, format target, dan lampirkan opsi HTML.

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

5. Jalankan Konversi: Panggil metode convertDocument dan tangani hasilnya.

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

Untuk detail lebih lanjut tentang setiap kelas dan metode, lihat referensi API.

Contoh Kode Lengkap: Menghasilkan HTML dari DOCX di PHP

Contoh berikut menunjukkan konversi end‑to‑end lengkap menggunakan 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;
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (sample.docx, output.html) agar sesuai dengan lokasi file Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda menemukan masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Mengonversi File DOCX ke HTML Menggunakan cURL dan REST API

SDK juga menawarkan endpoint REST yang dapat dipanggil dengan cURL. Di bawah ini adalah alur kerja tipikal.

1. Dapatkan Token Akses
   Ganti YOUR_CLIENT_ID dan YOUR_CLIENT_SECRET dengan kredensial Anda.

   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. Unggah File DOCX
   Gunakan token dari langkah sebelumnya.

   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. Mulai Konversi
   Minta konversi ke 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. Unduh HTML yang Dihasilkan

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

Untuk daftar lengkap parameter, lihat dokumentasi API resmi.

Menginstal dan Mengonfigurasi GroupDocs.Conversion Cloud SDK for PHP

composer require groupdocs-conversion-cloud

Unduh paket terbaru dari halaman rilis. SDK memerlukan PHP 7.4 atau yang lebih baru serta akun GroupDocs Cloud yang aktif dengan kredensial yang valid.

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 Kemampuan untuk DOCX ke HTML

• Ekstraksi Gambar - extractImages memungkinkan Anda mengekstrak gambar yang disematkan ke file terpisah, mempertahankan kesetiaan tata letak.
• Kontrol Nomor Halaman - preserveOriginalPageNumbers dapat dinonaktifkan untuk menghasilkan aliran HTML kontinu.
• Output HTML Biasa - Mengatur zipOutput ke false menghasilkan satu file HTML tunggal alih-alih arsip ZIP archive, menyederhanakan pemrosesan lanjutan.
• Penanganan Teks Tersembunyi - showHiddenText menentukan apakah konten tersembunyi muncul dalam HTML akhir.
• Render Halaman Tunggal - renderToSinglePage dapat menggabungkan semua halaman menjadi satu dokumen HTML untuk penyematan yang lebih mudah.

Semua fitur dijelaskan dalam dokumentasi.

Kesimpulan

Mengonversi DOCX ke HTML di PHP menjadi sederhana dengan GroupDocs.Conversion Cloud SDK for PHP. Perpustakaan menangani pemformatan kompleks, ekstraksi gambar, dan manajemen halaman tanpa memerlukan Microsoft Office di server. Setelah mengikuti langkah‑langkah di atas, Anda dapat mengintegrasikan konversi DOCX ke HTML ke dalam alur kerja berbasis PHP apa pun, baik Anda lebih suka panggilan SDK native atau permintaan cURL RESTful. Ingatlah untuk memperoleh lisensi yang tepat untuk penggunaan produksi; detail harga tersedia di halaman lisensi sementara. Mulailah mengonversi hari ini dan berikan konten kaya, siap web kepada pengguna Anda.

FAQs

• Bagaimana cara saya mengimplementasikan DOCX ke HTML di PHP tanpa menginstal perangkat lunak tambahan?
  SDK berbasis cloud melakukan semua pemrosesan di server GroupDocs, jadi Anda hanya memerlukan pustaka PHP dan kredensial Anda.

• Apakah saya dapat mengonversi beberapa file DOCX dalam satu permintaan?
  API mendukung konversi batch dengan melakukan perulangan atas file dalam kode Anda; setiap panggilan mengembalikan hasil HTML masing-masing.

• Apa yang terjadi pada gambar di dalam file DOCX?
  Dengan extractImages diaktifkan, gambar disimpan sebagai file terpisah dan direferensikan dalam HTML yang dihasilkan, memungkinkan Anda menyajikannya secara langsung.

• Apakah ada cara untuk menyesuaikan tata letak HTML yang dihasilkan?
  Anda dapat memproses kembali output HTML atau menyesuaikan opsi konversi seperti renderToSinglePage untuk memengaruhi struktur.

Baca Selengkapnya

• Tutorial Konversi JSON ke HTML yang Komprehensif dalam PHP
• Tutorial Konversi HTML ke XLSX Langkah demi Langkah dalam PHP
• Tutorial Konversi HTML ke DOCX Langkah demi Langkah dalam Node.JS