Ce document explique comment créer un build FrankenPHP qui chargera PHP en tant que bibliothèque dynamique. C'est la méthode recommandée.
Alternativement, il est aussi possible de créer des builds statiques.
FrankenPHP est compatible avec PHP 8.2 et versions ultérieures.
Tout d'abord, téléchargez les sources de PHP et extrayez-les :
tar xf php-*
cd php-*/
Ensuite, configurez PHP pour votre système d'exploitation.
Les options de configuration suivantes sont nécessaires pour la compilation, mais vous pouvez également inclure d'autres options selon vos besoins, par exemple pour ajouter des extensions et fonctionnalités supplémentaires.
./configure \
--enable-embed \
--enable-zts \
--disable-zend-signals \
--enable-zend-max-execution-timers
Utilisez le gestionnaire de paquets Homebrew pour installer libiconv
, bison
, re2c
et pkg-config
:
brew install libiconv bison re2c pkg-config
echo 'export PATH="/opt/homebrew/opt/bison/bin:$PATH"' >> ~/.zshrc
Puis exécutez le script de configuration :
./configure \
--enable-embed=static \
--enable-zts \
--disable-zend-signals \
--disable-opcache-jit \
--enable-static \
--enable-shared=no \
--with-iconv=/opt/homebrew/opt/libiconv/
Finalement, compilez et installez PHP :
make -j"$(getconf _NPROCESSORS_ONLN)"
sudo make install
Vous pouvez maintenant compilez FrankenPHP :
curl -L https://github.com/dunglas/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
Alternativement, Vous pouvez utiliser xcaddy pour compiler FrankenPHP avec des modules Caddy additionnels:
CGO_ENABLED=1 \
XCADDY_GO_BUILD_FLAGS="-ldflags '-w -s'" \
xcaddy build \
--output frankenphp \
--with github.com/dunglas/frankenphp/caddy \
--with github.com/dunglas/caddy-cbrotli \
--with github.com/dunglas/mercure/caddy \
--with github.com/dunglas/vulcain/caddy
# Add extra Caddy modules here
[!TIP]
Si vous utilisez musl libc (la bibliothèque par défaut sur Alpine Linux) et Symfony, vous pourriez avoir besoin d'augmenter la taille par défaut de la pile. Sinon, vous pourriez rencontrer des erreurs telles que
PHP Fatal error: Maximum call stack size of 83360 bytes reached during compilation. Try splitting expression
Pour ce faire, modifiez la variable d'environnement
XCADDY_GO_BUILD_FLAGS
en quelque chose commeXCADDY_GO_BUILD_FLAGS=$'-ldflags "-w -s -extldflags \'-Wl,-z,stack-size=0x80000\'"'
(modifiez la valeur de la taille de la pile selon les besoins de votre application).