FrankenPHP — запуск PHP-приложений без PHP-FPM и сложной настройки

FrankenPHP — современный способ запуска PHP-приложений с минимальной настройкой окружения. Это веб-сервер на базе Caddy, интегрированный с PHP и распространяемый в виде готового бинарного файла. Он позволяет запускать PHP-проекты без отдельной установки PHP-FPM, сложной конфигурации Nginx и поиска подходящего Docker-образа.

В этой статье разберём, как работает FrankenPHP, как запустить на нём WordPress, чем он отличается от классической связки Nginx + PHP-FPM и в каких случаях его стоит использовать.

Что такое FrankenPHP и зачем он нужен

FrankenPHP объединяет веб-сервер Caddy и PHP в одном решении. Вместо установки нескольких компонентов и настройки их взаимодействия можно скачать готовый бинарник, подготовить файлы проекта и запустить приложение.

Основные преимущества FrankenPHP:

• Простой запуск PHP-приложений — минимум зависимостей и настроек.
• Единый бинарный файл — удобнее разворачивать небольшие проекты и утилиты.
• Поддержка Caddy — гибкая конфигурация веб-сервера, автоматическое получение TLS-сертификатов и поддержка современных HTTP-протоколов.
• Несколько режимов работы — запуск PHP-сервера, выполнение CLI-скриптов и обработка запросов с длительным временем жизни приложения.
• Возможность повышения производительности — благодаря долгоживущим процессам и специальным режимам выполнения PHP-кода.

FrankenPHP подходит как для быстрого развёртывания небольших PHP-проектов, так и для более сложных приложений, если их архитектура и требования совместимы с выбранным режимом работы.

Как запустить WordPress на FrankenPHP

Рассмотрим практический пример: запустим WordPress на Linux-сервере без отдельной настройки Nginx и PHP-FPM.

Сначала скачиваем бинарный файл FrankenPHP:

wget https://github.com/php/frankenphp/releases/download/v1.12.7/frankenphp-linux-x86_64

Делаем его исполняемым и перемещаем в системный каталог:

chmod +x frankenphp-linux-x86_64sudo mv frankenphp-linux-x86_64 /usr/local/bin/frankenphp

Затем скачиваем русскоязычный дистрибутив WordPress и распаковываем архив:

wget https://ru.wordpress.org/latest-ru_RU.zipunzip latest-ru_RU.zipcd wordpress

Запускаем встроенный PHP-сервер:

frankenphp php-server

После запуска можно открыть адрес сервера в браузере и перейти к установке WordPress.

Таким образом, для первого запуска достаточно скачать FrankenPHP, подготовить файлы сайта и выполнить одну команду. При этом нужно учитывать, что доступность сайта зависит от настроек портов и сети, а для полноценной установки WordPress также потребуется настроить базу данных и необходимые параметры приложения.

Перед использованием в production стоит дополнительно проверить актуальные требования к PHP-расширениям, настройкам безопасности и конфигурации сервера.

Запуск PHP-скриптов через командную строку

FrankenPHP можно использовать не только для запуска сайтов. Для выполнения отдельных PHP-скриптов предусмотрен режим CLI:

frankenphp php-cli /path/to/your/script.php

Этот вариант подходит для запуска служебных скриптов, автоматизации задач, обработки данных и небольших PHP-утилит.

Главное преимущество такого подхода — отсутствие необходимости отдельно устанавливать и настраивать полноценное PHP-окружение на каждом сервере, если возможностей выбранного бинарного файла достаточно для проекта.

Настройка сайта: Nginx против Caddy

При классическом развёртывании PHP-приложений часто используют связку Nginx и PHP-FPM. В этом случае веб-сервер принимает HTTP-запросы и передаёт выполнение PHP-кода отдельному процессу через FastCGI.

Пример типовой конфигурации Nginx:

server {    listen 80;    server_name example.com;    root /var/www/app/public;    index index.php;    location / {        try_files $uri $uri/ /index.php$is_args$args;    }    location ~ \.php$ {        fastcgi_pass unix:/run/php/php-fpm.sock;        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;        include fastcgi_params;    }}

В FrankenPHP аналогичный сценарий можно описать значительно короче с помощью Caddyfile:

example.com {    root * /var/www/app/public    php_server}

Вместо настройки нескольких блоков Nginx и параметров взаимодействия с PHP-FPM используется встроенный обработчик php_server.

