Belajar Yii - Pre-Requisites Skill & Setup Environment

#Pendahuluan

Selamat datang di series Belajar Yii! Series ini akan membawa kalian menguasai Yii — framework PHP berperforma tinggi berbasis MVC dengan Active Record, Gii (code generator), dan keamanan built-in — untuk membangun aplikasi bisnis, admin panel, dan aplikasi enterprise. Total ada 27 episode yang tersusun dalam enam fase, dari fondasi konsep sampai production readiness.

Sebelum menjalankan composer create-project yiisoft/yii2-app-basic, ada skill dasar dan perangkat yang wajib kalian siapkan. Mengapa prasyarat ini penting? Karena Yii adalah framework yang berjalan di atas prinsip PHP modern: ia mengandalkan namespace dan autoloading untuk memetakan class, Composer untuk mengelola dependensi, serta Active Record yang menerjemahkan tabel database menjadi object PHP. Tanpa memahami lapisan-lapisan ini, kalian akan kesulitan membaca kode framework atau mendiagnosis error yang muncul.

Episode 0 ini adalah peta jalan kalian: kita akan memastikan skill dasar terpenuhi, menyiapkan PHP, Composer, database, dan editor, lalu memverifikasi environment untuk pertama kali. Setelah episode ini selesai, seluruh series bisa diikuti dengan nyaman.

#Skill Dasar yang Wajib Dimiliki

#PHP OOP: Namespace, Class, Interface, dan Trait

Yii adalah framework OOP murni. Hampir semua yang kalian sentuh — model, controller, component — adalah class PHP dengan namespace. Kalian wajib nyaman dengan namespace (karena seluruh kode app hidup di app\...), autoloading (bagaimana Composer menghubungkan nama class ke file), serta perbedaan interface (kontrak) dan trait (bagian kode yang dipakai ulang).

<?php
 
namespace app\models;
 
use yii\db\ActiveRecord;
 
class Post extends ActiveRecord
{
    public static function tableName(): string
    {
        return 'posts';
    }
}

Perhatikan use yii\db\ActiveRecord: di sinilah autoloading bekerja. Nama app\models\Post dipetakan oleh Composer ke file models/Post.php — tanpa pemahaman ini, error class not found akan terasa seperti teka-teki yang tidak bisa dipecahkan.

#Composer sebagai Dependency Manager

Composer adalah kunci ekosistem PHP — analog dengan npm untuk Node.js. Yii sendiri diinstall melalui Composer, dan seluruh dependensi (framework inti, package pihak ketiga seperti yii2-queue, yii2-redis) dikelola di composer.json dan composer.lock. Kalian wajib paham tiga perintah inti:

composer install            # install dependensi dari composer.lock
composer update             # update ke versi terbaru sesuai constraint
composer require vendor/pkg # tambah dependensi baru

composer install di production harus memakai --no-dev dan --optimize-autoloader — detail lengkapnya kita bahas di episode 22.

#Dasar SQL dan Konsep MVC

Active Record memang menyembunyikan SQL, tapi kalian wajib paham relasi tabel, primary/foreign key, dan dasar SQL seperti SELECT, INSERT, UPDATE, DELETE. Bayangkan Active Record sebagai asisten: ia menuliskan SQL untuk kalian, tapi jika kalian tidak paham relasi database, kalian tidak akan tahu query apa yang seharusnya dihasilkan — dan bakal kebingungan saat query berjalan lambat.

Selain itu, pahami MVC: Model (data + logika bisnis), View (tampilan), Controller (penghubung request ke model dan view). Yii menegakkan pola ini dengan tegas lewat struktur folder models/, views/, controllers/ — kita bedah penuhnya di episode 2 dan 4.

#Perangkat Software yang Disiapkan

#PHP 8.2+ (Yii3) atau PHP 7.4+ (Yii2)

