我們?nèi)绾螛?gòu)建自己的PHP靜態(tài)可執(zhí)行文件
介紹
static-php-cli 是一個(gè)用于構(gòu)建靜態(tài)編譯的 PHP 二進(jìn)制的工具，目前支持 Linux 和 macOS 系統(tǒng)。在本章節(jié)中，你將了解到如何使用 static-php-cli 構(gòu)建獨(dú)立的 php 程序。
編譯環(huán)境
下面是架構(gòu)支持情況?? 代表支持 GitHub Action 構(gòu)建，?? 代表支持本地構(gòu)建，空代表暫不支持。
OS | x86_64 | aarch64 |
macOS | ?? ?? | ?? ?? |
Linux | ?? ?? | ?? ?? |
Windows | ?? ?? | |
FreeBSD | ?? | ?? |
其中，Linux 目前僅在 Ubuntu、Debian、Alpine 發(fā)行版測試通過，其他發(fā)行版未進(jìn)行測試，不能保證編譯成功。對于未經(jīng)過測試的發(fā)行版，可以使用 Docker 等方式本地編譯，避免環(huán)境導(dǎo)致的問題。
macOS 下支持 x86_64 和 Arm 兩種架構(gòu)，但在其中一個(gè)架構(gòu)上編譯的二進(jìn)制無法直接在另一個(gè)架構(gòu)上使用。Rosetta 2 不能保證 Arm 架構(gòu)編譯的程序可以完全運(yùn)行在 x86_64 環(huán)境下。
Windows 目前只支持 x86_64 架構(gòu)，不支持 32 位 x86、不支持 arm64 架構(gòu)。
PHP 支持版本
目前，static-php-cli 對 PHP 7.4 ~ 8.3 版本是支持的，對于 PHP 7.4 及更早版本理論上支持，只需下載時(shí)選擇早期版本即可。但由于部分?jǐn)U展和特殊組件已對早期版本的 PHP 停止了支持，所以 static-php-cli 不會(huì)明確支持早期版本。我們推薦你編譯盡可能新的 PHP 版本，以獲得更好的體驗(yàn)。
本地構(gòu)建
手動(dòng)構(gòu)建
本項(xiàng)目提供了一個(gè) static-php-cli 的二進(jìn)制文件，你可以直接下載對應(yīng)平臺的二進(jìn)制文件，然后使用它來構(gòu)建靜態(tài)的 PHP。目前spc二進(jìn)制支持的平臺有 Linux 和 macOS。
使用以下命令從自托管服務(wù)器下載；
curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-linux-x86_64更多版本：https://static-php.dev/zh/guide/manual-build.html。
賦予二進(jìn)制可執(zhí)行權(quán)限；
chmod +x ./spc查看版本
./spc --version
static-php-cli 2.3.2下載依賴包
使用命令bin/spc download可以下載編譯需要的源代碼，包括 php-src 以及依賴的各種庫的源碼。
僅下載要編譯的擴(kuò)展及依賴庫（使用擴(kuò)展名，包含可選庫）；
./spc download --for-extensions=pcntl,zstd --with-php=8.2
圖片
環(huán)境檢查
如果你可以正常運(yùn)行bin/spc但無法正常編譯靜態(tài)的 PHP 或依賴庫，可以先運(yùn)行bin/spc doctor檢查系統(tǒng)自身是否缺少依賴。
./spc doctor
圖片
如果提示以下錯(cuò)誤，請使用sudo權(quán)限。
[11:12:22] [INFO] [EXEC] ./configure --disable-gcc-wrapper
Fix failed
Some check item are not fixedcmake版本太低；
Checking if cmake version >= 3.18 ... cmake version is too low (3.10.2), please update it manually!
Some check items can not be fixed !下載解壓；
wget https://cmake.org/files/v3.22/cmake-3.22.5.tar.gz
tar -zxvf cmake-3.22.5.tar.gz
cd cmake-3.22.5
# 編譯安裝
./configure
make
sudo make install
圖片
驗(yàn)證安裝；
cmake --version
cmake version 3.22.5
CMake suite maintained and supported by Kitware (kitware.com/cmake).重新檢測，可以看出以下輸出信息表示環(huán)境檢查通過。
_ _ _ _
___| |_ __ _| |_(_) ___ _ __ | |__ _ __
/ __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \
\__ \ || (_| | |_| | (_|_____| |_) | | | | |_) |
|___/\__\__,_|\__|_|\___| | .__/|_| |_| .__/ v2.3.2
|_| |_|
Checking if current OS are supported ... Linux x86_64 ubuntu, supported
Checking if necessary tools are installed ... ok
Checking if musl-wrapper is installed ... ok
Checking if musl-cross-make is installed ... ok
Checking if cmake version >= 3.18 ... 3.22.5
Checking if necessary linux headers are installed ... ok
Doctor check complete !編譯 PHP
使用 build 命令可以開始構(gòu)建靜態(tài) php 二進(jìn)制，在執(zhí)行bin/spc build命令前，務(wù)必先使用download命令下載資源，建議使用doctor檢查環(huán)境。
./spc build pcntl,zstd --build-cli
圖片
構(gòu)建結(jié)果；
_ _ _ _
___| |_ __ _| |_(_) ___ _ __ | |__ _ __
/ __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \
\__ \ || (_| | |_| | (_|_____| |_) | | | | |_) |
|___/\__\__,_|\__|_|\___| | .__/|_| |_| .__/ v2.3.2
|_| |_|
[14:52:49] [INFO] Build OS: Linux (x86_64)
[14:52:49] [INFO] Build SAPI: cli
[14:52:49] [INFO] Extensions (2): pcntl,zstd
[14:52:49] [INFO] Libraries (1): zstd
[14:52:49] [INFO] Strip Binaries: yes
[14:52:49] [INFO] Enable ZTS: no
[14:52:49] [INFO] PHP Version: 8.2.22
[14:52:49] [NOTI] Build will start after 2s ...
[14:52:51] [NOTI] lib [pkg-config] already built
[14:52:51] [INFO] Building required library [zstd]
[14:52:51] [INFO] Entering dir: /home/www/build/source/zstd/build/cmake/build
[14:52:51] [INFO] [EXEC] cmake -DCMAKE_C_COMPILER=x86_64-linux-musl-gcc -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/ -DCMAKE_INSTALL_BINDIR=/bin -DCMAKE_INSTALL_LIBDIR=/lib -DCMAKE_INSTALL_INCLUDEDIR=/include -DCMAKE_TOOLCHAIN_FILE=/home/www/build/source/toolchain.cmake -DZSTD_BUILD_STATIC=ON -DZSTD_BUILD_SHARED=OFF ..
[14:52:53] [INFO] [EXEC] cmake --build . -j 2
[14:54:38] [INFO] [EXEC] make install DESTDIR=/home/www/build/buildroot
[14:54:39] [INFO] Patching library [zstd] pkgconfig
[14:54:39] [INFO] lib [zstd] setup success, took 107.47 s
[14:54:39] [INFO] Entering dir: /home/www/build/source/php-src
[14:54:39] [INFO] [EXEC] ./buildconf --force
[14:54:42] [INFO] Entering dir: /home/www/build/source/php-src
[14:54:42] [INFO] pcntl is using --enable-pcntl
[14:54:42] [INFO] zstd is using --enable-zstd --with-libzstd="/home/www/build/buildroot"
[14:54:42] [INFO] [EXEC] LD_LIBRARY_PATH=/usr/local/musl/x86_64-linux-musl/lib ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg --enable-cli --disable-fpm --disable-embed --disable-micro --enable-pcntl --enable-zstd --with-libzstd="/home/www/build/buildroot" CFLAGS='' CPPFLAGS='-I/home/www/build/buildroot/include' LDFLAGS='-L/home/www/build/buildroot/lib' LIBS='-ldl -lpthread -lm'
[14:55:02] [INFO] cleaning up
[14:55:02] [INFO] Entering dir: /home/www/build/source/php-src
[14:55:02] [INFO] [EXEC] make clean
[14:55:03] [INFO] building cli
[14:55:03] [INFO] Entering dir: /home/www/build/source/php-src
[14:55:03] [INFO] [EXEC] sed -i "s|//lib|/lib|g" Makefile
[14:55:03] [INFO] [EXEC] $SPC_CMD_PREFIX_PHP_MAKE EXTRA_CFLAGS='-g -Os -fno-ident -fPIE' EXTRA_LIBS='/home/www/build/buildroot/lib/libzstd.a ' EXTRA_LDFLAGS_PROGRAM='-all-static' cli
[15:02:04] [INFO] Entering dir: /home/www/build/source/php-src/sapi/cli
[15:02:04] [INFO] [EXEC] strip --strip-all php
[15:02:04] [INFO] Deploying cli file
[15:02:04] [INFO] [EXEC] cp '/home/www/build/source/php-src/sapi/cli/php' '/home/www/build/buildroot/bin/'
[15:02:04] [INFO] running cli sanity check
[15:02:04] [INFO] [EXEC] /home/www/build/buildroot/bin/php -r "echo \"hello\";"
[15:02:04] [INFO] Build complete, used 554.717 s !
[15:02:04] [INFO] Static php binary path: /home/www/build/buildroot/bin/php
[15:02:04] [INFO] License path: /home/www/build/buildroot/license/使用 PHP CLi
構(gòu)建完成之后，會(huì)在當(dāng)前目錄buildroot/bin生產(chǎn)一個(gè)二進(jìn)制文件php，可以直接分發(fā)和使用。
buildroot/bin$ tree -L 1
.
├── php
├── pkg-config
├── unzstd -> zstd
├── zstd
├── zstdcat -> zstd
├── zstdgrep
├── zstdless
└── zstdmt -> zstd查看PHP版本；
/buildroot/bin$ ./php -v
PHP 8.2.22 (cli) (built: Aug 9 2024 23:01:57) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.22, Copyright (c) Zend Technologies已安裝模塊pcntl,zstd；
./php -m
[PHP Modules]
Core
date
hash
json
pcntl
pcre
random
Reflection
SPL
standard
zstd
[Zend Modules]打包編譯好的二進(jìn)制文件
tar -czvf php-8.2.22-static-bin-x86_64.tar.gz /home/www/build/buildroot/bin/php其他
重復(fù)構(gòu)建、調(diào)試
如果你需要重復(fù)構(gòu)建、調(diào)試，你可以刪除buildroot/和source/兩個(gè)目錄，這樣你可以從已下載的源碼壓縮包重新解壓并構(gòu)建：
# remove
rm -rf buildroot source
# build again
bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli構(gòu)建多個(gè)版本的 PHP
如果你想構(gòu)建多個(gè)版本的 PHP，且不想每次都重復(fù)構(gòu)建其他依賴庫，可以使用switch-php-version在編譯好一個(gè)版本后快速切換至另一個(gè)版本并編譯：
# switch to 8.3
bin/spc switch-php-version 8.3
# build
bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli
# switch to 8.0
bin/spc switch-php-version 8.0
# build
bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli切換到7.4；
sudo ./spc switch-php-version 7.4
[sudo] password for www:
Downloading PHP source...
Switched to PHP 7.4 successfully!重新構(gòu)建；
./spc build pcntl,zstd --build-cli
_ _ _ _
___| |_ __ _| |_(_) ___ _ __ | |__ _ __
/ __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \
\__ \ || (_| | |_| | (_|_____| |_) | | | | |_) |
|___/\__\__,_|\__|_|\___| | .__/|_| |_| .__/ v2.3.2
|_| |_|
[01:22:00] [INFO] Build OS: Linux (x86_64)
[01:22:00] [INFO] Build SAPI: cli
[01:22:00] [INFO] Extensions (2): pcntl,zstd
[01:22:00] [INFO] Libraries (1): zstd
[01:22:00] [INFO] Strip Binaries: yes
[01:22:00] [INFO] Enable ZTS: no
[01:22:00] [INFO] PHP Version: 7.4.33
[01:22:00] [NOTI] Build will start after 2s ...查看版本；
/home/www/build/buildroot/bin/php -v
PHP 7.4.33 (cli) (built: Aug 10 2024 09:30:26) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
