static-php-cli

Compile A Statically Linked PHP With Swoole and other Extensions. English README

编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！

注：只能编译 CLI 模式，暂不支持 CGI 和 FPM 模式

环境需求

• 目前在 x86_64 和 aarch64(arm64) 架构上编译成功，其他架构需自行测试
• 需要 Docker（或等我将脚本提出来也可以直接在 Alpine Linux 上使用）
• 脚本支持编译的 PHP 版本（7.2 ~ 8.0）

开始

可以直接在旁边的 Release 中下载编译好的二进制。

也可以自己使用 Dockerfile 进行编译构建：

git clone https://github.com/crazywhalecc/static-php-cli.git
cd static-php-cli/docker
docker build -t static-php .

编译之后可以使用下方命令将二进制 PHP 提取出来，用以下方式：

mkdir dist
docker run --rm -v $(pwd)/dist:/dist/ -it static-php cp php-dist/bin/php /dist/
cd dist
file ./php

如果要选择安装的扩展，可以修改 docker/extensions.txt 文件，具体规则如下：

• 文件内使用 # 可以注释，表示不安装
• 扩展名一律使用小写，目前默认状态下文件内所列的扩展为支持的扩展，其他扩展暂不支持，如有需求请提 Issue 添加

支持的扩展表

是否支持	PHP 扩展名称	支持版本	备注
yes	bcmath	*
yes	calendar	*
yes	ctype	*
yes	curl	*
yes	dom	*
	event
yes	filter	*
yes	gd	*
yes	hash	*	PHP7.3及以下版本需指定 --enable-hash，7.4以上默认开启
yes	iconv	*
yes	inotify	3.0.0
yes	json	*
yes	libxml	*
yes	mbstring	*
yes	mongodb	>=1.9.1	not tested
	mysqli
yes	mysqlnd	*
yes	openssl	*
yes	pcntl	*
yes	pdo	*
yes	pdo_mysql	*
	pdo_pgsql	*
yes	phar	*
yes	posix	*
yes	redis	*
yes	simplexml	*
yes	sockets	*
yes	sqlite3	*	not tested
yes	swoole	>=4.6.6	默认支持mysqlnd, sockets, openssl, redis
yes	tokenizer	*
yes	xml	*
yes	xmlreader	*
yes	xmlwriter	*
	zip
yes	zlib	*

自定义

• docker/Dockerfile 中修改 VER_PHP=x.x.x 来更换 PHP 版本。
• docker/Dockerfile 中修改 USE_BACKUP=yes 使用备用下载源码地址（不在中国大陆可以使用备用地址）。
• docker/extensions.txt 指定要编译安装的扩展。
• docker/compile-php.sh 中的 php_compile_args 函数来调整 PHP 编译参数。
• docker/check-extensions.sh 中的 check_in_configure 函数可调整 PHP 扩展编译的参数 。
• docker/config.json 可调整要下载的扩展和依赖库版本和链接。

目前的问题（对勾为已解决）

• 不支持 event(libevent) 扩展，event 扩展的 sockets 支持不能在静态编译中使用，因为静态内嵌编译暂时没办法调整扩展编译顺序，同时其本身也不支持静态编译。
• Swoole 扩展不支持 --enable-swoole-curl，也是因为编译顺序和加载顺序的问题。
• 不支持 readline 扩展，readline 扩展安装后无法正常使用 php -a，原因还没有弄清楚，可能是静态编译造成的 ncurses 库出现了问题。
• curl/libcurl 扩展静态编译
• 可自行选择不需要编译进入的扩展
• php.ini 内嵌或分发
• i18n（国际化脚本本身和 README）

如果你对以上问题有解决方案，请提出 Issue 或 PR！

运行示例

编译后的状态

直接运行 Workerman

参考资料

• https://blog.terrywh.net/post/2019/php-static-openssl/
• https://stackoverflow.com/a/37245653
• http://blog.gaoyuan.xyz/2014/04/09/statically-compile-php/