Cara Menginstal dan Mengaktifkan PHP GD, INTL, ZIP untuk PhpSpreadsheet di XAMPP
📊 Tutorial PhpSpreadsheet

Cara Mengaktifkan Ekstensi PHP untuk PhpSpreadsheet di XAMPP

PhpSpreadsheet merupakan library PHP yang digunakan untuk membaca, membuat, dan mengolah file spreadsheet seperti Microsoft Excel.

Library ini mendukung berbagai format file, antara lain XLSX, XLS, CSV, ODS, dan HTML.

✅ Persyaratan PHP untuk PhpSpreadsheet

PhpSpreadsheet versi terbaru membutuhkan PHP 8.1 atau lebih baru. Library ini juga membutuhkan beberapa ekstensi PHP agar dapat berjalan dengan baik.

Ekstensi utama yang dibutuhkan:

ctype
dom
fileinfo
filter
gd
iconv
libxml
mbstring
simplexml
xml
xmlreader
xmlwriter
zip
zlib

🌍 Ekstensi intl bersifat tambahan, tetapi sangat disarankan untuk pemformatan angka, mata uang, tanggal, locale, dan fitur Number Format Wizard.

đŸ–Ĩī¸ 1. Menjalankan XAMPP Control Panel

Buka aplikasi XAMPP Control Panel pada komputer Windows.

Biasanya XAMPP terinstal pada direktori berikut:

C:\xampp

Pastikan Apache belum dijalankan saat Anda akan mengubah konfigurasi PHP.

Apabila Apache sedang aktif, tekan tombol:

Stop

⚙ī¸ 2. Membuka File php.ini dari XAMPP

Pada XAMPP Control Panel, cari bagian Apache, kemudian klik tombol:

Config

Kemudian pilih menu:

PHP (php.ini)

File konfigurasi PHP akan terbuka melalui aplikasi editor teks seperti Notepad.

Alternatifnya, file tersebut dapat dibuka langsung melalui lokasi:

C:\xampp\php\php.ini
⚠ī¸ Pastikan Anda mengubah file php.ini yang digunakan oleh XAMPP, bukan file php.ini milik instalasi PHP lainnya.
Membuka file php.ini melalui XAMPP Control Panel
Membuka konfigurasi PHP melalui XAMPP Control Panel.

đŸ–ŧī¸ 3. Mengaktifkan Ekstensi PHP GD

Ekstensi GD digunakan untuk mengolah gambar. Dalam PhpSpreadsheet, GD diperlukan ketika file Excel memiliki gambar, logo, diagram, atau elemen grafis lainnya.

Cari baris berikut di dalam file php.ini:

;extension=gd

Hapus tanda titik koma ; pada bagian awal sehingga menjadi:

extension=gd

Pada beberapa versi PHP lama, nama ekstensi dapat terlihat seperti:

;extension=gd2

Ubah menjadi:

extension=gd2
ℹī¸ Pada versi PHP modern yang digunakan oleh XAMPP, umumnya cukup menggunakan extension=gd.

🌍 4. Mengaktifkan Ekstensi PHP INTL

Ekstensi INTL digunakan untuk fitur internasionalisasi, seperti pengaturan locale, format tanggal, format angka, mata uang, dan bahasa.

Cari baris berikut:

;extension=intl

Ubah menjadi:

extension=intl
✅ Ekstensi ini sebaiknya tetap diaktifkan, terutama ketika aplikasi mengolah angka, tanggal, mata uang, dan locale tertentu.

đŸ“Ļ 5. Mengaktifkan Ekstensi PHP ZIP

Ekstensi ZIP dibutuhkan karena file Excel dengan format .xlsx sebenarnya merupakan kumpulan file XML yang dikompresi dalam format ZIP.

Cari baris berikut:

;extension=zip

Hapus tanda titik koma sehingga menjadi:

extension=zip
đŸšĢ Tanpa ekstensi ZIP, aplikasi biasanya tidak dapat membuat atau membaca file XLSX dengan benar.

