Konversi PHP menjadi PDF

Salinan dengan tata letak tetap diperlukan ketika halaman yang dihasilkan PHP harus dicetak, dikirimkan, dibagikan, atau diarsipkan. Source PHP itu sendiri harus dieksekusi untuk menghasilkan halaman atau diformat sebagai kode; source tersebut tidak langsung dirender menjadi PDF yang sudah selesai oleh file converter biasa.

Format PHP

PHP adalah bahasa scripting sisi server yang digunakan oleh web developer dan administrator untuk menghasilkan halaman dinamis, formulir, faktur, laporan, dan respons API. File .php berisi source code, biasanya dicampur dengan HTML, CSS, SQL, atau markup template; PHP adalah bahasa pemrograman, bukan format dokumen.

Web server yang mendukung PHP menafsirkan file tersebut dan mengembalikan output yang dihasilkan, biasanya HTML, ke browser. Membuka file .php dari file manager tidak menjalankan kode sisi servernya: file tersebut mungkin menampilkan teks source atau gagal dimuat, tergantung pada sistem operasi dan aplikasi.

Format PDF

PDF adalah format dokumen dengan tata letak tetap yang mempertahankan dimensi halaman, font, gambar, spasi, dan penomoran halaman di berbagai sistem operasi dan perangkat. Penerima dapat mencetak atau melihatnya tanpa PHP, web server, atau aplikasi yang membuat halaman asli.

PDF cocok untuk faktur, pengiriman resmi, lampiran email, dan salinan arsip. PDF biasanya tidak ditujukan untuk diedit seperti file pengolah kata, dan konversi tidak menjamin ukuran file yang lebih kecil; font dan gambar yang disematkan dapat memperbesar ukurannya.

Mengonversi halaman PHP yang dihasilkan

Gunakan metode ini ketika PDF yang diperlukan adalah laporan, tanda terima, formulir, atau halaman lain yang dihasilkan oleh script.

1. Instal PHP dan, jika diperlukan, paket server lokal seperti XAMPP, Laragon, atau MAMP. Server bawaan PHP sudah memadai untuk banyak project mandiri.
2. Tempatkan project di direktori dokumennya dan konfigurasikan database, variabel lingkungan, extension, file yang disertakan, dan folder yang dapat ditulisi sesuai kebutuhan.
3. Dari direktori project atau document root yang sesuai, jalankan php -S localhost:8000. Perintah ini memulai development server; ini bukan deployment produksi.
4. Buka alamat yang relevan, seperti http://localhost:8000/report.php, di Chrome, Edge, atau Firefox dan verifikasi bahwa halaman berisi data yang diharapkan.
5. Gunakan Print → Save as PDF di browser. Pilih ukuran kertas dan margin yang diperlukan, aktifkan grafik latar belakang jika desain menggunakannya, lalu periksa page break, gambar, header, dan footer dalam pratinjau cetak.

Untuk output sisi server yang dapat diulang, gunakan workflow Chromium tanpa antarmuka dengan Playwright atau Puppeteer dan fungsi PDF-nya. Gunakan print CSS, viewport, format kertas, margin, dan kondisi pemuatan halaman yang sama seperti yang digunakan dalam produksi; tunggu permintaan jaringan dan konten yang dirender JavaScript sebelum membuat PDF.

Jika halaman sudah tersedia sebagai HTML, layanan online bereputasi seperti PDFCrowd atau CloudConvert dapat menyediakan konversi HTML-ke-PDF. Upload HTML yang dihasilkan, bukan file .php asli: layanan ini umumnya tidak mengeksekusi PHP sembarang, dan stylesheet eksternal, font, gambar, session, serta data yang memerlukan autentikasi mungkin tidak tersedia bagi layanan tersebut.

Mengonversi source code PHP

Gunakan metode ini ketika source itu sendiri merupakan dokumen, misalnya untuk code review, materi pelatihan, atau catatan tertulis.

1. Buka file di code editor seperti PhpStorm, Notepad++, atau Visual Studio Code dan aktifkan PHP syntax highlighting.
2. Atur font monospaced yang mudah dibaca, margin yang sesuai, line wrapping, dan nomor baris opsional. Nonaktifkan wrapping jika mempertahankan baris source yang persis lebih penting daripada menyesuaikan kode dengan halaman.
3. Cetak dari editor yang mendukung pencetakan, seperti Notepad++ atau PhpStorm, lalu pilih printer PDF sistem: Microsoft Print to PDF di Windows atau Save as PDF dalam dialog cetak macOS. Visual Studio Code mungkin memerlukan printing extension atau HTML export perantara.

Untuk PDF source code otomatis, terapkan syntax highlighting dengan Pygments atau formatter serupa, export hasilnya sebagai HTML, lalu cetak HTML tersebut melalui Chromium. Ini mendokumentasikan teks source; proses ini tidak mengeksekusi PHP atau menangkap halaman yang dihasilkan oleh script.

Membuat PDF di dalam aplikasi PHP

Untuk faktur, laporan, atau formulir berulang, aplikasi PHP dapat membuat PDF dari template dengan library seperti Dompdf, mPDF, atau TCPDF. Ini adalah pembuatan PDF, bukan konversi file, dan memerlukan kode, instalasi dependency, persiapan template, serta pengujian dukungan CSS.

Keterbatasan kualitas dan keamanan

Autentikasi, hasil database, extension PHP yang tidak tersedia, permission, path relatif, CSS eksternal, web font, JavaScript, dan print CSS browser dapat mengubah hasil render. Uji dengan data yang representatif, verifikasi gambar dan page break, lalu bandingkan PDF dengan halaman pada URL yang dituju.

Jangan upload source PHP rahasia, kredensial, data pelanggan, atau halaman hasil yang bersifat privat ke converter online. Browser lokal, proses Chromium tanpa antarmuka, atau library PDF PHP dapat mencegah file tersebut terekspos dan memungkinkan akses ke dependency lokal. Hapus secret dari PDF source code dan periksa agar PDF yang dihasilkan tidak berisi metadata yang tidak diinginkan atau data formulir tersembunyi.