Bilinen sorunlar

Aşağıdaki eklentilerin FrankenPHP ile uyumlu olmadığı bilinmektedir:

Aşağıdaki eklentiler FrankenPHP ile kullanıldığında bilinen hatalara ve beklenmeyen davranışlara sahiptir:

PHP 8.2.35, 8.3.36, 8.4.27 ve 8.5.12’den beri, memory_limit‘in aşılması betiği hemen durdurmaz: “Allowed memory size exhausted” (İzin verilen bellek boyutu tükendi) ölümcül hatası bir sonraki fonksiyon çağrısında veya döngü iterasyonunda yükseltilir. Eğer betik, bundan önce sabit bellek sınırını aşacak şekilde bellek ayırırsa, PHP süreci sonlandırır. Sabit sınır varsayılan olarak memory_limit‘in iki katıdır (veya 1 GiB’ın üzerinde 1 GiB artı memory_limit‘tir) ve memory_hard_limit_percent INI ayarı ile değiştirilebilir.

memory_limit‘i aşan kodlar, örneğin memory_limit‘ten daha büyük tek bir tahsis (büyük dizilerde array_merge() gibi) veya ardışık dize birleştirmeleri gibi durumlarda bu sınıra ulaşabilir.

PHP-FPM yalnızca bir çocuk sürecini kaybeder. FrankenPHP, tüm istekleri tek bir sürecin iş parçacıklarından sunar, bu nedenle devam eden her istek kaybolur ve sunucu yeniden başlatılana kadar durur. FrankenPHP’yi, Docker yeniden başlatma politikası veya systemd’nin Restart= (deb ve rpm paketlerinde zaten ayarlanmış olan) gibi onu yeniden başlatan bir denetleyici altında çalıştırın.

get_browser() fonksiyonu bir süre sonra kötü performans gösteriyor gibi görünüyor. Geçici bir çözüm, statik oldukları için User-Agent başına sonuçları önbelleğe almaktır (örneğin APCu ile).

Tamamen statik ikili dosya ve Alpine tabanlı Docker imajları (dunglas/frankenphp:*-alpine), daha küçük bir ikili dosya boyutu korumak için glibc ve benzerleri yerine musl libc kullanır. Bu durum bazı uyumluluk sorunlarına yol açabilir. Özellikle, glob bayrağı GLOB_BRACE mevcut değildir.

Sorun yaşarsanız, statik ikili dosyanın GNU varyantını ve Debian tabanlı Docker imajlarını kullanmayı tercih edin.

FrankenPHP varsayılan olarak localhost için bir TLS sertifikası oluşturur. Bu, yerel geliştirme için en kolay ve önerilen seçenektir.

Bunun yerine ana bilgisayar olarak 127.0.0.1 kullanmak istiyorsanız, sunucu adını 127.0.0.1 olarak ayarlayarak bunun için bir sertifika oluşturacak şekilde yapılandırmak mümkündür.

Ne yazık ki, ağ sistemi nedeniyle Docker kullanırken bu yeterli değildir. curl: (35) LibreSSL/3.3.6: error:1404B438:SSL routines:ST_CONNECT:tlsv1 alert internal error benzeri bir TLS hatası alırsınız.

Linux kullanıyorsanız, ana bilgisayar ağ sürücüsünü kullanmak bir çözümdür:

docker run \
    -e SERVER_NAME="127.0.0.1" \
    -v $PWD:/app/public \
    --network host \
    dunglas/frankenphp

Ana bilgisayar ağ sürücüsü Mac ve Windows’ta desteklenmez. Bu platformlarda, konteynerin IP adresini tahmin etmeniz ve bunu sunucu adlarına dahil etmeniz gerekecektir.

docker network inspect bridge komutunu çalıştırın ve Containers anahtarının altındaki IPv4Address anahtarındaki son atanmış IP adresini belirlemek için bakın, ardından bu IP’yi bir artırın. Eğer hiçbir konteyner çalışmıyorsa, ilk atanan IP adresi genellikle 172.17.0.2dir.

