Известные проблемы

Следующие расширения не совместимы с FrankenPHP:

Следующие расширения имеют известные ошибки или могут вести себя непредсказуемо при использовании с FrankenPHP:

Начиная с PHP 8.2.35, 8.3.36, 8.4.27 и 8.5.12, превышение memory_limit больше не останавливает скрипт немедленно: фатальная ошибка “Allowed memory size exhausted” возникает при следующем вызове функции или итерации цикла. Если скрипт выделяет память за пределы жёсткого лимита памяти до этого, PHP завершает процесс. Жёсткий лимит по умолчанию составляет двукратный memory_limit (или memory_limit плюс 1 ГиБ сверх 1 ГиБ) и может быть изменён с помощью настройки INI memory_hard_limit_percent.

Код, продолжающий выполняться после memory_limit, может достичь жёсткого лимита, например, при одном выделении памяти, превышающем memory_limit (таком как array_merge() для больших массивов), или при последовательных конкатенациях строк.

PHP-FPM теряет только один дочерний процесс. FrankenPHP обслуживает все запросы из потоков одного процесса, поэтому каждый обрабатываемый запрос будет потерян, а сервер остановится до перезапуска. Запускайте FrankenPHP под управлением супервизора, который его перезапускает, например, с помощью политики перезапуска Docker или настройки Restart= в systemd (уже установлено в пакетах deb и rpm).

Функция get_browser() со временем начинает работать медленно. Решение — кэшировать результаты для каждого User-Agent (например, с помощью APCu), так как они статичны.

Полностью статический бинарный файл и образы Docker на базе Alpine (dunglas/frankenphp:*-alpine) используют musl libc вместо glibc и его друзей для уменьшения размера бинарного файла. Это может привести к некоторым проблемам совместимости. В частности, флаг GLOB_BRACE недоступен.

Если вы столкнетесь с проблемами, предпочитайте использовать GNU-вариант статического бинарного файла и образы Docker на базе Debian.

По умолчанию FrankenPHP генерирует TLS-сертификат для localhost. Это самый простой и рекомендуемый вариант для локальной разработки.

Если вы действительно хотите использовать 127.0.0.1 в качестве хоста, его можно настроить для генерации сертификата, установив имя сервера в 127.0.0.1.

К сожалению, этого недостаточно при использовании Docker из-за его сетевой системы. Вы получите ошибку TLS, похожую на curl: (35) LibreSSL/3.3.6: error:1404B438:SSL routines:ST_CONNECT:tlsv1 alert internal error.

Если вы используете Linux, решением является использование драйвера хостовой сети:

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

Драйвер хостовой сети не поддерживается на Mac и Windows. На этих платформах вам придется угадать IP-адрес контейнера и включить его в имена серверов.

Выполните docker network inspect bridge и найдите ключ Containers, чтобы определить последний текущий назначенный IP-адрес в ключе IPv4Address, и увеличьте его на единицу. Если контейнеры не запущены, первый назначенный IP-адрес обычно 172.17.0.2.

Затем включите это в переменную окружения SERVER_NAME:

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 на IP, который будет присвоен вашему контейнеру.

Теперь вы сможете получить доступ к https://127.0.0.1 с хост-машины.

Если это не так, запустите FrankenPHP в режиме отладки, чтобы попытаться выяснить проблему:

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 могут вызывать бинарный файл PHP для выполнения некоторых задач, например, в проекте Laravel для запуска @php artisan package:discover --ansi. Это в настоящее время не удается по двум причинам:

• Composer не знает, как вызывать бинарный файл FrankenPHP;
• Composer может добавлять настройки PHP с помощью флага -d в команде, который FrankenPHP пока не поддерживает.

В качестве обходного пути мы можем создать shell-скрипт в /usr/local/bin/php, который удаляет неподдерживаемые параметры, а затем вызывает FrankenPHP:

#!/usr/bin/env bash
# /usr/local/bin/php
args=("$@")
index=0
for i in "$@"
do
    if [ "$i" == "-d" ]; then
        unset 'args[$index]'
        unset 'args[$index+1]'
    fi
    index=$((index+1))
done

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

Затем установите переменную окружения PHP_BINARY на путь к нашему скрипту php и запустите Composer:

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

При использовании статических бинарных файлов вы можете столкнуться со следующими ошибками, связанными с TLS, например, при отправке электронных писем с использованием STARTTLS:

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

Поскольку статический бинарный файл не включает TLS-сертификаты, вам необходимо указать OpenSSL путь к локальной установке CA-сертификатов.

Проверьте вывод openssl_get_cert_locations(), чтобы определить, куда должны быть установлены CA-сертификаты, и поместите их в это место.

Warning

Веб- и CLI-контексты могут иметь разные настройки. Убедитесь, что вы запускаете openssl_get_cert_locations() в соответствующем контексте.

CA-сертификаты, извлечённые из Mozilla, можно скачать с сайта cURL.

Кроме того, многие дистрибутивы, включая Debian, Ubuntu и Alpine, предоставляют пакеты с именем ca-certificates, которые содержат эти сертификаты.

Также можно использовать SSL_CERT_FILE и SSL_CERT_DIR, чтобы подсказать OpenSSL, где искать CA-сертификаты:

# Установите переменные окружения для TLS-сертификатов
export SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
export SSL_CERT_DIR=/etc/ssl/certs