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  sapi/micro

2.打patch

patch文件在patches目录下，选择patch文件：

并分别进行patch：

# 在php源码目录下
patch -p1 < sapi/micro/patches/

unix-like 构建

0.参考官方构建说明准备PHP构建环境

1.buildconf

# 在php源码目录下
./buildconf --force

2.configure

# 在php源码目录下
./configure 

参考的选项：

--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 

参考的选项：

--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内容为

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 
autoreconf -i
# 或者直接下载tarball解压
wget 
tar xf 
cd 
# 如果使用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