PHP – Membuat dokumen word dari template

Untuk kasus tertentu kita mungkin perlu untuk membuat sebuah dokumen misalnya word (docx) menggunakan PHP. Pada artikel ini kita akan mencoba membahas bagaimana membuat dokumen word dari template yang telah disediakan dengan menggunakan PHP.

Contoh kasus, kita perlu generate sebuah surat dalam format docx. Sebuah surat biasanya memiliki template tertentu, hanya beberapa konten saja yang bersifat dinamis. Karena itu, dibandingkan dengan generate semua konten untuk file ini menggunakan PHP, akan lebih tepat jika kita menyiapkan sebuah template yang kemudian kita replace beberapa konten sesuai dengan nilai yang diperlukan.

Untuk mengatasi kasus diatas, kita akan menggunakan library PHPWord untuk mereplace nilai-nilai tertentu yang didefinisikan pada template dokumen.

Install PHPWord

Sebelum menginstall library PHPWord, ada beberapa requirement yang harus kita penuhi. Pastikan requirement dibawah ini telah terinstal.

• PHP 5.3.3+
• XML Parser extension
• Zend\Escaper component
• Zend\Stdlib component
• Zip extension (optional, used to write OOXML and ODF)
• GD extension (optional, used to add images)
• XMLWriter extension (optional, used to write OOXML and ODF)
• XSL extension (optional, used to apply XSL style sheet to template )
• dompdf library (optional, used to write PDF)

Untuk install library PHPWord, gunakan perintah composer dibawah ini:

composer require phpoffice/phpword

Setelah berhasil menginstal library PHPWord, kita harus menyiapkan template dokumen yang akan kita gunakan sebagai template utama dalam generate surat.

Buat template word dengan format docx, kemudian buat key dengan format ${search_pattern}, yang nantinya key ini akan di replace dengan value yang kita kirim dari PHP.

Pada contoh diatas, kita mendefinisikan beberapa search pattern, pattern ini akan kita gunakan sebagai array key di PHP yang nantinya akan di replace berdasarkan value yang diberikan.

Selanjutnya, buat sebuah file php misalnya kita beri nama index.php, kemudian tambahkan kode dibawah ini.

<?php

require 'vendor/autoload.php';

$templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor('template.docx');

$templateProcessor->setValues([
    'number' => '212/SKD/VII/2019',
    'name' => 'Alfa',
    'birthplace' => 'Bandung',
    'birthdate' => '4 Mei 1991',
    'gender' => 'Laki-Laki',
    'religion' => 'Islam',
    'address' => 'Jln. ABC no 12',
    'date' => date('Y-m-d'),
]);

header("Content-Disposition: attachment; filename=template.docx");

$templateProcessor->saveAs('php://output');

Pada contoh diatas, kita memiliki beberapa array item yang kita definisikan dalam method setValues(). Nilai-nilai inilah yang nantinya akan kita gunakan untuk mereplace pattern yang kita atur dalam template dokumen.

Dengan kata lain, untuk membuat dokumen word dari template, kita perlu mendefiniskan search pattern pada dokumen word dengan format ${pattern}, dan pada PHP kita akan menjadikan pattern sebagai array key.

Menyimpan File

Untuk kasus tertentu juga, kita perlu untuk menyimpan file hasil generate dari pada mendownload file secara langsung.

header("Content-Disposition: attachment; filename=template.docx");
$templateProcessor->saveAs('php://output');

Pada contoh kode diatas, kita akan langsung mendownload file hasil generate. Jika kita hanya perlu untuk menyimpan file tersebut, kita hanya perlu menghapus baris header pada kode diatas, kemudian ganti php://output menjadi path dimana kita akan menyimpan file ini.

Alfa Adhitya Member since December 18, 2019

Computer science education cannot make anybody an expert programmer any more than studying brushes and pigment can make somebody an expert painter – Eric S