Belajar Yii - Events, Behaviors & Extensions

#Pendahuluan

Di episode 2 kita menyebut event system dan behaviors sebagai fondasi — dan sejak episode 10 kalian sudah memakai behavior (TimestampBehavior, BlameableBehavior) tanpa memikirkan cara kerjanya. Sekarang saatnya membongkar mekanisme itu, karena begitu kalian memahaminya, kalian tidak lagi sekadar memakai Yii — kalian mulai memperpanjang Yii.

Di episode ini kita membahas tiga hal yang berlapis: events (sistem pemicu-reaksi), behaviors (cara menempelkan kode ke komponen), dan extensions (mengemas kemampuan itu menjadi package Composer yang bisa dipakai ulang dan dibagikan). Ini adalah garis antara "developer framework" dan "developer yang menggunakan framework".

#Event: Sinyal Antar Kode

Event adalah mekanisme longgar-terhubung: satu bagian aplikasi memicu kejadian, bagian lain mendengarkan dan bereaksi — tanpa saling tahu. Yii menyediakan event di setiap component:

use yii\db\ActiveRecord;
 
// mendengarkan event pada satu instance
$post = new Post();
$post->on(ActiveRecord::EVENT_AFTER_INSERT, function ($event) {
    Yii::info("Post baru dibuat: " . $event->sender->id, 'app\post');
});
 
// memicu dari dalam model
$this->trigger(ActiveRecord::EVENT_AFTER_INSERT);

$event->sender selalu merujuk object yang memicu event — jadi handler bisa membaca konteks tanpa referensi eksternal.

#Event Statis: Mendengarkan untuk Semua Instance

on() berlaku untuk satu instance. Untuk mendengarkan event dari semua instance sekaligus, gunakan Event::on — biasanya di bootstrap aplikasi:

<?php
 
use yii\base\Event;
use yii\db\ActiveRecord;
 
Event::on(Post::class, ActiveRecord::EVENT_AFTER_INSERT, function ($event) {
    /** @var Post $post */
    $post = $event->sender;
    Yii::$app->cache->delete('latest_posts');
});

Dengan handler global seperti ini, invalidasi cache berjalan otomatis untuk post apa pun yang dibuat di mana pun — tanpa menyentuh controller atau model. Inilah kekuatan event: cross-cutting concern dipasang sekali di satu tempat.

#Event Bawaan Active Record

Model AR memicu event di setiap tahap siklus hidupnya — inilah yang membuat behaviors di episode 10 bekerja:

Handler bisa membatalkan operasi dengan mengatur $event->isValid = false (seperti softDelete di episode 10).

#Behavior: Kode yang Menempel

Behavior adalah object yang me-reuse method dan event handler ke component yang dipasanginya — mirip trait, tapi dinamis: bisa dipasang/dilepas saat runtime, dan tidak mengubah class asli.

<?php
 
namespace app\behaviors;
 
use yii\base\Behavior;
 
class LoggableBehavior extends Behavior
{
    public string $logMessage = 'Aksi dilakukan';
 
    public function log(string $action): void
    {
        Yii::info("{$this->logMessage}: $action", 'app\audit');
    }
}

use app\behaviors\LoggableBehavior;
 
public function behaviors(): array
{
    return [
        [
            'class' => LoggableBehavior::class,
            'logMessage' => 'Post diakses',
        ],
    ];
}
 
// method behavior bisa dipanggil seperti method model
$post->log('view');

Method, properties, dan event handler yang dimiliki behavior menjadi milik component tempat ia dipasang. $post->log('view') berfungsi karena behavior terpasang. Inilah mengapa TimestampBehavior bisa mengisi created_at tanpa model mendeklarasikan apa pun: behavior tersebut menempelkan event handler ke EVENT_BEFORE_INSERT.

#Kapan Memakai Behavior vs Event vs Trait

#Membuat Extension Yii

Ketika suatu kemampuan sudah dipakai di banyak project, saatnya mengemasnya sebagai extension — package Composer yang bisa diinstall di project mana pun. Struktur extension Yii mengikuti standar Yii extension:

yii2-audit-log/
├── src/
│   ├── AuditBehavior.php
│   └── AuditTarget.php
├── tests/
├── composer.json
└── README.md

