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