Tutorial Codeigniter 4: Instalasi dan Persiapan Belajar Codeigniter 4

 

Sebelum mulai belajar Codeigniter 4 lebih, kita harus meyiapkan alat yang dibutuhkan untuk coding Codeigniter 4.

Apa Saja itu?

Persiapan Sebelum Belajar CI 4

Prasyarat belajar Codeigniter 4..

• Memahami basic bahasa pemrograman PHP. Silahkan, ikuti tutorial basic pemrograman PHP jika kamu belum menguasainya.
• Untuk bisa belajar Codeigniter dengan lancar setidaknya kamu sudah paham konsep pemrograman berorientasikan objek (OOP) dengan PHP.
• Memahami sintaks dasar SQL;

Nah, setelah prasyarat ini terpenuhi. Selanjutnya silahkan siapkan alat-alatnya untuk mulai belajar.

Berikut ini beberapa peralatan yang harus kamu siapkan di komputermu:

1. Teks Editor
2. Web Browser
3. Web Server: PHP, MySQL, Phpmyadmin
4. Composer
5. File Project Codeigniter

Mari kita siapkan satu-per-satu.

1. Teks Editor

Teks editor akan kita gunakan untuk menulis kode. Kamu bebas menggunakan teks editor apa saja untuk coding CI.

Saya merekomendasikan menggunakan VS Code, karena mudah digunakan dan punya banyak fitur.

Untuk menginstal VS Code, silahkan baca:

• Review dan Cara Install VS Code di Linux

2. Web Browser

Web browser akan kita gunakan untuk melihat hasil dari aplikasi. Kamu juga bebas menggunakan web browser apapun, asalkan masih mendukung teknologi web modern zaman sekarang.

Rekomendasi, gunakan Google Chrome atau Firefox.

3. Web Server

Codeigniter merupakan framework PHP, karena itu ia pasti membutuhkan web server. Berikut ini requirement server untuk Codeigniter 4:

• PHP Versi 7.2+
• MySQL Versi 5.1+
• Phpmyadmin

Jika kamu sudah menginstal XAMPP, maka ketiga aplikasi server ini sudah terpenuhi. Tapi jika kamu pengguna Linux, maka ini bisa diinstal satu-per-satu.

Silahkan baca:

• Cara Install XAMPP di Windows (recommended)
• Persiapan Pemrograman Web PHP di Linux (recommended)
• Cara Install XAMPP di Linux (alternatif)

Setelah menginstal webserver, kita harus mengaktifkan beberapa ekstension yang dibutuhkan untuk pengembangan CI 4.

Apa saja itu?

• php-json ekstension untuk bekerja dengan JSON;
• php-mysqlnd native driver untuk MySQL;
• php-xml ekstension untuk bekerja dengan XML;
• php-intl ekstensi untuk membuat aplikasi multibahasa;
• libcurl (opsional), jika ingin pakai Curl.

Silahkan install semuanya dengan perintah:

sudo apt install php-json php-mysqlnd php-xml php-intl libcurl

Untuk kamu yang menggunakan Windows dan XAMPP. Silahkan buka XAMPP Control Panel, lalu pada bagian apache klik Config->PHP.

Setelah itu, cari di bagian extension dan hapus ; yang ada di depan nama extension untuk mengaktifkannya.

4. Composer

Composer adalah program berbasis command line (CLI) untuk menajemen proyek PHP. Tugas dari composer adalah melakukan instalasi paket, membuat proyek baru, menjalankan script, dan lain-lain.

Silahkan install Composer dengan perintah berikut:

apt install composer

Jika kamu ingin belajar tentang composer lebih lanjut, silahkan baca:

• Cara Menggunakan Composer untuk Manajemen Proyek PHP

O ya, di sana juga ada penjelasan tentang cara installComposer di Windows.

5. File Project Codeigniter

File project Codeigniter dapat di-download di website resmi Codeigniter. Nanti kita akan mendapatkan file berupa ZIP. File inilah yang akan kita gunakan untuk mulai membuat proyek Codeigniter.

File project ini juga dapat kita download dengan composer.

Silahkan ikuti:

Install CI 4 dengan Composer

Untuk menginstal CI 4 dengan composer, silahkan ketik perintah berikut.

composer create-project codeigniter4/appstarter ci-news -vvv

Tungulah sampai prosesnya selesai.

Ada beberapa argumen yang kita berikan pada perintah ini:

• create-project adalah perintah untuk membuat proyek baru dengan composer;
• codeigniter4/appstarter adalah file CI yang akan di-download;
• ci-news adalah nama proyek yang akan kita buat;
• -vvv berfungsi untuk melihat proses install lebih detail.

Setelah prosesnya selesai, kita akan mendapatkan folder baru dengan nama ci-news.

buka folder ci-news dengan teks editor VS Code.

Setelah itu buka terminal dengan menekan Ctrl+` dan jalankan perintah:

composer install -vvv

Perintah ini akan menginstal semua library yang dibutuhkan CI 4.

Setelah selesai, coba ketik perintah:

php spark serve

Perintah ini akan menjalankan server CI 4 pada port 8080.

Coba buka web browser dan arahkan ke alamat http://localhost:8080, maka hasilnya:

Selamat. 👏👏👏

CI 4 sudah berhasil diinstal.

Selanjutnya kita tinggal mulai coding.

Install CI 4 dengan Cara Manual

Nah, buat kamu yang ingin menginstal CI4 dengan cara manual, tanpa harus melalui Composer, bisa ikuti cara ini.

Langkah-langkah yang harus dilakukan:

1. Download Codeigniter;
2. Ekstrak File ZIP Codeigniter ke htdocs.

Silahkan buka website Codeigniter untuk mendownload.

Note: Biar versi CI4 sama dengan versi yang digunakan pada tutorial ini, yakni 4.0.4.. silahkan Download CI dari link ini.

Kita akan mendapatkan sebuah file zip 📦 framework-4.x.x.zip, ekstrak file tersebut ke dalam c:\xampp\htdocs (XAMPP) atau /var/www/html (di Linux).

Setelah itu, ubah nama framework-4.x.xx menjadi ci-news.

Sekarang coba buka web browser dan buka alamat: http://localhost/ci-news/public/.

Jiak hasilnya kosong atau blank, maka kita harus melakukan install library yang dibutuhkan.

Silahkan buka folder ci-news dengan Visual Studio Code, lalu buka terminal dan ketik perintah berikut.

composer install -vvv

Perintah ini akan menginstal semua library yang dibutuhkan CI 4.

Setelah itu, ubah kepemilikan dari folder writable dengan perintah berikut ini:

sudo chown -Rv www-data writable/

Note: ini khusus di Linux

Setelah selesai, coba buka kembali http://localhost/ci-news/public/, maka hasilnya:

Selamat. 👏👏👏

CI 4 sudah berhasil diinstal.

Selanjutnya kita tinggal mulai coding.

Biar Enak, Hidupkan Mode Debugging

CI4 menyediakan fitur debugging yang cukup bagus. Ini sama seperti profiler pada CI3.

Secara default, fitur ini belum aktif. Jika ada error pada aplikasi, maka ia akan menampilkan pesan Whoops! seperti ini:

Kita tidak akan bisa tahu tempat masalahnya jika aplikasi cuma menampilkan ini. Cocoknya ini dipakai pada aplikasi production.

Nah, untuk mengaktifkan mode debugging, kita harus mengubah environment variabel CI_ENVIRONMENT menjadi development.

Silahkan buka file env, kemudian cari variabel CI_ENVIRONMENT dan ubahlah nilainya menjadi development.

Setelah itu, ubah nama file env menjadi .env (tingga tambah titik di depan).

Sekarang, coba buat sebuah kesalahan. Misalnya, saya menghapus titik koma pada controller Home.

Lalu buka kembali aplikasinya.

Maka hasilnya:

Nah, dengan begini.. kita bisa debug aplikasi dengan lebih mudah. CI akan ngasih tahu, di mana letak error-nya.

Nanti, setelah kita selesai mengembangkan aplikasi. Ubah kembali CI_ENVIRONTMENT menjadi production.

Membuat Virutal Host Domain

Ini boleh kamu lakukan dan boleh juga tidak.

Buat kamu yang menginstal CI4 secara manual di htdocs, ada baiknya membuatkan virtual host agar memudahkan dalam proses development.

Virtual host adalah alamat khusus yang kita buat di localhost untuk mengakses aplikasi.

Pada contoh di atas, kita membuka aplikasi melalui http://localhost/ci-news/public/.

Nah, dengan virtual host, kita bisa membukanya melalui cinews.test.

Nama domain yang digunakan terserah kita, bisa .com, .net, .web, dan sebagainya.

Tapi..

Biar tidak membingungkan dan bentrok dengan domain yang sudah ada di internet, kita berikan domain .test atau .local saja.

Biaklah, langkah-langkah berikut:

Membuat Virtual Host di Linux

Untuk kamu pengguna Linux atau Mac, bisa mengikuti cara berikut. Silahkan buka Terminal lalu ketik.

sudo cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/cinews.test.conf

Perintah ini akan melakukan copy dari konfigurasi default host apache.

Setelah itu, buka file cinews.test.conf dengan tekes editor. Ketik perintah berikut:

sudo nano /etc/apache2/sites-available/cinews.test.conf

Lalu ubah isinya menjadi seperti ini:

<VirtualHost *:80>
    ServerAdmin admin@cinews.test
    ServerName cinews.test
    ServerAlias www.cinews.test
    DocumentRoot /var/www/html/ci-news/public
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Setelah itu, tekan Ctrl+x lalu pilih y untuk menyimpan.

Berikutnya, buka file /etc/hosts ketik perintah berikut:

sudo nano /etc/hosts

Setelah itu, tambahkan:

127.0.0.1 cinews.test

Ini akan menjadi alamat domain yang akan kita pakai. Kamu juga bisa menggantinya dengan yang lain.

Setelah itu, simpan dengan menekan Ctrl+x lalu pilih y.

Berikutnya, kita harus mengaktifkan konfigurasi site apache yang sudah dibuat. Silahkan ketik perintah berikut:

sudo a2ensite cinews.test.conf

Terakhir, restart server dengan perintah berikut:

sudo service apache2 restart

…dan coba buka alamat cinews.test dari web browser.

Membuat Virtual Host di Windows

Untuk kamu yang menggunakan XAMPP di Windows, berikut ini cara membuat virtual host.

Silahkan buka windows explorer, lalu masuk ke folder C:/xampp/apache/conf/extra.

Setelah itu, buka file httpd.vshosts.conf dengan Notepad atau Notepad++.

Selanjutnya tambahkan kode berikut ini pada file httpd-vhosts.conf:

<VirtualHost *:80>
    ServerAdmin admin@cinews.test
    ServerName cinews.test
    ServerAlias www.cinews.test
    DocumentRoot "c:\xampp\htdocs\ci-news\public"
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
    <Directory "c:\xampp\htdocs\ci-news\public"></Directory>
</VirtualHost>

Setelah itu, tekan Windows+r, lalu masukkan..

C:\Windows\System32\drivers\etc\hosts

pada kolom Open.

Tambahkan kode berikut:

127.0.0.1 cinews.test

Setelah itu simpan, dan restart server apache.

Sekarang coba buka browser dan arahkan ke alamat beritacoding.test, maka hasilnya:

Troubleshooting..

Saya yakin ada beberapa diantara kamu yang akan mendapatkan masalah saat install Codeigniter 4. Berikut ini beberapa masalah yang sering ditemukan.

Tidak bisa menjalankan server

Saat menjalankan server dengan perintah php spark serve muncul pesan error seperti ini:

PHP Warning:  require(/app/Config/../../vendor/codeigniter4/framework/system/bootstrap.php): failed to open stream: No such file or directory in /home/dian/Playground/ci-playground/ci-news/spark on line 44

Contoh:

Kalau kita lihat, perintah ini akan mencari file di folder vendor. Folder ini adalah folder yang berisi library yang diinstal dengan composer.

✅ Solusi:

Lakukan install dengan perintah

composer install -vvv

Argumen -vvv berfungsi untuk melihat proses instalasi lebih detail.

Tunggulah sampai prosesnya selesai..

..dan akan ada folder vendor di proyek kita.

Tidak bisa melakukan install

Saat melakukan install dengan perintah composer install, muncul pesan seperti ini:

codeigniter4/framework v4.0.4 requires ext-intl * -> the requested PHP extension intl is missing from your system
Installation request for codeigniter4/framework ^4 -> satisfiable by codeigniter4/framework[4.0.0, v4.0.1, v4.0.2, v4.0.3, v4.0.4].

Ini artinya ekstensi ext-intl belum terinstal

✅ Solusi:

Instal ekstensi tersebut dengan perintah:

sudo apt install php-intl

Setelah itu, coba jalankan lagi composer install

Apa Selanjutnya?

Pada tahapan ini, kita sudah berhasil membuat proyek baru Codeigniter. Baik itu dengan composer, maupun install secara manual ke htdocs.

Kamu lebih suka cara yang mana?

Kalau saya, lebih suka yang pakai Composer, karena lebih praktis.

Berikutnya, silahkan pelajari tentang:

➡️ Tutorial Codeigniter 4 #03: Memahami Konsep MVC di CI 4 (Coming Soon)