🔤 6. Mengaktifkan Ekstensi PHP MBString

Ekstensi MBString digunakan untuk menangani teks multibyte, seperti karakter UTF-8, huruf khusus, dan teks berbahasa non-Latin.

Cari:

;extension=mbstring

Ubah menjadi:

extension=mbstring
📝 Ekstensi ini penting agar data teks di dalam spreadsheet tidak rusak atau berubah menjadi karakter yang tidak terbaca.

📄 7. Mengaktifkan Ekstensi Fileinfo

Ekstensi Fileinfo digunakan untuk mendeteksi tipe file berdasarkan isi atau kontennya.

Cari:

;extension=fileinfo

Ubah menjadi:

extension=fileinfo
ℹī¸ Pada sebagian instalasi XAMPP, ekstensi Fileinfo mungkin sudah aktif secara default.

🧩 8. Memastikan Ekstensi XML Aktif

PhpSpreadsheet membutuhkan beberapa ekstensi XML, seperti DOM, SimpleXML, XMLReader, dan XMLWriter.

Ekstensi tersebut biasanya sudah aktif secara bawaan pada XAMPP. Namun, Anda tetap dapat memastikannya melalui perintah:

php -m

Pastikan daftar modul menampilkan:

dom
libxml
SimpleXML
xml
xmlreader
xmlwriter

💡 Biasanya ekstensi XML tidak memiliki baris aktivasi terpisah di php.ini karena sudah dikompilasi dan diaktifkan bersama PHP.

💾 9. Menyimpan Perubahan php.ini

Setelah seluruh ekstensi yang dibutuhkan diaktifkan, simpan file php.ini.

Gunakan kombinasi tombol:

Ctrl + S

Setelah file berhasil disimpan, tutup aplikasi editor teks.

🔄 10. Me-restart Apache

Kembali ke aplikasi XAMPP Control Panel, kemudian jalankan ulang Apache.

Tekan tombol:

Start

Apabila Apache sebelumnya masih berjalan, lakukan restart:

Stop Apache
Start Apache

⚠ī¸ Perubahan konfigurasi php.ini baru akan diterapkan setelah Apache dijalankan ulang.

🔍 Memeriksa Ekstensi PHP yang Sudah Aktif

Untuk memeriksa ekstensi PHP melalui Command Prompt atau terminal, jalankan:

php -m

Anda juga dapat memeriksa ekstensi tertentu menggunakan perintah berikut:

php -m | findstr /I "gd intl zip mbstring fileinfo xml"

Pastikan nama ekstensi yang telah diaktifkan muncul pada hasil perintah tersebut.

📋 Ringkasan Ekstensi yang Perlu Diaktifkan

Ekstensi Konfigurasi php.ini Kegunaan
gd extension=gd Mengolah gambar, logo, dan elemen grafis.
intl extension=intl Mengatur locale, tanggal, angka, dan mata uang.
zip extension=zip Membaca dan membuat file Excel berformat XLSX.
mbstring extension=mbstring Menangani teks UTF-8 dan karakter multibyte.
fileinfo extension=fileinfo Mendeteksi tipe file berdasarkan kontennya.
xml Umumnya aktif secara bawaan Membaca struktur XML yang digunakan PhpSpreadsheet.

✅ Kesimpulan

Error saat menginstal PhpSpreadsheet biasanya terjadi karena ekstensi PHP yang dibutuhkan belum aktif pada XAMPP.

Ekstensi utama yang perlu diperiksa antara lain:

✅ GD
✅ ZIP
✅ MBString
✅ Fileinfo
✅ XML
✅ INTL
🚀 Dengan konfigurasi yang benar, aplikasi PHP di XAMPP dapat membaca, membuat, dan mengekspor file Excel menggunakan PhpSpreadsheet tanpa mengalami error ekstensi.
Fauzan Falah
Tentang penulis
Fauzan Falah

Full-Stack Web Developer at Codekop.com.

Lihat Profil Kontak
Komentar