PHPMicromicro 自执行 SAPI
microphp 自执行 SAPI
micro 自执行 SAPI 提供了 php“自执行文件”的可能性
你只需要将构建的 micro.sfx 文件与任意 php 文件或者 phar 包拼接（cat 或者 copy /b）为一个文件就可以直接执行这个 php 文件
兼容性
目前兼容 PHP7.4 与 8.0；兼容 Windows、Linux、macOS。
构建
准备源码
1.将本仓库clone到php源码的sapi/micro下
# 在php源码目录下 git clone <url for this repo> sapi/micro
2.打patch
patch文件在patches目录下，选择patch文件：
| patch文件 | 平台/PHP版本 | 是否必须 | 作用 |
|---|---|---|---|
| disable_huge_page.patch | Linux | 可选 | 禁用linux构建的max-page-size选项，缩减sfx体积（典型的， 10M+ -> 5M） |
| vcruntime140_<php version>.patch | Windows | 必选 | 禁用sfx启动时GetModuleHandle(vcruntime140(d).dll) |
| win32_<php version>.patch | Windows | 必选 | 修改构建系统以静态构建 |
| zend_stream.patch | Windows | 必选 | 修改构建系统以静态构建 |
| phar.patch | * | 可选 | 实现phar的支持 |
并分别进行patch：
# 在php源码目录下 patch -p1 < sapi/micro/patches/<name of patch>
unix-like 构建
0.参考官方构建说明准备PHP构建环境
1.buildconf
# 在php源码目录下 ./buildconf --force
2.configure
# 在php源码目录下 ./configure <options>
参考的选项：
--disable-phpdbg --disable-cgi --disable-cli --disable-all --enable-micro --enable-phar --with-ffi --enable-zlib
3.make
# 在php源码目录下 make micro
（make all（或者make） 或许也可以，但建议还是只构建micro SAPI
生成的文件在 sapi/micro/micro.sfx
Windows 构建
0.参考官方构建说明准备PHP构建环境
1.buildconf
# 在php源码目录下 buildconf
2.configure
# 在php源码目录下 configure <options>
参考的选项：
--disable-all --disable-zts --enable-micro --enable-phar --with-ffi --enable-zlib
3.make 由于构建系统的实现问题， Windows下不能使用nmake命令直接构建，使用nmake sfx来构建
# 在php源码目录下 nmake sfx
生成的文件在 <架构名>\<配置名>\micro.sfx
使用
将micro.sfx和php文件拼接即可
例如：myawesomeapp.php内容为
<?php echo "hello, this is my awesome app." . PHP_EOL;
linux下
cat /path/to/micro.sfx myawesomeapp.php > myawesomeapp chmod 0755 ./myawesomeapp ./myawesomeapp # 回显 "hello, this is my awesome app."
或者Windows下
COPY /b \path\to\micro.sfx + myawesomeapp.php myawesomeapp.exe myawesomeapp.exe REM 回显 "hello, this is my awesome app."
优化
linux下php对于hugepages优化导致了生成的文件很大，如果不考虑对hugepages的优化，使用disable_huge_page.patch来来减小文件尺寸
linux下静态构建需要包含c标准库，常见的glibc较大，推荐使用musl，手动安装的musl或者某些发行版会提供gcc（或clang）的musl wrapper：musl-gcc或者musl-clang。在进行configure之前，通过指定CC和CXX变量来使用这些wrapper
例如
# ./buildconf things... export CC=musl-gcc export CXX=musl-gcc # ./configure balabala # make balabala
linux下构建时一般希望是纯静态的，但构建使用的发行版不一定提供依赖的库（zlib libffi等）的静态库版本，这时考虑自行构建依赖库
以libffi为例：
# 通过git获取源码 git clone https://github.com/libffi/libffi cd libffi git checkout <version you like, v3.3 for example> autoreconf -i # 或者直接下载tarball解压 wget <url> tar xf <tar name> cd <extracted name> # 如果使用musl的话 export CC=musl-gcc export CXX=musl-gcc # 构建安装 ./configure --prefix=/my/prefered/path && make -j`nproc` && make install
然后使用以下export命令来构建micro：
# ./buildconf things... # export CC=musl-xxx things... export PKG_CONFIG_PATH=/my/prefered/path/lib/pkgconfig # ./configure balabala # make balabala