Panduan Lengkap Instalasi dan Konfigurasi CodeIgniter 4

CodeIgniter 4 adalah framework PHP modern yang ringan, cepat, dan mudah digunakan 🚀. Dirancang untuk membantu pengembang membuat aplikasi web dengan struktur yang rapi dan efisien, CodeIgniter menjadi pilihan populer bagi banyak developer — terutama untuk proyek dengan kebutuhan performa tinggi dan konfigurasi minimalis ⚙️.

Pada panduan ini, kita akan membahas langkah-langkah lengkap mulai dari instalasi hingga konfigurasi CodeIgniter 4 agar siap digunakan untuk pengembangan aplikasi web berbasis PHP 💻.

1. Persiapan Sebelum Instalasi

Kebutuhan Sistem (System Requirements)

Sebelum mulai instalasi, pastikan sistem kamu memenuhi persyaratan berikut:

✅ PHP versi 7.4 atau lebih tinggi
✅ Ekstensi PHP aktif: intl, mbstring, json, curl
✅ Database server seperti MySQL, MariaDB, atau PostgreSQL
✅ Composer telah terpasang (untuk manajemen dependensi)
✅ Server lokal seperti XAMPP, Laragon, atau MAMP

Untuk memastikan Composer sudah terpasang, jalankan perintah berikut di terminal:

composer -V

Jika muncul versi Composer, berarti instalasi berhasil 👍.

2. Instalasi CodeIgniter 4

Metode 1: Instalasi Menggunakan Composer

Metode ini paling direkomendasikan karena lebih mudah diperbarui dan dikelola.

composer create-project codeigniter4/appstarter ci4_app

Perintah di atas akan mengunduh versi terbaru CodeIgniter 4 ke folder ci4_app.

Metode 2: Instalasi Manual (Tanpa Composer)

Jika kamu belum menggunakan Composer, kamu dapat mengunduh CodeIgniter 4 secara manual:

Kunjungi situs resmi CodeIgniter.
Unduh paket CodeIgniter 4 versi terbaru.
Ekstrak ke dalam folder proyek (misalnya htdocs/ci4_app).

Setelah itu, framework siap dijalankan.

3. Menjalankan Server Development

Langkah Pertama Menjalankan CodeIgniter

Masuk ke folder proyek dan jalankan perintah berikut di terminal:

cd ci4_app php spark serve

Jika berhasil, kamu akan melihat pesan seperti ini:

CodeIgniter development server started on http://localhost:8080

Buka browser dan akses http://localhost:8080 untuk melihat tampilan awal CodeIgniter ✅.

4. Struktur Folder CodeIgniter 4

Mengenal Struktur Dasar

Berikut adalah struktur folder penting di CodeIgniter 4:

Folder	Deskripsi
`app/`	Berisi file utama aplikasi seperti Controller, Model, dan View
`public/`	Root folder untuk file yang bisa diakses secara publik (index.php, assets, dll.)
`writable/`	Tempat penyimpanan log, cache, dan file upload
`system/`	Berisi core library CodeIgniter (jangan diubah!)
`env`	File konfigurasi lingkungan (environment variables)

5. Konfigurasi Dasar

Menyesuaikan Base URL

Buka file .env dan aktifkan pengaturan berikut dengan menghapus tanda # di awal baris:

app.baseURL = 'http://localhost:8080/'

Konfigurasi Database

Masih di file .env, atur koneksi database sesuai server kamu:

database.default.hostname = localhost database.default.database = db_ci4 database.default.username = root database.default.password = database.default.DBDriver = MySQLi database.default.DBPrefix = database.default.port = 3306

Pastikan database sudah dibuat sebelumnya menggunakan phpMyAdmin atau terminal MySQL 🗄️.

6. Membuat Controller Pertama

Langkah Praktis Membuat Controller

Buka folder app/Controllers dan buat file baru bernama Home.php:

<?php namespace App\Controllers;

class Home extends BaseController
{
public function index()
{
return view('welcome_message');
}
}
?>

Controller ini akan menampilkan halaman default welcome_message ketika diakses.

7. Membuat View Sederhana

Menghubungkan Controller dengan View

Buat file baru di folder app/Views/ dengan nama halo.php:

<h1>Halo, Selamat Datang di CodeIgniter 4! 🎉</h1>

Lalu ubah controller Home agar menampilkan view ini:

public function index() { return view('halo'); }

Buka browser dan akses http://localhost:8080. Kamu akan melihat pesan sapaan yang menandakan view telah berhasil terhubung 💡.

8. Mengatur Routing

Menentukan Arah Alur Halaman

Routing digunakan untuk mengarahkan URL ke controller yang sesuai. Buka file app/Config/Routes.php dan ubah baris berikut:

$routes->get('/', 'Home::index');

Kamu bisa menambahkan route lain, misalnya:

$routes->get('/about', 'Page::about'); $routes->get('/contact', 'Page::contact');

Dengan begitu, struktur navigasi situs kamu lebih fleksibel 🧭.

9. Testing Aplikasi

Memastikan Instalasi Berhasil

Setelah semua konfigurasi dilakukan, lakukan uji coba dengan langkah berikut:

✅ Jalankan server dengan php spark serve
🌐 Akses http://localhost:8080
📄 Pastikan halaman tampil tanpa error

Jika semua berjalan dengan lancar, instalasi dan konfigurasi CodeIgniter 4 kamu sudah berhasil 🎯.

10. Tips Optimalisasi Awal

Meningkatkan Performa CodeIgniter

🧹 Hapus file dan folder yang tidak diperlukan
🔐 Gunakan environment production untuk proyek yang sudah live
📦 Manfaatkan fitur cache untuk mempercepat halaman
🧰 Gunakan helper dan library bawaan CodeIgniter untuk efisiensi kode

FAQ (13 Pertanyaan Umum tentang Instalasi CodeIgniter 4)

Apa itu CodeIgniter 4? Framework PHP modern berbasis MVC yang cepat dan ringan.
Apakah CodeIgniter 4 bisa dijalankan tanpa Composer? Bisa, dengan cara instalasi manual.
Bagaimana cara menjalankan server lokal? Gunakan perintah php spark serve.
Di mana lokasi file konfigurasi utama? Di file .env dan app/Config.
Apakah CodeIgniter 4 mendukung MySQL? Ya, sepenuhnya mendukung MySQL dan database lain.
Bagaimana mengatur Base URL? Edit variabel app.baseURL di file .env.
Apakah perlu menggunakan Apache? Tidak wajib, bisa juga menggunakan PHP built-in server.
Bagaimana cara menampilkan view? Gunakan fungsi return view('nama_view');.
Apakah bisa membuat REST API? Bisa, CodeIgniter 4 mendukung REST API dengan mudah.
Apakah mendukung template engine? Ya, bisa menggunakan parser atau Blade engine.
Bagaimana cara membuat model? Buat class di folder app/Models.
Apa fungsi folder writable? Untuk menyimpan log, cache, dan file upload.
Apakah CodeIgniter 4 open-source? Ya, framework ini open-source dan gratis 🎉.

Kesimpulan

Instalasi dan konfigurasi CodeIgniter 4 sangat sederhana ⚡. Dengan dukungan Composer dan sistem modular, framework ini menjadi pilihan ideal untuk membangun aplikasi web yang efisien, cepat, dan mudah dikembangkan.

Setelah tahap ini, kamu sudah siap melangkah ke tahap selanjutnya: membangun aplikasi CRUD, autentikasi, atau API menggunakan CodeIgniter 4 🚀.