aside: false

环境变量列表

本页面的环境变量列表中所提到的所有环境变量都具有默认值，除非另有说明。你可以通过设置这些环境变量来覆盖默认值。

一般情况下，你不需要修改任何以下环境变量，因为它们已经被设置为最佳值。但是，如果你有特殊需求，你可以通过设置这些环境变量来满足你的需求（比如你需要调试不同编译参数下的 PHP 性能表现）。

如需使用自定义环境变量，你可以在终端中使用 export 命令或者在命令前直接设置环境变量，例如：

# export 方式
export SPC_CONCURRENCY=4
bin/spc build mbstring,pcntl --build-cli

# 直接设置方式
SPC_CONCURRENCY=4 bin/spc build mbstring,pcntl --build-cli

通用环境变量

通用环境变量是所有构建目标都可以使用的环境变量。

var name	default value	comment
`BUILD_ROOT_PATH`	`{pwd}/buildroot`	编译目标的根目录
`BUILD_LIB_PATH`	`{pwd}/buildroot/lib`	编译依赖库的根目录
`BUILD_INCLUDE_PATH`	`{pwd}/buildroot/include`	编译依赖库的头文件目录
`BUILD_BIN_PATH`	`{pwd}/buildroot/bin`	编译依赖库的二进制文件目录
`PKG_ROOT_PATH`	`{pwd}/pkgroot`	闭源或预编译工具下载后安装的目录
`SOURCE_PATH`	`{pwd}/source`	编译项目的源码解压缩目录
`DOWNLOAD_PATH`	`{pwd}/downloads`	下载的文件存放目录
`SPC_CONCURRENCY`	取决于当前 CPU 核心数量	并行编译的数量
`SPC_SKIP_PHP_VERSION_CHECK`	空	设置为 `yes` 时，跳过扩展对 PHP 版本的检查

系统特定变量

这些环境变量是特定于系统的，它们只在特定的系统上才会生效。

Windows

var name	default value	comment
`PHP_SDK_PATH`	`{pwd}\php-sdk-binary-tools`	PHP SDK 工具的安装目录
`UPX_EXEC`	`$PKG_ROOT_PATH\bin\upx.exe`	UPX 压缩工具的路径

macOS

var name	default value	comment
`CC`	`clang`	C 编译器
`CXX`	`clang++`	C++ 编译器
`SPC_DEFAULT_C_FLAGS`	`--target=arm64-apple-darwin` 或 `--target=x86_64-apple-darwin`	默认 C 编译标志（与 `CFLAGS` 不同）
`SPC_DEFAULT_CXX_FLAGS`	`--target=arm64-apple-darwin` 或 `--target=x86_64-apple-darwin`	默认 C++ 编译标志（与 `CXXFLAGS` 不同）
`SPC_CMD_PREFIX_PHP_BUILDCONF`	`./buildconf --force`	编译 PHP `buildconf` 命令前缀
`SPC_CMD_PREFIX_PHP_CONFIGURE`	`./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg`	编译 PHP `configure` 命令前缀
`SPC_CMD_PREFIX_PHP_MAKE`	`make -j$SPC_CONCURRENCY`	编译 PHP `make` 命令前缀
`SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS`	`$SPC_DEFAULT_C_FLAGS -Werror=unknown-warning-option`	PHP `configure` 命令的 `CFLAGS` 变量
`SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS`	`-I$BUILD_INCLUDE_PATH`	PHP `configure` 命令的 `CPPFLAGS` 变量
`SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS`	`-L$BUILD_LIB_PATH`	PHP `configure` 命令的 `LDFLAGS` 变量
`SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS`	`-g0 -Os` 或 `-g -O0`（当使用 `--no-strip` 时为后者）	PHP `make` 命令的 `EXTRA_CFLAGS` 变量
`SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS`	`-lresolv`	PHP `make` 命令的额外 `EXTRA_LIBS` 变量

Linux