Series ini berjalan dalam dua dunia: Yii2 sebagai target utama kita (mature, ekosistem terbesar, banyak dipakai di production) dan Yii3 yang akan kita bedah di episode 23 dan 25. Syarat versi PHP-nya berbeda:

• Yii2: minimal PHP 7.4, tapi rekomendasi kuat PHP 8.2+ agar performa dan kompatibilitas ekstensi optimal.
• Yii3: wajib PHP 8.2+ — bukan saran, tapi prasyarat mutlak.

Cek versi kalian:

php -v
composer --version

Jika belum ada, install lewat package manager distro kalian (Ubuntu: sudo apt install php8.3-cli php8.3-mbstring ...), atau lewat manajer PHP modern seperti FrankenPHP / phpbrew / package manager sesuai OS. Pastikan juga ekstensi PHP wajib aktif: pdo, pdo_mysql, mbstring, openssl, tokenizer, xml, curl, dan fileinfo.

#Composer 2.x

Install Composer global sekali:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer --version

#Database

Untuk praktik, siapkan salah satu dari SQLite (tanpa server, paling mudah untuk lab), MySQL/MariaDB, atau PostgreSQL. MySQL/PostgreSQL akan menjadi target utama mulai episode 6 (migrations), jadi idealnya install yang salah satu langsung. Kalian bisa menyiapkannya bertahap.

#Editor

Yii sangat diuntungkan editor dengan IntelliSense PHP yang kuat. VS Code dengan ekstensi PHP Intelephense adalah kombinasi paling umum, ditambah ekstensi untuk PHP Namespace Resolver (auto-import use). Ini bukan sekadar kenyamanan — navigasi "Go to Definition" ke kode framework sangat membantu saat debugging.

#Verifikasi Environment

Sebelum lanjut ke episode 1, jalankan verifikasi menyeluruh:

php -v
composer --version
php -m | grep -E "pdo|mbstring|openssl|tokenizer|xml|curl"

php -v harus menampilkan versi 7.4 ke atas (idealnya 8.2+), composer --version menampilkan Composer 2.x, dan ekstensi wajib di atas harus muncul di daftar module. Jika ada yang hilang, install ekstensinya dulu — tanpa pdo, Yii tidak bisa terhubung ke database.

#Ringkasan Prasyarat

Rangkuman yang sudah kalian siapkan di episode 0:

• Skill PHP: OOP (class, interface, trait), namespace, dan use.
• Skill database: relasi tabel, foreign key, dan SQL dasar.
• Skill konsep: MVC — model, view, controller.
• Runtime: PHP 7.4+ (rekomendasi 8.2+), Composer 2.x, dan satu database (SQLite cukup untuk awal).
• Editor: VS Code + Intelephense (atau editor PHP lain yang kalian nyaman).
• Verifikasi: php -v, composer --version, dan cek ekstensi semua lolos.

Jika ada yang belum terpenuhi, berhenti dulu dan lengkapi sebelum melanjutkan. Perjalanan 26 episode ke depan akan jauh lebih lancar dengan pijakan yang kuat ini.

#Penutup

Inti yang harus dibawa pulang:

• Yii memakai OOP, namespace, dan Composer sebagai fondasi — kuasai ketiganya.
• Yii2 butuh PHP 7.4+, sedangkan Yii3 butuh PHP 8.2+.
• SQLite cukup untuk episode awal; MySQL/PostgreSQL menyusul mulai episode 6.
• Verifikasi environment dengan php -v dan composer --version sebelum praktik.

Di episode 1 selanjutnya kita akan membahas sejarah, latar belakang, dan mengapa kalian membutuhkan Yii — dari lahirnya sebagai proyek Qiang Xue pada 2008 dengan nama "Yes It Is", evolusi Yii 1.1 → Yii 2.0 (2014) → Yii3 (31 Desember 2025), dan alasan di tahun 2026 Yii masih menjadi pilihan kuat untuk aplikasi enterprise. Pastikan environment kalian sudah siap, karena perjalanan Belajar Yii baru saja dimulai!