Laravel secara default menggunakan MySQL. Tapi kalau proyek Anda butuh fitur seperti JSON columns yang lebih canggih, full-text search bawaan, atau JSONB, PostgreSQL adalah pilihan yang solid.
Artikel ini membahas cara setup PostgreSQL di Laravel, termasuk konfigurasi, perbedaan dengan MySQL, dan fitur-fitur PostgreSQL yang bisa dimanfaatkan langsung dari Eloquent.
Instalasi dan Konfigurasi
Pastikan extension PHP untuk PostgreSQL sudah aktif:
# Ubuntu/Debian
sudo apt install php-pgsql
# Cek apakah sudah aktif
php -m | grep pdo_pgsqlEdit file .env:
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=nama_database
DB_USERNAME=postgres
DB_PASSWORD=password_andaTidak perlu ubah konfigurasi lain. Laravel sudah punya driver PostgreSQL bawaan.
Perbedaan Sintaks Migration
Sebagian besar sintaks migration sama antara MySQL dan PostgreSQL. Perbedaan utama ada di beberapa tipe data:
Schema::create('products', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->decimal('price', 10, 2);
// PostgreSQL: pakai jsonb, bukan json biasa
$table->jsonb('metadata')->nullable();
// PostgreSQL: UUID native
$table->uuid('external_id')->unique();
// Enum di PostgreSQL butuh cast berbeda
$table->string('status')->default('active');
$table->timestamps();
});Tips: Di PostgreSQL, pakai
jsonbdaripadajson. JSONB disimpan dalam format binary yang lebih efisien untuk query dan indexing.
Query JSON dengan PostgreSQL
PostgreSQL punya operator JSON yang sangat powerful. Di Laravel, Anda bisa pakai operator -> dan ->> langsung di Eloquent:
// Cari produk berdasarkan field di dalam JSON
$products = Product::where('metadata->category', 'elektronik')->get();
// Atau dengan whereJsonContains
$products = Product::whereJsonContains('metadata->tags', 'promo')->get();
// Query nested JSON
$products = Product::where('metadata->specs->weight', '>', 500)->get();
Contoh migration dengan index JSONB:
Schema::create('products', function (Blueprint $table) {
$table->id();
$table->string('name');
$table->jsonb('metadata')->nullable();
$table->timestamps();
});
// Tambah index GIN untuk performa query JSONB
DB::statement('CREATE INDEX products_metadata_gin ON products USING GIN (metadata jsonb_path_ops)');
Full-Text Search
PostgreSQL punya full-text search bawaan yang bisa langsung dipakai tanpa plugin tambahan:
// Migration: tambah kolom tsvector
$table->tsvector('search_vector')->nullable();
// Isi kolom tsvector saat insert/update
DB::statement("
UPDATE articles
SET search_vector = to_tsvector('indonesian', coalesce(title, '') || ' ' || coalesce(content, ''))
");
// Query full-text search
$results = Article::whereRaw(
"search_vector @@ plainto_tsquery('indonesian', ?)",
[$keyword]
)->get();Untuk proyek besar, buat trigger PostgreSQL agar search_vector otomatis diperbarui saat data berubah.
UUID sebagai Primary Key
PostgreSQL mendukung UUID natively. Cara pakai di Laravel 12:
Schema::create('orders', function (Blueprint $table) {
$table->uuid('id')->primary()->default(DB::raw('gen_random_uuid()'));
$table->string('status');
$table->timestamps();
});Di model:
<?php
namespace AppModels;
use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentConcernsHasUuids;
class Order extends Model
{
use HasUuids;
}Transaksi dan Savepoint
PostgreSQL mendukung nested transaction lewat savepoint. Di Laravel ini otomatis dipakai saat Anda nested DB::transaction():
DB::transaction(function () {
$order = Order::create([...]);
DB::transaction(function () use ($order) {
// Ini pakai savepoint di PostgreSQL
// Kalau gagal, hanya bagian ini yang di-rollback
foreach ($order->items as $item) {
Inventory::decrement($item->product_id, $item->qty);
}
});
$order->update(['status' => 'confirmed']);
});Koneksi Multiple Database
Kalau Anda pakai MySQL dan PostgreSQL bersamaan, tambahkan konfigurasi di config/database.php:
'connections' => [
'mysql' => [
'driver' => 'mysql',
// ...
],
'pgsql' => [
'driver' => 'pgsql',
'host' => env('PGSQL_HOST', '127.0.0.1'),
'port' => env('PGSQL_PORT', '5432'),
'database' => env('PGSQL_DATABASE'),
'username' => env('PGSQL_USERNAME'),
'password' => env('PGSQL_PASSWORD'),
],
],Di model, tentukan koneksi yang dipakai:
class AnalyticsEvent extends Model
{
protected $connection = 'pgsql';
}Baca Juga
- Migration di Laravel: Panduan Lengkap dengan Contoh Kode
- Routing di Laravel: Panduan Lengkap dengan Contoh Kode
Butuh tim yang berpengalaman setup aplikasi Laravel dengan PostgreSQL di production? Lihat layanan pengembangan aplikasi kami.