Это упрощает первоначальную настройку и уменьшает количество отдельных компонентов, которыми нужно управлять. Кроме того, Caddy поддерживает автоматическое получение и продление TLS-сертификатов при корректной настройке домена и доступности сервера.

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

Worker mode: как FrankenPHP ускоряет PHP-приложения

Одна из наиболее интересных возможностей FrankenPHP — режим Worker. В отличие от классической модели, при которой приложение обычно загружается для обработки каждого запроса заново, Worker mode позволяет загрузить приложение один раз и обрабатывать несколько запросов в долгоживущем PHP-процессе.

Это может сократить накладные расходы на загрузку файлов, инициализацию фреймворка и создание объектов. В результате некоторые приложения способны обрабатывать запросы быстрее и эффективнее использовать ресурсы сервера.

Однако такой подход требует внимания к архитектуре приложения. Данные, состояние и объекты, которые сохраняются между запросами, могут привести к ошибкам, если код изначально рассчитан на запуск в новом процессе для каждого запроса.

Поэтому перед использованием Worker mode необходимо проверить совместимость приложения с долгоживущими процессами и убедиться, что ресурсы корректно освобождаются, а пользовательские данные не переносятся между запросами.

Hot reload: обновление приложения без перезапуска сервера

Для работы с долгоживущими PHP-приложениями важна возможность обновлять код без полного перезапуска сервера. Для этого в FrankenPHP предусмотрен механизм hot reload.

Он позволяет автоматически обнаруживать изменения исходников и перезагружать приложение в соответствии с настройками выбранного режима работы.

Это удобно при разработке и тестировании, когда код часто меняется, а постоянно перезапускать сервер неудобно.

Поддержка hot reload и особенности его настройки зависят от способа запуска приложения. Для некоторых фреймворков и CMS могут потребоваться дополнительные изменения в коде или конфигурации.

Подробнее: https://frankenphp.dev/docs/hot-reload/

FrankenPHP в production: преимущества и ограничения

Несмотря на простоту запуска, FrankenPHP не стоит воспринимать как универсальную замену всем существующим решениям для PHP.

Для небольших сайтов, административных панелей, внутренних сервисов и разовых задач он может оказаться особенно удобным. В таких сценариях сокращение количества компонентов и упрощение развёртывания зачастую важнее сложной оптимизации производительности.

В высоконагруженных production-системах ситуация другая. Здесь необходимо учитывать:

• потребление оперативной памяти и количество одновременно работающих процессов;
• совместимость приложения с Worker mode;
• корректность работы глобального состояния и долгоживущих объектов;
• особенности обработки запросов и фоновых задач;
• требования к мониторингу, безопасности и обновлению приложения;
• реальные результаты нагрузочного тестирования.

Важно понимать, что FrankenPHP не гарантирует автоматического ускорения любого PHP-проекта. Итоговая производительность зависит от приложения, используемой базы данных, характера нагрузки, конфигурации сервера и выбранного режима работы.

Когда стоит использовать FrankenPHP

FrankenPHP особенно интересен в нескольких сценариях:

• Быстрый запуск PHP-проектов. Можно проверить работу приложения без длительной настройки серверного окружения.
• Небольшие сайты и панели управления. Минимальная конфигурация помогает сократить время развёртывания.
• Запуск CLI-скриптов. Удобный вариант для служебных задач и автоматизации.
• Разработка и тестирование. Можно быстро подготовить окружение и экспериментировать с приложением.
• Оптимизация подходящих приложений. Worker mode может повысить производительность при правильной адаптации кода.

Если же проект требует сложной инфраструктуры, специфической конфигурации PHP-FPM или строгого контроля над процессами, перед миграцией стоит сравнить FrankenPHP с текущим стеком на реальной нагрузке.

Итоги

FrankenPHP — интересный инструмент для упрощения запуска и развёртывания PHP-приложений. Он объединяет PHP и веб-сервер Caddy, позволяет запускать сайты практически одной командой и предлагает дополнительные возможности для повышения производительности за счёт долгоживущих процессов.

Для простых проектов, небольших сервисов, административных панелей и отдельных PHP-скриптов это удобная альтернатива более сложным конфигурациям. А для крупных приложений FrankenPHP может стать частью производительной инфраструктуры, если заранее проверить совместимость кода, потребление памяти и поведение приложения под нагрузкой.

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

Официальный репозиторий: https://github.com/php/frankenphp