mirror of https://github.com/dunglas/frankenphp.git synced 2025-12-24 13:38:11 +08:00

Files

Pierre 2c6e201ea6 docs: Chinese translation (#597 )

* docs: translated in Chinese

* fix: readme md links and duplicate images

* docs: lint and remove outdated parts

---------

Co-authored-by: Pierre Clavequin <pierre.clavequin@valueapex.com>
Co-authored-by: ginifizz <laury@les-tilleuls.coop>
Co-authored-by: Kévin Dunglas <kevin@dunglas.fr>

2024-02-28 15:29:20 +01:00

2.6 KiB

Raw Blame History

从源代码编译

本文档解释了如何创建一个 FrankenPHP 构建，它将 PHP 加载为一个动态库。这是推荐的方法。

或者，创建静态构建也是可能的。

安装 PHP

FrankenPHP 与 PHP 8.2 及更高版本兼容。

首先，获取PHP的源代码并提取它们：

tar xf php-*
cd php-*/

然后，为您的平台配置 PHP：

Linux

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

最后，编译并安装 PHP：

make -j$(nproc)
sudo make install

Mac

使用 Homebrew 包管理器安装 libiconv, bison, re2c 和 pkg-config：

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

然后运行配置脚本：

./configure \
    --enable-embed=static \
    --enable-zts \
    --disable-zend-signals \
    --disable-opcache-jit \
    --enable-static \
    --enable-shared=no \
    --with-iconv=/opt/homebrew/opt/libiconv/

这些标志是必需的，但您可以添加其他标志(例如额外的扩展) 如果需要。

最后，编译并安装 PHP：

make -j$(sysctl -n hw.logicalcpu)
sudo make install

编译 Go 应用

您现在可以使用 Go 库并编译我们的 Caddy 构建：

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

使用 xcaddy

或者，使用 xcaddy 用自定义 Caddy 模块编译 FrankenPHP：

CGO_ENABLED=1 \
XCADDY_GO_BUILD_FLAGS="-ldflags '-w -s'" \
xcaddy build \
    --output frankenphp \
    --with github.com/dunglas/frankenphp/caddy \
    --with github.com/dunglas/mercure/caddy \
    --with github.com/dunglas/vulcain/caddy
    # Add extra Caddy modules here

[!提示]

如果您使用的是 musl libc(Alpine Linux 上的默认值)和 Symfony，您可能需要增加默认堆栈大小。否则，您可能会收到如下错误 PHP Fatal error: Maximum call stack size of 83360 bytes reached during compilation. Try splitting expression

为此，请将 XCADDY_GO_BUILD_FLAGS 环境变量更改为类似 XCADDY_GO_BUILD_FLAGS=$'-ldflags "-w -s -extldflags \'-Wl,-z,stack-size=0x80000\'"' (根据您的应用需求更改堆栈大小的值)。

2.6 KiB Raw Blame History Unescape Escape