Bug CodeIgniter 3: 5 Jebakan Tersembunyi yang Baru Muncul di Server Linux

Bug CodeIgniter 3 yang baru muncul di server Linux: controller 404, select pecah koma, query builder, base_url, dan log

Bayangkan sebuah band yang berlatih di studio kecil. Semua lagu terdengar rapi, lalu saat manggung di gedung besar, gitar mendadak sumbang dan mikrofon berdengung. Lagunya sama, namun ruangannya berbeda. Hal serupa sering menimpa aplikasi kita. Pada artikel ini kita membedah lima bug CodeIgniter 3 yang lolos dari laptop Windows, lalu baru muncul setelah aplikasi berjalan di server Linux produksi.

Kelima bug ini bukan teori. Kami menemukannya satu per satu saat mengembangkan aplikasi billing ISP berbasis CodeIgniter 3. Selain itu, untuk artikel ini kami mereproduksi semuanya ulang di server uji dengan CodeIgniter 3.1.13 resmi, PHP 8.5, dan MariaDB 11.8. Oleh karena itu, setiap kode, pesan error, dan screenshot di bawah ini berasal dari percobaan nyata.

Ringkasan 5 Bug CodeIgniter 3 di Server Linux

Sebelum masuk ke detail, tabel berikut merangkum gejala dan perbaikan setiap bug. Perhatikan kolom “di laptop”. Kolom itu menjelaskan kenapa bug ini begitu sulit tertangkap sebelum deploy.

NoBugDi laptopDi serverPerbaikan singkat
1Nama file controller tidak Ucfirst200 OK404Ganti nama file: huruf pertama besar, sisanya kecil
2select() memecah komaData salah, tanpa errorData salah, tanpa errorKirim array ke select() atau pakai query()
3Query builder tercampurJarang teruji500 / ambiguousAmbil data model lain lebih dulu
4base_url() di view errorJarang teruji500, bukan 404Bungkus dengan function_exists()
5Mode productionError tampil di layarLayar putihBaca application/logs

Menyiapkan Lab Reproduksi

Kami membuat aplikasi mini dengan tiga tabel: pelanggan, akun PPPoE, dan sesi online. Struktur ini meniru aplikasi billing ISP versi sederhana. Pertama, jalankan SQL berikut di database uji.

CREATE TABLE pelanggan (
  id INT AUTO_INCREMENT PRIMARY KEY,
  tenant_id INT NOT NULL,
  nama VARCHAR(80) NULL
);
CREATE TABLE akun_pppoe (
  id INT AUTO_INCREMENT PRIMARY KEY,
  tenant_id INT NOT NULL,
  pelanggan_id INT NOT NULL,
  username VARCHAR(40) NOT NULL
);
CREATE TABLE sesi_online (
  id INT AUTO_INCREMENT PRIMARY KEY,
  tenant_id INT NOT NULL,
  username VARCHAR(40) NOT NULL
);
INSERT INTO pelanggan (tenant_id, nama) VALUES (1,'Budi'),(1,'Sari'),(1,NULL);
INSERT INTO akun_pppoe (tenant_id, pelanggan_id, username) VALUES
 (1,1,'budi'),(1,1,'budi2'),(1,2,'sari'),(1,3,'tanpanama');
INSERT INTO sesi_online (tenant_id, username) VALUES (1,'budi2'),(1,'sari');

Budi punya dua akun, yaitu budi dan budi2. Sementara itu, satu pelanggan sengaja tidak punya nama agar COALESCE punya pekerjaan. Kemudian kami menjalankan aplikasi dengan server bawaan PHP agar tidak perlu menyentuh konfigurasi Nginx.

cd /opt/ci3lab/app
php -S 127.0.0.1:8090 index.php

