Update docs vue components

* Add optional workflow

* Add optional workflow

.github/FUNDING.yml

@@ -3,7 +3,7 @@
 github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
 patreon: # Replace with a single Patreon username
 open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
+ko_fi: crazywhalecc # Replace with a single Ko-fi username
 tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
 community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
 liberapay: # Replace with a single Liberapay username
@@ -11,5 +11,5 @@ issuehunt: # Replace with a single IssueHunt username
 otechie: # Replace with a single Otechie username
 lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
 # noinspection YAMLSchemaValidation
-buy_me_a_coffee: crazywhalecc
+buy_me_a_coffee: # crazywhalecc
 custom: 'https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md' # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/workflows/tests.yml

@@ -109,24 +109,41 @@ jobs:
 
       - name: "Run PHPUnit Tests"
         run: |
-          vendor/bin/phpunit tests/ --no-coverage
+          SPC_NO_MUSL_PATH=yes vendor/bin/phpunit tests/ --no-coverage
+
+  define-matrix:
+    name: "Define Matrix"
+    runs-on: ubuntu-latest
+    outputs:
+      php: ${{ steps.gendef.outputs.php }}
+      os: ${{ steps.gendef.outputs.os }}
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Setup PHP"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.2
+
+      - name: Define
+        id: gendef
+        run: |
+          PHP_VERSIONS=$(php src/globals/test-extensions.php php)
+          OS_VERSIONS=$(php src/globals/test-extensions.php os)
+          echo 'php='"$PHP_VERSIONS" >> "$GITHUB_OUTPUT"
+          echo 'os='"$OS_VERSIONS" >> "$GITHUB_OUTPUT"
+
 
   build:
     name: "Build PHP Test (PHP ${{ matrix.php }} ${{ matrix.os }})"
     runs-on: ${{ matrix.os }}
+    needs: define-matrix
     timeout-minutes: 120
     strategy:
       matrix:
-        php:
+        php: ${{ fromJSON(needs.define-matrix.outputs.php) }}
-          - "8.0"
+        os: ${{ fromJSON(needs.define-matrix.outputs.os) }}
-          - "8.1"
-          - "8.2"
-          - "8.3"
-        os:
-          - ubuntu-latest
-          - macos-13
-          - windows-latest
-          - macos-14
       fail-fast: false
     steps:
       - name: "Checkout"
@@ -139,6 +156,8 @@ jobs:
           tools: pecl, composer
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
+        env:
+          phpts: nts
 
       - name: "Cache composer packages"
         id: composer-cache
@@ -154,13 +173,13 @@ jobs:
         uses: actions/cache@v4
         with:
           path: downloads
-          key: php-${{ matrix.php }}-dependencies
+          key: php-dependencies-${{ matrix.os }}
 
       - name: "Install Dependencies"
         run: composer update -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
 
       - name: "Run Build Tests (doctor)"
-        run: bin/spc doctor --auto-fix
+        run: bin/spc doctor --auto-fix --debug
 
       - name: "Prepare UPX for Windows"
         if: matrix.os == 'windows-latest'
@@ -175,19 +194,7 @@ jobs:
           echo "UPX_CMD=$(php src/globals/test-extensions.php upx)" >> $GITHUB_ENV
 
       - name: "Run Build Tests (download)"
-        run: |
+        run: php src/globals/test-extensions.php download_cmd ${{ matrix.os }} ${{ matrix.php }}
-          bin/spc download --for-extensions="$(php src/globals/test-extensions.php extensions)" --for-libs="$(php src/globals/test-extensions.php libs)" --with-php=${{ matrix.php }} --ignore-cache-sources=php-src --debug --retry=5 --shallow-clone
 
-      - name: "Download pre-built libraries for pkg-config"
+      - name: "Run Build Tests (build)"
-        if: matrix.os != 'windows-latest'
+        run: php src/globals/test-extensions.php build_cmd ${{ matrix.os }} ${{ matrix.php }}
-        run: |
-          bin/spc del-download pkg-config
-          bin/spc download pkg-config --prefer-pre-built --debug
-
-      - name: "Run Build Tests (build, *nix)"
-        if: matrix.os != 'windows-latest'
-        run: bin/spc build "$(php src/globals/test-extensions.php extensions)" $(php src/globals/test-extensions.php zts) $(php src/globals/test-extensions.php no_strip) $UPX_CMD --with-libs="$(php src/globals/test-extensions.php libs)" --build-cli --build-micro --build-fpm --debug
-
-      - name: "Run Build Tests (build, windows)"
-        if: matrix.os == 'windows-latest'
-        run: bin/spc build "$(php src/globals/test-extensions.php extensions)" $(php src/globals/test-extensions.php zts) $(php src/globals/test-extensions.php no_strip) $env:UPX_CMD --with-libs="$(php src/globals/test-extensions.php libs)" --build-cli --build-micro --debug

README.md

@@ -142,7 +142,7 @@ curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-m
 # macOS aarch64 (Apple)
 curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-macos-aarch64
 # Windows (x86_64, win10 build 17063 or later)
-curl.exe -fsSL -o spc.exehttps://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-windows-x64.exe
+curl.exe -fsSL -o spc.exe https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-windows-x64.exe
 
 # Add execute perm (Linux and macOS only)
 chmod +x ./spc

bin/setup-runtime.ps1

@@ -51,10 +51,10 @@ if ($action -eq 'add-path') {
 }
 
 # get php 8.1 specific version
-$API = (Invoke-WebRequest -Uri "https://www.php.net/releases/index.php?json&version=8.1") | ConvertFrom-Json
+$API = (Invoke-WebRequest -Uri "https://www.php.net/releases/index.php?json&version=8.3") | ConvertFrom-Json
 
 # php windows download
-$PHPRuntimeUrl = "https://windows.php.net/downloads/releases/php-" + $API.version + "-Win32-vs16-x64.zip"
+$PHPRuntimeUrl = "https://windows.php.net/downloads/releases/php-" + $API.version + "-nts-Win32-vs16-x64.zip"
 $ComposerUrl = "https://getcomposer.org/download/latest-stable/composer.phar"
 
 # create dir

composer.json

