İçeriğe geç
zefıly
← Tüm yazılar

Ubuntu 26.04'te Laravel: PHP-FPM mi, FrankenPHP ile Octane mı?

6 dk okuma

Laravel 13'ü canlıda çalıştırmanın iki yolu. Her biri nedir, aynı makinede ne ölçtük, Octane kodunuzdan ne ister ve hangisini seçmeniz gerektiğine dair yalın bir öneri. Ubuntu 26.04'te PHP 8.5 ile denendi.

Bugün Laravel'i çalıştırmanın iki ciddi yolu var. PHP-FPM klasik olanıdır: nginx her isteği bir PHP işçisine verir; işçi çatıyı yükler, yanıtlar ve her şeyi unutur. FrankenPHP ile Laravel Octane ise uygulamayı istekler arasında bellekte yüklü tutar; çatı her seferinde değil, bir kez başlar.

İkisini de 12 Kasım 2026'da aynı yeni Ubuntu 26.04.1 sisteminde, yeni bir Laravel 13.42 projesiyle kurduk.

Kısaca

  • PHP-FPM güvenli varsayılandır. Her Laravel paketi çalışır ve istekler arasında hiçbir şey sızmaz.
  • Octane, çatının başlama süresini her istekten çıkarır. Kazanç, kendi kodunuz hızlıysa gerçektir; istek zaten veritabanını bekliyorsa küçüktür.
  • Laravel'in varsayılan sayfasındaki hızlı denememizde Octane saniyede 169 istek, PHP-FPM 144 istek yanıtladı. Bu %17 fazladır, on kat değil.
  • Octane durumu bellekte tutar. Bunun için yazılmamış kod, istekler arasında veri sızdırabilir.
  • PHP-FPM ile başlayın. Sorununuzun başlama süresi olduğunu ölçtüğünüzde Octane'e geçin.

Kurulu olanlar

Ubuntu 26.04'te Laravel 13'ün ihtiyacı vardır. Yeni proje PHP ^8.3 ister; arşivde PHP 8.5 var.

sudo apt-get install nginx php8.5-fpm php8.5-cli php8.5-mbstring php8.5-xml \
  php8.5-curl php8.5-zip php8.5-bcmath php8.5-intl php8.5-sqlite3 composer
composer create-project laravel/laravel app

Seçenek 1: PHP-FPM

server {
    root /srv/app/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.5-fpm.sock;
    }
}
php artisan optimize