Satu catatan penting: CodeIgniter 3.1.13 di PHP 8.2 ke atas memunculkan banyak pesan Deprecated soal dynamic property. Pesan itu topik tersendiri. Karena itu, di lab ini kami mengganti error_reporting(-1) di index.php menjadi error_reporting(E_ALL & ~E_DEPRECATED) supaya output tetap bersih.

Bug 1: Nama File Controller Harus Ucfirst

Misalnya Anda membuat halaman laporan harian dan menamai file-nya mengikuti gaya CamelCase yang terlihat rapi.

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

// file: application/controllers/LaporanHarian.php  (nama file SALAH)
class Laporanharian extends CI_Controller {
    public function index()
    {
        echo "Laporan harian OK\n";
    }
}

Saat URL /laporanharian masuk, router CodeIgniter 3 menjalankan ucfirst() pada segmen URL. Hasilnya Laporanharian, lalu router mencari file Laporanharian.php. Windows menganggap LaporanHarian.php dan Laporanharian.php sama, sehingga halaman tetap tampil. Sebaliknya, filesystem ext4 di Linux membedakan huruf besar dan kecil, akibatnya router menyerah dan mengirim 404.

Diagram bug CodeIgniter 3: router ucfirst mencari Laporanharian.php, Windows menemukan LaporanHarian.php tetapi Linux mengirim 404
Router mencari nama file hasil ucfirst(). Hanya Windows yang memaafkan perbedaan huruf.

Kami menguji file yang sama persis di dua tempat. Di laptop Windows, halaman membalas 200. Di server Linux, halaman yang sama membalas 404. Log CodeIgniter bahkan menyebut nama kelas yang router cari, yaitu Laporanharian/index.

Bug CodeIgniter 3 nama file controller: 200 di Windows, 404 di server Linux, lalu 200 setelah file diganti nama
Tangkapan asli dari laptop Windows dan server uji Linux. Nama user server kami sensor.

Perbaikan dan Route untuk URL Bertanda Hubung

Perbaikannya cukup mengganti nama file. Huruf pertama besar, sisanya kecil, dan nama kelas di dalam file harus sama.

mv application/controllers/LaporanHarian.php application/controllers/Laporanharian.php

Lalu, bagaimana kalau Anda ingin URL yang lebih mudah terbaca seperti /laporan-harian? Jangan mengandalkan translate_uri_dashes. Sebaiknya tulis route eksplisit di application/config/routes.php.

$route['laporan-harian'] = 'laporanharian/index';

Dengan route ini, URL /index.php/laporan-harian di server uji kami langsung membalas “Laporan harian OK”. Aturan yang sama juga berlaku untuk model. Jika Anda memanggil $this->load->model('Akun_model'), file-nya harus bernama Akun_model.php, bukan akun_model.php.

Audit Semua Controller Sekaligus

Selanjutnya, jalankan loop kecil ini dari root aplikasi sebelum deploy. Loop ini membandingkan nama file dengan bentuk Ucfirst yang router harapkan.

