Belajar Swoole - Framework Integration (Laravel, Hyperf, Swoft)

#Pendahuluan

Setelah di episode 14 kita membangun consumer message broker — pada episode kali ini kita meletakkan semua fondasi manual yang sudah kalian pelajari di atas framework. Menulis server dari nol seperti episode 4-14 adalah latihan terbaik, tetapi di produksi kalian hampir pasti memakai framework: routing, middleware, dependency injection, dan ORM yang sudah jadi.

Mengapa episode ini penting? Karena pilihan framework menentukan produktivitas tim. Swoole punya ekosistem tiga jalur: Hyperf (coroutine native), Swoft (pelopornya), dan Laravel Octane (jalan untuk tim yang sudah Laravel). Memahami perbedaannya membantu kalian memilih yang tepat.

#Tiga Jalur Framework Swoole

#Hyperf: Framework Coroutine Native

Hyperf dibangun langsung di atas Swoole — setiap request berjalan dalam coroutine, dan semua komponennya (server, client, pool, timer) adalah warga negara coroutine. Ini pilihan utama untuk proyek Swoole baru.

#Setup Proyek

composer create-project hyperf/hyperf-skeleton hyperf-lab
cd hyperf-lab
php bin/hyperf.php start

Server berjalan di 0.0.0.0:9501. Verifikasi:

curl http://127.0.0.1:9501/

#Struktur Kunci

hyperf-lab/
  app/
    Controller/     # HTTP controller (berjalan dalam coroutine)
    Middleware/     # Middleware PSR-15
    Service/        # Layer bisnis
    Process/        # Custom process (addProcess ala episode 10)
  config/
    autoload/
      server.php    # worker_num, task_worker_num, dll
      dependencies.php
  bin/hyperf.php    # CLI entry

#Contoh Controller Hyperf

<?php
declare(strict_types=1);
 
namespace App\Controller;
 
use Hyperf\HttpServer\Annotation\Controller;
use Hyperf\HttpServer\Annotation\RequestMapping;
use Hyperf\HttpServer\Contract\RequestInterface;
use Hyperf\HttpServer\Contract\ResponseInterface;
use Hyperf\DbConnection\Db;
 
#[Controller]
class UserController
{
    #[RequestMapping(path: '/users/{id}', methods: ['get'])]
    public function show(int $id, RequestInterface $request, ResponseInterface $response)
    {
        // query berjalan di coroutine + connection pool otomatis
        $user = Db::table('users')->find($id);
        return $response->json($user);
    }
}

Perhatikan: Db::table() di Hyperf memakai pool secara otomatis — apa yang kita bangun manual di episode 13 sudah menjadi default framework.

#Konfigurasi Server Hyperf

return [
    'mode' => SWOOLE_PROCESS,
    'servers' => [
        [
            'name' => 'http',
            'host' => '0.0.0.0',
            'port' => 9501,
            'type' => SWOOLE_HTTP,
        ],
    ],
    'settings' => [
        'worker_num' => swoole_cpu_num(),
        'max_request' => 100000,
        'task_worker_num' => 8,
        'enable_coroutine' => true,
    ],
];

#Swoft: Pendahulu yang Masih Dipakai

Swoft muncul 2018 sebagai framework Swoole coroutine pertama yang populer. Gayanya berbasis annotation (mirip Spring Boot di Java), dan masih dipakai di banyak codebase legacy. Konsep inti — coroutine, pool, process — identik dengan yang sudah kalian pelajari. Jika bertemu Swoft di pekerjaan kalian, kalian sudah tahu 80% isinya.

#Laravel Octane dengan Driver Swoole

Laravel Octane adalah paket resmi Laravel untuk menjalankan aplikasi Laravel di atas app server (Swoole, RoadRunner, FrankenPHP). Setup-nya:

composer require laravel/octane
php artisan octane:install --server=swoole

Menjalankan server:

php artisan octane:start --host=127.0.0.1 --port=8000

Octane membawa aplikasi Laravel hidup terus — bootstrap sekali, tidak per-request. Konsekuensi yang harus dipahami:

#Warm-up Worker

Octane punya fitur warm-up: menjalankan kode sekali saat worker lahir, sehingga request pertama tidak lambat:

// config/octane.php
'warm' => [
    // komponen yang dimuat sekali di tiap worker
    \App\Models\User::class,
],

#Memilih Framework

Panduan cepat:

• Proyek baru, tim kecil, fokus performa → Hyperf. Ekosistem coroutine-native paling lengkap.
• Sudah Laravel, mau efisiensi tanpa migrasi besar → Laravel Octane (Swoole driver). Hitung dulu biaya audit global state.
• Legacy Swoft / tuntutan annotation → Swoft. Kurangi penggunaan baru bila memungkinkan.

#Common Pitfalls

#Penutup

Pada episode 15 ini, kalian telah memetakan ekosistem framework Swoole.

Inti yang harus dibawa pulang:

• Hyperf: framework coroutine-native — default untuk proyek Swoole baru.
• Swoft: pendahulu berbasis annotation, masih dipakai di legacy.
• Laravel Octane: Laravel + Swoole — waspadai state yang bertahan antar request.
• Semua fondasi manual (pool, process, coroutine) menjadi default di framework-framework ini.

Di episode 16 selanjutnya, kita masuk ke arsitektur microservices: gRPC & JSON-RPC — membangun service gRPC dengan Swoole, JSON-RPC, dan service discovery. Sampai jumpa di episode 16!