Sebelum Anda Memulai: Prasyarat dan Instalasi

Untuk mengikuti panduan ini Anda memerlukan:

• PHP 7.4 atau lebih tinggi terinstal pada mesin pengembangan atau server Anda.
• Composer untuk manajemen dependensi.
• Akun GroupDocs Cloud (client ID dan client secret) – Anda dapat membuatnya di portal GroupDocs.
• Ruang disk yang cukup untuk PDF sumber dan file DOCX yang dihasilkan.

Instal pustaka dengan Composer:

composer require groupdocs-conversion-cloud

Unduh paket terbaru atau lihat sumbernya di GitHub: Download URL. Setelah instalasi, Anda siap mulai menulis kode.

Konversi Dokumen PDF ke DOCX di PHP - Membangun Langkah demi Langkah

Berikut adalah panduan singkat yang menunjukkan setiap operasi penting. Kode sumber lengkap muncul nanti di bagian Implementasi PHP Lengkap untuk Mengonversi Dokumen ke DOCX.

Langkah 1: Muat PDF Sumber

Buat instance ConversionApi dan arahkan ke PDF yang ingin Anda konversi.

use GroupDocs\Conversion\Configuration;
use GroupDocs\Conversion\Api\ConversionApi;

$config = new Configuration('YOUR_CLIENT_ID', 'YOUR_CLIENT_SECRET');
$api = new ConversionApi($config);
$sourcePath = 'input.pdf';

Langkah 2: Inisialisasi Pengaturan Konversi

Tentukan format output dan jalur tujuan. Kelas ConvertOptions memungkinkan Anda menyesuaikan batas memori untuk PDF besar, yang meningkatkan Kinerja Konversi PDF ke DOCX dalam PHP.

use GroupDocs\Conversion\Model\ConvertOptions;

$options = new ConvertOptions();
$options->setFilePath($sourcePath);
$options->setOutputPath('output.docx');
$options->setFormat('docx');
// Optional: $options->setMemoryLimit(1024); // in MB

Langkah 3: Jalankan Konversi

Kirim permintaan ke layanan cloud. Panggilan API tunggal ini melakukan pekerjaan berat.

use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

$request = new ConvertDocumentRequest($options);
$api->convertDocument($request);

Langkah 4: Mengambil Hasil

File DOCX yang telah dikonversi disimpan ke jalur yang Anda tentukan. Anda sekarang dapat menyajikannya kepada pengguna atau menyimpannya untuk pemrosesan nanti.

echo "Conversion completed. DOCX saved to output.docx";

Langkah 5: Bersihkan Sumber Daya

Buang instance API jika Anda menjalankan banyak konversi dalam sebuah loop. Menggunakan kembali instance yang sama lebih efisien untuk microservice konversi PDF ke DOCX dalam PHP.

unset($api);

Implementasi PHP Lengkap untuk Mengonversi Dokumen ke DOCX

Kode berikut menggabungkan semua langkah menjadi satu skrip yang dapat dijalankan.

<?php
require 'vendor/autoload.php';

use GroupDocs\Conversion\Configuration;
use GroupDocs\Conversion\Api\ConversionApi;
use GroupDocs\Conversion\Model\ConvertOptions;
use GroupDocs\Conversion\Model\Requests\ConvertDocumentRequest;

// ==== Configuration ====
$clientId = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';
$config = new Configuration($clientId, $clientSecret);
$api = new ConversionApi($config);

// ==== Input / Output ====
$sourcePath = __DIR__ . '/input.pdf';
$outputPath = __DIR__ . '/output.docx';

// ==== Conversion Options ====
$options = new ConvertOptions();
$options->setFilePath($sourcePath);
$options->setOutputPath($outputPath);
$options->setFormat('docx');
// Example of performance tuning
$options->setMemoryLimit(1024); // 1 GB

// ==== Convert ====
$request = new ConvertDocumentRequest($options);
try {
    $api->convertDocument($request);
    echo "PDF successfully converted to DOCX. File saved at: $outputPath\n";
} catch (Exception $e) {
    echo "Conversion failed: " . $e->getMessage() . "\n";
}

// ==== Cleanup ====
unset($api);
?>

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui jalur file (input.pdf, output.docx, dll.) 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 forum dukungan untuk bantuan.

Menjalankan Konversi Dokumen melalui REST API Menggunakan cURL

Jika Anda lebih suka berinteraksi langsung dengan layanan, perintah cURL berikut menggambarkan alur kerja lengkap.

1. Otentikasi dan Dapatkan Token Akses

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

2. Unggah PDF Sumber

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=/input.pdf" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@/path/to/input.pdf"

3. Meminta Konversi PDF ke DOCX

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?outputFormat=docx&outputPath=/output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filePath":"/input.pdf"}'

4. Unduh DOCX yang Dikonversi

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=/output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.docx

Perintah-perintah ini dapat dibungkus dalam skrip PHP sederhana atau digunakan dalam pipeline CI untuk alat CLI konversi PDF ke DOCX di PHP. Untuk detail lebih lanjut, lihat referensi API.

Kesimpulan

Mengintegrasikan konversi PDF ke DOCX di PHP sangat mudah dengan GroupDocs.Conversion Cloud SDK for PHP. Anda telah mempelajari cara menyiapkan pustaka, menjalankan konversi langkah demi langkah, dan memanggil fungsi yang sama melalui panggilan REST. Pustaka ini mendukung baik penyebaran berbasis cloud maupun skenario on‑premise, memberi Anda fleksibilitas untuk arsitektur mikroservis atau instalasi server tradisional. Ingatlah untuk meninjau opsi harga di halaman produk dan memperoleh lisensi sementara dari halaman lisensi sementara sebelum beralih ke produksi. Selamat coding!

FAQ

Bagaimana cara saya mengimplementasikan konversi dokumen PDF ke DOCX di PHP secara on‑premise?
Pasang pustaka di server Anda sendiri, konfigurasikan client ID dan secret, dan jalankan kode konversi secara lokal. Tidak ada lalu lintas jaringan eksternal yang diperlukan setelah otentikasi.

Apa cara terbaik untuk meningkatkan kecepatan konversi PDF besar?
Gunakan kembali satu instance ConversionApi, tingkatkan batas memori PHP, dan aktifkan streaming dengan mengatur opsi yang sesuai di ConvertOptions. Ini mengurangi overhead dan meningkatkan Kinerja Konversi PDF ke DOCX dalam PHP.

Bisakah saya menggunakan perpustakaan ini dalam kontainer Docker untuk layanan mikro?
Ya. Sertakan langkah instalasi Composer dalam Dockerfile Anda, salin skrip PHP Anda, dan buka endpoint yang memanggil logika konversi. Ini membuat layanan mikro konversi PDF ke DOCX dalam PHP.

Apakah ada paket Composer untuk fungsi ini?
Pustaka ini didistribusikan melalui Composer. Instal dengan composer require groupdocs-conversion-cloud dan kelola pembaruan melalui composer.json Anda.

Baca Selengkapnya

• Tutorial Langkah-demi-Langkah - Konversi DOCX ke PDF dalam Java
• Tutorial Konversi HTML ke XLSX Langkah-demi-Langkah dalam PHP
• Contoh Konversi CSV ke PDF Langkah-demi-Langkah dalam Node.JS