for f in application/controllers/*.php; do
  n=$(basename "$f" .php)
  [ "$n" = "$(echo ${n:0:1} | tr a-z A-Z)$(echo ${n:1} | tr A-Z a-z)" ] || echo "SALAH: $f"
done

Saat kami menaruh file uji AccountDeletion.php, loop ini langsung mencetak SALAH: application/controllers/AccountDeletion.php. File yang benar tidak menghasilkan output apa pun.

Contoh Kasus: Halaman Hapus Akun yang Hilang

Kami pernah menambah halaman permintaan hapus akun di landing page aplikasi billing. File controller bernama AccountDeletion.php. Di XAMPP semuanya lancar, namun setelah deploy, URL yang sama membalas 404. Pada akhirnya, solusinya persis seperti di atas: file berganti nama menjadi Accountdeletion.php, lalu route eksplisit account-deletion mengarah ke accountdeletion/index.

Bug 2: select() Memecah Koma di Dalam Fungsi SQL

Bug ini paling licik karena tidak menghasilkan error sama sekali. Contohnya, kita ingin menampilkan akun PPPoE terbaru milik setiap pelanggan. Caranya, gabungkan username dengan GROUP_CONCAT, lalu ambil potongan pertama dengan SUBSTRING_INDEX.

// application/models/Pelanggan_model.php — VERSI BUG
public function daftar_bug()
{
    $this->db->select('p.id, COALESCE(p.nama, "(tanpa nama)") AS nama,
        SUBSTRING_INDEX(GROUP_CONCAT(a.username ORDER BY a.id DESC), ",", 1) AS akun_terbaru', FALSE);
    $this->db->from('pelanggan p');
    $this->db->join('akun_pppoe a', 'a.pelanggan_id = p.id');
    $this->db->group_by('p.id');
    return $this->db->get()->result_array();
}

Hasilnya, Budi mendapat budi2,budi, bukan budi2. Kenapa? Fungsi select() di CodeIgniter 3.1.13 selalu menjalankan explode(',', $select) pada string. Kemudian setiap potongan melewati trim(), lalu _compile_select() menyambungnya lagi dengan ", ". Akibatnya pemisah "," berubah menjadi ", " (koma plus spasi). Karena GROUP_CONCAT memakai koma tanpa spasi, SUBSTRING_INDEX tidak pernah menemukan pemisahnya dan mengembalikan seluruh string.

Bug CodeIgniter 3 select memecah koma: pemisah berubah menjadi koma spasi sehingga akun_terbaru berisi budi2,budi
Tangkapan asli server uji. Perhatikan pemisah “, ” pada versi bug. Nama user server kami sensor.

Kenapa Parameter FALSE Saja Tidak Cukup

Banyak tutorial menyarankan parameter kedua FALSE untuk ekspresi SQL. Parameter itu memang mematikan backtick otomatis. Namun, pemecahan koma tetap berjalan karena explode() terjadi sebelum CodeIgniter melihat flag tersebut. Kami menguji tiga variasi dan semuanya berubah diam-diam.

Ekspresi yang kita tulisYang sampai ke MySQLDampak
SUBSTRING_INDEX(..., ",", 1)SUBSTRING_INDEX(..., ", ", 1)Seluruh string kembali utuh
CONCAT_WS(",", p.id, p.nama)CONCAT_WS(", ", p.id, p.nama)Format label berubah
COALESCE(p.nama, 'Budi,Sari')COALESCE(p.nama, 'Budi, Sari')Teks default berubah
COALESCE(p.nama, "(tanpa nama)")Tetap samaAman, karena koma asli sudah punya satu spasi sesudahnya

Jadi, koma di antara argumen biasa tidak berbahaya. Yang rusak adalah koma di dalam string literal yang tidak punya tepat satu spasi sesudahnya.

Perbaikan: Kirim Array atau Pakai query()

Saat select() menerima array, explode() tidak jalan. Setiap elemen array menjadi satu ekspresi utuh, sedangkan FALSE tetap mencegah backtick pada fungsi SQL.

// application/models/Pelanggan_model.php — VERSI AMAN
public function daftar()
{
    $this->db->select(array(
        'p.id',
        'COALESCE(p.nama, "(tanpa nama)") AS nama',
        'SUBSTRING_INDEX(GROUP_CONCAT(a.username ORDER BY a.id DESC), ",", 1) AS akun_terbaru',
    ), FALSE);
    $this->db->from('pelanggan p');
    $this->db->join('akun_pppoe a', 'a.pelanggan_id = p.id');
    $this->db->group_by('p.id');
    return $this->db->get()->result_array();
}

Versi ini menghasilkan budi2 sesuai harapan. Sebagai alternatif, tulis SQL utuh dengan $this->db->query() dan binding ?. Cara ini juga terbukti benar di lab kami, sekaligus tetap aman dari SQL injection.

$sql = 'SELECT p.id,
               COALESCE(p.nama, "(tanpa nama)") AS nama,
               SUBSTRING_INDEX(GROUP_CONCAT(a.username ORDER BY a.id DESC), ",", 1) AS akun_terbaru
        FROM pelanggan p
        JOIN akun_pppoe a ON a.pelanggan_id = p.id
        WHERE p.tenant_id = ?
        GROUP BY p.id';
$rows = $this->db->query($sql, array(1))->result_array();

Contoh Kasus: Peta Jaringan Menampilkan Dua Username

Kami menemukan bug ini di fitur peta jaringan aplikasi billing. Setiap titik pelanggan seharusnya menampilkan satu username PPPoE, tetapi pelanggan dengan dua akun menampilkan keduanya sekaligus, misalnya budi2,budi. Anehnya, query yang sama memberi hasil benar saat kami jalankan langsung di MySQL client. Oleh karena itu, selalu uji hasil query lewat aplikasi, bukan hanya di client database.

Bug 3: Query Builder Tercampur Saat Membangun Query DataTables

Pola DataTables server-side di CodeIgniter 3 biasanya begini: model menyusun query lalu mengembalikan $this->db yang belum jalan. Setelah itu library DataTables menambah limit, order, dan pencarian sebelum memanggil get().

// application/models/Akun_model.php
public function dt_query($tenant_id)
{
    $this->db->select('a.id, a.username, p.nama');
    $this->db->from('akun_pppoe a');
    $this->db->join('pelanggan p', 'p.id = a.pelanggan_id');
    $this->db->where('a.tenant_id', $tenant_id);
    return $this->db;   // builder masih tertunda
}

// application/models/Sesi_model.php
public function username_online($tenant_id)
{
    $rows = $this->db->select('username')
                     ->from('sesi_online')
                     ->where('tenant_id', $tenant_id)
                     ->get()->result_array();
    return array_column($rows, 'username');
}

Kedua model terlihat wajar. Masalahnya muncul dari urutan pemanggilan di controller berikut, saat kita ingin memfilter akun yang sedang online.

// application/controllers/Akun.php — VERSI BUG
public function online_bug()
{
    $qb = $this->Akun_model->dt_query(1);
    $online = $this->Sesi_model->username_online(1);
    $qb->where_in('a.username', $online);
    $this->_json($qb->get()->result_array());
}

Kenapa Query Bisa Tercampur

Di CodeIgniter 3, $this->db adalah satu objek yang sama untuk semua model. Builder baru kembali kosong setelah get(). Jadi, ketika Sesi_model menambah select, from, dan where lalu memanggil get(), potongan query milik Akun_model ikut terkirim. MySQL menerima FROM (akun_pppoe a, sesi_online) dengan dua kolom username, lalu menolaknya.

Diagram bug CodeIgniter 3 query builder singleton: urutan salah membuat query tercampur, urutan benar mengambil data online lebih dulu
Satu builder untuk semua model. Urutan pemanggilan menentukan hasilnya.

Screenshot berikut menunjukkan hasilnya dalam mode production. Browser hanya menerima HTTP 500 tanpa isi, sedangkan log mencatat query campuran tersebut.

Bug CodeIgniter 3 query builder tercampur: Column username in SELECT is ambiguous di log, lalu JSON benar setelah urutan diperbaiki
Tangkapan asli server uji: log error versi bug dan JSON versi aman. Nama user server kami sensor.

Perbaikan: Ambil Data Model Lain Lebih Dulu

Pindahkan semua pemanggilan model lain ke atas, sebelum builder mulai tersusun. Setelah itu, jangan sentuh database lagi sampai get() jalan.

// application/controllers/Akun.php — VERSI AMAN
public function online()
{
    $online = $this->Sesi_model->username_online(1);
    $qb = $this->Akun_model->dt_query(1);
    $qb->where_in('a.username', $online);
    $this->_json($qb->get()->result_array());
}

Endpoint ini mengembalikan dua akun online, yaitu budi2 dan sari, dengan HTTP 200. Aturan praktisnya sederhana: di antara dt_query() dan get(), hindari memanggil fungsi apa pun yang memakai $this->db, termasuk helper atau library milik sendiri.

Contoh Kasus: Filter Online/Offline di Halaman PPPoE

Bug ini sempat lolos ke produksi di halaman daftar akun PPPoE aplikasi billing kami. Tabelnya normal, tetapi begitu admin memilih filter “Online”, tabel kosong dan DataTables menampilkan pesan error. Log mencatat Column 'tenant_id' is ambiguous dan klausa FROM ganda. Ternyata controller mengambil daftar username online dari model router setelah builder DataTables mulai tersusun. Setelah urutannya kami tukar, filter langsung berfungsi.

Bug 4: View Error yang Memanggil base_url() Tanpa Guard

Banyak developer mempercantik halaman 404 bawaan dengan CSS milik aplikasi. Contohnya, kami menambah satu baris ini di application/views/errors/html/error_404.php, padahal helper URL sudah ada di autoload.

<link rel="stylesheet" href="<?= base_url('assets/css/error.css') ?>">

Kemudian kami membuka URL yang tidak ada, misalnya /halaman-ngawur. Hasilnya bukan halaman 404, melainkan error fatal Call to undefined function base_url() dengan status 500.

Kenapa Autoload Tidak Menolong

Autoload helper berjalan di dalam constructor CI_Controller. Ketika router tidak menemukan controller, CodeIgniter memanggil show_404() sebelum controller mana pun lahir. Akibatnya, url_helper belum termuat saat view error tampil.

Bagian yang membuatnya tersembunyi: show_404() dari dalam controller tetap normal. Di lab kami, /pelanggan/detail/99 memanggil show_404() dan halaman 404 tampil lengkap dengan CSS. Jadi, kalau Anda hanya menguji 404 dari controller, bug ini tidak akan terlihat.

Bug CodeIgniter 3 base_url di view error 404: Call to undefined function base_url, lalu halaman 404 normal setelah diberi function_exists
Tangkapan asli dari browser ke server uji: sebelum dan sesudah guard.

Perbaikan: Guard function_exists()

Bungkus setiap pemanggilan helper di view error dengan function_exists() dan sediakan path cadangan.

<link rel="stylesheet" href="<?= function_exists('base_url') ? base_url('assets/css/error.css') : '/assets/css/error.css' ?>">

Setelah perubahan ini, URL ngawur kembali membalas 404 dengan halaman yang benar. Lalu, untuk mencari sisa pemanggilan tanpa guard di semua view error, jalankan perintah ini.

grep -n "base_url(\|site_url(" application/views/errors/html/*.php | grep -v function_exists

Jika perintah tidak mencetak apa pun, semua view error sudah aman.

Contoh Kasus: Log PWA Penuh Error 404

Di aplikasi PWA billing kami, log tiba-tiba penuh dengan Call to undefined function base_url() dari error_404.php baris 8. Audit kemudian menemukan masalah yang sama di error_general.php, view yang CodeIgniter pakai untuk show_error(). View itu muncul pada halaman “Akses ditolak” dan penolakan CSRF. Jadi pengguna yang token CSRF-nya kedaluwarsa justru melihat error 500. Setelah semua view error memakai guard, masalah itu hilang.

Bug 5: Mode Production Menyembunyikan Error

Bug kelima sebenarnya bukan kesalahan kode, tetapi kebiasaan debugging. Di produksi, kita wajib memakai ENVIRONMENT production agar pesan error, path file, dan query tidak bocor ke pengunjung. Aturannya ada di index.php.

define('ENVIRONMENT', isset($_SERVER['CI_ENV']) ? $_SERVER['CI_ENV'] : 'production');

Konsekuensinya, semua bug di atas hanya terlihat sebagai layar putih. Pada bug 3, misalnya, curl hanya menerima HTTP 500, 0 byte. Selain itu, database.php bawaan mematikan db_debug di mode production, sehingga query yang gagal hanya mengembalikan false lalu memicu error lanjutan.

Aktifkan Log dan Baca dari Terminal

Pertama, pastikan log_threshold di application/config/config.php minimal 1 agar CodeIgniter mencatat semua ERROR.

$config['log_threshold'] = 1;

Kedua, pastikan user web server boleh menulis ke folder log. Server uji kami awalnya gagal pada tes ini, karena folder masih milik user biasa.

sudo -u www-data test -w application/logs && echo "logs bisa ditulis" || echo "logs TIDAK bisa ditulis www-data"
sudo chown -R www-data:www-data application/logs

Terakhir, ikuti log secara langsung sambil mengulang request yang gagal di browser.

tail -f application/logs/log-$(date +%F).php

Log tersebut memuat semua yang kita butuhkan: nama kelas pada 404 bug 1, query campuran pada bug 3, serta nama file dan baris pada bug 4.

Contoh Kasus: Pindah ke Production Tanpa Kehilangan Jejak

Sejak semua aplikasi billing kami pindah ke mode production, tidak ada lagi pesan error di layar pengguna. Sebagai gantinya, langkah pertama setiap laporan “halaman putih” adalah membuka log hari itu. Hampir semua kasus di artikel ini, termasuk view error dan filter Online, terungkap dari log, bukan dari browser.

Checklist Sebelum Deploy CodeIgniter 3 ke Linux

CekCara
Nama file controller dan modelLoop audit Ucfirst di atas
Ekspresi SQL berkoma di select()Cari SUBSTRING_INDEX, CONCAT_WS, SEPARATOR lalu ubah ke array
Builder DataTablesTidak ada akses database di antara dt_query() dan get()
View errorgrep base_url/site_url tanpa function_exists
Loglog_threshold 1 dan folder logs milik user web server

Kesalahan Umum

  • Menguji aplikasi hanya di Windows lalu menganggap hasilnya sama di Linux. Sebaiknya uji di server staging Linux, atau minimal jalankan loop audit nama file.
  • Mengira parameter FALSE di select() mematikan pemecahan koma. Parameter itu hanya mematikan backtick.
  • Menguji query di MySQL client lalu menganggap hasil aplikasi pasti sama. Query builder bisa mengubah SQL sebelum sampai ke database.
  • Memanggil model lain di tengah penyusunan builder DataTables, termasuk lewat helper yang diam-diam memakai $this->db.
  • Hanya menguji 404 dari show_404() di controller, bukan dari URL yang benar-benar tidak ada.
  • Mengubah ENVIRONMENT kembali ke development di server produksi untuk debugging. Cara ini membocorkan path dan query ke pengunjung, jadi baca log saja.
  • Lupa memberi izin tulis folder application/logs, sehingga log kosong justru saat Anda paling membutuhkannya.

Kesimpulan

Kelima bug CodeIgniter 3 ini punya pola yang sama: semuanya lolos dari pengujian di laptop, lalu baru muncul di server. Nama file controller butuh format Ucfirst karena Linux membedakan huruf. Selain itu, select() memecah setiap koma, sehingga ekspresi SQL berkoma lebih aman lewat array atau query(). Kemudian, satu $this->db untuk semua model menuntut urutan pemanggilan yang disiplin, sedangkan view error memerlukan guard function_exists(). Terakhir, mode production menyembunyikan semuanya dari layar, jadi biasakan membaca application/logs. Dengan checklist di atas, deploy berikutnya jauh lebih kecil kemungkinannya berakhir dengan halaman putih.

Baca Juga

Referensi: CodeIgniter 3 User Guide: Controllers, CodeIgniter 3 User Guide: Query Builder Class, CodeIgniter 3 User Guide: Error Handling, PHP Manual: ucfirst().

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *