Site icon SUSANTOKUN

PHP Fiber: Konkurensi Kooperatif Tanpa Ekstensi

Selama bertahun-tahun, konkurensi di PHP berarti salah satu dari dua pilihan: menambah ekstensi seperti Swoole, atau menulis ulang logika jadi rangkaian callback yang saling memanggil. Sejak PHP 8.1 ada jalur ketiga yang jauh lebih santai: PHP Fiber. Fiber membuat sebuah fungsi bisa dijeda di tengah jalan — bahkan dari dalam fungsi yang bersarang cukup dalam — lalu dilanjutkan lagi nanti, sementara kode tetap ditulis berurutan seperti biasa.

Artikel ini membahas cara kerja Fiber, API-nya, contoh scheduler sederhana, dan batasan yang bikin banyak orang salah pakai. Semua contoh butuh PHP 8.1 ke atas; versi stabil terbaru saat artikel ini ditulis adalah PHP 8.5.12.

Apa Itu Fiber, Sebenarnya

Dokumentasi resmi menyebut Fiber sebagai full-stack, interruptible functions. Artinya seluruh tumpukan panggilan milik fiber bisa dihentikan sementara, bukan cuma satu fungsi. Kalau di dalam fiber kamu memanggil A, A memanggil B, lalu B memanggil Fiber::suspend(), yang berhenti adalah fiber secara keseluruhan. Saat di-resume, eksekusi lanjut di baris itu dengan variabel lokal masih utuh.

Yang penting: pemanggil tidak perlu tahu apa-apa. Fungsi yang memanggil Fiber::suspend() tidak mengubah tipe kembaliannya. Beda mendasar dengan Generator, yang hanya bisa dijeda lewat yield di dalam fungsinya sendiri dan memaksa return type jadi Generator.

Satu hal yang sering bikin kecewa: Fiber bukan paralelisme. Tidak ada thread baru dan tidak ada CPU core tambahan. Semua fiber hidup di satu proses PHP, dan hanya satu yang benar-benar berjalan pada satu waktu. Yang kamu dapat adalah konkurensi kooperatif — tugas bergantian secara sukarela, bukan dipotong paksa oleh sistem operasi.

Fiber vs Generator vs Proses Paralel

Praktisnya, Fiber adalah bahan bangunan. Yang kamu pakai sehari-hari biasanya library yang membungkusnya.

API Fiber yang Perlu Dihafal

Kelas Fiber bersifat final dan ada sejak PHP 8.1.0. Permukaannya kecil: konstruktor dengan satu callable, lalu start(), resume(), throw(), getReturn(), empat pengecek status (isStarted(), isSuspended(), isRunning(), isTerminated()), plus statis suspend() dan getCurrent().

<?php

$fiber = new Fiber(function (string $nama): string {
    echo "Mulai untuk {$nama}\n";
    $balasan = Fiber::suspend('menunggu data');
    echo "Lanjut dengan: {$balasan}\n";
    return 'selesai';
});

$nilai = $fiber->start('Anto');   // "Mulai untuk Anto", $nilai = 'menunggu data'
echo $nilai, "\n";

$fiber->resume('data siap');      // "Lanjut dengan: data siap"
var_dump($fiber->isTerminated()); // true
echo $fiber->getReturn(), "\n";   // "selesai"

Perhatikan alurnya. start() menjalankan fiber sampai suspend() pertama dan mengembalikan argumen yang dikirim ke sana. Sebaliknya, argumen resume() menjadi nilai kembalian suspend() di dalam fiber. Komunikasinya dua arah, tanpa globals atau closure tambahan.

Melempar Exception ke Dalam Fiber

Selain mengirim nilai, kamu bisa menyuntikkan exception lewat throw(). Exception itu muncul di titik Fiber::suspend() yang sedang menunggu, sehingga blok try/catch di dalam fiber bisa menanganinya seperti exception biasa.

<?php

$job = new Fiber(function (): string {
    try {
        Fiber::suspend('siap');
        return 'tidak akan sampai sini';
    } catch (RuntimeException $e) {
        return 'ditangkap: ' . $e->getMessage();
    }
});

$job->start();
$job->throw(new RuntimeException('koneksi putus'));
echo $job->getReturn(); // ditangkap: koneksi putus

Ini penting untuk produksi: kegagalan jaringan bisa dikirim balik ke dalam fiber seolah fungsi IO yang melempar error, tanpa status khusus atau flag manual.

Memanggil resume() pada fiber yang tidak sedang dijeda — belum di-start() atau sudah selesai — melempar FiberError, kelas final turunan Error. Jangan asal resume dalam loop tanpa memeriksa isSuspended().

Membangun Scheduler Mini

Contoh paling jujur untuk memahami Fiber adalah scheduler round-robin. Setiap tugas dibungkus fiber, dan scheduler memutar semuanya sampai tidak ada yang tersisa. Di sini fungsi tiruan tunggu() berperan sebagai IO yang memanggil Fiber::suspend().

<?php

function tunggu(string $label, int $detik): void
{
    echo "[tunggu] {$label} {$detik}s\n";
    Fiber::suspend($label);
}

function tugas(string $nama, int $langkah): string
{
    for ($i = 1; $i <= $langkah; $i++) {
        tunggu("{$nama} langkah {$i}", 1);
    }
    return "{$nama} beres";
}

$fibers = [
    new Fiber(fn () => tugas('unduh', 2)),
    new Fiber(fn () => tugas('parse', 3)),
    new Fiber(fn () => tugas('simpan', 1)),
];

foreach ($fibers as $f) {
    $f->start();
}

while (true) {
    $aktif = array_filter($fibers, fn (Fiber $f) => $f->isSuspended());
    if ($aktif === []) {
        break;
    }
    foreach ($aktif as $f) {
        $f->resume();
    }
}

foreach ($fibers as $f) {
    echo $f->getReturn(), "\n";
}

Outputnya memperlihatkan ketiga tugas saling menyela: unduh, parse, simpan, lalu kembali ke unduh. Yang membuat ini bekerja adalah kesepakatan bahwa setiap titik tunggu memanggil Fiber::suspend(). Kalau ada satu fungsi memakai sleep() asli, seluruh scheduler ikut membeku.

Batasan yang Sering Disalahpahami

Kapan Sebaiknya Dipakai

Fiber paling berguna saat kamu menulis library yang ingin dipakai dengan dua gaya sekaligus: pemanggil menulis alur berurutan, sementara di belakang layar eksekusinya dijeda menunggu IO. Pola inilah yang membuat library async modern terasa sinkron.

Fiber juga masuk akal untuk membungkus proses bertahap yang butuh jeda di antara langkah, misalnya pipeline ETL yang menarik data per batch. Kalau kamu mengerjakan hal seperti ini di Laravel, kombinasikan dengan antrean yang sudah matang; Laravel Horizon memberi dashboard dan pengaturan worker yang lebih aman daripada scheduler buatan sendiri.

Sebaliknya, jangan pakai Fiber untuk kerja berat CPU seperti hashing massal, kompresi, atau olahan gambar — konkurensi kooperatif tidak menambah throughput di situ. Pindahkan ke worker atau job queue.

Fiber di Ekosistem Nyata

Yang membuat Fiber berguna di praktik adalah event loop. revolt/event-loop — paket rock-solid event loop for concurrent PHP applications — berdiri di atas Fiber dan mensyaratkan PHP 8.1 atau lebih baru. Versi yang tercatat di Packagist saat artikel ini ditulis adalah 1.1.0-RC1, dengan rilis stabil terakhir 1.0.9.

Di atasnya ada amphp/amp 3.1.3, framework konkurensi non-blocking yang membutuhkan revolt/event-loop versi ^1 || ^0.2. Di sinilah Fiber terasa manfaatnya: kode Amphp ditulis berurutan, tetapi dijeda otomatis saat menunggu IO. Artikel Property Hooks PHP 8.4 dan fitur baru PHP 8.5 membahas pola serupa dari sisi sintaks.

Catatan Produksi

Setiap fiber menyimpan tumpukan panggilan sendiri, jadi memorinya sebanding dengan kedalaman call stack. Membuat puluhan ribu fiber untuk tugas kecil bukan penghematan, melainkan cara cepat menghabiskan memori. Batasi jumlah tugas aktif atau pakai pool.

Timeout juga harus kamu pikirkan sendiri: tidak ada watchdog yang memotong fiber yang kelamaan menunggu, jadi scheduler-mu yang melacak waktu dan memutuskan kapan memanggil throw(). Tambahkan logging per perpindahan fiber, karena stack trace saat error menunjuk ke titik suspend(), bukan alur logis yang kamu bayangkan.

FAQ Singkat

Apakah Fiber membuat PHP jadi multi-thread?

Tidak. Fiber hanya menyimpan dan berpindah konteks eksekusi di dalam satu proses. Untuk benar-benar memakai beberapa core, kamu tetap butuh proses terpisah, worker, atau ekstensi khusus.

Bisakah Fiber dipakai di PHP 8.0?

Tidak bisa. Kelas Fiber tersedia sejak PHP 8.1.0, dan FiberError ikut di versi yang sama. Di PHP 8.0 atau lebih lama, satu-satunya jalan adalah Generator atau library berbasis callback.

Apa bedanya Fiber::suspend() dan yield?

yield hanya berlaku di dalam fungsi generator dan mengubah tipe kembaliannya. Fiber::suspend() bisa dipanggil dari fungsi mana pun di dalam fiber, tanpa mengubah signature pemanggilnya.

Kesimpulan

Fiber adalah fitur bahasa kecil yang mengubah cara library async ditulis di PHP. Kuncinya tiga: tumpukan panggilan penuh yang bisa dijeda, komunikasi dua arah lewat suspend() dan resume(), serta sifatnya yang sepenuhnya kooperatif. Di kode aplikasi biasa, kamu akan menikmatinya lewat library seperti Revolt dan Amphp. Tapi memahami mekanismenya membuat FiberError atau scheduler yang membeku jadi mudah dijelaskan, bukan misteri.

Referensi

Exit mobile version