Panduan Membuat Server-Side Processing DataTables untuk Dataset Berukuran Besar
Admin HijrahKreativa
Penulis
Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk
Admin HijrahKreativa
Penulis
Ketika tabel berisi ratusan ribu baris, browser tidak boleh lagi memegang seluruh data. Panduan ini membangun server-side processing DataTables di Laravel dua cara: implementasi manual yang aman dan transparan, lalu dengan yajra/laravel-datatables v13, beserta optimasi query, indeks, hitungan total, filter tambahan, dan ekspor.
Mode client-side DataTables (artikel sebelumnya) mengirim semua data sekaligus. Itu nyaman untuk 2.000 baris, tetapi untuk riwayat iuran seluruh RW selama lima tahun (ratusan ribu baris):
Dalam server-side processing, browser hanya meminta satu halaman data. Pencarian, pengurutan, dan paginasi dikerjakan oleh database.
Browser (DataTables) Laravel
│ GET /admin/iuran/data?draw=3&start=50&length=25
│ &search[value]=budi&order[0][column]=2&order[0][dir]=desc
│ ─────────────────────────────────────────────►
│ validasi parameter
│ query + filter + sort + limit
│ {"draw":3,"recordsTotal":512340, hitung total
│ "recordsFiltered":87,"data":[...25]}
│ ◄─────────────────────────────────────────────
Hasil akhir:
yajra/laravel-datatables v13,| Komponen | Versi |
|---|---|
| PHP | 8.3+ (disarankan 8.4) |
| Laravel | 13.x |
| Database | MySQL 8.0+ / PostgreSQL 15+ |
| DataTables | 2.3.x |
| yajra/laravel-datatables-oracle | ^13.0 (opsional, Bagian B) |
Layout admin, helper api(), dan pengaturan bahasa DataTables mengikuti artikel Cara Membuat Admin Dashboard Laravel dengan Bootstrap 5 dan DataTables AJAX.
Parameter penting yang dikirim DataTables:
| Parameter | Arti |
|---|---|
draw |
Nomor urut request; harus dikembalikan apa adanya (sebagai integer) |
start |
Offset baris pertama |
length |
Jumlah baris per halaman (-1 berarti semua) |
search[value] |
Kata kunci kotak pencarian global |
order[i][column] |
Indeks kolom yang diurutkan |
order[i][dir] |
asc atau desc |
columns[i][data] |
Nama data kolom ke-i |
columns[i][searchable] / orderable |
Status kolom |
Respons yang diharapkan:
{
"draw": 3,
"recordsTotal": 512340,
"recordsFiltered": 87,
"data": [ { "id": 1, "periode": "2026-10", "...": "..." } ]
}
Aturan keamanan utama: jangan pernah memakai columns[i][data] atau parameter lain dari browser langsung sebagai nama kolom SQL. Semua parameter ini bisa dimanipulasi. Petakan ke daftar putih kolom yang Anda definisikan sendiri.
Tabel iuran akan diurutkan berdasarkan periode dan tanggal bayar, difilter berdasarkan RT dan status, dan dicari berdasarkan nomor KK atau nama kepala keluarga.
// database/migrations/2026_10_19_200000_add_indexes_for_iuran_table.php
public function up(): void
{
Schema::table('iuran', function (Blueprint $table) {
$table->index(['periode', 'id']);
$table->index(['dibayar_pada', 'id']);
$table->index(['keluarga_id', 'periode']);
});
Schema::table('keluarga', function (Blueprint $table) {
$table->index(['rukun_tetangga_id', 'id']);
$table->index('kepala_keluarga');
});
}
Periksa rencana query setelah data contoh dalam jumlah realistis tersedia:
Iuran::query()->orderByDesc('periode')->limit(25)->explain()->dd();
Buat class tabel yang menjadi satu-satunya sumber kebenaran: kolom apa yang boleh dicari, diurutkan, dan bagaimana dipetakan ke SQL.
// app/Tables/IuranTable.php
namespace App\Tables;
use App\Models\{Iuran, User};
use Illuminate\Database\Eloquent\Builder;
final class IuranTable
{
/**
* Kunci = nama data kolom di DataTables.
* sort = ekspresi kolom SQL untuk ORDER BY (null = tidak bisa diurutkan)
* search = kolom SQL untuk pencarian global (null = tidak dicari)
*/
public const COLUMNS = [
'nomor_kk' => ['sort' => 'keluarga.nomor_kk', 'search' => 'keluarga.nomor_kk'],
'kepala_keluarga' => ['sort' => 'keluarga.kepala_keluarga', 'search' => 'keluarga.kepala_keluarga'],
'rt' => ['sort' => 'rukun_tetangga.nomor', 'search' => null],
'periode' => ['sort' => 'iuran.periode', 'search' => 'iuran.periode'],
'jumlah' => ['sort' => 'iuran.jumlah', 'search' => null],
'dibayar_pada' => ['sort' => 'iuran.dibayar_pada', 'search' => null],
'aksi' => ['sort' => null, 'search' => null],
];
public function baseQuery(User $user): Builder
{
return Iuran::query()
->visibleTo($user) // cakupan data per pengguna
->join('keluarga', 'keluarga.id', '=', 'iuran.keluarga_id')
->join('rukun_tetangga', 'rukun_tetangga.id', '=', 'keluarga.rukun_tetangga_id')
->select([
'iuran.id', 'iuran.periode', 'iuran.jumlah', 'iuran.dibayar_pada',
'keluarga.nomor_kk', 'keluarga.kepala_keluarga',
'rukun_tetangga.nomor as rt',
]);
}
public function applyFilters(Builder $query, array $filters): Builder
{
return $query
->when($filters['rt_id'] ?? null, fn ($q, $rt) => $q->where('keluarga.rukun_tetangga_id', $rt))
->when($filters['periode'] ?? null, fn ($q, $p) => $q->where('iuran.periode', $p))
->when(($filters['status'] ?? null) === 'lunas', fn ($q) => $q->whereNotNull('iuran.dibayar_pada'))
->when(($filters['status'] ?? null) === 'belum', fn ($q) => $q->whereNull('iuran.dibayar_pada'));
}
public function applySearch(Builder $query, ?string $term): Builder
{
if (blank($term)) {
return $query;
}
$term = str_replace(['\\', '%', '_'], ['\\\\', '\%', '\_'], mb_substr(trim($term), 0, 50));
return $query->where(function ($q) use ($term) {
foreach (self::COLUMNS as $col) {
if ($col['search']) {
$q->orWhere($col['search'], 'like', "{$term}%"); // awalan: bisa memakai indeks
}
}
});
}
}
Perhatikan pencarian memakai pola term% (awalan), bukan %term%. Pola awalan bisa memanfaatkan indeks B-tree; pola %term% selalu memindai seluruh tabel. Untuk pencarian teks bebas di dataset besar, gunakan indeks FULLTEXT (lihat artikel Cara Membuat Filter, Search, Sorting, dan Pagination yang Efisien).
// app/Http/Requests/DataTableRequest.php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
class DataTableRequest extends FormRequest
{
public function authorize(): bool
{
return true; // otorisasi di controller, sesuai tabelnya
}
public function rules(): array
{
return [
'draw' => ['required', 'integer', 'min:0'],
'start' => ['required', 'integer', 'min:0', 'max:1000000'],
'length' => ['required', 'integer', 'in:10,25,50,100'], // tolak -1 (semua data)
'search.value' => ['nullable', 'string', 'max:100'],
'order' => ['nullable', 'array', 'max:3'],
'order.*.column' => ['required_with:order', 'integer', 'min:0', 'max:20'],
'order.*.dir' => ['required_with:order', 'in:asc,desc'],
'columns' => ['required', 'array', 'max:20'],
'columns.*.data' => ['nullable', 'string', 'max:50'],
];
}
}
Batas length menolak -1 dan angka seperti 1000000 yang bisa dipakai untuk menyedot seluruh tabel lewat satu request.
// app/Http/Controllers/Admin/IuranTableController.php
namespace App\Http\Controllers\Admin;
use App\Http\Controllers\Controller;
use App\Http\Requests\DataTableRequest;
use App\Models\Iuran;
use App\Tables\IuranTable;
use Illuminate\Support\Facades\{Cache, Gate};
use Illuminate\Validation\Rule;
class IuranTableController extends Controller
{
public function __invoke(DataTableRequest $request, IuranTable $table)
{
Gate::authorize('viewAny', Iuran::class);
$filters = $request->validate([
'filter.rt_id' => ['nullable', 'integer'],
'filter.periode' => ['nullable', 'date_format:Y-m'],
'filter.status' => ['nullable', Rule::in(['lunas', 'belum'])],
])['filter'] ?? [];
$user = $request->user();
$base = $table->baseQuery($user);
// 1) Total tanpa filter: di-cache singkat karena mahal dan jarang berubah drastis
$total = Cache::remember(
"dt:iuran:total:{$user->id}",
now()->addMinutes(2),
fn () => (clone $base)->toBase()->getCountForPagination(),
);
// 2) Terapkan filter tambahan dan pencarian
$filtered = $table->applySearch($table->applyFilters(clone $base, $filters), $request->input('search.value'));
$recordsFiltered = blank($request->input('search.value')) && empty(array_filter($filters))
? $total
: (clone $filtered)->toBase()->getCountForPagination();
// 3) Pengurutan lewat daftar putih
foreach ($request->input('order', []) as $order) {
$key = $request->input("columns.{$order['column']}.data");
$sortColumn = IuranTable::COLUMNS[$key]['sort'] ?? null;
if ($sortColumn) {
$filtered->orderBy($sortColumn, $order['dir'] === 'desc' ? 'desc' : 'asc');
}
}
$filtered->orderBy('iuran.id', 'desc'); // tie-breaker agar urutan stabil antar halaman
// 4) Ambil satu halaman
$rows = $filtered
->offset($request->integer('start'))
->limit($request->integer('length'))
->get();
return response()->json([
'draw' => $request->integer('draw'),
'recordsTotal' => $total,
'recordsFiltered' => $recordsFiltered,
'data' => $rows->map(fn ($r) => [
'id' => $r->id,
'nomor_kk' => $r->nomor_kk,
'kepala_keluarga' => $r->kepala_keluarga,
'rt' => $r->rt,
'periode' => $r->periode,
'jumlah' => $r->jumlah,
'dibayar_pada' => $r->dibayar_pada?->timezone('Asia/Jakarta')->format('d/m/Y'),
'lunas' => $r->dibayar_pada !== null,
]),
]);
}
}
// routes/web.php (di grup admin)
Route::get('iuran/data', \App\Http\Controllers\Admin\IuranTableController::class)
->middleware('throttle:120,1')
->name('iuran.data');
Hal-hal yang membuat endpoint ini aman dan cepat:
ORDER BY diambil dari IuranTable::COLUMNS, bukan dari input.recordsTotal di-cache singkat; recordsFiltered hanya dihitung ulang bila ada filter atau pencarian.select().iuran.id sehingga baris tidak "melompat" antar halaman ketika nilai kolom urutan sama.{{-- resources/views/admin/iuran/index.blade.php --}}
@extends('layouts.admin')
@section('title', 'Riwayat Iuran')
@section('content')
<div class="card border-0 shadow-sm">
<div class="card-body">
<form id="filter-iuran" class="row g-2 mb-3">
<div class="col-sm-3">
<select class="form-select" name="rt_id">
<option value="">Semua RT</option>
@foreach ($daftarRt as $rt)
<option value="{{ $rt->id }}">RT {{ $rt->nomor }}</option>
@endforeach
</select>
</div>
<div class="col-sm-3"><input type="month" class="form-control" name="periode"></div>
<div class="col-sm-3">
<select class="form-select" name="status">
<option value="">Semua status</option>
<option value="lunas">Lunas</option>
<option value="belum">Belum bayar</option>
</select>
</div>
<div class="col-sm-3 d-flex gap-2">
<button type="reset" class="btn btn-light">Reset</button>
<a class="btn btn-outline-secondary" id="btn-ekspor" href="#"><i class="bi bi-download"></i> CSV</a>
</div>
</form>
<table id="tabel-iuran" class="table table-hover align-middle w-100">
<thead>
<tr><th>No. KK</th><th>Kepala Keluarga</th><th>RT</th><th>Periode</th>
<th class="text-end">Jumlah</th><th>Dibayar</th><th></th></tr>
</thead>
</table>
</div>
</div>
@endsection
@push('scripts')
@vite('resources/js/admin/iuran.js')
@endpush
// resources/js/admin/iuran.js
const filterForm = document.getElementById('filter-iuran');
const filters = () => Object.fromEntries(new FormData(filterForm));
const rupiah = DataTable.render.number('.', ',', 0, 'Rp ');
const escapeHtml = (s) => String(s ?? '').replace(/[&<>"']/g, (c) => (
{ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' }[c]
));
const table = new DataTable('#tabel-iuran', {
serverSide: true,
processing: true,
searchDelay: 400, // tunggu 400 ms setelah berhenti mengetik
deferRender: true,
ajax: {
url: '/admin/iuran/data',
data: (d) => { d.filter = filters(); },
},
columns: [
{ data: 'nomor_kk', render: DataTable.render.text() },
{ data: 'kepala_keluarga', render: DataTable.render.text() },
{ data: 'rt', render: DataTable.render.text() },
{ data: 'periode', render: DataTable.render.text() },
{ data: 'jumlah', className: 'text-end', render: rupiah },
{
data: 'dibayar_pada',
render: (val, type, row) => row.lunas
? `<span class="badge text-bg-success">${escapeHtml(val)}</span>`
: '<span class="badge text-bg-warning">Belum</span>',
},
{ data: 'aksi', orderable: false, searchable: false, defaultContent: '',
render: (_, __, row) => `<a class="btn btn-sm btn-outline-secondary" href="/admin/iuran/${row.id}">Detail</a>` },
],
order: [[3, 'desc']],
lengthMenu: [10, 25, 50, 100],
});
filterForm.addEventListener('change', () => table.ajax.reload());
filterForm.addEventListener('reset', () => setTimeout(() => table.ajax.reload()));
document.getElementById('btn-ekspor').addEventListener('click', (e) => {
e.preventDefault();
const params = new URLSearchParams({ ...filters(), search: table.search() });
window.location = `/admin/iuran/ekspor?${params}`;
});
Catatan:
searchDelay mencegah satu request per huruf yang diketik.lengthMenu sama persis dengan aturan validasi in:10,25,50,100.dibayar_pada) meng-escape nilainya secara manual.Ekspor memakai class tabel yang sama sehingga cakupan dan filter identik dengan yang dilihat pengguna. Data dialirkan (streaming) per potongan agar memori tetap rendah.
// app/Http/Controllers/Admin/IuranExportController.php
public function __invoke(Request $request, IuranTable $table)
{
Gate::authorize('laporan.export');
$filters = $request->validate([
'rt_id' => ['nullable', 'integer'],
'periode' => ['nullable', 'date_format:Y-m'],
'status' => ['nullable', Rule::in(['lunas', 'belum'])],
'search' => ['nullable', 'string', 'max:100'],
]);
$query = $table->applySearch($table->applyFilters($table->baseQuery($request->user()), $filters), $filters['search'] ?? null);
activity('ekspor')->causedBy($request->user())->withProperties($filters)->log('Ekspor riwayat iuran');
return response()->streamDownload(function () use ($query) {
$out = fopen('php://output', 'w');
fputcsv($out, ['No. KK', 'Kepala Keluarga', 'RT', 'Periode', 'Jumlah', 'Dibayar']);
$query->orderBy('iuran.id')->lazyById(1000, 'iuran.id', 'id')->each(function ($r) use ($out) {
fputcsv($out, [
$r->nomor_kk,
$this->csvSafe($r->kepala_keluarga),
$r->rt, $r->periode, $r->jumlah,
$r->dibayar_pada?->format('Y-m-d'),
]);
});
fclose($out);
}, 'iuran-'.now()->format('Ymd-His').'.csv', ['Content-Type' => 'text/csv; charset=UTF-8']);
}
/** Cegah CSV/Formula Injection saat file dibuka di Excel */
private function csvSafe(?string $value): ?string
{
return $value !== null && preg_match('/^[=+\-@\t\r]/', $value) ? "'".$value : $value;
}
Fungsi csvSafe() mencegah CSV injection: nama seperti =HYPERLINK("http://evil.test","Klik") akan dijalankan sebagai formula oleh Excel bila tidak diberi awalan kutip. Untuk ekspor yang sangat besar, jalankan di queue dan kirim tautan unduhan lewat notifikasi.
Paket yajra menangani parsing protokol, pencarian, dan pengurutan. Cocok bila banyak tabel admin dan Anda ingin konsisten.
composer require yajra/laravel-datatables-oracle:"^13.0"
// app/Http/Controllers/Admin/IuranTableController.php (versi yajra)
use Yajra\DataTables\Facades\DataTables;
public function __invoke(Request $request, IuranTable $table)
{
Gate::authorize('viewAny', Iuran::class);
$query = $table->applyFilters($table->baseQuery($request->user()), $request->input('filter', []));
return DataTables::eloquent($query)
->orderColumns(['nomor_kk', 'kepala_keluarga', 'periode', 'jumlah', 'dibayar_pada'], ':column $1')
->filterColumn('kepala_keluarga', fn ($q, $keyword) => $q->where('keluarga.kepala_keluarga', 'like', "{$keyword}%"))
->filterColumn('nomor_kk', fn ($q, $keyword) => $q->where('keluarga.nomor_kk', 'like', "{$keyword}%"))
->editColumn('dibayar_pada', fn ($r) => $r->dibayar_pada?->timezone('Asia/Jakarta')->format('d/m/Y'))
->addColumn('lunas', fn ($r) => $r->dibayar_pada !== null)
->addColumn('aksi', '')
->rawColumns([]) // tidak ada kolom HTML mentah dari server
->setTotalRecords(fn () => Cache::remember('dt:iuran:total:'.$request->user()->id, 120, fn () => $query->toBase()->getCountForPagination()))
->toJson();
}
Hal yang perlu diperhatikan saat memakai yajra:
filterColumn/orderColumn eksplisit untuk kolom hasil join agar tidak ada kolom yang tak sengaja bisa dicari atau diurutkan.rawColumns kosong kecuali benar-benar perlu. Kolom yang terdaftar sebagai raw tidak di-escape oleh paket.setTotalRecords() atau skipTotalRecords() untuk menghindari COUNT(*) berulang pada tabel sangat besar.length tetap dilakukan (misalnya lewat middleware atau Form Request) agar klien tidak bisa meminta -1.LIMIT 25 OFFSET 400000 memaksa database membaca dan membuang 400.000 baris. Untuk tabel yang sangat besar:
start maksimal (sudah ada di validasi: max:1000000) dan dorong pengguna memakai filter.id ada dalam satu indeks komposit (Langkah 2).// tests/Feature/Admin/IuranTableTest.php
function dtParams(array $override = []): array
{
return array_replace_recursive([
'draw' => 1, 'start' => 0, 'length' => 10,
'search' => ['value' => ''],
'order' => [['column' => 3, 'dir' => 'desc']],
'columns' => collect(['nomor_kk', 'kepala_keluarga', 'rt', 'periode', 'jumlah', 'dibayar_pada', 'aksi'])
->map(fn ($c) => ['data' => $c])->all(),
], $override);
}
it('mengembalikan struktur respons DataTables', function () {
$admin = User::factory()->create()->assignRole('admin');
Iuran::factory()->count(30)->create();
$this->actingAs($admin)->getJson('/admin/iuran/data?'.http_build_query(dtParams()))
->assertOk()
->assertJsonPath('draw', 1)
->assertJsonPath('recordsTotal', 30)
->assertJsonCount(10, 'data');
});
it('mengabaikan kolom urutan di luar daftar putih', function () {
$admin = User::factory()->create()->assignRole('admin');
$params = dtParams(['columns' => [3 => ['data' => '(select password from users limit 1)']]]);
$this->actingAs($admin)->getJson('/admin/iuran/data?'.http_build_query($params))->assertOk();
});
it('menolak permintaan semua data sekaligus', function () {
$admin = User::factory()->create()->assignRole('admin');
$this->actingAs($admin)->getJson('/admin/iuran/data?'.http_build_query(dtParams(['length' => -1])))
->assertUnprocessable();
});
it('mencegah CSV injection pada ekspor', function () {
$admin = User::factory()->create()->assignRole('admin');
Iuran::factory()->for(Keluarga::factory()->state(['kepala_keluarga' => '=CMD()']))->create();
$csv = $this->actingAs($admin)->get('/admin/iuran/ekspor')->streamedContent();
expect($csv)->toContain("'=CMD()");
});
| Error / Gejala | Penyebab | Solusi |
|---|---|---|
| Tabel berputar terus ("Processing...") | draw tidak dikembalikan atau bukan integer |
Kembalikan $request->integer('draw') |
DataTables warning: ... Ajax error |
Validasi gagal (422) atau error server | Periksa tab Network; samakan lengthMenu dengan aturan validasi |
| Urutan tidak berubah saat header diklik | Nama kolom tidak ada di daftar putih | Tambahkan ke IuranTable::COLUMNS dengan ekspresi sort |
| Baris yang sama muncul di dua halaman | Urutan tidak stabil untuk nilai yang sama | Tambahkan tie-breaker orderBy('iuran.id') |
| Pencarian sangat lambat | LIKE '%term%' pada tabel besar |
Gunakan awalan term%, indeks, atau FULLTEXT |
Column 'id' in field list is ambiguous |
Join tanpa prefiks tabel | Prefiks semua kolom (iuran.id) di select, where, dan orderBy |
recordsTotal selalu sama walaupun data bertambah |
Hitungan di-cache | Normal untuk 2 menit; turunkan TTL atau hapus cache saat data berubah |
| Ekspor timeout | Data terlalu besar untuk satu request | Gunakan lazyById (streaming) atau pindahkan ke queue |
| Kolom HTML dari yajra tampil sebagai teks | Kolom tidak ada di rawColumns |
Hasilkan HTML di frontend (render), bukan di server |
Keamanan
length dan start agar tidak ada permintaan "semua data".render.text()), dan cegah CSV injection pada ekspor.Performa
id sebagai tie-breaker.select() hanya kolom yang ditampilkan; hindari SELECT * dengan join.recordsTotal; hitung ulang recordsFiltered hanya saat ada filter/pencarian.searchDelay di frontend untuk mengurangi request.lazyById.Maintainability
IuranTable) untuk kolom, filter, pencarian, dan query dasar; dipakai endpoint data dan ekspor.DataTableRequest untuk semua tabel server-side.| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 |
| MySQL | 8.4 LTS |
| DataTables | 2.3.x |
| yajra/laravel-datatables-oracle | 13.x |
| Tanggal | 19 Oktober 2026 |
Sebelumnya
Cara Membuat Admin Dashboard Laravel dengan Bootstrap 5 dan DataTables AJAX
Berikutnya
Integrasi Laravel dengan Tailwind CSS 4: Setup, Konfigurasi, dan Troubleshooting
Dokumen ini menjelaskan prosedur konfigurasi autentikasi SSH Key antara server Ubuntu dan GitHub untuk memungkinkan server melakukan operasi Git, seperti clone, pull, dan fetch tanpa menggunakan username dan password akun GitHub.
Peta jalan arsitektur dari satu server hingga banyak server: tahapan pertumbuhan dan sinyal kapan naik tahap, prinsip yang sebaiknya diterapkan sejak awal (stateless, asinkron, data ber-tenant), read replica, pengelolaan data yang terus tumbuh, degradasi yang anggun saat layanan bermasalah, feature...
Menyiapkan lingkungan uji yang jujur, mengukur satu endpoint dengan ApacheBench, mensimulasikan perilaku pengguna sungguhan dengan k6 (skenario, threshold, autentikasi token), menelusuri penyebab request lambat dengan Telescope, memantau server selama pengujian, serta menulis laporan hasil dan angga...
Bagaimana Octane membuat Laravel lebih cepat dengan mem-boot aplikasi sekali dan menyimpannya di memori, apa yang sebenarnya dipercepat (dan yang tidak), risiko kebocoran state antar-request yang wajib dipahami, cara memeriksa kode agar aman untuk Octane, pemasangan dengan FrankenPHP di production,...
03 Nov 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
19 Oct 2026
HijrahKreativa
Kami balas secepatnya
Masuk dulu untuk chat dengan tim kami. Riwayat chat Anda tersimpan di akun.
Masuk