Ardından, bunu SERVER_NAME ortam değişkenine ekleyin:

docker run \
    -e SERVER_NAME="127.0.0.1, 172.17.0.3" \
    -v $PWD:/app/public \
    -p 80:80 -p 443:443 -p 443:443/udp \
    dunglas/frankenphp

Caution

172.17.0.3‘ü konteynerinize atanacak IP ile değiştirdiğinizden emin olun.

Artık ana makineden https://127.0.0.1 adresine erişebilmeniz gerekir.

Eğer durum böyle değilse, sorunu anlamaya çalışmak için FrankenPHP’yi hata ayıklama modunda başlatın:

docker run \
    -e CADDY_GLOBAL_OPTIONS="debug" \
    -e SERVER_NAME="127.0.0.1" \
    -v $PWD:/app/public \
    -p 80:80 -p 443:443 -p 443:443/udp \
    dunglas/frankenphp

Composer betikleri bazı görevler için bir PHP ikili dosyası çalıştırmak isteyebilir, örneğin bir Laravel projesinde @php artisan package:discover --ansi çalıştırmak. Bu durum şu anda başarısız oluyor ve iki nedeni vardır:

• Composer, FrankenPHP ikili dosyasını nasıl çağıracağını bilmiyor;
• Composer, FrankenPHP’nin henüz desteklemediği -d bayrağını kullanarak PHP ayarlarını komuta ekleyebilir.

Geçici bir çözüm olarak, /usr/local/bin/php içinde desteklenmeyen parametreleri silen ve ardından FrankenPHP’yi çağıran bir kabuk betiği oluşturabiliriz:

#!/usr/bin/env bash
# /usr/local/bin/php
# Parametreleri bir diziye kopyala
args=("$@")
index=0
# Parametreleri döngüye al
for i in "$@"
do
    # "-d" bayrağını ve sonraki parametreyi kaldır
    if [ "$i" == "-d" ]; then
        unset 'args[$index]'
        unset 'args[$index+1]'
    fi
    index=$((index+1))
done

/usr/local/bin/frankenphp php-cli "${args[@]}"

Ardından PHP_BINARY ortam değişkenini PHP betiğimizin yoluna ayarlayın ve Composer’ı çalıştırın:

export PHP_BINARY=/usr/local/bin/php
composer install

Statik ikili dosyaları kullanırken, örneğin STARTTLS kullanarak e-posta gönderirken aşağıdaki TLS ile ilgili hatalarla karşılaşabilirsiniz:

Unable to connect with STARTTLS: stream_socket_enable_crypto(): SSL operation failed with code 5. OpenSSL Error messages:
error:80000002:system library::No such file or directory
error:80000002:system library::No such file or directory
error:80000002:system library::No such file or directory
error:0A000086:SSL routines::certificate verify failed

Statik ikili dosya TLS sertifikalarını içermediği için, OpenSSL’i yerel CA sertifikaları kurulumunuza yönlendirmeniz gerekir.

CA sertifikalarının nereye yüklenmesi gerektiğini bulmak ve bunları bu konuma kaydetmek için openssl_get_cert_locations() çıktısını inceleyin.

Warning

Web ve CLI bağlamlarının farklı ayarları olabilir. openssl_get_cert_locations() fonksiyonunu doğru bağlamda çalıştırdığınızdan emin olun.

Mozilla’dan çıkarılan CA sertifikaları cURL sitesinden indirilebilir.

Alternatif olarak, Debian, Ubuntu ve Alpine dahil olmak üzere birçok dağıtım, bu sertifikaları içeren ca-certificates adlı paketler sunar.

OpenSSL’e CA sertifikalarını nerede arayacağını belirtmek için SSL_CERT_FILE ve SSL_CERT_DIR ortam değişkenlerini kullanmak da mümkündür:

# TLS sertifikaları ortam değişkenlerini ayarla
export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
export SSL_CERT_DIR=/etc/ssl/certs