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.
| No | Bug | Di laptop | Di server | Perbaikan singkat |
|---|---|---|---|---|
| 1 | Nama file controller tidak Ucfirst | 200 OK | 404 | Ganti nama file: huruf pertama besar, sisanya kecil |
| 2 | select() memecah koma | Data salah, tanpa error | Data salah, tanpa error | Kirim array ke select() atau pakai query() |
| 3 | Query builder tercampur | Jarang teruji | 500 / ambiguous | Ambil data model lain lebih dulu |
| 4 | base_url() di view error | Jarang teruji | 500, bukan 404 | Bungkus dengan function_exists() |
| 5 | Mode production | Error tampil di layar | Layar putih | Baca 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.

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.

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.

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 tulis | Yang sampai ke MySQL | Dampak |
|---|---|---|
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 sama | Aman, 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.

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

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.

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
| Cek | Cara |
|---|---|
| Nama file controller dan model | Loop audit Ucfirst di atas |
Ekspresi SQL berkoma di select() | Cari SUBSTRING_INDEX, CONCAT_WS, SEPARATOR lalu ubah ke array |
| Builder DataTables | Tidak ada akses database di antara dt_query() dan get() |
| View error | grep base_url/site_url tanpa function_exists |
| Log | log_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
FALSEdiselect()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
ENVIRONMENTkembali 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
- Cara Membuat Login dan Autentikasi di CodeIgniter 3 (Part 4)
- Cara Membuat Pencarian dan Pagination di CodeIgniter 3 (Part 3)
- DataTables Server-side dengan CodeIgniter 3 (Sort + Search + Pagination)
Referensi: CodeIgniter 3 User Guide: Controllers, CodeIgniter 3 User Guide: Query Builder Class, CodeIgniter 3 User Guide: Error Handling, PHP Manual: ucfirst().