Başarımını iki ayar belirler:

  • OPcache, derlenmiş PHP'yi bellekte tutar. PHP 8.5'te her zaman PHP'nin parçasıdır ve denememizde hiçbir değişiklik yapmadan açıktı.
  • pm.max_children, PHP'nin aynı anda kaç istek üzerinde çalışabileceğidir. Ubuntu'nun varsayılanı 5'tir. Yoğun bir site için düşüktür; her işçi 100 MB kullanıyorsa 1 GB'lık sunucu için de yüksektir. Belleğinize göre ayarlayın: (PHP'ye ayırabileceğiniz bellek) ÷ (tek işçinin belleği).

Seçenek 2: FrankenPHP ile Octane

composer require laravel/octane
php artisan octane:install --server=frankenphp
php artisan octane:start --server=frankenphp --host=127.0.0.1 --port=8000 --workers=4

octane:install, FrankenPHP ikili dosyasını projeye indirir. Denememizde bu FrankenPHP 1.13.5 idi; yaklaşık 180 MB'lık tek bir dosya, Octane 2.24 ile.

Kısa rehberlerin atladığı, bizim fark ettiğimiz üç şey:

FrankenPHP kendi PHP'sini getirir. İkili dosya PHP 8.5.12 bildirdi; sistemin PHP'si ise 8.5.4 idi. Uygulamanız apt ile kurduğunuz PHP'de çalışmaz. apt install php8.5-… ile eklediğiniz eklentiler onun içinde değildir; ikili dosyanın kendi yerleşik seti vardır. Uygulamanızın ihtiyaç duyduğu her şeyin orada olduğunu kontrol edin:

./frankenphp php-cli -m

Yazılabilir bir ev dizini ister. Kullanılabilir ev dizini olmayan www-data ile başlatıldığında şunu yazdı:

ERROR  could not clean default/global storage.
ERROR  unable to create folder for config autosave.

İsteklere yine de yanıt verdi; ama gerçek ev dizini olan bir kullanıcıyla çalıştırın ya da XDG_DATA_HOME ve XDG_CONFIG_HOME değişkenlerini yazılabilir klasörlere ayarlayın.

nginx'i önde tutun. Octane'i 127.0.0.1 üzerinde çalıştırın; public/ içindeki dosyaları nginx sunsun, gerisini iletsin. HTTPS, sınırlar ve günlükler için tek yeriniz olur.

Ne ölçtük

Aynı makine, Laravel'in varsayılan karşılama sayfası, ab ile 2.000 istek, aynı anda 20:

Saniyedeki istek İstek başına ortalama süre
nginx + PHP-FPM (5 işçi, Ubuntu varsayılanı) 144 138 ms
Octane + FrankenPHP (4 işçi) 169 118 ms

Bunu lütfen kıyaslama testi değil, kaba bir kontrol olarak okuyun. Tek bir çalıştırmaydı; bir kapsayıcıda, farklı işçi sayılarıyla, SQLite'a oturum da yazan bir sayfada. İki kurulum da ayarlandığında daha iyisini yapar.

Asıl mesele farkın büyüklüğüdür. Octane, çatının başlama süresini kazandırır; bu istek başına birkaç milisaniyedir. İsteğin geri kalanı 100 ms sürüyorsa sayfa pek hızlanmaz. Uç noktalarınız zaten hızlıysa (önbellekten yanıt veren bir API) kazanılan pay büyüktür ve kazanç büyüktür.

Octane kodunuzdan ne ister

PHP-FPM ile her istek sıfırdan başlar. Octane ile uygulama nesnesi yaşamaya devam eder. Zararsız olan şeyler hataya dönüşür:

  • Geçerli kullanıcıyla ilgili bir şey tutan statik özellik ya da tekil nesne (singleton), sonraki ziyaretçi için de oradadır.
  • Her istekte büyüyen bir dizi bellek sızıntısıdır.
  • Yapılandırmayı başlangıçta tekil nesneye okuyan kod sonraki değişiklikleri görmez.
  • Dağıtımdan sonra işçiler, siz yeniden yükleyene kadar eski kodu çalıştırır: php artisan octane:reload.

Laravel kendi durumunu istekler arasında sıfırlar. Sizin kodunuz ve paketleriniz sizin sorumluluğunuzdadır. Testlerinizi çalıştırın ve işçi başına belleği birkaç gün izleyin.

Hangisi?

Şu durumlarda PHP-FPM seçin:

  • yeni başlıyorsunuz ve henüz ölçümünüz yok,
  • uygulama, Octane için denetlemediğiniz çok sayıda üçüncü taraf paket kullanıyor,
  • sunucuyu birkaç farklı PHP uygulaması paylaşıyor.

Şu durumlarda Octane seçin:

  • çatı başlangıcının yanıt sürenizde gerçek bir pay tuttuğunu ölçtünüz,
  • ekibiniz durum sızıntılarını sınayabiliyor,
  • eşzamanlı görevler gibi uzun ömürlü özellikler istiyorsunuz.

Birinden diğerine sonradan geçmek yeniden yazım değil, bir dağıtımdır. Basit başlamak size hiçbir şey kaybettirmez.

Zefily ile

Zefily, Laravel sitelerini varsayılan olarak PHP-FPM'de çalıştırır; her site kendi Linux kullanıcısıyla, kendi havuzunda, zamanlayıcı ve bir kuyruk işçisiyle. Octane istediğinizde sitenin Dağıtım bölmesinde bir Octane (FrankenPHP) kartı vardır: deponuza laravel/octane ekleyin, Octane'i etkinleştir'e basın; Zefily sabitlenmiş, sağlama toplamı doğrulanmış FrankenPHP'yi kurar, site kullanıcınızla yerel bir portta başlatır ve web sunucusunu ona yönlendirir. Uygulama geçişten sonra yanıt vermezse Zefily PHP-FPM'i kendiliğinden geri getirir. Laravel belgesine bakın.

Sık sorulan sorular

FrankenPHP, Laravel için PHP-FPM'den hızlı mı?

İstek başına çatının başlama süresini kazandırır. Laravel'in varsayılan sayfasındaki hızlı denememizde FrankenPHP ile Octane saniyede 169, PHP-FPM 144 istek yanıtladı. Zaten hızlı olan uç noktalarda kazanç daha büyüktür.

FrankenPHP sunucumda kurulu PHP'yi mi kullanır?

Hayır. FrankenPHP ikili dosyası kendi PHP'sini içerir. Denememizde sistemde 8.5.4 varken o PHP 8.5.12 idi ve apt ile kurulan eklentiler onun parçası değildir.

Laravel uygulamam Octane ile değişiklik yapmadan çalışır mı?

Çoğu zaman evet, ama her zaman değil. İsteğe özel veriyi statik özelliklerde ya da tekil nesnelerde tutan kod, onu sonraki isteğe sızdırabilir. Geçmeden önce sınayın.

Laravel 13 hangi PHP sürümünü ister?

Yeni bir Laravel 13 projesi PHP 8.3 ya da daha yenisini ister. Ubuntu 26.04, PHP 8.5 ile gelir.

Kaç PHP-FPM işçisi ayarlamalıyım?

PHP'ye ayırabileceğiniz belleği tek işçinin belleğine bölün. Ubuntu'nun varsayılan pm.max_children değeri 5'tir.

Zefily'de PHP ayarı için PHP ayarları belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →