Cara Install dan Implementasi Hashids di PHP via Composer

Instalasi Hashids via Composer

Hashids adalah library open-source yang digunakan untuk menghasilkan string unik, pendek, dan tidak berurutan dari angka integer (seperti ID database). Untuk menggunakannya dalam proyek PHP, Anda wajib menggunakan Composer. Jalankan perintah berikut di terminal pada direktori proyek Anda:

composer require hashids/hashids

Implementasi Dasar

Setelah instalasi selesai, Anda dapat langsung menggunakannya dengan memanggil namespace Hashids\Hashids. Berikut adalah contoh implementasi untuk melakukan enkoding dan dekoding ID:

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

use Hashids\Hashids;

$hashids = new Hashids('salt-anda-di-sini', 8);

// Enkoding ID
$id = $hashids->encode(1, 2, 3);
echo $id; // Output: gY3iZ0oP

// Dekoding ID
$numbers = $hashids->decode('gY3iZ0oP');
print_r($numbers); // Output: [1, 2, 3]

Tabel Perbandingan Konfigurasi

ParameterDeskripsiRekomendasi
SaltString unik untuk mengacak hashGunakan string acak yang panjang
Min Hash LengthPanjang minimum string hasilMinimal 8-10 karakter
AlphabetKarakter yang digunakanDefault (a-z, A-Z, 0-9)

Poin Penting Penggunaan

  • Bukan Enkripsi: Hashids bersifat reversibel. Jangan gunakan ini untuk menyimpan data sensitif seperti password atau data pribadi yang membutuhkan keamanan tingkat tinggi.
  • Keamanan: Selalu gunakan salt yang unik dan rahasia agar hasil hash tidak mudah ditebak oleh pihak luar.
  • Database: Sangat efektif untuk menyembunyikan ID database yang berurutan (misal: 1, 2, 3) agar tidak bisa ditebak oleh pengguna melalui URL (misal: /user/1 menjadi /user/jK8sL2mN).

Troubleshooting Umum

Jika Anda menemui error Class 'Hashids\Hashids' not found, pastikan Anda telah menjalankan composer dump-autoload dan memastikan file vendor/autoload.php sudah di-include dengan benar di bagian atas skrip PHP Anda.