Memasang ionCube Loader di Laragon/XAMPP (Windows).

ionCube Loader adalah ekstensi Zend untuk PHP yang dibutuhkan agar server bisa membaca dan menjalankan file PHP yang sudah di-encode (dienkripsi) dengan ionCube Encoder. Banyak skrip/aplikasi PHP komersial dikirim dalam bentuk ter-encode seperti ini, sehingga tanpa Loader-nya kamu akan mendapat pesan error seperti “The file was encoded by the ionCube Encoder”. Catatan ini merangkum cara memasangnya pada lingkungan Windows (Laragon atau XAMPP).

1. Cek versi PHP terlebih dulu

ionCube Loader harus cocok dengan versi PHP dan arsitektur (x64 / thread-safe) yang kamu pakai. Cek dulu:

php -v

Perhatikan versi mayor.minor (misalnya 8.1) dan apakah build-nya Thread Safe (TS) atau Non Thread Safe (NTS). Laragon dengan Apache biasanya memakai build TS.

2. Download Loader

Unduh paket Loader sesuai sistem operasi dari situs resmi:

https://www.ioncube.com/loaders.php

Untuk Windows pilih paket VC15/VS16 x86-64 (sesuaikan dengan versi PHP-mu).

3. Extract dan salin file DLL

Ekstrak arsip yang sudah diunduh, lalu salin file loader yang sesuai versi PHP-mu ke folder ekstensi PHP. Nama filenya berpola ioncube_loader_win_<versi>.dll, contohnya ioncube_loader_win_8.1.dll.

Salin ke folder ext milik PHP-mu, misalnya:

C:\laragon\bin\php\php-8.1.10-Win32-vs16-x64\ext\

Kalau memakai versi PHP Non Thread Safe, gunakan file DLL yang berakhiran _nts.dll.

4. Konfigurasi php.ini

Buka php.ini (di Laragon: menu Menu → PHP → php.ini), lalu tambahkan baris zend_extension yang menunjuk ke file loader yang tadi disalin. Perhatikan: ionCube memakai zend_extension, bukan extension, dan sebaiknya diletakkan di bagian paling atas file agar dimuat lebih dulu.

zend_extension = "C:\laragon\bin\php\php-8.1.10-Win32-vs16-x64\ext\ioncube_loader_win_8.1.dll"

Sesuaikan path dan nama file DLL dengan versi PHP yang kamu pakai.

5. Restart web server dan verifikasi

Restart Apache/Nginx (di Laragon klik Stop lalu Start) agar konfigurasi terbaca. Lalu verifikasi bahwa Loader sudah aktif:

php -v

Jika berhasil, output akan memuat baris seperti with the ionCube PHP Loader ... v.... Kamu juga bisa membuat file info.php berisi <?php phpinfo(); dan mencari bagian ionCube.

6. (Opsional) Jalankan Loader Wizard

Jika masih ragu file DLL mana yang tepat, jalankan loader-wizard.php yang ikut dalam paket unduhan lewat browser (letakkan di root web, misalnya http://localhost/loader-wizard.php). Wizard akan mendeteksi versi PHP dan menunjukkan file loader serta baris zend_extension yang persis dibutuhkan. Hapus kembali file wizard setelah selesai karena dapat membocorkan informasi server.

Catatan: pastikan versi Loader, versi PHP, dan mode TS/NTS benar-benar cocok. Ketidakcocokan salah satunya adalah penyebab paling umum Loader gagal dimuat.