Tutorial CodeIgniter 4: Persiapan & Fondasi Lingkungan Kerja

Terakhir diperbarui: 27 Agu 2026

In a nutshell: "Bab 1 membimbing Anda menyiapkan lingkungan pengembangan lokal (PHP 8.1+, Composer, MySQL), menginstal CodeIgniter 4 via Composer melalui langkah berurutan, mengkonfigurasi file .env, memahami struktur folder CI4 melalui diagram alur, serta mengatasi kendala troubleshooting umum seperti error ekstensi PHP intl."

Direct Answer: Persiapan lingkungan kerja CodeIgniter 4 membutuhkan PHP >= 8.1 dengan ekstensi intl, mbstring, dan mysqli. Metode instalasi standar industri adalah menggunakan Composer (composer create-project codeigniter4/appstarter ci4-app), disusul pengaktifan file .env untuk CI_ENVIRONMENT = development, app.baseURL, dan koneksi database MySQL.

1. Persyaratan Sistem & Lingkungan Pengembangan PHP 8

Sebelum memulai instalasi CodeIgniter 4 (CI4), pastikan komputer atau server lokal Anda telah memenuhi spesifikasi teknis minimum berikut:

Verifikasi kesiapan PHP dan Composer di terminal command line Anda:

# 1. Cek versi PHP
php -v

# 2. Cek ketersediaan ekstensi intl dan mbstring
php -m | grep -E "intl|mbstring|mysqli"

# 3. Cek versi Composer
composer --version

2. Panduan Instalasi CodeIgniter 4 via Composer untuk Pemula

Menggunakan Composer merupakan metode instalasi resmi yang direkomendasikan karena mempermudah pembaruan framework dan manajemen dependensi library eksternal secara otomatis.

Berikut eksekusi perintah lengkap di terminal:

# Menjalankan instalasi skeleton project CI4 bernama ci4-stok-barang
composer create-project codeigniter4/appstarter ci4-stok-barang

# Pindah ke direktori project
cd ci4-stok-barang

3. Konfigurasi Awal File .env & Koneksi Database MySQL

CodeIgniter 4 menggunakan file .env berbasis dotenv untuk membedakan konfigurasi antara mode pengembangan (local) dan server produksi (production).

# Linux & macOS
cp env .env

# Windows Command Prompt
copy env .env

Buka file .env di code editor (seperti VS Code), kemudian sesuaikan baris kunci berikut:

# 1. Aktifkan Mode Development (Menampilkan Error Lengkap & CodeIgniter Toolbar)
CI_ENVIRONMENT = development

# 2. Tentukan Base URL Aplikasi
app.baseURL = 'http://localhost:8080/'

# 3. Kredensial Database MySQL Lokal
database.default.hostname = localhost
database.default.database = ci4_stok_db
database.default.username = root
database.default.password = 
database.default.DBDriver = MySQLi
database.default.DBPrefix =
database.default.port = 3306

4. Anatomi & Struktur Folder CodeIgniter 4 Lengkap

CodeIgniter 4 menerapkan pemisahan direktori tingkat lanjut demi keamanan aplikasi. Folder publik yang diakses oleh web browser dipisahkan dari folder kode inti framework dan konfigurasi sensitif.

• 📁 app/: Pusat seluruh logika aplikasi Anda, memuat sub-folder Controllers, Models, Views, Entities, Filters, Database/Migrations, dan Config.
• 📁 public/: Dokumen web root publik. Hanya direktori ini yang boleh diakses publik oleh web server. Berisi index.php, file CSS, JavaScript, aset gambar, dan .htaccess.
• 📁 writable/: Direktori dengan hak akses tulis untuk penyimpanan file cache, session user, berkas upload sementara, dan log debugging (writable/logs/).
• 📁 system/: Kode inti framework CodeIgniter 4. Folder ini tidak boleh diubah manual agar aplikasi mudah di-upgrade.
• 📁 vendor/: Berisi pustaka dependensi Composer dan autoloader PSR-4.
• 📄 spark: Skrip CLI pembantu (Spark) untuk menjalankan server lokal, generator controller/migration, dan eksekusi task otomasi.

5. Panduan Troubleshooting Error CodeIgniter 4 yang Sering Dialami Pemula

Berikut adalah solusi praktis untuk kendala dan pesan error yang paling sering dialami saat pertama kali menginstal dan menjalankan CodeIgniter 4:

1. Penanganan Error Ekstensi PHP intl (The intl extension is required)

Gejala Error: Muncul pesan "CodeIgniter\Exceptions\FrameworkException: The framework needs the following extension(s) to be installed and loaded: intl" saat menjalankan aplikasi.

Solusi:

1. Pada Windows (XAMPP / Laragon): Buka file php.ini (melalui Control Panel XAMPP → Config → PHP (php.ini)), cari baris ;extension=intl, lalu hilangkan tanda titik koma (;) di depannya menjadi extension=intl. Simpan file lalu Restart Apache.
2. Pada Ubuntu / Debian Linux: Jalankan perintah di terminal: sudo apt install php-intl (atau sesuaikan versi: sudo apt install php8.1-intl atau sudo apt install php8.2-intl), lalu restart web server: sudo systemctl restart php8.1-fpm apache2.

2. Penanganan Error Permission Folder writable/ (Directory is not writable)

Gejala Error: Muncul pesan "CriticalException: The writable directory does not appear to be writable".

Solusi: Di lingkungan Linux atau macOS, pastikan direktori writable memiliki izin tulis yang cukup untuk user web server (misal: www-data):

# Memberikan izin kepemilikan dan permission tulis ke folder writable
chmod -R 775 writable
sudo chown -R www-data:www-data writable

3. Penanganan Error Port 8080 Bentrok pada Spark Server

Gejala Error: Muncul pesan "Failed to listen on localhost:8080 (reason: Address already in use)" saat menjalankan php spark serve.

Solusi: Tentukan port alternatif kustom menggunakan opsi --port:

php spark serve --port 8081

4. Penanganan Composer Memory Limit & SSL Issue

Gejala Error: Composer mengalami memory exhausted saat men-download paket.

Solusi: Jalankan Composer dengan menaikkan alokasi batas memori secara dinamis:

COMPOSER_MEMORY_LIMIT=-1 composer create-project codeigniter4/appstarter ci4-stok-barang

6. Menjalankan Server Lokal & Menggunakan CodeIgniter Debug Toolbar

Jalankan server pengembangan lokal bawaan CodeIgniter 4:

php spark serve

Buka peramban web dan navigasikan ke alamat http://localhost:8080. Anda akan disambut halaman selamat datang resmi CodeIgniter 4. Di pojok kanan bawah, Anda dapat mengklik Debug Toolbar untuk memantau performa timeline eksekusi, query SQL database yang berjalan, riwayat request HTTP, serta memori RAM yang digunakan.

7. Pertanyaan Umum Seputar Instalasi CodeIgniter 4 (FAQ)