FrankenPHP: um moderno servidor de aplicações para PHP

O FrankenPHP é um moderno servidor de aplicações para PHP, construído sobre o servidor web Caddy.

O FrankenPHP dá superpoderes às suas aplicações PHP graças aos seus recursos impressionantes: Early Hints, modo worker, recursos em tempo real, suporte automático a HTTPS, HTTP/2 e HTTP/3…

O FrankenPHP funciona com qualquer aplicação PHP e torna seus projetos Laravel e Symfony mais rápidos do que nunca, graças às suas integrações oficiais com o modo worker.

O FrankenPHP também pode ser usado como uma biblioteca Go independente para incorporar PHP em qualquer aplicação usando net/http.

Saiba mais em frankenphp.dev e neste conjunto de slides:

# Começando

No Windows, use WSL para executar o FrankenPHP.

# Script de instalação

Você pode copiar esta linha no seu terminal para instalar automaticamente a versão apropriada para sua plataforma:

curl https://frankenphp.dev/install.sh | sh

# Binário independente

Fornecemos binários estáticos do FrankenPHP para desenvolvimento em Linux e macOS contendo o PHP 8.4 e as extensões PHP mais populares.

Baixe o FrankenPHP

Instalação de extensões: As extensões mais comuns já estão incluídas. Não é possível instalar mais extensões.

# Pacotes rpm

Nossos mantenedores oferecem pacotes rpm para todos os sistemas que usam dnf. Para instalar, execute:

sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm
sudo dnf module enable php-zts:static-8.4 # 8.2-8.5 disponíveis
sudo dnf install frankenphp

Instalação de extensões: sudo dnf install php-zts-<extension>

Para extensões não disponíveis por padrão, use o PIE:

sudo dnf install pie-zts
sudo pie-zts install asgrim/example-pie-extension

# Pacotes deb

Nossos mantenedores oferecem pacotes deb para todos os sistemas que usam apt. Para instalar, execute:

sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \
echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \
sudo apt update
sudo apt install frankenphp

Instalação de extensões: sudo apt install php-zts-<extension>

Para extensões não disponíveis por padrão, use o PIE:

sudo apt install pie-zts
sudo pie-zts install asgrim/example-pie-extension

Para servir o conteúdo do diretório atual, execute:

frankenphp php-server

Você também pode executar scripts de linha de comando com:

frankenphp php-cli /caminho/para/seu/script.php

# Docker

Alternativamente, imagens Docker estão disponíveis:

docker run -v .:/app/public \
    -p 80:80 -p 443:443 -p 443:443/udp \
    dunglas/frankenphp

Acesse https://localhost e divirta-se!

Tip
Não tente usar https://127.0.0.1. Use https://localhost e aceite o certificado autoassinado. Use a variável de ambiente SERVER_NAME para alterar o domínio a ser usado.

# Homebrew

O FrankenPHP também está disponível como um pacote Homebrew para macOS e Linux.

Para instalá-lo:

brew install dunglas/frankenphp/frankenphp

Instalação de extensões: Use o PIE.

# Uso

Para servir o conteúdo do diretório atual, execute:

frankenphp php-server

Você também pode executar scripts de linha de comando com:

frankenphp php-cli /caminho/para/seu/script.php

Para os pacotes deb e rpm, você também pode iniciar o serviço systemd:

sudo systemctl start frankenphp

# Documentação

# Exemplos e esqueletos

Editar esta página