@@ -11,6 +11,7 @@
     "require": {
         "php": ">= 8.1",
         "ext-mbstring": "*",
+        "ext-zlib": "*",
         "laravel/prompts": "^0.1.12",
         "symfony/console": "^5.4 || ^6 || ^7",
         "zhamao/logger": "^1.0"
@@ -19,10 +20,10 @@
         "captainhook/captainhook-phar": "^5.23",
         "captainhook/hook-installer": "^1.0",
         "friendsofphp/php-cs-fixer": "^3.25",
-        "humbug/box": "^4.5",
+        "humbug/box": "^4.5.0 || ^4.6.0",
         "nunomaduro/collision": "^7.8",
         "phpstan/phpstan": "^1.10",
-        "phpunit/phpunit": "^10.3 || ^9"
+        "phpunit/phpunit": "^10.3 || ^9.5"
     },
     "autoload": {
         "psr-4": {

config/env.ini

@@ -0,0 +1,134 @@
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; static-php-cli (spc) env configuration
+;
+; This file is used to set default env vars for static-php-cli build.
+; As dynamic build process, some of these vars can be overwritten by CLI options.
+; And you can also overwrite these vars by setting them in your shell environment.
+;
+; We need to use some pre-defined internal env vars, like `BUILD_ROOT_PATH`, `DOWNLOAD_PATH`, etc.
+; Please note that these vars cannot be defined in this file, they are only be defined before static-php-cli running.
+; Here's a list of these pre-defined internal env vars, these vars are only be defined in the static-php-cli build process if not set in the shell environment:
+;
+;   BUILD_ROOT_PATH:    the root path of the build process. (default: `$(pwd)/buildroot`)
+;   BUILD_INCLUDE_PATH: the path of the include files. (default: `$BUILD_ROOT_PATH/include`)
+;   BUILD_LIB_PATH:     the path of the lib files. (default: `$BUILD_ROOT_PATH/lib`)
+;   BUILD_BIN_PATH:     the path of the bin files. (default: `$BUILD_ROOT_PATH/bin`)
+;   PKG_ROOT_PATH:      the root path of the package files. (default: `$(pwd)/pkgroot`)
+;   SOURCE_PATH:        the path of the source files. (default: `$(pwd)/source`)
+;   DOWNLOAD_PATH:      the path of the download files. (default: `$(pwd)/downloads`)
+;   CPU_COUNT:          the count of the CPU cores. (default: `$(nproc)`)
+;   GNU_ARCH:           the GNU arch of the current system. (default: `$(uname -m)`, e.g. `x86_64`, `aarch64`)
+;   MAC_ARCH:           the MAC arch of the current system. (default: `$(uname -m)`, e.g. `x86_64`, `arm64`)
+;
+; Here's a list of env vars, these value cannot be changed anywhere:
+;
+;   WORKING_DIR:        the working directory of the build process. (default: `$(pwd)`)
+;   ROOT_DIR:           the root directory of static-php-cli. (default: `/path/to/static-php-cli`, when running in phar or micro mode: `phar://path/to/spc.phar`)
+;
+;   * These vars are only be defined in Unix (macOS, Linux, FreeBSD)Builder *
+;   PATH:                               static-php-cli will add `$BUILD_BIN_PATH` to PATH.
+;   PKG_CONFIG:                         static-php-cli will set `$BUILD_BIN_PATH/pkg-config` to PKG_CONFIG.
+;   PKG_CONFIG_PATH:                    static-php-cli will set `$BUILD_LIB_PATH/pkgconfig` to PKG_CONFIG_PATH.
+;   SPC_PHP_DEFAULT_OPTIMIZE_CFLAGS:    the default optimization CFLAGS for compiling php. (if --no-strip option is set: `-g -O0`, else: `-g -Os`)
+;
+;   * These vars are only be defined in LinuxBuilder *
+;   SPC_LINUX_DEFAULT_CC:                   the default compiler for linux. (For alpine linux: `gcc`, default: `$GNU_ARCH-linux-musl-gcc`)
+;   SPC_LINUX_DEFAULT_CXX:                  the default c++ compiler for linux. (For alpine linux: `g++`, default: `$GNU_ARCH-linux-musl-g++`)
+;   SPC_LINUX_DEFAULT_AR:                   the default archiver for linux. (For alpine linux: `ar`, default: `$GNU_ARCH-linux-musl-ar`)
+;   SPC_PHP_DEFAULT_LD_LIBRARY_PATH_CMD:    the default LD_LIBRARY_PATH for php. (linux: `LD_LIBRARY_PATH=/usr/local/musl/$GNU_ARCH-linux-musl/lib`, default: empty)
+
+
+[global]
+; Build concurrency for make -jN, default is CPU_COUNT, this value are used in every libs.
+SPC_CONCURRENCY=${CPU_COUNT}
+; Ignore PHP version check before building some extensions
+SPC_SKIP_PHP_VERSION_CHECK="no"
+; Ignore some check item for bin/spc doctor command, comma separated (e.g. SPC_SKIP_DOCTOR_CHECK_ITEMS="if homebrew has installed")
+SPC_SKIP_DOCTOR_CHECK_ITEMS=""
+
+[windows]
+; php-sdk-binary-tools path
+PHP_SDK_PATH="${WORKING_DIR}\php-sdk-binary-tools"
+; upx executable path
+UPX_EXEC="${PKG_ROOT_PATH}\bin\upx.exe"
+; phpmicro patches, for more info, see: https://github.com/easysoft/phpmicro/tree/master/patches
+SPC_MICRO_PATCHES=static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,cli_static
+
+[linux]
+; include PATH for musl libc.
+SPC_NO_MUSL_PATH=no
+; compiler environments
+CC=${SPC_LINUX_DEFAULT_CC}
+CXX=${SPC_LINUX_DEFAULT_CXX}
+AR=${SPC_LINUX_DEFAULT_AR}
+LD=ld.gold
+; default compiler flags, used in CMake toolchain file, openssl and pkg-config build
+SPC_DEFAULT_C_FLAGS=
+SPC_DEFAULT_CXX_FLAGS=
+; extra libs for building php executable, used in `make` command for building php (this value may changed by extension build process, space separated)
+SPC_EXTRA_LIBS=
+; upx executable path
+UPX_EXEC=${PKG_ROOT_PATH}/bin/upx
+; phpmicro patches, for more info, see: https://github.com/easysoft/phpmicro/tree/master/patches
+SPC_MICRO_PATCHES=static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream
+
+; *** default build command for building php ***
+; buildconf command
+SPC_CMD_PREFIX_PHP_BUILDCONF="./buildconf --force"
+; configure command
+SPC_CMD_PREFIX_PHP_CONFIGURE="${SPC_PHP_DEFAULT_LD_LIBRARY_PATH_CMD} ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg"
+; make command
+SPC_CMD_PREFIX_PHP_MAKE="make -j${CPU_COUNT}"
+
+; *** default build vars for building php ***
+; CFLAGS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS="${SPC_DEFAULT_C_FLAGS}"
+; CPPFLAGS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS="-I${BUILD_INCLUDE_PATH}"
+; LDFLAGS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS="-L${BUILD_LIB_PATH}"
+; LIBS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_LIBS="-ldl -lpthread -lm"
+; EXTRA_CFLAGS for `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS="${SPC_PHP_DEFAULT_OPTIMIZE_CFLAGS} -fno-ident -fPIE"
+; EXTRA_LIBS for `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS=""
+; EXTRA_LDFLAGS_PROGRAM for `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM="-all-static"
+
+[macos]
+; compiler environments
+CC=clang
+CXX=clang++
+; default compiler flags, used in CMake toolchain file, openssl and pkg-config build
+SPC_DEFAULT_C_FLAGS="--target=${MAC_ARCH}-apple-darwin"
+SPC_DEFAULT_CXX_FLAGS="--target=${MAC_ARCH}-apple-darwin"
+; extra libs for building php executable, used in `make` command for building php (this value may changed by extension build process, space separated)
+SPC_EXTRA_LIBS=
+; phpmicro patches, for more info, see: https://github.com/easysoft/phpmicro/tree/master/patches
+SPC_MICRO_PATCHES=static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,macos_iconv
+
+; *** default build command for building php ***
+; buildconf command
+SPC_CMD_PREFIX_PHP_BUILDCONF="./buildconf --force"
+; configure command
+SPC_CMD_PREFIX_PHP_CONFIGURE="./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg"
+; make command
+SPC_CMD_PREFIX_PHP_MAKE="make -j${CPU_COUNT}"
+
+; *** default build vars for building php ***
+; CFLAGS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS="${SPC_DEFAULT_C_FLAGS} -Werror=unknown-warning-option"
+; CPPFLAGS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS="-I${BUILD_INCLUDE_PATH}"
+; LDFLAGS for configuring php
+SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS="-L${BUILD_LIB_PATH}"
+; EXTRA_CFLAGS for `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS="${SPC_PHP_DEFAULT_OPTIMIZE_CFLAGS}"
+; EXTRA_LIBS for `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS="-lresolv"
+
+[freebsd]
+; compiler environments
+CC=clang
+CXX=clang++

config/ext.json

@@ -189,6 +189,16 @@
             "gmp"
         ]
     },
+    "gmssl": {
+        "support": {
+            "BSD": "wip"
+        },
+        "type": "external",
+        "source": "ext-gmssl",
+        "lib-depends": [
+            "gmssl"
+        ]
+    },
     "iconv": {
         "support": {
             "BSD": "wip"
@@ -360,6 +370,15 @@
             "zlib"
         ]
     },
+    "msgpack": {
+        "support": {
+            "BSD": "wip"
+        },
+        "type": "external",
+        "source": "msgpack",
+        "arg-type-unix": "with",
+        "arg-type-win": "enable"
+    },
     "mysqli": {
         "type": "builtin",
         "arg-type": "with",

config/lib.json

@@ -127,6 +127,18 @@
             "gmp.h"
         ]
     },
+    "gmssl": {
+        "source": "gmssl",
+        "static-libs-unix": [
+            "libgmssl.a"
+        ],
+        "static-libs-windows": [
+            "gmssl.lib"
+        ],
+        "frameworks": [
+            "Security"
+        ]
+    },
     "icu": {
         "source": "icu",
         "cpp-library": true,
@@ -631,7 +643,7 @@
             "liblzma.a"
         ],
         "static-libs-windows": [
-            "liblzma.lib",
+            "lzma.lib",
             "liblzma_a.lib"
         ],
         "headers-unix": [

config/source.json

@@ -83,6 +83,15 @@
             "path": "LICENSE"
         }
     },
+    "ext-gmssl": {
+        "type": "ghtar",
+        "repo": "gmssl/GmSSL-PHP",
+        "path": "php-src/ext/gmssl",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        }
+    },
     "ext-imagick": {
         "type": "url",
         "url": "https://pecl.php.net/get/imagick",
@@ -194,6 +203,14 @@
             "text": "Since version 6, GMP is distributed under the dual licenses, GNU LGPL v3 and GNU GPL v2. These licenses make the library free to use, share, and improve, and allow you to pass on the result. The GNU licenses give freedoms, but also set firm restrictions on the use with non-free programs."
         }
     },
+    "gmssl": {
+        "type": "ghtar",
+        "repo": "guanzhi/GmSSL",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        }
+    },
     "icu": {
         "type": "ghrel",
         "repo": "unicode-org/icu",
@@ -514,6 +531,16 @@
             "path": "LICENSE"
         }
     },
+    "msgpack": {
+        "type": "url",
+        "url": "https://pecl.php.net/get/msgpack",
+        "path": "php-src/ext/msgpack",
+        "filename": "msgpack.tgz",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        }
+    },
     "ncurses": {
         "type": "filelist",
         "url": "https://ftp.gnu.org/pub/gnu/ncurses/",
@@ -647,13 +674,16 @@
         }
     },
     "redis": {
-        "type": "git",
+        "type": "url",
+        "url": "https://pecl.php.net/get/redis",
         "path": "php-src/ext/redis",
-        "rev": "5.3.7",
+        "filename": "redis.tgz",
-        "url": "https://github.com/phpredis/phpredis",
         "license": {
             "type": "file",
-            "path": "COPYING"
+            "path": [
+                "LICENSE",
+                "COPYING"
+            ]
         }
     },
     "snappy": {

docs/.vitepress/components/CliGenerator.vue

@@ -2,17 +2,29 @@
   <div>
     <h2>{{ I18N[lang].selectedSystem }}</h2>
     <div class="option-line">
-      <span v-for="(item, index) in osList" :key="index" style="margin-right: 4px">
+      <span v-for="(item, index) in osList" :key="index" style="margin-right: 8px">
         <input type="radio" :id="'os-' + item.os" :value="item.os" :disabled="item.disabled === true" v-model="selectedSystem" />
         <label :for="'os-' + item.os">{{ item.label }}</label>
       </span>
     </div>
+    <div class="option-line">
+      <select v-model="selectedArch">
+        <option value="x86_64">x86_64</option>
+        <option value="aarch64" :disabled="selectedSystem === 'windows'">aarch64</option>
+      </select>
+    </div>
     <h2>{{ I18N[lang].selectExt }}{{ checkedExts.length > 0 ? (' (' + checkedExts.length + ')') : '' }}</h2>
     <div class="box">
-      <div v-for="(item, index) in ext" class="ext-item">
+      <input class="input" v-model="filterText" placeholder="Highlight search..." />
-        <span v-if="isSupported(index, selectedSystem)">
+      <br>
-          <input type="checkbox" :id="index" :value="index" v-model="checkedExts" :disabled="extDisableList.indexOf(index) !== -1">
+      <div v-for="item in extFilter" class="ext-item">
-          <label :for="index">{{ index }}</label>
+        <span>
+          <input type="checkbox" :id="item" :value="item" v-model="checkedExts" :disabled="extDisableList.indexOf(item) !== -1">
+          <label :for="item">
+            <span>{{ highlightItem(item, 0) }}</span>
+            <span style="color: orangered; font-weight: bolder">{{ highlightItem(item, 1) }}</span>
+            <span>{{ highlightItem(item, 2) }}</span>
+          </label>
         </span>
 
       </div>
@@ -20,7 +32,7 @@
     <div class="my-btn" v-if="selectedSystem !== 'windows'" @click="selectCommon">{{ I18N[lang].selectCommon }}</div>
     <div class="my-btn" @click="checkedExts = []">{{ I18N[lang].selectNone }}</div>
 
-    <details class="details custom-block">
+    <details class="details custom-block" open>
       <summary>{{ I18N[lang].buildLibs }}{{ checkedLibs.length > 0 ? (' (' + checkedLibs.length + ')') : '' }}</summary>
       <div class="box">
         <div v-for="(item, index) in libContain" class="ext-item">
@@ -135,24 +147,33 @@
         <div class="warning custom-block">
           <p class="custom-block-title">WARNING</p>
           <p>{{ I18N[lang].windowsDownSPCWarning }}</p>
+          <a href="https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-windows-x64.exe" target="_blank">https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-windows-x64.exe</a>
         </div>
       </div>
     </div>
     <div v-if="downloadByExt" class="command-container">
       <b>{{ I18N[lang].downloadExtOnlyCommand }}</b>
-      <div class="command-preview">{{ spcCommand }} download --with-php={{ selectedPhpVersion }} --for-extensions "{{ extList }}"{{ preBuilt ? ' --prefer-pre-built' : '' }}{{ debug ? ' --debug' : '' }}</div>
+      <div id="download-ext-cmd" class="command-preview">
+        {{ downloadExtCommand }}
+      </div>
     </div>
     <div v-else class="command-container">
       <b>{{ I18N[lang].downloadAllCommand }}</b>
-      <div class="command-preview">{{ spcCommand }} download --all --with-php={{ selectedPhpVersion }}{{ preBuilt ? ' --prefer-pre-built' : '' }}{{ debug ? ' --debug' : '' }}</div>
+      <div id="download-all-cmd" class="command-preview">
+        {{ downloadAllCommand }}
+      </div>
     </div>
     <div class="command-container" v-if="enableUPX">
       <b>{{ I18N[lang].downloadUPXCommand }}</b>
-      <div class="command-preview">{{ spcCommand }} install-pkg upx{{ debug ? ' --debug' : '' }}</div>
+      <div id="download-pkg-cmd" class="command-preview">
+        {{ downloadPkgCommand }}
+      </div>
     </div>
     <div class="command-container">
       <b>{{ I18N[lang].compileCommand }}</b>
-      <div class="command-preview">{{ spcCommand }} build {{ buildCommand }} "{{ extList }}"{{ additionalLibs }}{{ debug ? ' --debug' : '' }}{{ zts ? ' --enable-zts' : '' }}{{ enableUPX ? ' --with-upx-pack' : '' }}{{ displayINI }}</div>
+      <div id="build-cmd" class="command-preview">
+        {{ buildCommandString }}
+      </div>
     </div>
   </div>
 </template>
@@ -170,6 +191,15 @@ import libData from '../config/lib.json';
 import { getAllExtLibsByDeps } from './DependencyUtil.js';
 
 const ext = ref(extData);
+const extFilter = computed(() => {
+  const ls = [];
+  for (const [name, item] of Object.entries(ext.value)) {
+    if (isSupported(name, selectedSystem.value)) {
+      ls.push(name);
+    }
+  }
+  return ls;
+});
 const lib = ref(libData);
 const libContain = ref([]);
 
@@ -234,7 +264,7 @@ const I18N = {
     microUnavailable: 'micro 不支持 PHP 7.4 及更早版本！',
     windowsSAPIUnavailable: 'Windows 目前不支持 fpm、embed 构建！',
     useUPX: '是否开启 UPX 压缩（减小二进制体积）',
-    windowsDownSPCWarning: 'Windows 下请手动下载 spc.exe 二进制文件并解压到当前目录！',
+    windowsDownSPCWarning: 'Windows 下请手动下载 spc.exe 二进制文件，解压到当前目录并重命名为 spc.exe！',
     usePreBuilt: '如果可能，下载预编译的依赖库（减少编译时间）',
   },
   en: {
@@ -268,7 +298,7 @@ const I18N = {
     microUnavailable: 'Micro does not support PHP 7.4 and earlier versions!',
     windowsSAPIUnavailable: 'Windows does not support fpm and embed build!',
     useUPX: 'Enable UPX compression (reduce binary size)',
-    windowsDownSPCWarning: 'Please download the spc.exe binary file manually and extract it to the current directory on Windows!',
+    windowsDownSPCWarning: 'Please download the binary file manually, extract it to the current directory and rename to spc.exe on Windows!',
     usePreBuilt: 'Download pre-built dependencies if possible (reduce compile time)',
   }
 };
@@ -325,7 +355,7 @@ const libDisableList = ref([]);
 const checkedTargets = ref(['cli']);
 
 // chosen env
-const selectedEnv = ref('native');
+const selectedEnv = ref('spc');
 
 // chosen php version
 const selectedPhpVersion = ref('8.2');
@@ -348,6 +378,13 @@ const enableUPX = ref(0);
 const hardcodedINIData = ref('');
 
 const selectedSystem = ref('linux');
+
+watch(selectedSystem, () => {
+  if (selectedSystem.value === 'windows') {
+    selectedArch.value = 'x86_64';
+  }
+});
+
 const selectedArch = ref('x86_64');
 
 // spc command string, alt: spc-alpine-docker, spc
@@ -381,6 +418,25 @@ const displayINI = computed(() => {
   return ' ' + str.map((x) => '-I "' + x + '"').join(' ');
 });
 
+const filterText = ref('');
+
+const highlightItem = (item, step) => {
+  if (item.includes(filterText.value)) {
+    if (step === 0) {
+      return item.substring(0, item.indexOf(filterText.value));
+    } else if (step === 1) {
+      return filterText.value;
+    } else {
+      return item.substring(item.indexOf(filterText.value) + filterText.value.length);
+    }
+  } else {
+    if (step === 0) {
+      return item;
+    }
+    return '';
+  }
+};
+
 const onTargetChange = (event) => {
   let id;
   if (checkedTargets.value.indexOf('all') !== -1 && event.target.value === 'all') {
@@ -427,6 +483,22 @@ const calculateExtDepends = (input) => {
   return Array.from(result);
 };
 
+const downloadAllCommand = computed(() => {
+  return `${spcCommand.value} download --all --with-php=${selectedPhpVersion.value}${preBuilt.value ? ' --prefer-pre-built' : ''}${debug.value ? ' --debug' : ''}`;
+});
+
+const downloadExtCommand = computed(() => {
+  return `${spcCommand.value} download --with-php=${selectedPhpVersion.value} --for-extensions "${extList.value}"${preBuilt.value ? ' --prefer-pre-built' : ''}${debug.value ? ' --debug' : ''}`;
+});
+
+const downloadPkgCommand = computed(() => {
+  return `${spcCommand.value} install-pkg upx${debug.value ? ' --debug' : ''}`;
+});
+
+const buildCommandString = computed(() => {
+  return `${spcCommand.value} build ${buildCommand.value} "${extList.value}"${additionalLibs.value}${debug.value ? ' --debug' : ''}${zts.value ? ' --enable-zts' : ''}${enableUPX.value ? ' --with-upx-pack' : ''}${displayINI.value}`;
+});
+
 const calculateExtLibDepends = (input) => {
   const result = new Set();
 
@@ -539,9 +611,12 @@ h2 {
 .command-preview {
   padding: 1.2rem;
   background: var(--vp-c-divider);
+  border-radius: 8px;
+  word-break: break-all;
   font-family: monospace;
   overflow-wrap: break-word;
 }
+
 .option-line {
   padding: 4px 8px;
 }
@@ -582,12 +657,38 @@ select {
   background-color: var(--vp-button-alt-active-bg);
 }
 .textarea {
-  border: 1px solid var(--vp-button-alt-border);
+  border: 1px solid var(--vp-c-divider);
-  padding: 0 4px;
+  border-radius: 4px;
-  min-width: 300px;
+  width: calc(100% - 12px);
+  padding: 4px 8px;
+}
+
+.input {
+  display: block;
+  border: 1px solid var(--vp-c-divider);
+  border-radius: 4px;
+  width: 100%;
+  padding: 4px 8px;
 }
 
 .command-container {
   margin-bottom: 24px;
 }
+.modal-button {
+  padding: 4px 8px;
+  border-radius: 4px;
+  border-color: var(--vp-button-alt-border);
+  color: var(--vp-button-alt-text);
+  background-color: var(--vp-button-alt-bg);
+}
+.modal-button:hover {
+  border-color: var(--vp-button-alt-hover-border);
+  color: var(--vp-button-alt-hover-text);
+  background-color: var(--vp-button-alt-hover-bg)
+}
+.modal-button:active {
+  border-color: var(--vp-button-alt-active-border);
+  color: var(--vp-button-alt-active-text);
+  background-color: var(--vp-button-alt-active-bg)
+}
 </style>

docs/.vitepress/components/SearchTable.vue

@@ -0,0 +1,79 @@
+<template>
+  <div>
+    <header class="DocSearch-SearchBar" style="padding: 0">
+      <form class="DocSearch-Form searchinput">
+        <input class="DocSearch-Input" v-model="filterText" placeholder="Filter name..." @input="doFilter" />
+      </form>
+    </header>
+    <table>
+      <thead>
+      <tr>
+        <th>Extension Name</th>
+        <th>Linux</th>
+        <th>macOS</th>
+        <th>FreeBSD</th>
+        <th>Windows</th>
+      </tr>
+      </thead>
+      <tbody>
+      <tr v-for="item in filterData">
+        <td v-if="!item.notes">{{ item.name }}</td>
+        <td v-else>
+          <a :href="'./extension-notes.html#' + item.name">{{ item.name }}</a>
+        </td>
+        <td>{{ item.linux }}</td>
+        <td>{{ item.macos }}</td>
+        <td>{{ item.freebsd }}</td>
+        <td>{{ item.windows }}</td>
+      </tr>
+      </tbody>
+    </table>
+    <div v-if="filterData.length === 0" style="margin: 0 4px 20px 4px; color: var(--vp-c-text-2); font-size: 14px">
+      No result, please try another keyword.
+    </div>
+  </div>
+</template>
+
+<script>
+export default {
+  name: "SearchTable"
+}
+</script>
+
+<script setup>
+import {ref} from "vue";
+import ext from '../../../config/ext.json';
+
+// 将 ext 转换为列表，方便后续操作
+const data = ref([]);
+for (const [name, item] of Object.entries(ext)) {
+  data.value.push({
+    name,
+    linux: item.support?.Linux === undefined ? 'yes' : (item.support?.Linux === 'wip' ? '' : item.support?.Linux),
+    macos: item.support?.Darwin === undefined ? 'yes' : (item.support?.Darwin === 'wip' ? '' : item.support?.Darwin),
+    freebsd: item.support?.BSD === undefined ? 'yes' : (item.support?.BSD === 'wip' ? '' : item.support?.BSD),
+    windows: item.support?.Windows === undefined ? 'yes' : (item.support?.Windows === 'wip' ? '' : item.support?.Windows),
+    notes: item.notes === true,
+  });
+}
+
+
+const filterData = ref(data.value);
+const filterText = ref('');
+
+const doFilter = () => {
+  if (filterText.value === '') {
+    filterData.value = data.value;
+    return;
+  }
+  filterData.value = data.value.filter(item => {
+    return item.name.toLowerCase().includes(filterText.value.toLowerCase());
+  });
+}
+</script>
+
+<style>
+.searchinput {
+  border: 1px solid var(--vp-c-divider);
+}
+</style>

docs/en/develop/source-module.md

@@ -317,3 +317,24 @@ When an open source project has multiple licenses, multiple files can be specifi
    }
 }
 ```
+
+When the license of an open source project uses different files between versions, 
+`path` can be used as an array to list the possible license files:
+
+```json
+{
+  "redis": {
+    "type": "git",
+    "path": "php-src/ext/redis",
+    "rev": "release/6.0.2",
+    "url": "https://github.com/phpredis/phpredis",
+    "license": {
+      "type": "file",
+      "path": [
+        "LICENSE",
+        "COPYING"
+      ]
+    }
+  }
+}
+```

docs/en/guide/cli-generator.md

@@ -1,3 +1,7 @@
+---
+aside: false
+---
+
 <script setup lang="ts">
 import CliGenerator from "../../.vitepress/components/CliGenerator.vue";
 </script>

docs/en/guide/env-vars.md

@@ -1,12 +1,23 @@
----
-aside: false
----
-
 # Environment variables
 
 All environment variables mentioned in the list on this page have default values unless otherwise noted. 
 You can override the default values by setting these environment variables.
 
+## Environment variables list
+
+Starting from version 2.3.5, we have centralized the environment variables in the `config/env.ini` file.
+You can set environment variables by modifying this file.
+
+We divide the environment variables supported by static-php-cli into three types:
+
+- Global internal environment variables: declared after static-php-cli starts, you can use `getenv()` to get them internally in static-php-cli, and you can override them before starting static-php-cli.
+- Fixed environment variables: declared after static-php-cli starts, you can only use `getenv()` to get them, but you cannot override them through shell scripts.
+- Config file environment variables: declared before static-php-cli build, you can set these environment variables by modifying the `config/env.ini` file or through shell scripts.
+
+You can read the comments for each parameter in [config/env.ini](https://github.com/crazywhalecc/static-php-cli/blob/main/config/env.ini) to understand its purpose.
+
+## Custom environment variables
+
 Generally, you don't need to modify any of the following environment variables as they are already set to optimal values.
 However, if you have special needs, you can set these environment variables to meet your needs 
 (for example, you need to debug PHP performance under different compilation parameters).
@@ -22,94 +33,13 @@ bin/spc build mbstring,pcntl --build-cli
 SPC_CONCURRENCY=4 bin/spc build mbstring,pcntl --build-cli
 ```
 
-## General environment variables
+Or, if you need to modify an environment variable for a long time, you can modify the `config/env.ini` file.
 
-General environment variables can be used by all build targets.
+`config/env.ini` is divided into three sections, `[global]` is globally effective, `[windows]`, `[macos]`, `[linux]` are only effective for the corresponding operating system.
 
-| var name                     | default value             | comment                                         |
+For example, if you need to modify the `./configure` command for compiling PHP, you can find the `SPC_CMD_PREFIX_PHP_CONFIGURE` environment variable in the `config/env.ini` file, and then modify its value.
-|------------------------------|---------------------------|-------------------------------------------------|
-| `BUILD_ROOT_PATH`            | `{pwd}/buildroot`         | The root directory of the build target          |
-| `BUILD_LIB_PATH`             | `{pwd}/buildroot/lib`     | The root directory of compilation libraries     |
-| `BUILD_INCLUDE_PATH`         | `{pwd}/buildroot/include` | Header file directory for compiling libraries   |
-| `BUILD_BIN_PATH`             | `{pwd}/buildroot/bin`     | Compiled binary file directory                  |
-| `PKG_ROOT_PATH`              | `{pwd}/pkgroot`           | Directory where precompiled tools are installed |
-| `SOURCE_PATH`                | `{pwd}/source`            | The source code extract directory               |
-| `DOWNLOAD_PATH`              | `{pwd}/downloads`         | Downloaded file directory                       |
-| `SPC_CONCURRENCY`            | Depends on CPU cores      | Number of parallel compilations                 |
-| `SPC_SKIP_PHP_VERSION_CHECK` | empty                     | Skip PHP version check when set to `yes`        |
 
-## OS specific variables
+## Library environment variables (Unix only)
-
-These environment variables are system-specific and will only take effect on a specific OS.
-
-### Windows
-
-| var name            | default value                                                                                                   | comment                                                                                     |
-|---------------------|-----------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
-| `PHP_SDK_PATH`      | `{pwd}\php-sdk-binary-tools`                                                                                    | PHP SDK tools path                                                                          |
-| `UPX_EXEC`          | `$PKG_ROOT_PATH\bin\upx.exe`                                                                                    | UPX compression tool path                                                                   |
-| `SPC_MICRO_PATCHES` | `static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,cli_static` | Used phpmicro [patches](https://github.com/easysoft/phpmicro/blob/master/patches/Readme.md) |
-
-### macOS
-
-| var name                             | default value                                                                                                                  | comment                                                                                     |
-|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
-| `CC`                                 | `clang`                                                                                                                        | C Compiler                                                                                  |
-| `CXX`                                | `clang++`                                                                                                                      | C++ Compiler                                                                                |
-| `SPC_DEFAULT_C_FLAGS`                | `--target=arm64-apple-darwin` or `--target=x86_64-apple-darwin`                                                                | Default C flags (not the same as `CFLAGS`)                                                  |
-| `SPC_DEFAULT_CXX_FLAGS`              | `--target=arm64-apple-darwin` or `--target=x86_64-apple-darwin`                                                                | Default C flags (not the same as `CPPFLAGS`)                                                |
-| `SPC_CMD_PREFIX_PHP_BUILDCONF`       | `./buildconf --force`                                                                                                          | PHP `buildconf` command prefix                                                              |
-| `SPC_CMD_PREFIX_PHP_CONFIGURE`       | `./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg` | PHP `configure` command prefix                                                              |
-| `SPC_CMD_PREFIX_PHP_MAKE`            | `make -j$SPC_CONCURRENCY`                                                                                                      | PHP `make` command prefix                                                                   |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS`   | `$SPC_DEFAULT_C_FLAGS -Werror=unknown-warning-option`                                                                          | `CFLAGS` variable of PHP `configure` command                                                |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS` | `-I$BUILD_INCLUDE_PATH`                                                                                                        | `CPPFLAGS` variable of PHP `configure` command                                              |
-| `SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS`  | `-L$BUILD_LIB_PATH`                                                                                                            | `LDFLAGS` variable of PHP `configure` command                                               |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS`  | `-g0 -Os` or `-g -O0` (the latter when using `--no-strip`)                                                                     | `EXTRA_CFLAGS` variable of PHP `make` command                                               |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS`    | `-lresolv`                                                                                                                     | Extra `EXTRA_LIBS` variables for PHP `make` command                                         |
-| `SPC_MICRO_PATCHES`                  | `static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,macos_iconv`               | Used phpmicro [patches](https://github.com/easysoft/phpmicro/blob/master/patches/Readme.md) |
-
-### Linux
-
-| var name                                     | default value                                                                                                                                                | comment                                                                                     |
-|----------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|
-| `UPX_EXEC`                                   | `$PKG_ROOT_PATH/bin/upx`                                                                                                                                     | UPX compression tool path                                                                   |
-| `GNU_ARCH`                                   | `x86_64` or `aarch64`                                                                                                                                        | CPU architecture                                                                            |
-| `CC`                                         | Alpine: `gcc`, Other: `$GNU_ARCH-linux-musl-gcc`                                                                                                             | C Compiler                                                                                  |
-| `CXX`                                        | Alpine: `g++`, Other: `$GNU_ARCH-linux-musl-g++`                                                                                                             | C++ Compiler                                                                                |
-| `AR`                                         | Alpine: `ar`, Other: `$GNU_ARCH-linux-musl-ar`                                                                                                               | Static library tools                                                                        |
-| `LD`                                         | `ld.gold`                                                                                                                                                    | Linker                                                                                      |
-| `PATH`                                       | `/usr/local/musl/bin:/usr/local/musl/$GNU_ARCH-linux-musl/bin:$PATH`                                                                                         | System PATH                                                                                 |
-| `SPC_DEFAULT_C_FLAGS`                        | empty                                                                                                                                                        | Default C flags                                                                             |
-| `SPC_DEFAULT_CXX_FLAGS`                      | empty                                                                                                                                                        | Default C++ flags                                                                           |
-| `SPC_CMD_PREFIX_PHP_BUILDCONF`               | `./buildconf --force`                                                                                                                                        | PHP `buildconf` command prefix                                                              |
-| `SPC_CMD_PREFIX_PHP_CONFIGURE`               | `LD_LIBRARY_PATH={ld_lib_path} ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg` | PHP `configure` command prefix                                                              |
-| `SPC_CMD_PREFIX_PHP_MAKE`                    | `make -j$SPC_CONCURRENCY`                                                                                                                                    | PHP `make` command prefix                                                                   |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS`           | `$SPC_DEFAULT_C_FLAGS`                                                                                                                                       | `CFLAGS` variable of PHP `configure` command                                                |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS`         | `-I$BUILD_INCLUDE_PATH`                                                                                                                                      | `CPPFLAGS` variable of PHP `configure` command                                              |
-| `SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS`          | `-L$BUILD_LIB_PATH`                                                                                                                                          | `LDFLAGS` variable of PHP `configure` command                                               |
-| `SPC_CMD_VAR_PHP_CONFIGURE_LIBS`             | `-ldl -lpthread`                                                                                                                                             | `LIBS` variable of PHP `configure` command                                                  |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS`          | `-g0 -Os -fno-ident -fPIE` or `-g -O0 -fno-ident -fPIE` (the latter when using `--no-strip`)                                                                 | `EXTRA_CFLAGS` variable of PHP `make` command                                               |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS`            | empty                                                                                                                                                        | Extra `EXTRA_LIBS` variables for PHP `make` command                                         |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM` | `-all-static` (when using `clang`: `-Xcompiler -fuse-ld=lld -all-static`)                                                                                    | Additional `LDFLAGS` variable for `make` command                                            |
-| `SPC_NO_MUSL_PATH`                           | empty                                                                                                                                                        | Whether to not insert the PATH of the musl toolchain (not inserted when the value is `yes`) |
-| `SPC_MICRO_PATCHES`                          | `static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream`                                                         | Used phpmicro [patches](https://github.com/easysoft/phpmicro/blob/master/patches/Readme.md) |
-> `{ld_lib_path}` value is `/usr/local/musl/$GNU_ARCH-linux-musl/lib`。
-
-### FreeBSD
-
-Due to the small number of users of the FreeBSD system, we do not provide environment variables for the FreeBSD system for the time being.
-
-### Unix
-
-For Unix systems such as macOS, Linux, FreeBSD, etc., the following environment variables are common.
-
-| var name          | default value                | comment                    |
-|-------------------|------------------------------|----------------------------|
-| `PATH`            | `$BUILD_BIN_PATH:$PATH`      | System PATH                |
-| `PKG_CONFIG_PATH` | `$BUILD_LIB_PATH/pkgconfig`  | pkg-config search path     |
-| `PKG_CONFIG`      | `$BUILD_BIN_PATH/pkg-config` | pkg-config executable path |
-
-## Library Environment variables (Unix only)
 
 Starting from 2.2.0, static-php-cli supports custom environment variables for all compilation dependent library commands of macOS, Linux, FreeBSD and other Unix systems.
 

docs/en/guide/extensions.md

@@ -1,3 +1,7 @@
+<script setup>
+import SearchTable from "../../.vitepress/components/SearchTable.vue";
+</script>
+
 # Extensions
 
 > - `yes`: supported
@@ -5,7 +9,7 @@
 > - `no` with issue link: confirmed to be unavailable due to issue
 > - `partial` with issue link: supported but not perfect due to issue
 
-<!--@include: ../../extensions.md-->
+<search-table />
 
 ::: tip
 If an extension you need is missing, you can create a [Feature Request](https://github.com/crazywhalecc/static-php-cli/issues).

docs/zh/develop/source-module.md

@@ -297,3 +297,23 @@ pkg.json 存放的是非源码类型的文件资源，例如 musl-toolchain、UP
   }
 }
 ```
+
+当一个开源项目的许可证在不同版本间使用不同的文件，`path` 参数可以使用数组将可能的许可证文件列出：
+
+```json
+{
+  "redis": {
+    "type": "git",
+    "path": "php-src/ext/redis",
+    "rev": "release/6.0.2",
+    "url": "https://github.com/phpredis/phpredis",
+    "license": {
+      "type": "file",
+      "path": [
+        "LICENSE",
+        "COPYING"
+      ]
+    }
+  }
+}
+```

docs/zh/guide/cli-generator.md

@@ -1,3 +1,7 @@
+---
+aside: false
+---
+
 <script setup lang="ts">
 import CliGenerator from "../../.vitepress/components/CliGenerator.vue";
 </script>

docs/zh/guide/env-vars.md

@@ -1,11 +1,21 @@
----
+# 环境变量
-aside: false
----
-
-# 环境变量列表
 
 本页面的环境变量列表中所提到的所有环境变量都具有默认值，除非另有说明。你可以通过设置这些环境变量来覆盖默认值。
 
+## 环境变量列表
+
+在 2.3.5 版本之后，我们将环境变量集中到了 `config/env.ini` 文件中，你可以通过修改这个文件来设置环境变量。
+
+我们将 static-php-cli 支持的环境变量分为三种：
+
+- 全局内部环境变量：在 static-php-cli 启动后即声明，你可以在 static-php-cli 的内部使用 `getenv()` 来获取他们，也可以在启动 static-php-cli 前覆盖。
+- 固定环境变量：在 static-php-cli 启动后声明，你仅可使用 `getenv()` 获取，但无法通过 shell 脚本对其覆盖。
+- 配置文件环境变量：在 static-php-cli 构建前声明，你可以通过修改 `config/env.ini` 文件或通过 shell 脚本来设置这些环境变量。
+
+你可以阅读 [config/env.ini](https://github.com/crazywhalecc/static-php-cli/blob/main/config/env.ini) 中每项参数的注释来了解其作用（仅限英文版）。
+
+## 自定义环境变量
+
 一般情况下，你不需要修改任何以下环境变量，因为它们已经被设置为最佳值。
 但是，如果你有特殊需求，你可以通过设置这些环境变量来满足你的需求（比如你需要调试不同编译参数下的 PHP 性能表现）。
 
@@ -20,93 +30,11 @@ bin/spc build mbstring,pcntl --build-cli
 SPC_CONCURRENCY=4 bin/spc build mbstring,pcntl --build-cli
 ```
 
-## 通用环境变量
+或者，如果你需要长期修改某个环境变量，你可以通过修改 `config/env.ini` 文件来实现。
 
-通用环境变量是所有构建目标都可以使用的环境变量。
+`config/env.ini` 分为三段，其中 `[global]` 全局有效，`[windows]`、`[macos]`、`[linux]` 仅对应的操作系统有效。
 
-| var name                     | default value             | comment                     |
+例如，你需要修改编译 PHP 的 `./configure` 命令，你可以在 `config/env.ini` 文件中找到 `SPC_CMD_PREFIX_PHP_CONFIGURE` 环境变量，然后修改其值即可。
-|------------------------------|---------------------------|-----------------------------|
-| `BUILD_ROOT_PATH`            | `{pwd}/buildroot`         | 编译目标的根目录                    |
-| `BUILD_LIB_PATH`             | `{pwd}/buildroot/lib`     | 编译依赖库的根目录                   |
-| `BUILD_INCLUDE_PATH`         | `{pwd}/buildroot/include` | 编译依赖库的头文件目录                 |
-| `BUILD_BIN_PATH`             | `{pwd}/buildroot/bin`     | 编译依赖库的二进制文件目录               |
-| `PKG_ROOT_PATH`              | `{pwd}/pkgroot`           | 闭源或预编译工具下载后安装的目录            |
-| `SOURCE_PATH`                | `{pwd}/source`            | 编译项目的源码解压缩目录                |
-| `DOWNLOAD_PATH`              | `{pwd}/downloads`         | 下载的文件存放目录                   |
-| `SPC_CONCURRENCY`            | 取决于当前 CPU 核心数量            | 并行编译的数量                     |
-| `SPC_SKIP_PHP_VERSION_CHECK` | 空                         | 设置为 `yes` 时，跳过扩展对 PHP 版本的检查 |
-
-## 系统特定变量
-
-这些环境变量是特定于系统的，它们只在特定的系统上才会生效。
-
-### Windows
-
-| var name            | default value                                                                                                   | comment                                                                                    |
-|---------------------|-----------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
-| `PHP_SDK_PATH`      | `{pwd}\php-sdk-binary-tools`                                                                                    | PHP SDK 工具的安装目录                                                                            |
-| `UPX_EXEC`          | `$PKG_ROOT_PATH\bin\upx.exe`                                                                                    | UPX 压缩工具的路径                                                                                |
-| `SPC_MICRO_PATCHES` | `static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,cli_static` | 使用的 phpmicro [patches](https://github.com/easysoft/phpmicro/blob/master/patches/Readme.md) |
-
-### macOS
-
-| var name                             | default value                                                                                                                  | comment                                                                                    |
-|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
-| `CC`                                 | `clang`                                                                                                                        | C 编译器                                                                                      |
-| `CXX`                                | `clang++`                                                                                                                      | C++ 编译器                                                                                    |
-| `SPC_DEFAULT_C_FLAGS`                | `--target=arm64-apple-darwin` 或 `--target=x86_64-apple-darwin`                                                                 | 默认 C 编译标志（与 `CFLAGS` 不同）                                                                   |
-| `SPC_DEFAULT_CXX_FLAGS`              | `--target=arm64-apple-darwin` 或 `--target=x86_64-apple-darwin`                                                                 | 默认 C++ 编译标志（与 `CXXFLAGS` 不同）                                                               |
-| `SPC_CMD_PREFIX_PHP_BUILDCONF`       | `./buildconf --force`                                                                                                          | 编译 PHP `buildconf` 命令前缀                                                                    |
-| `SPC_CMD_PREFIX_PHP_CONFIGURE`       | `./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg` | 编译 PHP `configure` 命令前缀                                                                    |
-| `SPC_CMD_PREFIX_PHP_MAKE`            | `make -j$SPC_CONCURRENCY`                                                                                                      | 编译 PHP `make` 命令前缀                                                                         |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS`   | `$SPC_DEFAULT_C_FLAGS -Werror=unknown-warning-option`                                                                          | PHP `configure` 命令的 `CFLAGS` 变量                                                            |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS` | `-I$BUILD_INCLUDE_PATH`                                                                                                        | PHP `configure` 命令的 `CPPFLAGS` 变量                                                          |
-| `SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS`  | `-L$BUILD_LIB_PATH`                                                                                                            | PHP `configure` 命令的 `LDFLAGS` 变量                                                           |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS`  | `-g0 -Os` 或 `-g -O0`（当使用 `--no-strip` 时为后者）                                                                                    | PHP `make` 命令的 `EXTRA_CFLAGS` 变量                                                           |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS`    | `-lresolv`                                                                                                                     | PHP `make` 命令的额外 `EXTRA_LIBS` 变量                                                           |
-| `SPC_MICRO_PATCHES`                  | `static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,macos_iconv`               | 使用的 phpmicro [patches](https://github.com/easysoft/phpmicro/blob/master/patches/Readme.md) |
-
-### Linux
-
-| var name                                     | default value                                                                                                                                                | comment                                                                                    |
-|----------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
-| `UPX_EXEC`                                   | `$PKG_ROOT_PATH/bin/upx`                                                                                                                                     | UPX 压缩工具的路径                                                                                |
-| `GNU_ARCH`                                   | `x86_64` 或 `aarch64`                                                                                                                                         | 当前环境的 CPU 架构                                                                               |
-| `CC`                                         | Alpine: `gcc`, Other: `$GNU_ARCH-linux-musl-gcc`                                                                                                             | C 编译器                                                                                      |
-| `CXX`                                        | Alpine: `g++`, Other: `$GNU_ARCH-linux-musl-g++`                                                                                                             | C++ 编译器                                                                                    |
-| `AR`                                         | Alpine: `ar`, Other: `$GNU_ARCH-linux-musl-ar`                                                                                                               | 静态库工具                                                                                      |
-| `LD`                                         | `ld.gold`                                                                                                                                                    | 链接器                                                                                        |
-| `PATH`                                       | `/usr/local/musl/bin:/usr/local/musl/$GNU_ARCH-linux-musl/bin:$PATH`                                                                                         | 系统 PATH                                                                                    |
-| `SPC_DEFAULT_C_FLAGS`                        | empty                                                                                                                                                        | 默认 C 编译标志                                                                                  |
-| `SPC_DEFAULT_CXX_FLAGS`                      | empty                                                                                                                                                        | 默认 C++ 编译标志                                                                                |
-| `SPC_CMD_PREFIX_PHP_BUILDCONF`               | `./buildconf --force`                                                                                                                                        | 编译 PHP `buildconf` 命令前缀                                                                    |
-| `SPC_CMD_PREFIX_PHP_CONFIGURE`               | `LD_LIBRARY_PATH={ld_lib_path} ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg` | 编译 PHP `configure` 命令前缀                                                                    |
-| `SPC_CMD_PREFIX_PHP_MAKE`                    | `make -j$SPC_CONCURRENCY`                                                                                                                                    | 编译 PHP `make` 命令前缀                                                                         |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS`           | `$SPC_DEFAULT_C_FLAGS`                                                                                                                                       | PHP `configure` 命令的 `CFLAGS` 变量                                                            |
-| `SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS`         | `-I$BUILD_INCLUDE_PATH`                                                                                                                                      | PHP `configure` 命令的 `CPPFLAGS` 变量                                                          |
-| `SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS`          | `-L$BUILD_LIB_PATH`                                                                                                                                          | PHP `configure` 命令的 `LDFLAGS` 变量                                                           |
-| `SPC_CMD_VAR_PHP_CONFIGURE_LIBS`             | `-ldl -lpthread`                                                                                                                                             | PHP `configure` 命令的 `LIBS` 变量                                                              |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS`          | `-g0 -Os -fno-ident -fPIE` 或 `-g -O0 -fno-ident -fPIE`（当使用 `--no-strip` 时为后者）                                                                                | PHP `make` 命令的 `EXTRA_CFLAGS` 变量                                                           |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS`            | empty                                                                                                                                                        | PHP `make` 命令的额外 `EXTRA_LIBS` 变量                                                           |
-| `SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM` | `-all-static`（当使用 `clang` 时：`-Xcompiler -fuse-ld=lld -all-static`）                                                                                           | `make` 命令的额外 `LDFLAGS` 变量（用于编译程序）                                                          |
-| `SPC_NO_MUSL_PATH`                           | empty                                                                                                                                                        | 是否不插入 musl 工具链的 PATH（值为 `yes` 时不插入）                                                        |
-| `SPC_MICRO_PATCHES`                          | `static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream`                                                                        | 使用的 phpmicro [patches](https://github.com/easysoft/phpmicro/blob/master/patches/Readme.md) |
-
-> `{ld_lib_path}` 值为 `/usr/local/musl/$GNU_ARCH-linux-musl/lib`。
-
-### FreeBSD
-
-因 FreeBSD 系统的用户较少，我们暂时不提供 FreeBSD 系统的环境变量。
-
-### Unix
-
-对于 macOS、Linux、FreeBSD 等 Unix 系统，以下环境变量是通用的。
-
-| var name          | default value                | comment          |
-|-------------------|------------------------------|------------------|
-| `PATH`            | `$BUILD_BIN_PATH:$PATH`      | 系统 PATH          |
-| `PKG_CONFIG_PATH` | `$BUILD_LIB_PATH/pkgconfig`  | pkg-config 的搜索路径 |
-| `PKG_CONFIG`      | `$BUILD_BIN_PATH/pkg-config` | pkg-config 命令路径  |
 
 ## 编译依赖库的环境变量（仅限 Unix 系统）
 
@@ -142,6 +70,7 @@ openssl_CFLAGS="-O0"
 | `ldap_LDFLAGS`        | `-L$BUILD_LIB_PATH`                                                                             |
 | `openssl_CFLAGS`      | Linux: `$SPC_DEFAULT_C_FLAGS`, Other: empty                                                     |
 | others...             | empty                                                                                           |
+
 :::
 
 下表是支持自定义以上三种变量的依赖库名称列表：
@@ -165,5 +94,6 @@ openssl_CFLAGS="-O0"
 ::: tip
 因为给每个库适配自定义环境变量是一项特别繁琐的工作，且大部分情况下你都不需要这些库的自定义环境变量，所以我们目前只支持了部分库的自定义环境变量。
 
-如果你需要自定义环境变量的库不在上方列表，可以通过 [GitHub Issue](https://github.com/crazywhalecc/static-php-cli/issues) 来提出需求。
+如果你需要自定义环境变量的库不在上方列表，可以通过 [GitHub Issue](https://github.com/crazywhalecc/static-php-cli/issues)
+来提出需求。
 :::

docs/zh/guide/extensions.md

@@ -1,3 +1,7 @@
+<script setup>
+import SearchTable from "../../.vitepress/components/SearchTable.vue";
+</script>
+
 # 扩展列表
 
 > - `yes`: 已支持
@@ -5,7 +9,8 @@
 > - `no` with issue link: 确定不支持或无法支持
 > - `partial` with issue link: 已支持，但是无法完美工作
 
-<!--@include: ../../extensions.md-->
+
+<search-table />
 
 ::: tip
 如果缺少您需要的扩展，您可以创建 [功能请求](https://github.com/crazywhalecc/static-php-cli/issues)。

phpstan.neon

@@ -4,7 +4,6 @@ parameters:
   paths:
     - ./src/
   ignoreErrors:
-    - '#Constant .* not found#'
     - '#Unsafe usage of new static#'
     - '#class Fiber#'
     - '#Attribute class JetBrains\\PhpStorm\\ArrayShape does not exist#'
@@ -15,4 +14,4 @@ parameters:
       analyseAndScan:
             - ./src/globals/ext-tests/swoole.php
             - ./src/globals/ext-tests/swoole.phpt
-            - ./src/globals/test-extensions.php
+            - ./src/globals/test-extensions.php

phpunit.xml.dist

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<phpunit
+        bootstrap="tests/bootstrap.php"
+>
+</phpunit>

src/SPC/ConsoleApplication.php

@@ -30,12 +30,15 @@ use Symfony\Component\Console\Application;
  */
 final class ConsoleApplication extends Application
 {
-    public const VERSION = '2.3.3';
+    public const VERSION = '2.3.5';
 
     public function __construct()
     {
         parent::__construct('static-php-cli', self::VERSION);
 
+        // Define internal env vars and constants
+        require_once ROOT_DIR . '/src/globals/internal-env.php';
+
         $this->addCommands(
             [
                 // Common commands

src/SPC/builder/BuilderBase.php

@@ -418,30 +418,6 @@ abstract class BuilderBase
         }
     }
 
-    /**
-     * Check if all libs are downloaded.
-     * If not, throw exception.
-     *
-     * @throws RuntimeException
-     */
-    protected function checkLibsSource(): void
-    {
-        $not_downloaded = [];
-        foreach ($this->libs as $lib) {
-            if (!file_exists($lib->getSourceDir())) {
-                $not_downloaded[] = $lib::NAME;
-            }
-        }
-        if ($not_downloaded !== []) {
-            throw new RuntimeException(
-                '"' . implode(', ', $not_downloaded) .
-                '" totally ' . count($not_downloaded) .
-                ' source' . (count($not_downloaded) === 1 ? '' : 's') .
-                ' not downloaded, maybe you need to "fetch" ' . (count($not_downloaded) === 1 ? 'it' : 'them') . ' first?'
-            );
-        }
-    }
-
     /**
      * Generate micro extension test php code.
      */

src/SPC/builder/extension/gmssl.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('gmssl')]
+class gmssl extends Extension
+{
+    public function patchBeforeBuildconf(): bool
+    {
+        if (str_contains(file_get_contents(SOURCE_PATH . '/php-src/ext/gmssl/config.w32'), 'CHECK_LIB(')) {
+            return false;
+        }
+        FileSystem::replaceFileStr(SOURCE_PATH . '/php-src/ext/gmssl/config.w32', 'AC_DEFINE(', 'CHECK_LIB("gmssl.lib", "gmssl", PHP_GMSSL);' . PHP_EOL . 'AC_DEFINE(');
+        return true;
+    }
+}

src/SPC/builder/linux/LinuxBuilder.php

@@ -35,7 +35,7 @@ class LinuxBuilder extends UnixBuilderBase
 
         GlobalEnvManager::init($this);
 
-        if (str_ends_with(getenv('CC'), 'linux-musl-gcc') && !file_exists("/usr/local/musl/bin/{$arch}-linux-musl-gcc")) {
+        if (str_ends_with(getenv('CC'), 'linux-musl-gcc') && !file_exists("/usr/local/musl/bin/{$arch}-linux-musl-gcc") && (getenv('SPC_NO_MUSL_PATH') !== 'yes')) {
             throw new WrongUsageException('musl-cross-make not installed, please install it first. (You can use `doctor` command to install it)');
         }
 

src/SPC/builder/linux/SystemUtil.php

@@ -6,7 +6,6 @@ namespace SPC\builder\linux;
 
 use SPC\builder\traits\UnixSystemUtilTrait;
 use SPC\exception\RuntimeException;
-use SPC\exception\WrongUsageException;
 
 class SystemUtil
 {
@@ -83,52 +82,6 @@ class SystemUtil
         };
     }
 
-    /**
-     * @throws RuntimeException
-     * @throws WrongUsageException
-     * @throws WrongUsageException
-     */
-    public static function getArchCFlags(string $cc, string $arch): string
-    {
-        if (php_uname('m') === $arch) {
-            return '';
-        }
-        return match (static::getCCType($cc)) {
-            'clang' => match ($arch) {
-                'x86_64' => '--target=x86_64-unknown-linux',
-                'arm64', 'aarch64' => '--target=arm64-unknown-linux',
-                default => throw new WrongUsageException('unsupported arch: ' . $arch),
-            },
-            'gcc' => '',
-            default => throw new WrongUsageException('cc compiler ' . $cc . ' is not supported'),
-        };
-    }
-
-    /**
-     * @throws RuntimeException
-     */
-    public static function getTuneCFlags(string $arch): array
-    {
-        return match ($arch) {
-            'x86_64', 'arm64', 'aarch64' => [],
-            default => throw new RuntimeException('unsupported arch: ' . $arch),
-        };
-    }
-
-    public static function checkCCFlags(array $flags, string $cc): array
-    {
-        return array_filter($flags, fn ($flag) => static::checkCCFlag($flag, $cc));
-    }
-
-    public static function checkCCFlag(string $flag, string $cc): string
-    {
-        [$ret] = shell()->execWithResult("echo | {$cc} -E -x c - {$flag} 2>/dev/null");
-        if ($ret != 0) {
-            return '';
-        }
-        return $flag;
-    }
-
     /**
      * @throws RuntimeException
      * @noinspection PhpUnused

src/SPC/builder/linux/library/gmssl.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+class gmssl extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\gmssl;
+
+    public const NAME = 'gmssl';
+}

src/SPC/builder/macos/library/gmssl.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class gmssl extends MacOSLibraryBase
+{
+    use \SPC\builder\unix\library\gmssl;
+
+    public const NAME = 'gmssl';
+}

src/SPC/builder/unix/library/gmssl.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\unix\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+
+trait gmssl
+{
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build(): void
+    {
+        // CMake needs a clean build directory
+        FileSystem::resetDir($this->source_dir . '/build');
+        // Start build
+        shell()->cd($this->source_dir . '/build')
+            ->setEnv(['CFLAGS' => $this->getLibExtraCFlags(), 'LDFLAGS' => $this->getLibExtraLdFlags(), 'LIBS' => $this->getLibExtraLibs()])
+            ->execWithEnv("cmake {$this->builder->makeCmakeArgs()} -DBUILD_SHARED_LIBS=OFF ..")
+            ->execWithEnv("cmake --build . -j {$this->builder->concurrency}")
+            ->execWithEnv('make install DESTDIR=' . BUILD_ROOT_PATH);
+    }
+}

src/SPC/builder/windows/SystemUtil.php

@@ -21,7 +21,7 @@ class SystemUtil
         if (!$paths) {
             $paths = explode(PATH_SEPARATOR, getenv('Path'));
             if ($include_sdk_bin) {
-                $paths[] = PHP_SDK_PATH . '\bin';
+                $paths[] = getenv('PHP_SDK_PATH') . '\bin';
             }
         }
         foreach ($paths as $path) {

src/SPC/builder/windows/WindowsBuilder.php

@@ -38,7 +38,7 @@ class WindowsBuilder extends BuilderBase
         // ---------- set necessary options ----------
         // set sdk (require visual studio 16 or 17)
         $vs = SystemUtil::findVisualStudio()['version'];
-        $this->sdk_prefix = PHP_SDK_PATH . "\\phpsdk-{$vs}-x64.bat -t";
+        $this->sdk_prefix = getenv('PHP_SDK_PATH') . "\\phpsdk-{$vs}-x64.bat -t";
 
         // set zts
         $this->zts = $this->getOption('enable-zts', false);

src/SPC/builder/windows/library/gmssl.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\windows\library;
+
+use SPC\store\FileSystem;
+
+class gmssl extends WindowsLibraryBase
+{
+    public const NAME = 'gmssl';
+
+    protected function build(): void
+    {
+        // reset cmake
+        FileSystem::resetDir($this->source_dir . '\builddir');
+
+        // start build
+        cmd()->cd($this->source_dir . '\builddir')
+            ->execWithWrapper(
+                $this->builder->makeSimpleWrapper('cmake .. -G "NMake Makefiles" -DWIN32=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_FLAGS_RELEASE="/MT /O2 /Ob2 /DNDEBUG" -DCMAKE_CXX_FLAGS_RELEASE="/MT /O2 /Ob2 /DNDEBUG" -DCMAKE_INSTALL_PREFIX=' . BUILD_ROOT_PATH),
+                '-DCMAKE_INSTALL_PREFIX=' . BUILD_ROOT_PATH
+            );
+
+        FileSystem::writeFile($this->source_dir . '\builddir\cmake_install.cmake', 'set(CMAKE_INSTALL_PREFIX "' . str_replace('\\', '/', BUILD_ROOT_PATH) . '")' . PHP_EOL . FileSystem::readFile($this->source_dir . '\builddir\cmake_install.cmake'));
+
+        cmd()->cd($this->source_dir . '\builddir')
+            ->execWithWrapper(
+                $this->builder->makeSimpleWrapper('nmake'),
+                'install XCFLAGS=/MT'
+            );
+    }
+}

src/SPC/builder/windows/library/xz.php

@@ -32,7 +32,7 @@ class xz extends WindowsLibraryBase
             );
 
         // copy liblzma.lib to liblzma_a.lib
-        copy(BUILD_LIB_PATH . '/liblzma.lib', BUILD_LIB_PATH . '/liblzma_a.lib');
+        copy(BUILD_LIB_PATH . '/lzma.lib', BUILD_LIB_PATH . '/liblzma_a.lib');
         // patch lzma.h
         FileSystem::replaceFileStr(BUILD_INCLUDE_PATH . '/lzma.h', 'defined(LZMA_API_STATIC)', 'defined(_WIN32)');
     }

src/SPC/command/BaseCommand.php

@@ -10,6 +10,7 @@ use Psr\Log\LogLevel;
 use SPC\ConsoleApplication;
 use SPC\exception\ExceptionHandler;
 use SPC\exception\WrongUsageException;
+use SPC\util\GlobalEnvManager;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Helper\QuestionHelper;
 use Symfony\Component\Console\Input\InputInterface;
@@ -94,6 +95,11 @@ abstract class BaseCommand extends Command
             $question = new ConfirmationQuestion($prompt->label . $case, $prompt->default);
             return $helper->ask($input, $output, $question);
         });
+
+        // init GlobalEnv
+        if (!$this instanceof BuildCommand) {
+            GlobalEnvManager::init();
+        }
         if ($this->shouldExecute()) {
             try {
                 // show raw argv list for logger()->debug

src/SPC/command/DoctorCommand.php

@@ -23,6 +23,8 @@ class DoctorCommand extends BaseCommand
     {
         try {
             $checker = new CheckListHandler();
+            // skipped items
+            $skip_items = array_filter(explode(',', getenv('SPC_SKIP_DOCTOR_CHECK_ITEMS') ?: ''));
 
             $fix_policy = $this->input->getOption('auto-fix') ? FIX_POLICY_AUTOFIX : FIX_POLICY_PROMPT;
             foreach ($checker->runChecks() as $check) {
@@ -32,13 +34,12 @@ class DoctorCommand extends BaseCommand
 
                 $this->output->write('Checking <comment>' . $check->item_name . '</comment> ... ');
 
-                $result = call_user_func($check->callback);
+                // check if this item is skipped
-                if ($result === null) {
+                if (in_array($check->item_name, $skip_items) || ($result = call_user_func($check->callback)) === null) {
                     $this->output->writeln('skipped');
                 } elseif ($result instanceof CheckResult) {
                     if ($result->isOK()) {
                         $this->output->writeln($result->getMessage() ?? 'ok');
-
                         continue;
                     }
 

src/SPC/command/dev/PackLibCommand.php

@@ -5,8 +5,12 @@ declare(strict_types=1);
 namespace SPC\command\dev;
 
 use SPC\builder\BuilderProvider;
+use SPC\builder\LibraryBase;
 use SPC\command\BuildCommand;
 use SPC\exception\ExceptionHandler;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\FileSystem;
 use SPC\util\DependencyUtil;
@@ -53,6 +57,8 @@ class PackLibCommand extends BuildCommand
                     $lib->tryBuild(true);
                     // do something like patching pkg-conf files.
                     $lib->beforePack();
+                    // sanity check for libs (check if the libraries are built correctly)
+                    $this->sanityCheckLib($lib);
                     // After build: load buildroot/ directory, and calculate increase files
                     $after_buildroot = FileSystem::scanDirFiles(BUILD_ROOT_PATH, relative: true);
                     $increase_files = array_diff($after_buildroot, $before_buildroot);
@@ -82,4 +88,20 @@ class PackLibCommand extends BuildCommand
             return static::FAILURE;
         }
     }
+
+    /**
+     * @throws WrongUsageException
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    private function sanityCheckLib(LibraryBase $lib): void
+    {
+        logger()->info('Sanity check for library ' . $lib->getName());
+        // config
+        foreach ($lib->getStaticLibs() as $static_lib) {
+            if (!file_exists(FileSystem::convertPath(BUILD_LIB_PATH . '/' . $static_lib))) {
+                throw new RuntimeException('Static library ' . $static_lib . ' not found in ' . BUILD_LIB_PATH);
+            }
+        }
+    }
 }

src/SPC/doctor/item/LinuxMuslCheck.php

@@ -73,9 +73,9 @@ class LinuxMuslCheck
             FileSystem::extractSource($musl_version_name, DOWNLOAD_PATH . "/{$musl_version_name}.tar.gz");
             logger()->info('Installing musl wrapper');
             shell()->cd(SOURCE_PATH . "/{$musl_version_name}")
-                ->exec('./configure --disable-gcc-wrapper')
+                ->exec('CC=gcc CXX=g++ AR=ar LD=ld ./configure --disable-gcc-wrapper')
-                ->exec('make -j')
+                ->exec('CC=gcc CXX=g++ AR=ar LD=ld make -j')
-                ->exec("{$prefix}make install");
+                ->exec("CC=gcc CXX=g++ AR=ar LD=ld {$prefix}make install");
             // TODO: add path using putenv instead of editing /etc/profile
             return true;
         } catch (RuntimeException) {

src/SPC/doctor/item/WindowsToolCheckList.php

@@ -37,10 +37,10 @@ class WindowsToolCheckList
     #[AsCheckItem('if php-sdk-binary-tools are downloaded', limit_os: 'Windows', level: 997)]
     public function checkSDK(): ?CheckResult
     {
-        if (!file_exists(PHP_SDK_PATH . DIRECTORY_SEPARATOR . 'phpsdk-starter.bat')) {
+        if (!file_exists(getenv('PHP_SDK_PATH') . DIRECTORY_SEPARATOR . 'phpsdk-starter.bat')) {
             return CheckResult::fail('php-sdk-binary-tools not downloaded', 'install-php-sdk');
         }
-        return CheckResult::ok(PHP_SDK_PATH);
+        return CheckResult::ok(getenv('PHP_SDK_PATH'));
     }
 
     #[AsCheckItem('if git associated command exists', limit_os: 'Windows', level: 996)]
@@ -81,8 +81,8 @@ class WindowsToolCheckList
     public function installPhpSdk(): bool
     {
         try {
-            FileSystem::removeDir(PHP_SDK_PATH);
+            FileSystem::removeDir(getenv('PHP_SDK_PATH'));
-            cmd(true)->exec('git.exe clone --depth 1 https://github.com/php/php-sdk-binary-tools.git ' . PHP_SDK_PATH);
+            cmd(true)->exec('git.exe clone --depth 1 https://github.com/php/php-sdk-binary-tools.git ' . getenv('PHP_SDK_PATH'));
         } catch (RuntimeException) {
             return false;
         }

src/SPC/store/CurlHook.php

@@ -20,11 +20,17 @@ class CurlHook
         }
         if (getenv('GITHUB_USER')) {
             $auth = base64_encode(getenv('GITHUB_USER') . ':' . getenv('GITHUB_TOKEN'));
-            $headers[] = "Authorization: Basic {$auth}";
+            $he = "Authorization: Basic {$auth}";
+            if (!in_array($he, $headers)) {
+                $headers[] = $he;
+            }
             logger()->info("using basic github token for {$method} {$url}");
         } else {
             $auth = getenv('GITHUB_TOKEN');
-            $headers[] = "Authorization: Bearer {$auth}";
+            $he = "Authorization: Bearer {$auth}";
+            if (!in_array($he, $headers)) {
+                $headers[] = $he;
+            }
             logger()->info("using bearer github token for {$method} {$url}");
         }
     }

src/SPC/store/Downloader.php

@@ -182,6 +182,7 @@ class Downloader
      *
      * @throws FileSystemException
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public static function downloadFile(string $name, string $url, string $filename, ?string $move_path = null, int $lock_as = SPC_LOCK_SOURCE): void
     {
@@ -220,6 +221,7 @@ class Downloader
      *
      * @throws FileSystemException
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public static function downloadGit(string $name, string $url, string $branch, ?string $move_path = null, int $retry = 0, int $lock_as = SPC_LOCK_SOURCE): void
     {
@@ -381,6 +383,7 @@ class Downloader
      * @param  int                 $lock_as Lock source type (default: SPC_LOCK_SOURCE)
      * @throws DownloaderException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public static function downloadSource(string $name, ?array $source = null, bool $force = false, int $lock_as = SPC_LOCK_SOURCE): void
     {
@@ -539,6 +542,7 @@ class Downloader
      * Use curl to download sources from url
      *
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public static function curlDown(string $url, string $path, string $method = 'GET', array $headers = [], array $hooks = [], int $retry = 0): void
     {

src/SPC/store/FileSystem.php

@@ -428,7 +428,7 @@ class FileSystem
     {
         $replacement = [
             '{pkg_root_path}' => PKG_ROOT_PATH,
-            '{php_sdk_path}' => defined('PHP_SDK_PATH') ? PHP_SDK_PATH : WORKING_DIR . '/php-sdk-binary-tools',
+            '{php_sdk_path}' => getenv('PHP_SDK_PATH') ? getenv('PHP_SDK_PATH') : WORKING_DIR . '/php-sdk-binary-tools',
             '{working_dir}' => WORKING_DIR,
             '{download_path}' => DOWNLOAD_PATH,
             '{source_path}' => SOURCE_PATH,
@@ -480,7 +480,7 @@ class FileSystem
             };
         } elseif (PHP_OS_FAMILY === 'Windows') {
             // use php-sdk-binary-tools/bin/7za.exe
-            $_7z = self::convertPath(PHP_SDK_PATH . '/bin/7za.exe');
+            $_7z = self::convertPath(getenv('PHP_SDK_PATH') . '/bin/7za.exe');
 
             // Windows notes: I hate windows tar.......
             // When extracting .tar.gz like libxml2, it shows a symlink error and returns code[1].

src/SPC/store/source/PhpSource.php

@@ -20,7 +20,11 @@ class PhpSource extends CustomSourceBase
     public function fetch(bool $force = false, ?array $config = null, int $lock_as = SPC_LOCK_SOURCE): void
     {
         $major = defined('SPC_BUILD_PHP_VERSION') ? SPC_BUILD_PHP_VERSION : '8.1';
-        Downloader::downloadSource('php-src', self::getLatestPHPInfo($major), $force);
+        if ($major === '8.4') {
+            Downloader::downloadSource('php-src', ['type' => 'url', 'url' => 'https://downloads.php.net/~saki/php-8.4.0RC1.tar.xz'], $force);
+        } else {
+            Downloader::downloadSource('php-src', self::getLatestPHPInfo($major), $force);
+        }
     }
 
     /**

src/SPC/util/GlobalEnvManager.php

@@ -5,11 +5,9 @@ declare(strict_types=1);
 namespace SPC\util;
 
 use SPC\builder\BuilderBase;
-use SPC\builder\freebsd\SystemUtil as BSDSystemUtil;
+use SPC\builder\linux\SystemUtil;
-use SPC\builder\linux\SystemUtil as LinuxSystemUtil;
-use SPC\builder\macos\SystemUtil as MacOSSystemUtil;
-use SPC\builder\windows\SystemUtil as WindowsSystemUtil;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 
 /**
  * Environment variable manager
@@ -26,171 +24,87 @@ class GlobalEnvManager
     /**
      * Initialize the environment variables
      *
-     * @param  BuilderBase      $builder Builder
+     * @param  null|BuilderBase    $builder Builder
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
-    public static function init(BuilderBase $builder): void
+    public static function init(?BuilderBase $builder = null): void
     {
-        // Init global env, build related path
+        // Check pre-defined env vars exists
-        self::putenv('BUILD_ROOT_PATH=' . BUILD_ROOT_PATH);
+        if (getenv('BUILD_ROOT_PATH') === false) {
-        self::putenv('BUILD_INCLUDE_PATH=' . BUILD_INCLUDE_PATH);
+            throw new RuntimeException('You must include src/globals/internal-env.php before using GlobalEnvManager');
-        self::putenv('BUILD_LIB_PATH=' . BUILD_LIB_PATH);
+        }
-        self::putenv('BUILD_BIN_PATH=' . BUILD_BIN_PATH);
-        self::putenv('PKG_ROOT_PATH=' . PKG_ROOT_PATH);
-        self::putenv('SOURCE_PATH=' . SOURCE_PATH);
-        self::putenv('DOWNLOAD_PATH=' . DOWNLOAD_PATH);
 
-        // Init SPC env
+        // Define env vars for unix
-        self::initIfNotExists('SPC_CONCURRENCY', match (PHP_OS_FAMILY) {
+        if (is_unix()) {
-            'Windows' => (string) WindowsSystemUtil::getCpuCount(),
+            self::putenv('PATH=' . BUILD_ROOT_PATH . '/bin:' . getenv('PATH'));
-            'Darwin' => (string) MacOSSystemUtil::getCpuCount(),
+            self::putenv('PKG_CONFIG=' . BUILD_BIN_PATH . '/pkg-config');
-            'Linux' => (string) LinuxSystemUtil::getCpuCount(),
+            self::putenv('PKG_CONFIG_PATH=' . BUILD_ROOT_PATH . '/lib/pkgconfig');
-            'BSD' => (string) BSDSystemUtil::getCpuCount(),
+            if ($builder instanceof BuilderBase) {
-            default => '1',
+                self::putenv('SPC_PHP_DEFAULT_OPTIMIZE_CFLAGS=' . ($builder->getOption('no-strip') ? '-g -O0' : '-g -Os'));
-        });
+            }
+        }
 
-        // Init system-specific env
+        // Define env vars for linux
-        match (PHP_OS_FAMILY) {
+        if (PHP_OS_FAMILY === 'Linux') {
-            'Windows' => self::initWindowsEnv(),
-            'Darwin' => self::initDarwinEnv($builder),
-            'Linux' => self::initLinuxEnv($builder),
-            'BSD' => 'TODO',
-            default => logger()->warning('Unknown OS: ' . PHP_OS_FAMILY),
-        };
-    }
-
-    private static function initWindowsEnv(): void
-    {
-        // Windows need php-sdk binary tools
-        self::initIfNotExists('PHP_SDK_PATH', WORKING_DIR . DIRECTORY_SEPARATOR . 'php-sdk-binary-tools');
-        self::initIfNotExists('UPX_EXEC', PKG_ROOT_PATH . DIRECTORY_SEPARATOR . 'bin' . DIRECTORY_SEPARATOR . 'upx.exe');
-        self::initIfNotExists('SPC_MICRO_PATCHES', 'static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,cli_static');
-    }
-
-    private static function initLinuxEnv(BuilderBase $builder): void
-    {
-        // Init C Compiler and C++ Compiler (alpine)
-        if (LinuxSystemUtil::isMuslDist()) {
-            self::initIfNotExists('CC', 'gcc');
-            self::initIfNotExists('CXX', 'g++');
-            self::initIfNotExists('AR', 'ar');
-            self::initIfNotExists('LD', 'ld.gold');
-        } else {
             $arch = arch2gnu(php_uname('m'));
-            self::initIfNotExists('CC', "{$arch}-linux-musl-gcc");
+            if (SystemUtil::isMuslDist()) {
-            self::initIfNotExists('CXX', "{$arch}-linux-musl-g++");
+                self::putenv('SPC_LINUX_DEFAULT_CC=gcc');
-            self::initIfNotExists('AR', "{$arch}-linux-musl-ar");
+                self::putenv('SPC_LINUX_DEFAULT_CXX=g++');
-            self::initIfNotExists('LD', 'ld.gold');
+                self::putenv('SPC_LINUX_DEFAULT_AR=ar');
+            } else {
+                self::putenv("SPC_LINUX_DEFAULT_CC={$arch}-linux-musl-gcc");
+                self::putenv("SPC_LINUX_DEFAULT_CXX={$arch}-linux-musl-g++");
+                self::putenv("SPC_LINUX_DEFAULT_AR={$arch}-linux-musl-ar");
+            }
+            self::putenv("SPC_PHP_DEFAULT_LD_LIBRARY_PATH_CMD=LD_LIBRARY_PATH=/usr/local/musl/{$arch}-linux-musl/lib");
             if (getenv('SPC_NO_MUSL_PATH') !== 'yes') {
                 self::putenv("PATH=/usr/local/musl/bin:/usr/local/musl/{$arch}-linux-musl/bin:" . getenv('PATH'));
             }
         }
 
-        // Init arch-specific cflags
+        // Init env.ini file, read order:
-        self::initIfNotExists('SPC_DEFAULT_C_FLAGS', '');
+        //      WORKING_DIR/config/env.ini
-        self::initIfNotExists('SPC_DEFAULT_CXX_FLAGS', '');
+        //      ROOT_DIR/config/env.ini
-        self::initIfNotExists('SPC_EXTRA_LIBS', '');
+        $ini_files = [
-
+            WORKING_DIR . '/config/env.ini',
-        // SPC_MICRO_PATCHES for linux
+            ROOT_DIR . '/config/env.ini',
-        self::initIfNotExists('SPC_MICRO_PATCHES', 'static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream');
-
-        // Init linux-only env
-        self::initIfNotExists('UPX_EXEC', PKG_ROOT_PATH . '/bin/upx');
-        self::initIfNotExists('GNU_ARCH', arch2gnu(php_uname('m')));
-
-        // optimization flags with different strip option
-        $php_extra_cflags_optimize = $builder->getOption('no-strip') ? '-g -O0' : '-g -Os';
-        // optimization flags with different c compiler
-        $clang_use_lld = str_ends_with(getenv('CC'), 'clang') && LinuxSystemUtil::findCommand('lld') ? '-Xcompiler -fuse-ld=lld ' : '';
-
-        $init_spc_cmd_maps = [
-            // Init default build command prefix
-            'SPC_CMD_PREFIX_PHP_BUILDCONF' => './buildconf --force',
-            'SPC_CMD_PREFIX_PHP_CONFIGURE' => $builder->getOption('ld_library_path') . ' ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg',
-            'SPC_CMD_PREFIX_PHP_MAKE' => 'make -j' . getenv('SPC_CONCURRENCY'),
-            // Init default build vars for build command
-            'SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS' => getenv('SPC_DEFAULT_C_FLAGS'),
-            'SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS' => '-I' . BUILD_INCLUDE_PATH,
-            'SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS' => '-L' . BUILD_LIB_PATH,
-            'SPC_CMD_VAR_PHP_CONFIGURE_LIBS' => '-ldl -lpthread -lm',
-            'SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS' => $php_extra_cflags_optimize . ' -fno-ident -fPIE',
-            'SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS' => '',
-            'SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS_PROGRAM' => $clang_use_lld . '-all-static',
         ];
-        foreach ($init_spc_cmd_maps as $name => $value) {
+        $ini = null;
-            self::initIfNotExists($name, $value);
+        foreach ($ini_files as $ini_file) {
+            if (file_exists($ini_file)) {
+                $ini = parse_ini_file($ini_file, true);
+                break;
+            }
         }
-
+        if ($ini === null) {
-        self::initUnixEnv($builder);
+            throw new WrongUsageException('env.ini not found');
-    }
-
-    private static function initDarwinEnv(BuilderBase $builder): void
-    {
-        // Init C Compiler and C++ Compiler
-        self::initIfNotExists('CC', 'clang');
-        self::initIfNotExists('CXX', 'clang++');
-
-        // Init arch-specific cflags
-        self::initIfNotExists('SPC_DEFAULT_C_FLAGS', match (php_uname('m')) {
-            'arm64', 'aarch64' => '--target=arm64-apple-darwin',
-            default => '--target=x86_64-apple-darwin',
-        });
-        // Init arch-specific cxxflags
-        self::initIfNotExists('SPC_DEFAULT_CXX_FLAGS', match (php_uname('m')) {
-            'arm64', 'aarch64' => '--target=arm64-apple-darwin',
-            default => '--target=x86_64-apple-darwin',
-        });
-
-        // Init extra libs (will be appended before `before-php-buildconf` event point)
-        self::initIfNotExists('SPC_EXTRA_LIBS', '');
-
-        // SPC_MICRO_PATCHES for macOS
-        self::initIfNotExists('SPC_MICRO_PATCHES', 'static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,macos_iconv');
-
-        $init_spc_cmd_maps = [
-            // Init default build command prefix
-            'SPC_CMD_PREFIX_PHP_BUILDCONF' => './buildconf --force',
-            'SPC_CMD_PREFIX_PHP_CONFIGURE' => './configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg',
-            'SPC_CMD_PREFIX_PHP_MAKE' => 'make -j' . getenv('SPC_CONCURRENCY'),
-            // Init default build vars for build command
-            'SPC_CMD_VAR_PHP_CONFIGURE_CFLAGS' => getenv('SPC_DEFAULT_C_FLAGS') . ' -Werror=unknown-warning-option',
-            'SPC_CMD_VAR_PHP_CONFIGURE_CPPFLAGS' => '-I' . BUILD_INCLUDE_PATH,
-            'SPC_CMD_VAR_PHP_CONFIGURE_LDFLAGS' => '-L' . BUILD_LIB_PATH,
-            'SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS' => $builder->getOption('no-strip') ? '-g -O0' : '-g -Os',
-            'SPC_CMD_VAR_PHP_MAKE_EXTRA_LIBS' => '-lresolv',
-        ];
-        foreach ($init_spc_cmd_maps as $name => $value) {
-            self::initIfNotExists($name, $value);
         }
-
+        if ($ini === false || !isset($ini['global'])) {
-        self::initUnixEnv($builder);
+            throw new WrongUsageException('Failed to parse ' . $ini_file);
-    }
-
-    private static function initUnixEnv(BuilderBase $builder): void
-    {
-        self::putenv('PATH=' . BUILD_ROOT_PATH . '/bin:' . getenv('PATH'));
-        self::putenv('PKG_CONFIG=' . BUILD_BIN_PATH . '/pkg-config');
-        self::putenv('PKG_CONFIG_PATH=' . BUILD_ROOT_PATH . '/lib/pkgconfig');
-    }
-
-    /**
-     * Initialize the environment variable if it does not exist
-     *
-     * @param string $name  Environment variable name
-     * @param string $value Environment variable value
-     */
-    private static function initIfNotExists(string $name, string $value): void
-    {
-        if (($val = getenv($name)) === false) {
-            self::putenv($name . '=' . $value);
-        } else {
-            logger()->debug("env [{$name}] existing: {$val}");
         }
+        self::applyConfig($ini['global']);
+        match (PHP_OS_FAMILY) {
+            'Windows' => self::applyConfig($ini['windows']),
+            'Darwin' => self::applyConfig($ini['macos']),
+            'Linux' => self::applyConfig($ini['linux']),
+            'BSD' => self::applyConfig($ini['freebsd']),
+            default => null,
+        };
     }
 
-    private static function putenv(string $val): void
+    public static function putenv(string $val): void
     {
         f_putenv($val);
         self::$env_cache[] = $val;
     }
+
+    private static function applyConfig(array $ini): void
+    {
+        foreach ($ini as $k => $v) {
+            if (getenv($k) === false) {
+                self::putenv($k . '=' . $v);
+            }
+        }
+    }
 }

src/SPC/util/LicenseDumper.php

@@ -118,20 +118,26 @@ class LicenseDumper
     /**
      * @throws RuntimeException
      */
-    private function loadSourceFile(string $source_name, int $index, ?string $in_path, ?string $custom_base_path = null): string
+    private function loadSourceFile(string $source_name, int $index, null|array|string $in_path, ?string $custom_base_path = null): string
     {
         if (is_null($in_path)) {
             throw new RuntimeException('source [' . $source_name . '] license file is not set, please check config/source.json');
         }
 
-        if (file_exists(SOURCE_PATH . '/' . ($custom_base_path ?? $source_name) . '/' . $in_path)) {
+        if (!is_array($in_path)) {
-            return file_get_contents(SOURCE_PATH . '/' . ($custom_base_path ?? $source_name) . '/' . $in_path);
+            $in_path = [$in_path];
+        }
+
+        foreach ($in_path as $item) {
+            if (file_exists(SOURCE_PATH . '/' . ($custom_base_path ?? $source_name) . '/' . $item)) {
+                return file_get_contents(SOURCE_PATH . '/' . ($custom_base_path ?? $source_name) . '/' . $item);
+            }
         }
 
         if (file_exists(BUILD_ROOT_PATH . '/source-licenses/' . $source_name . '/' . $index . '.txt')) {
             return file_get_contents(BUILD_ROOT_PATH . '/source-licenses/' . $source_name . '/' . $index . '.txt');
         }
 
-        throw new RuntimeException('source [' . $source_name . '] license file [' . $in_path . '] not exist');
+        throw new RuntimeException('Cannot find any license file in source [' . $source_name . '] directory!');
     }
 }

src/globals/defines.php

@@ -2,32 +2,16 @@
 
 declare(strict_types=1);
 
-use SPC\store\FileSystem;
 use ZM\Logger\ConsoleLogger;
 
 define('WORKING_DIR', getcwd());
 define('ROOT_DIR', dirname(__DIR__, 2));
+putenv('WORKING_DIR=' . WORKING_DIR);
+putenv('ROOT_DIR=' . ROOT_DIR);
 
 // CLI start time
 define('START_TIME', microtime(true));
 
-define('BUILD_ROOT_PATH', FileSystem::convertPath(is_string($a = getenv('BUILD_ROOT_PATH')) ? $a : (WORKING_DIR . '/buildroot')));
-define('SOURCE_PATH', FileSystem::convertPath(is_string($a = getenv('SOURCE_PATH')) ? $a : (WORKING_DIR . '/source')));
-define('DOWNLOAD_PATH', FileSystem::convertPath(is_string($a = getenv('DOWNLOAD_PATH')) ? $a : (WORKING_DIR . '/downloads')));
-define('PKG_ROOT_PATH', FileSystem::convertPath(is_string($a = getenv('PKG_ROOT_PATH')) ? $a : (WORKING_DIR . '/pkgroot')));
-define('BUILD_BIN_PATH', FileSystem::convertPath(is_string($a = getenv('INSTALL_BIN_PATH')) ? $a : (BUILD_ROOT_PATH . '/bin')));
-define('BUILD_LIB_PATH', FileSystem::convertPath(is_string($a = getenv('INSTALL_LIB_PATH')) ? $a : (BUILD_ROOT_PATH . '/lib')));
-define('BUILD_INCLUDE_PATH', FileSystem::convertPath(is_string($a = getenv('INSTALL_INCLUDE_PATH')) ? $a : (BUILD_ROOT_PATH . '/include')));
-define('SEPARATED_PATH', [
-    '/' . pathinfo(BUILD_LIB_PATH)['basename'], // lib
-    '/' . pathinfo(BUILD_INCLUDE_PATH)['basename'], // include
-    BUILD_ROOT_PATH,
-]);
-
-if (PHP_OS_FAMILY === 'Windows') {
-    define('PHP_SDK_PATH', is_string($a = getenv('PHP_SDK_PATH')) ? $a : (WORKING_DIR . DIRECTORY_SEPARATOR . 'php-sdk-binary-tools'));
-}
-
 // for windows, prevent calling Invoke-WebRequest and wsl command
 const SPC_CURL_EXEC = PHP_OS_FAMILY === 'Windows' ? 'curl.exe' : 'curl';
 const SPC_GIT_EXEC = PHP_OS_FAMILY === 'Windows' ? 'git.exe' : 'git';

src/globals/ext-tests/gmssl.php

@@ -0,0 +1,8 @@
+<?php
+
+declare(strict_types=1);
+
+assert(function_exists('gmssl_rand_bytes'));
+assert(function_exists('gmssl_sm3'));
+
+assert(bin2hex(gmssl_sm3('123456')) === '207cf410532f92a47dee245ce9b11ff71f578ebd763eb3bbea44ebd043d018fb');

src/globals/ext-tests/msgpack.php

@@ -0,0 +1,7 @@
+<?php
+
+declare(strict_types=1);
+
+assert(function_exists('msgpack_pack'));
+assert(function_exists('msgpack_unpack'));
+assert(msgpack_unpack(msgpack_pack(['foo', 'bar'])) === ['foo', 'bar']);

src/globals/functions.php

@@ -31,6 +31,11 @@ function logger(): LoggerInterface
     return $ob_logger;
 }
 
+function is_unix(): bool
+{
+    return in_array(PHP_OS_FAMILY, ['Linux', 'Darwin', 'BSD']);
+}
+
 /**
  * Transfer architecture name to gnu triplet
  *

src/globals/internal-env.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+use SPC\builder\freebsd\SystemUtil as BSDSystemUtil;
+use SPC\builder\linux\SystemUtil as LinuxSystemUtil;
+use SPC\builder\macos\SystemUtil as MacOSSystemUtil;
+use SPC\builder\windows\SystemUtil as WindowsSystemUtil;
+use SPC\store\FileSystem;
+use SPC\util\GlobalEnvManager;
+
+define('BUILD_ROOT_PATH', FileSystem::convertPath(is_string($a = getenv('BUILD_ROOT_PATH')) ? $a : (WORKING_DIR . '/buildroot')));
+define('BUILD_INCLUDE_PATH', FileSystem::convertPath(is_string($a = getenv('BUILD_INCLUDE_PATH')) ? $a : (BUILD_ROOT_PATH . '/include')));
+define('BUILD_LIB_PATH', FileSystem::convertPath(is_string($a = getenv('BUILD_LIB_PATH')) ? $a : (BUILD_ROOT_PATH . '/lib')));
+define('BUILD_BIN_PATH', FileSystem::convertPath(is_string($a = getenv('BUILD_BIN_PATH')) ? $a : (BUILD_ROOT_PATH . '/bin')));
+define('PKG_ROOT_PATH', FileSystem::convertPath(is_string($a = getenv('PKG_ROOT_PATH')) ? $a : (WORKING_DIR . '/pkgroot')));
+define('SOURCE_PATH', FileSystem::convertPath(is_string($a = getenv('SOURCE_PATH')) ? $a : (WORKING_DIR . '/source')));
+define('DOWNLOAD_PATH', FileSystem::convertPath(is_string($a = getenv('DOWNLOAD_PATH')) ? $a : (WORKING_DIR . '/downloads')));
+define('CPU_COUNT', match (PHP_OS_FAMILY) {
+    'Windows' => (string) WindowsSystemUtil::getCpuCount(),
+    'Darwin' => (string) MacOSSystemUtil::getCpuCount(),
+    'Linux' => (string) LinuxSystemUtil::getCpuCount(),
+    'BSD' => (string) BSDSystemUtil::getCpuCount(),
+    default => 1,
+});
+define('GNU_ARCH', arch2gnu(php_uname('m')));
+define('MAC_ARCH', match ($_im8a = arch2gnu(php_uname('m'))) {
+    'aarch64' => 'arm64',
+    default => $_im8a
+});
+
+// deprecated variables
+define('SEPARATED_PATH', [
+    '/' . pathinfo(BUILD_LIB_PATH)['basename'], // lib
+    '/' . pathinfo(BUILD_INCLUDE_PATH)['basename'], // include
+    BUILD_ROOT_PATH,
+]);
+
+// add these to env vars with same name
+GlobalEnvManager::putenv('BUILD_ROOT_PATH=' . BUILD_ROOT_PATH);
+GlobalEnvManager::putenv('BUILD_INCLUDE_PATH=' . BUILD_INCLUDE_PATH);
+GlobalEnvManager::putenv('BUILD_LIB_PATH=' . BUILD_LIB_PATH);
+GlobalEnvManager::putenv('BUILD_BIN_PATH=' . BUILD_BIN_PATH);
+GlobalEnvManager::putenv('PKG_ROOT_PATH=' . PKG_ROOT_PATH);
+GlobalEnvManager::putenv('SOURCE_PATH=' . SOURCE_PATH);
+GlobalEnvManager::putenv('DOWNLOAD_PATH=' . DOWNLOAD_PATH);
+GlobalEnvManager::putenv('CPU_COUNT=' . CPU_COUNT);
+GlobalEnvManager::putenv('GNU_ARCH=' . GNU_ARCH);
+GlobalEnvManager::putenv('MAC_ARCH=' . MAC_ARCH);

src/globals/test-extensions.php

@@ -11,16 +11,37 @@ declare(strict_types=1);
 
 // --------------------------------- edit area ---------------------------------
 
+// test php version
+$test_php_version = [
+    '8.0',
+    '8.1',
+    '8.2',
+    '8.3',
+];
+
+// test os (macos-13, macos-14, ubuntu-latest, windows-latest are available)
+$test_os = [
+    'macos-14',
+    'ubuntu-latest',
+    'macos-13',
+    'windows-latest',
+];
+
+// whether enable thread safe
 $zts = false;
 
 $no_strip = false;
 
-$upx = true;
+// compress with upx
+$upx = false;
+
+// prefer downloading pre-built packages to speed up the build process
+$prefer_pre_built = true;
 
 // If you want to test your added extensions and libs, add below (comma separated, example `bcmath,openssl`).
 $extensions = match (PHP_OS_FAMILY) {
-    'Linux', 'Darwin' => 'imap,swoole-hook-sqlite,swoole',
+    'Linux', 'Darwin' => '',
-    'Windows' => 'igbinary,redis,session',
+    'Windows' => 'amqp,apcu,bcmath,bz2,calendar,ctype,curl,dba,dom,ds,exif,ffi,fileinfo,filter,ftp,gd,iconv,igbinary,libxml,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pdo,pdo_mysql,pdo_sqlite,pdo_sqlsrv,phar,rar,redis,session,shmop,simdjson,simplexml,soap,sockets,sqlite3,sqlsrv,ssh2,swow,sysvshm,tokenizer,xml,xmlreader,xmlwriter,yac,yaml,zip,zlib',
 };
 
 // If you want to test lib-suggests feature with extension, add them below (comma separated, example `libwebp,libavif`).
@@ -33,7 +54,7 @@ $with_libs = match (PHP_OS_FAMILY) {
 // You can use `common`, `bulk`, `minimal` or `none`.
 // note: combination is only available for *nix platform. Windows must use `none` combination
 $base_combination = match (PHP_OS_FAMILY) {
-    'Linux', 'Darwin' => 'none',
+    'Linux', 'Darwin' => 'bulk',
     'Windows' => 'none',
 };
 
@@ -58,7 +79,7 @@ function _getCombination(string $type = 'common'): string
 }
 
 if (!isset($argv[1])) {
-    exit("Please use 'extensions', 'cmd' or 'libs' as output type");
+    exit("Please use 'extensions', 'cmd', 'os', 'php' or 'libs' as output type");
 }
 
 $trim_value = "\r\n \t,";
@@ -72,7 +93,44 @@ if (PHP_OS_FAMILY === 'Windows') {
     $final_extensions_cmd = $final_extensions;
 }
 
+function quote2(string $param): string
+{
+    global $argv;
+    if (str_starts_with($argv[2], 'windows-')) {
+        return '"' . $param . '"';
+    }
+    return $param;
+}
+
+// generate download command
+if ($argv[1] === 'download_cmd') {
+    $down_cmd = 'download ';
+    $down_cmd .= '--for-extensions=' . quote2($final_extensions) . ' ';
+    $down_cmd .= '--for-libs=' . quote2($final_libs) . ' ';
+    $down_cmd .= '--with-php=' . quote2($argv[3]) . ' ';
+    $down_cmd .= '--ignore-cache-sources=php-src ';
+    $down_cmd .= '--debug ';
+    $down_cmd .= '--retry=5 ';
+    $down_cmd .= '--shallow-clone ';
+    $down_cmd .= $prefer_pre_built ? '--prefer-pre-built ' : '';
+}
+
+// generate build command
+if ($argv[1] === 'build_cmd') {
+    $build_cmd = 'build ';
+    $build_cmd .= quote2($final_extensions) . ' ';
+    $build_cmd .= $zts ? '--enable-zts ' : '';
+    $build_cmd .= $no_strip ? '--no-strip ' : '';
+    $build_cmd .= $upx ? '--with-upx-pack ' : '';
+    $build_cmd .= $final_libs === '' ? '' : ('--with-libs=' . quote2($final_libs) . ' ');
+    $build_cmd .= '--build-cli --build-micro ';
+    $build_cmd .= str_starts_with($argv[2], 'windows-') ? '' : '--build-fpm ';
+    $build_cmd .= '--debug ';
+}
+
 echo match ($argv[1]) {
+    'os' => json_encode($test_os),
+    'php' => json_encode($test_php_version),
     'extensions' => $final_extensions,
     'libs' => $final_libs,
     'libs_cmd' => ($final_libs === '' ? '' : (' --with-libs=' . $final_libs)),
@@ -80,5 +138,24 @@ echo match ($argv[1]) {
     'zts' => $zts ? '--enable-zts' : '',
     'no_strip' => $no_strip ? '--no-strip' : '',
     'upx' => $upx ? '--with-upx-pack' : '',
+    'prefer_pre_built' => $prefer_pre_built ? '--prefer-pre-built' : '',
+    'download_cmd' => $down_cmd,
+    'build_cmd' => $build_cmd,
     default => '',
 };
+
+if ($argv[1] === 'download_cmd') {
+    if (str_starts_with($argv[2], 'windows-')) {
+        passthru('powershell.exe -file .\bin\spc.ps1 ' . $down_cmd, $retcode);
+    } else {
+        passthru('./bin/spc ' . $down_cmd, $retcode);
+    }
+} elseif ($argv[1] === 'build_cmd') {
+    if (str_starts_with($argv[2], 'windows-')) {
+        passthru('powershell.exe -file .\bin\spc.ps1 ' . $build_cmd, $retcode);
+    } else {
+        passthru('./bin/spc ' . $build_cmd, $retcode);
+    }
+}
+
+exit($retcode);

tests/SPC/builder/BuilderTest.php

@@ -0,0 +1,252 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\builder;
+
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\TestCase;
+use SPC\builder\BuilderBase;
+use SPC\builder\BuilderProvider;
+use SPC\builder\Extension;
+use SPC\builder\LibraryBase;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+use SPC\util\DependencyUtil;
+use Symfony\Component\Console\Input\ArgvInput;
+
+/**
+ * @internal
+ */
+class BuilderTest extends TestCase
+{
+    private BuilderBase $builder;
+
+    public static function setUpBeforeClass(): void
+    {
+        BuilderProvider::makeBuilderByInput(new ArgvInput());
+        BuilderProvider::getBuilder();
+    }
+
+    public function setUp(): void
+    {
+        $this->builder = BuilderProvider::makeBuilderByInput(new ArgvInput());
+        [$extensions, $libs] = DependencyUtil::getExtsAndLibs(['mbregex']);
+        $this->builder->proveLibs($libs);
+        CustomExt::loadCustomExt();
+        foreach ($extensions as $extension) {
+            $class = CustomExt::getExtClass($extension);
+            $ext = new $class($extension, $this->builder);
+            $this->builder->addExt($ext);
+        }
+        foreach ($this->builder->getExts() as $ext) {
+            $ext->checkDependency();
+        }
+    }
+
+    public function testMakeBuilderByInput(): void
+    {
+        $this->assertInstanceOf(BuilderBase::class, BuilderProvider::makeBuilderByInput(new ArgvInput()));
+        $this->assertInstanceOf(BuilderBase::class, BuilderProvider::getBuilder());
+    }
+
+    public function testGetLibAndGetLibs()
+    {
+        $this->assertIsArray($this->builder->getLibs());
+        $this->assertInstanceOf(LibraryBase::class, $this->builder->getLib('onig'));
+    }
+
+    public function testGetExtAndGetExts()
+    {
+        $this->assertIsArray($this->builder->getExts());
+        $this->assertInstanceOf(Extension::class, $this->builder->getExt('mbregex'));
+    }
+
+    public function testHasCpp()
+    {
+        // mbregex doesn't have cpp
+        $this->assertFalse($this->builder->hasCpp());
+    }
+
+    public function testMakeExtensionArgs()
+    {
+        $this->assertStringContainsString('--enable-mbstring', $this->builder->makeExtensionArgs());
+    }
+
+    public function testIsLibsOnly()
+    {
+        // mbregex is not libs only
+        $this->assertFalse($this->builder->isLibsOnly());
+    }
+
+    public function testGetPHPVersionID()
+    {
+        if (file_exists(SOURCE_PATH . '/php-src/main/php_version.h')) {
+            $file = SOURCE_PATH . '/php-src/main/php_version.h';
+            $cnt = preg_match('/PHP_VERSION_ID (\d+)/m', file_get_contents($file), $match);
+            if ($cnt !== 0) {
+                $this->assertEquals(intval($match[1]), $this->builder->getPHPVersionID());
+            } else {
+                $this->expectException(RuntimeException::class);
+                $this->builder->getPHPVersionID();
+            }
+        } else {
+            $this->expectException(WrongUsageException::class);
+            $this->builder->getPHPVersionID();
+        }
+    }
+
+    public function testGetPHPVersion()
+    {
+        if (file_exists(SOURCE_PATH . '/php-src/main/php_version.h')) {
+            $file = SOURCE_PATH . '/php-src/main/php_version.h';
+            $cnt = preg_match('/PHP_VERSION "(\d+\.\d+\.\d+)"/', file_get_contents($file), $match);
+            if ($cnt !== 0) {
+                $this->assertEquals($match[1], $this->builder->getPHPVersion());
+            } else {
+                $this->expectException(RuntimeException::class);
+                $this->builder->getPHPVersion();
+            }
+        } else {
+            $this->expectException(WrongUsageException::class);
+            $this->builder->getPHPVersion();
+        }
+    }
+
+    public function testGetPHPVersionFromArchive()
+    {
+        $lock = file_exists(DOWNLOAD_PATH . '/.lock.json') ? file_get_contents(DOWNLOAD_PATH . '/.lock.json') : false;
+        if ($lock === false) {
+            $this->assertFalse($this->builder->getPHPVersionFromArchive());
+        } else {
+            $lock = json_decode($lock, true);
+            $file = $lock['php-src']['filename'] ?? null;
+            if ($file === null) {
+                $this->assertFalse($this->builder->getPHPVersionFromArchive());
+            } else {
+                $cnt = preg_match('/php-(\d+\.\d+\.\d+)/', $file, $match);
+                if ($cnt !== 0) {
+                    $this->assertEquals($match[1], $this->builder->getPHPVersionFromArchive());
+                } else {
+                    $this->assertFalse($this->builder->getPHPVersionFromArchive());
+                }
+            }
+        }
+    }
+
+    public function testGetMicroVersion()
+    {
+        $file = FileSystem::convertPath(SOURCE_PATH . '/php-src/sapi/micro/php_micro.h');
+        if (!file_exists($file)) {
+            $this->assertFalse($this->builder->getMicroVersion());
+        } else {
+            $content = file_get_contents($file);
+            $ver = '';
+            preg_match('/#define PHP_MICRO_VER_MAJ (\d)/m', $content, $match);
+            $ver .= $match[1] . '.';
+            preg_match('/#define PHP_MICRO_VER_MIN (\d)/m', $content, $match);
+            $ver .= $match[1] . '.';
+            preg_match('/#define PHP_MICRO_VER_PAT (\d)/m', $content, $match);
+            $ver .= $match[1];
+            $this->assertEquals($ver, $this->builder->getMicroVersion());
+        }
+    }
+
+    public static function providerGetBuildTypeName(): array
+    {
+        return [
+            [BUILD_TARGET_CLI, 'cli'],
+            [BUILD_TARGET_FPM, 'fpm'],
+            [BUILD_TARGET_MICRO, 'micro'],
+            [BUILD_TARGET_EMBED, 'embed'],
+            [BUILD_TARGET_ALL, 'cli, micro, fpm, embed'],
+            [BUILD_TARGET_CLI | BUILD_TARGET_EMBED, 'cli, embed'],
+        ];
+    }
+
+    /**
+     * @dataProvider providerGetBuildTypeName
+     */
+    public function testGetBuildTypeName(int $target, string $name): void
+    {
+        $this->assertEquals($name, $this->builder->getBuildTypeName($target));
+    }
+
+    public function testGetOption()
+    {
+        // we cannot assure the option exists, so just tests default value
+        $this->assertEquals('foo', $this->builder->getOption('bar', 'foo'));
+    }
+
+    public function testGetOptions()
+    {
+        $this->assertIsArray($this->builder->getOptions());
+    }
+
+    public function testSetOptionIfNotExist()
+    {
+        $this->assertEquals(null, $this->builder->getOption('bar'));
+        $this->builder->setOptionIfNotExist('bar', 'foo');
+        $this->assertEquals('foo', $this->builder->getOption('bar'));
+    }
+
+    public function testSetOption()
+    {
+        $this->assertEquals(null, $this->builder->getOption('bar'));
+        $this->builder->setOption('bar', 'foo');
+        $this->assertEquals('foo', $this->builder->getOption('bar'));
+    }
+
+    public function testGetEnvString()
+    {
+        $this->assertIsString($this->builder->getEnvString());
+        putenv('TEST_SPC_BUILDER=foo');
+        $this->assertStringContainsString('TEST_SPC_BUILDER=foo', $this->builder->getEnvString(['TEST_SPC_BUILDER']));
+    }
+
+    public function testValidateLibsAndExts()
+    {
+        $this->builder->validateLibsAndExts();
+        $this->assertTrue(true);
+    }
+
+    public static function providerEmitPatchPoint(): array
+    {
+        return [
+            ['before-libs-extract'],
+            ['after-libs-extract'],
+            ['before-php-extract'],
+            ['after-php-extract'],
+            ['before-micro-extract'],
+            ['after-micro-extract'],
+            ['before-exts-extract'],
+            ['after-exts-extract'],
+            ['before-php-buildconf'],
+            ['before-php-configure'],
+            ['before-php-make'],
+            ['before-sanity-check'],
+        ];
+    }
+
+    /**
+     * @dataProvider providerEmitPatchPoint
+     */
+    public function testEmitPatchPoint(string $point)
+    {
+        $code = '<?php if (patch_point() === "' . $point . '") echo "GOOD:' . $point . '";';
+        // emulate patch point
+        $this->builder->setOption('with-added-patch', ['/tmp/patch-point.' . $point . '.php']);
+        FileSystem::writeFile('/tmp/patch-point.' . $point . '.php', $code);
+        $this->expectOutputString('GOOD:' . $point);
+        $this->builder->emitPatchPoint($point);
+    }
+
+    public function testEmitPatchPointNotExists()
+    {
+        $this->expectOutputRegex('/failed to run/');
+        $this->builder->setOption('with-added-patch', ['/tmp/patch-point.not_exsssists.php']);
+        $this->builder->emitPatchPoint('not-exists');
+    }
+}

tests/SPC/builder/ExtensionTest.php

@@ -0,0 +1,100 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\builder;
+
+use PHPUnit\Framework\TestCase;
+use SPC\builder\BuilderProvider;
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+use SPC\util\DependencyUtil;
+use Symfony\Component\Console\Input\ArgvInput;
+
+/**
+ * @internal
+ */
+class ExtensionTest extends TestCase
+{
+    private Extension $extension;
+
+    protected function setUp(): void
+    {
+        $builder = BuilderProvider::makeBuilderByInput(new ArgvInput());
+        [$extensions, $libs] = DependencyUtil::getExtsAndLibs(['mbregex']);
+        $builder->proveLibs($libs);
+        CustomExt::loadCustomExt();
+        foreach ($extensions as $extension) {
+            $class = CustomExt::getExtClass($extension);
+            $ext = new $class($extension, $builder);
+            $builder->addExt($ext);
+        }
+        foreach ($builder->getExts() as $ext) {
+            $ext->checkDependency();
+        }
+        $this->extension = $builder->getExt('mbregex');
+    }
+
+    public function testPatches()
+    {
+        $this->assertFalse($this->extension->patchBeforeBuildconf());
+        $this->assertFalse($this->extension->patchBeforeConfigure());
+        $this->assertFalse($this->extension->patchBeforeMake());
+    }
+
+    public function testGetExtensionDependency()
+    {
+        $this->assertEquals('mbstring', current($this->extension->getExtensionDependency())->getName());
+    }
+
+    public function testGetWindowsConfigureArg()
+    {
+        $this->assertEquals('', $this->extension->getWindowsConfigureArg());
+    }
+
+    public function testGetConfigureArg()
+    {
+        $this->assertEquals('', $this->extension->getUnixConfigureArg());
+    }
+
+    public function testGetExtVersion()
+    {
+        // only swoole has version, we cannot test it
+        $this->assertEquals(null, $this->extension->getExtVersion());
+    }
+
+    public function testGetDistName()
+    {
+        $this->assertEquals('mbregex', $this->extension->getName());
+    }
+
+    public function testRunCliCheckWindows()
+    {
+        if (is_unix()) {
+            $this->markTestIncomplete('This test is for Windows only');
+        } else {
+            $this->extension->runCliCheckWindows();
+            $this->assertTrue(true);
+        }
+    }
+
+    public function testGetLibFilesString()
+    {
+        $this->assertStringEndsWith('libonig.a', $this->extension->getLibFilesString());
+    }
+
+    public function testGetName()
+    {
+        $this->assertEquals('mbregex', $this->extension->getName());
+    }
+
+    public function testGetUnixConfigureArg()
+    {
+        $this->assertEquals('', $this->extension->getUnixConfigureArg());
+    }
+
+    public function testGetEnableArg()
+    {
+        $this->assertEquals('', $this->extension->getEnableArg());
+    }
+}

tests/SPC/builder/linux/SystemUtilTest.php

@@ -0,0 +1,70 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\builder\linux;
+
+use PHPUnit\Framework\TestCase;
+use SPC\builder\linux\SystemUtil;
+
+/**
+ * @internal
+ */
+class SystemUtilTest extends TestCase
+{
+    public static function setUpBeforeClass(): void
+    {
+        if (PHP_OS_FAMILY !== 'Linux') {
+            self::markTestIncomplete('This test is only for Linux');
+        }
+    }
+
+    public function testIsMuslDistAndGetOSRelease()
+    {
+        $release = SystemUtil::getOSRelease();
+        // we cannot ensure what is the current distro, just test the key exists
+        $this->assertArrayHasKey('dist', $release);
+        $this->assertArrayHasKey('ver', $release);
+        $this->assertTrue($release['dist'] === 'alpine' && SystemUtil::isMuslDist() || $release['dist'] !== 'alpine' && !SystemUtil::isMuslDist());
+    }
+
+    public function testFindStaticLib()
+    {
+        $this->assertIsArray(SystemUtil::findStaticLib('ld-linux-x86-64.so.2'));
+    }
+
+    public function testGetCpuCount()
+    {
+        $this->assertIsInt(SystemUtil::getCpuCount());
+    }
+
+    public function testFindHeader()
+    {
+        $this->assertIsArray(SystemUtil::findHeader('elf.h'));
+    }
+
+    public function testGetCrossCompilePrefix()
+    {
+        $this->assertIsString(SystemUtil::getCrossCompilePrefix('gcc', 'x86_64'));
+    }
+
+    public function testGetCCType()
+    {
+        $this->assertEquals('gcc', SystemUtil::getCCType('xjfoiewjfoewof-gcc'));
+    }
+
+    public function testGetSupportedDistros()
+    {
+        $this->assertIsArray(SystemUtil::getSupportedDistros());
+    }
+
+    public function testFindHeaders()
+    {
+        $this->assertIsArray(SystemUtil::findHeaders(['elf.h']));
+    }
+
+    public function testFindStaticLibs()
+    {
+        $this->assertIsArray(SystemUtil::findStaticLibs(['ld-linux-x86-64.so.2']));
+    }
+}

tests/SPC/builder/macos/SystemUtilTest.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\builder\macos;
+
+use PHPUnit\Framework\TestCase;
+use SPC\builder\macos\SystemUtil;
+
+/**
+ * @internal
+ */
+class SystemUtilTest extends TestCase
+{
+    public static function setUpBeforeClass(): void
+    {
+        if (PHP_OS_FAMILY !== 'Darwin') {
+            self::markTestIncomplete('This test is only for macOS');
+        }
+    }
+
+    public function testGetCpuCount()
+    {
+        $this->assertIsInt(SystemUtil::getCpuCount());
+    }
+
+    public function testGetArchCFlags()
+    {
+        $this->assertEquals('--target=x86_64-apple-darwin', SystemUtil::getArchCFlags('x86_64'));
+    }
+}

tests/SPC/builder/unix/UnixSystemUtilTest.php

@@ -0,0 +1,52 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\builder\unix;
+
+use PHPUnit\Framework\TestCase;
+use SPC\builder\freebsd\SystemUtil as FreebsdSystemUtil;
+use SPC\builder\linux\SystemUtil as LinuxSystemUtil;
+use SPC\builder\macos\SystemUtil as MacosSystemUtil;
+use SPC\exception\FileSystemException;
+
+/**
+ * @internal
+ */
+class UnixSystemUtilTest extends TestCase
+{
+    private FreebsdSystemUtil|LinuxSystemUtil|MacosSystemUtil $util;
+
+    public function setUp(): void
+    {
+        $util_class = match (PHP_OS_FAMILY) {
+            'Linux' => 'SPC\builder\linux\SystemUtil',
+            'Darwin' => 'SPC\builder\macos\SystemUtil',
+            'FreeBSD' => 'SPC\builder\freebsd\SystemUtil',
+            default => null,
+        };
+        if ($util_class === null) {
+            self::markTestIncomplete('This test is only for Unix');
+        }
+        $this->util = new $util_class();
+    }
+
+    /**
+     * @throws FileSystemException
+     */
+    public function testMakeCmakeToolchainFile()
+    {
+        $str = $this->util->makeCmakeToolchainFile(PHP_OS_FAMILY, 'x86_64', '');
+        $this->assertIsString($str);
+    }
+
+    public function testFindCommand()
+    {
+        $this->assertIsString($this->util->findCommand('bash'));
+    }
+
+    public function testMakeEnvVarString()
+    {
+        $this->assertEquals("PATH='/usr/bin' PKG_CONFIG='/usr/bin/pkg-config'", $this->util->makeEnvVarString(['PATH' => '/usr/bin', 'PKG_CONFIG' => '/usr/bin/pkg-config']));
+    }
+}

tests/SPC/store/CurlHookTest.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\store;
+
+use PHPUnit\Framework\TestCase;
+use SPC\store\CurlHook;
+
+/**
+ * @internal
+ */
+class CurlHookTest extends TestCase
+{
+    public function testSetupGithubToken()
+    {
+        $header = [];
+        CurlHook::setupGithubToken('GET', 'https://example.com', $header);
+        if (getenv('GITHUB_TOKEN') === false) {
+            $this->assertEmpty($header);
+        } else {
+            $this->assertEquals(['Authorization: Bearer ' . getenv('GITHUB_TOKEN')], $header);
+        }
+        $header = [];
+        putenv('GITHUB_TOKEN=token');
+        CurlHook::setupGithubToken('GET', 'https://example.com', $header);
+        $this->assertEquals(['Authorization: Bearer token'], $header);
+    }
+}

tests/SPC/store/DownloaderTest.php

@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\Tests\store;
+
+use PHPUnit\Framework\TestCase;
+use SPC\exception\WrongUsageException;
+use SPC\store\Downloader;
+
+/**
+ * @internal
+ * TODO: Test all methods
+ */
+class DownloaderTest extends TestCase
+{
+    public function testGetLatestGithubTarball()
+    {
+        $this->assertEquals(
+            'https://api.github.com/repos/AOMediaCodec/libavif/tarball/v1.1.1',
+            Downloader::getLatestGithubTarball('libavif', [
+                'type' => 'ghtar',
+                'repo' => 'AOMediaCodec/libavif',
+            ])[0]
+        );
+    }
+
+    public function testDownloadGit()
+    {
+        Downloader::downloadGit('setup-static-php', 'https://github.com/static-php/setup-static-php.git', 'main');
+        $this->assertTrue(true);
+
+        // test keyboard interrupt
+        try {
+            Downloader::downloadGit('setup-static-php', 'https://github.com/static-php/setup-static-php.git', 'SIGINT');
+        } catch (WrongUsageException $e) {
+            $this->assertStringContainsString('interrupted', $e->getMessage());
+            return;
+        }
+        $this->fail('Expected exception not thrown');
+    }
+
+    public function testDownloadFile()
+    {
+        Downloader::downloadFile('fake-file', 'https://fakecmd.com/curlDown', 'curlDown.exe');
+        $this->assertTrue(true);
+
+        // test keyboard interrupt
+        try {
+            Downloader::downloadFile('fake-file', 'https://fakecmd.com/curlDown', 'SIGINT');
+        } catch (WrongUsageException $e) {
+            $this->assertStringContainsString('interrupted', $e->getMessage());
+            return;
+        }
+        $this->fail('Expected exception not thrown');
+    }
+
+    public function testLockSource()
+    {
+        Downloader::lockSource('fake-file', ['source_type' => 'archive', 'filename' => 'fake-file-name', 'move_path' => 'fake-path', 'lock_as' => 'fake-lock-as']);
+        $this->assertFileExists(DOWNLOAD_PATH . '/.lock.json');
+        $json = json_decode(file_get_contents(DOWNLOAD_PATH . '/.lock.json'), true);
+        $this->assertIsArray($json);
+        $this->assertArrayHasKey('fake-file', $json);
+        $this->assertArrayHasKey('source_type', $json['fake-file']);
+        $this->assertArrayHasKey('filename', $json['fake-file']);
+        $this->assertArrayHasKey('move_path', $json['fake-file']);
+        $this->assertArrayHasKey('lock_as', $json['fake-file']);
+        $this->assertEquals('archive', $json['fake-file']['source_type']);
+        $this->assertEquals('fake-file-name', $json['fake-file']['filename']);
+        $this->assertEquals('fake-path', $json['fake-file']['move_path']);
+        $this->assertEquals('fake-lock-as', $json['fake-file']['lock_as']);
+    }
+
+    public function testGetLatestBitbucketTag()
+    {
+        $this->assertEquals(
+            'abc.tar.gz',
+            Downloader::getLatestBitbucketTag('abc', [
+                'repo' => 'MATCHED/def',
+            ])[1]
+        );
+        $this->assertEquals(
+            'abc-1.0.0.tar.gz',
+            Downloader::getLatestBitbucketTag('abc', [
+                'repo' => 'abc/def',
+            ])[1]
+        );
+    }
+
+    public function testGetLatestGithubRelease()
+    {
+        $this->assertEquals(
+            'ghreltest.tar.gz',
+            Downloader::getLatestGithubRelease('ghrel', [
+                'type' => 'ghrel',
+                'repo' => 'ghreltest/ghrel',
+                'match' => 'ghreltest.tar.gz',
+            ])[1]
+        );
+    }
+
+    public function testGetFromFileList()
+    {
+        $filelist = Downloader::getFromFileList('fake-filelist', [
+            'url' => 'https://fakecmd.com/filelist',
+            'regex' => '/href="(?<file>filelist-(?<version>[^"]+)\.tar\.xz)"/',
+        ]);
+        $this->assertIsArray($filelist);
+        $this->assertEquals('filelist-4.7.0.tar.xz', $filelist[1]);
+    }
+}

tests/bootstrap.php

@@ -0,0 +1,6 @@
+<?php
+
+declare(strict_types=1);
+
+require_once __DIR__ . '/../src/globals/internal-env.php';
+require_once __DIR__ . '/mock/SPC_store.php';

tests/mock/SPC_store.php

@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+// mock global functions
+
+namespace SPC\store;
+
+use SPC\exception\RuntimeException;
+
+function f_exec(string $command, mixed &$output, mixed &$result_code): bool
+{
+    $result_code = 0;
+    if (str_contains($command, 'https://api.github.com/repos/AOMediaCodec/libavif/releases')) {
+        $output = explode("\n", gzdecode(file_get_contents(__DIR__ . '/../assets/github_api_AOMediaCodec_libavif_releases.json.gz')));
+        return true;
+    }
+    if (str_contains($command, 'https://api.github.com/repos/AOMediaCodec/libavif/tarball/v1.1.1')) {
+        $output = explode("\n", "HTTP/1.1 200 OK\r\nContent-Disposition: attachment; filename=AOMediaCodec-libavif-v1.1.1-0-gbb24db0.tar.gz\r\n\r\n");
+        return true;
+    }
+    if (str_contains($command, 'https://api.bitbucket.org/2.0/repositories/')) {
+        $output = explode("\n", json_encode(['values' => [['name' => '1.0.0']], 'tag_name' => '1.0.0']));
+        return true;
+    }
+    if (str_contains($command, 'https://bitbucket.org/')) {
+        $output = explode("\n", str_contains($command, 'MATCHED') ? "HTTP/2 200 OK\r\ncontent-disposition: attachment; filename=abc.tar.gz\r\n\r\n" : "HTTP/2 200 OK\r\n\r\n");
+        return true;
+    }
+    if (str_contains($command, 'ghreltest/ghrel')) {
+        $output = explode("\n", json_encode([[
+            'prerelease' => false,
+            'assets' => [
+                [
+                    'name' => 'ghreltest.tar.gz',
+                    'browser_download_url' => 'https://fakecmd.com/ghreltest.tar.gz',
+                ],
+            ],
+        ]]));
+        return true;
+    }
+    if (str_contains($command, 'filelist')) {
+        $output = explode("\n", gzdecode(file_get_contents(__DIR__ . '/../assets/filelist.gz')));
+        return true;
+    }
+    $result_code = -2;
+    $output = null;
+    return false;
+}
+
+function f_passthru(string $cmd): bool
+{
+    if (str_starts_with($cmd, 'git')) {
+        if (str_contains($cmd, '--branch "SIGINT"')) {
+            throw new RuntimeException('Interrupt', 2);
+        }
+        return true;
+    }
+    if (str_contains($cmd, 'https://fakecmd.com/curlDown')) {
+        if (str_contains($cmd, 'SIGINT')) {
+            throw new RuntimeException('Interrupt', 2);
+        }
+        return true;
+    }
+
+    // allowed commands
+    $allowed = ['cp', 'copy', 'xcopy'];
+    foreach ($allowed as $a) {
+        if (str_starts_with($cmd, $a)) {
+            \f_passthru($cmd);
+            return true;
+        }
+    }
+    throw new RuntimeException('Invalid tests');
+}