composer.json extension adalah kuncinya — Yii membaca konfigurasi dari properti khusus:

{
    "name": "vendor/yii2-audit-log",
    "description": "Audit log behavior untuk Yii 2",
    "type": "yii2-extension",
    "require": {
        "yiisoft/yii2": "~2.0.0",
        "php": ">=7.4"
    },
    "autoload": {
        "psr-4": {
            "vendor\\auditlog\\": "src/"
        }
    },
    "extra": {
        "bootstrap": "vendor\\auditlog\\Bootstrap"
    }
}

• type: yii2-extension memberi tahu Composer bahwa ini extension Yii.
• autoload.psr-4 memetakan namespace vendor\auditlog\ ke folder src/.
• extra.bootstrap adalah hook: class Bootstrap akan dijalankan otomatis saat aplikasi start (tempat memasang Event::on global).

#Bootstrap Extension

<?php
 
namespace vendor\auditlog;
 
use yii\base\Application;
use yii\base\BootstrapInterface;
use yii\base\Event;
use yii\db\ActiveRecord;
 
class Bootstrap implements BootstrapInterface
{
    public function bootstrap($app): void
    {
        Event::on(ActiveRecord::class, ActiveRecord::EVENT_AFTER_INSERT, function ($event) {
            AuditLog::record($event->sender);
        });
    }
}

Dengan BootstrapInterface, extension kalian "hidup" begitu terdaftar di config/web.php — tanpa user perlu memanggil apa pun.

#Publikasi dan Versioning

Untuk memakai extension antar project (tanpa publikasi publik), gunakan repository path di composer.json project:

"repositories": [
    {
        "type": "path",
        "url": "../yii2-audit-log"
    }
]

composer require vendor/yii2-audit-log:@dev

Untuk publikasi publik, push ke GitHub lalu daftarkan di Packagist — service yang menyediakan package Composer. Ikuti SemVer (2.0.0, 2.1.0 untuk fitur baru, 2.1.1 untuk bugfix) dan tulis README yang baik: instalasi, konfigurasi, contoh pemakaian.

#Praktik: Behavior + Event + Extension dalam Satu Alur

Satukan konsep dalam studi kasus nyata: extension audit log yang mencatat setiap perubahan model. User cukup memasang behavior:

<?php
 
namespace vendor\auditlog;
 
use yii\base\Behavior;
use yii\db\ActiveRecord;
 
class AuditBehavior extends Behavior
{
    public function events(): array
    {
        return [
            ActiveRecord::EVENT_AFTER_INSERT => 'recordInsert',
            ActiveRecord::EVENT_AFTER_UPDATE => 'recordUpdate',
            ActiveRecord::EVENT_AFTER_DELETE => 'recordDelete',
        ];
    }
 
    public function recordInsert($event): void
    {
        AuditLog::write($this->owner, 'insert');
    }
 
    public function recordUpdate($event): void
    {
        AuditLog::write($this->owner, 'update');
    }
 
    public function recordDelete($event): void
    {
        AuditLog::write($this->owner, 'delete');
    }
}

Pemasangan di model:

public function behaviors(): array
{
    return [
        \vendor\auditlog\AuditBehavior::class,
    ];
}

Sekarang setiap save/delete Order tercatat — behavior menempel, event menangkap, extension mengemas. Ketiga konsep bekerja sebagai satu ekosistem.

#Penutup

Inti yang harus dibawa pulang:

• Event: pemicu-reaksi longgar-terhubung; Event::on untuk handler global, trigger() untuk memicu.
• AR memicu event di setiap siklus hidup; handler bisa membatalkan via $event->isValid = false.
• Behavior: reusable method + event handler yang menempel ke component secara dinamis.
• Extension: package Composer type: yii2-extension dengan BootstrapInterface untuk hook otomatis.
• Publikasikan via Packagist dengan SemVer; mulai dari behavior internal, ekstrak setelah stabil.

Di episode 15 selanjutnya, kita menjadikan aplikasi kalian global: i18n & multilanguage — menerjemahkan pesan dengan Yii::t(), memformat tanggal, angka, dan mata uang sesuai locale, serta membuat aplikasi bilingual ID/EN dengan pemilihan bahasa dari URL. Sampai jumpa di episode 15!