var name	default value	comment
`UPX_EXEC`	`$PKG_ROOT_PATH/bin/upx`	UPX 压缩工具的路径
`GNU_ARCH`	`x86_64` 或 `aarch64`	当前环境的 CPU 架构
`CC`	Alpine: `gcc`, Other: `$GNU_ARCH-linux-musl-gcc`	C 编译器
`CXX`	Alpine: `g++`, Other: `$GNU_ARCH-linux-musl-g++`	C++ 编译器
`AR`	Alpine: `ar`, Other: `$GNU_ARCH-linux-musl-ar`	静态库工具
`LD`	`ld.gold`	链接器
`PATH`	`/usr/local/musl/bin:/usr/local/musl/$GNU_ARCH-linux-musl/bin:$PATH`	系统 PATH
`SPC_DEFAULT_C_FLAGS`	empty	默认 C 编译标志
`SPC_DEFAULT_CXX_FLAGS`	empty	默认 C++ 编译标志
`SPC_CMD_PREFIX_PHP_BUILDCONF`	`./buildconf --force`	编译 PHP `buildconf` 命令前缀
`SPC_CMD_PREFIX_PHP_CONFIGURE`	`LD_LIBRARY_PATH={ld_lib_path} ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg`	编译 PHP `configure` 命令前缀
`SPC_CMD_PREFIX_PHP_MAKE`	`make -j$SPC_CONCURRENCY`	编译 PHP `make` 命令前缀
`SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS`	`$SPC_DEFAULT_C_FLAGS`	PHP `configure` 命令的 `CFLAGS` 变量
`SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS`	`-I$BUILD_INCLUDE_PATH`	PHP `configure` 命令的 `CPPFLAGS` 变量
`SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS`	`-L$BUILD_LIB_PATH`	PHP `configure` 命令的 `LDFLAGS` 变量
`SPC_CMD_VAR_PHP_CONFIGURE_LIBS`	`-ldl -lpthread`	PHP `configure` 命令的 `LIBS` 变量
`SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS`	`-g0 -Os -fno-ident -fPIE` 或 `-g -O0 -fno-ident -fPIE`（当使用 `--no-strip` 时为后者）	PHP `make` 命令的 `EXTRA_CFLAGS` 变量
`SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS`	empty	PHP `make` 命令的额外 `EXTRA_LIBS` 变量
`SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM`	`-all-static`（当使用 `clang` 时：`-Xcompiler -fuse-ld=lld -all-static`）	`make` 命令的额外 `LDFLAGS` 变量（用于编译程序）
`SPC_NO_MUSL_PATH`	empty	是否不插入 musl 工具链的 PATH（值为 `yes` 时不插入）

{ld_lib_path} 值为 /usr/local/musl/$GNU_ARCH-linux-musl/lib。

FreeBSD

因 FreeBSD 系统的用户较少，我们暂时不提供 FreeBSD 系统的环境变量。

Unix

对于 macOS、Linux、FreeBSD 等 Unix 系统，以下环境变量是通用的。

var name	default value	comment
`PATH`	`$BUILD_BIN_PATH:$PATH`	系统 PATH
`PKG_CONFIG_PATH`	`$BUILD_LIB_PATH/pkgconfig`	pkg-config 的搜索路径
`PKG_CONFIG`	`$BUILD_BIN_PATH/pkg-config`	pkg-config 命令路径

编译依赖库的环境变量（仅限 Unix 系统）

从 2.2.0 开始，static-php-cli 对所有 macOS、Linux、FreeBSD 等 Unix 系统的编译依赖库的命令均支持自定义环境变量。

这样你就可以随时通过环境变量来调整编译依赖库的行为。例如你可以通过 xxx_CFLAGS=-O0 来设置编译 xxx 库的优化参数。

当然，不是每个依赖库都支持注入环境变量，我们目前提供了三个通配的环境变量，后缀分别为：

_CFLAGS: C 编译器的参数
_LDFLAGS: 链接器的参数
_LIBS: 额外的链接库

前缀为依赖库的名称，具体依赖库的名称以 lib.json 为准。其中，带有 - 的依赖库名称需要将 - 替换为 _。

下面是一个替换 openssl 库编译的优化选项示例：

openssl_CFLAGS="-O0"

库名称使用同 lib.json 中列举的名称，区分大小写。

::: tip 当未指定相关环境变量时，除以下变量外，其余值均默认为空：

var name	var default value
`pkg_config_CFLAGS`	macOS: `$SPC_DEFAULT_C_FLAGS -Wimplicit-function-declaration -Wno-int-conversion`, Other: empty
`pkg_config_LDFLAGS`	Linux: `--static`, Other: empty
`imagemagick_LDFLAGS`	Linux: `-static`, Other: empty
`imagemagick_LIBS`	macOS: `-liconv`, Other: empty
`ldap_LDFLAGS`	`-L$BUILD_LIB_PATH`
`openssl_CFLAGS`	Linux: `$SPC_DEFAULT_C_FLAGS`, Other: empty
others...	empty

:::

下表是支持自定义以上三种变量的依赖库名称列表：

lib name
brotli
bzip
curl
freetype
gettext
gmp
imagemagick
ldap
libargon2
libavif
libcares
libevent
openssl

::: tip 因为给每个库适配自定义环境变量是一项特别繁琐的工作，且大部分情况下你都不需要这些库的自定义环境变量，所以我们目前只支持了部分库的自定义环境变量。

如果你需要自定义环境变量的库不在上方列表，可以通过 GitHub Issue 来提出需求。 :::

env-vars.md 14 KB History Raw