Compilar a partir do código-fonte

Este documento explica como criar um binário FrankenPHP que carregará o PHP como uma biblioteca dinâmica. Este é o método recomendado.

Como alternativa, compilações totalmente e principalmente estáticas também podem ser criadas.

O FrankenPHP é compatível com PHP 8.2 e versões superiores.

A maneira mais fácil de instalar uma versão da libphp compatível com o FrankenPHP é usar os pacotes ZTS fornecidos pelo Homebrew PHP.

Primeiro, se ainda não o fez, instale o Homebrew.

Em seguida, instale a variante ZTS do PHP, o Brotli (opcional, para suporte à compressão) e o watcher (opcional, para detecção de alterações em arquivos):

brew install shivammathur/php/php-zts brotli watcher
brew link --overwrite --force shivammathur/php/php-zts

Alternativamente, você pode compilar o PHP a partir do código-fonte com as opções necessárias para o FrankenPHP seguindo estes passos.

Primeiro, obtenha o código-fonte do PHP e extraia-os:

tar xf php-*
cd php-*/

Em seguida, execute o script configure com as opções necessárias para sua plataforma. As seguintes flags ./configure são obrigatórias, mas você pode adicionar outras, por exemplo, para compilar extensões ou recursos adicionais.

Linux

./configure \
    --enable-embed \
    --enable-zts \
    --disable-zend-signals \
    --enable-zend-max-execution-timers

Mac

Use o gerenciador de pacotes Homebrew para instalar as dependências necessárias e opcionais:

brew install libiconv bison brotli re2c pkg-config watcher
echo 'export PATH="/opt/homebrew/opt/bison/bin:$PATH"' >> ~/.zshrc

Em seguida, execute o script configure:

./configure \
    --enable-embed \
    --enable-zts \
    --disable-zend-signals \
    --with-iconv=/opt/homebrew/opt/libiconv/

Compilar o PHP

Finalmente, compile e instale o PHP:

make -j"$(getconf _NPROCESSORS_ONLN)"
sudo make install

Alguns recursos do FrankenPHP dependem de dependências opcionais do sistema que devem ser instaladas. Alternativamente, esses recursos podem ser desabilitados passando as tags de compilação para o compilador Go.

Agora você pode compilar o binário final.

A maneira recomendada é usar o xcaddy para compilar o FrankenPHP. O xcaddy também permite adicionar facilmente módulos Caddy personalizados e extensões FrankenPHP:

CGO_ENABLED=1 \
XCADDY_GO_BUILD_FLAGS="-ldflags='-w -s' -tags=nobadger,nomysql,nopgx" \
CGO_CFLAGS=$(php-config --includes) \
CGO_LDFLAGS="$(php-config --ldflags) $(php-config --libs)" \
xcaddy build \
    --output frankenphp \
    --with github.com/php/frankenphp/caddy \
    --with github.com/dunglas/mercure/caddy \
    --with github.com/dunglas/vulcain/caddy
    # Adicione módulos Caddy e extensões FrankenPHP extras aqui

Tip

Se você estiver usando a libc musl (o padrão no Alpine Linux) e Symfony, pode ser necessário aumentar o tamanho da pilha padrão. Caso contrário, você poderá receber erros como PHP Fatal error: Maximum call stack size of 83360 bytes reached during compilation. Try splitting expression.

Para fazer isso, altere a variável de ambiente XCADDY_GO_BUILD_FLAGS para algo como XCADDY_GO_BUILD_FLAGS=$'-ldflags "-w -s -extldflags \'-Wl,-z,stack-size=0x80000\'"' (altere o valor do tamanho da pilha de acordo com as necessidades da sua aplicação).

Alternativamente, é possível compilar o FrankenPHP sem o xcaddy usando o comando go diretamente:

curl -L https://github.com/php/frankenphp/archive/refs/heads/main.tar.gz | tar xz
cd frankenphp-main/caddy/frankenphp
CGO_CFLAGS=$(php-config --includes) CGO_LDFLAGS="$(php-config --ldflags) $(php-config --libs)" go build -tags=nobadger,nomysql,nopgx