fix prompts dependency and box pack path

Linux c++ support using musl-cross-make toolchains

.github/FUNDING.yml

@@ -0,0 +1,13 @@
+# These are supported funding model platforms
+
+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
+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
+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
+custom: 'https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md' # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/workflows/build-linux-arm.yml

@@ -0,0 +1,106 @@
+name: CI on arm linux
+
+on:
+  workflow_dispatch:
+    inputs:
+      operating-system:
+        required: true
+        description: Compile target arch (Linux only)
+        type: choice
+        options:
+          - aarch64
+      version:
+        required: true
+        description: php version to compile
+        default: '8.2'
+        type: choice
+        options:
+          - '8.2'
+          - '8.1'
+          - '8.0'
+          - '7.4'
+      build-cli:
+        description: build cli binary
+        default: true
+        type: boolean
+      build-micro:
+        description: build phpmicro binary
+        type: boolean
+      build-fpm:
+        description: build fpm binary
+        type: boolean
+      extensions:
+        description: extensions to compile (comma separated)
+        required: true
+        type: string
+      debug:
+        type: boolean
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  build:
+    name: build ${{ inputs.version }} on ${{ inputs.operating-system }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      # Cache downloaded source
+      - id: cache-download
+        uses: actions/cache@v3
+        with:
+          path: downloads
+          key: php-${{ inputs.version }}-dependencies
+
+      # With or without debug
+      - if: inputs.debug == true
+        run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
+
+      # With target select: cli, micro or both
+      - if: ${{ inputs.build-cli == true }}
+        run: echo "SPC_BUILD_CLI=--build-cli" >> $GITHUB_ENV
+      - if: ${{ inputs.build-micro == true }}
+        run: echo "SPC_BUILD_MICRO=--build-micro" >> $GITHUB_ENV
+      - if: ${{ inputs.build-fpm == true }}
+        run: echo "SPC_BUILD_FPM=--build-fpm" >> $GITHUB_ENV
+
+      # If there's no dependencies cache, fetch sources, with or without debug
+      - if: steps.cache-download.outputs.cache-hit != 'true'
+        run: SPC_USE_ARCH=${{ inputs.operating-system }} ./bin/spc-alpine-docker download --with-php=${{ inputs.version }} --all ${{ env.SPC_BUILD_DEBUG }}
+
+      # Run build command
+      - run: SPC_USE_ARCH=${{ inputs.operating-system }} ./bin/spc-alpine-docker build ${{ inputs.extensions }} ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_BUILD_CLI }} ${{ env.SPC_BUILD_MICRO }} ${{ env.SPC_BUILD_FPM }}
+
+      # Upload cli executable
+      - if: ${{ inputs.build-cli == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-${{ inputs.version }}-linux-${{ inputs.operating-system }}
+          path: buildroot/bin/php
+
+      # Upload micro self-extracted executable
+      - if: ${{ inputs.build-micro == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: micro-${{ inputs.version }}-linux-${{ inputs.operating-system }}
+          path: buildroot/bin/micro.sfx
+
+      # Upload fpm executable
+      - if: ${{ inputs.build-fpm == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-fpm-${{ inputs.version }}-linux-${{ inputs.operating-system }}
+          path: buildroot/bin/php-fpm
+
+      # Upload extensions metadata
+      - uses: actions/upload-artifact@v3
+        with:
+          name: license-files
+          path: buildroot/license/
+      - uses: actions/upload-artifact@v3
+        with:
+          name: build-meta
+          path: |
+            buildroot/build-extensions.json
+            buildroot/build-libraries.json

.github/workflows/build-linux-x86_64.yml

@@ -0,0 +1,112 @@
+name: CI on x86_64 linux
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        required: true
+        description: php version to compile
+        default: '8.2'
+        type: choice
+        options:
+          - '8.2'
+          - '8.1'
+          - '8.0'
+          - '7.4'
+      build-cli:
+        description: build cli binary
+        default: true
+        type: boolean
+      build-micro:
+        description: build phpmicro binary
+        type: boolean
+      build-fpm:
+        description: build fpm binary
+        type: boolean
+      extensions:
+        description: extensions to compile (comma separated)
+        required: true
+        type: string
+      debug:
+        type: boolean
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  build:
+    name: build ${{ inputs.version }} on Linux x86_64
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      # Cache composer dependencies
+      - id: cache-composer-deps
+        uses: actions/cache@v3
+        with:
+          path: vendor
+          key: composer-dependencies
+
+      # If there's no Composer cache, install dependencies
+      - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
+        run: composer update --no-dev --classmap-authoritative
+
+      # Cache downloaded source
+      - id: cache-download
+        uses: actions/cache@v3
+        with:
+          path: downloads
+          key: php-${{ inputs.version }}-dependencies
+
+      # With or without debug
+      - if: inputs.debug == true
+        run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
+
+      # With target select: cli, micro or both
+      - if: ${{ inputs.build-cli == true }}
+        run: echo "SPC_BUILD_CLI=--build-cli" >> $GITHUB_ENV
+      - if: ${{ inputs.build-micro == true }}
+        run: echo "SPC_BUILD_MICRO=--build-micro" >> $GITHUB_ENV
+      - if: ${{ inputs.build-fpm == true }}
+        run: echo "SPC_BUILD_FPM=--build-fpm" >> $GITHUB_ENV
+
+      # If there's no dependencies cache, fetch sources, with or without debug
+      - if: steps.cache-download.outputs.cache-hit != 'true'
+        run: CACHE_API_EXEC=yes ./bin/spc-alpine-docker download --with-php=${{ inputs.version }} --all ${{ env.SPC_BUILD_DEBUG }}
+
+      # Run build command
+      - run: ./bin/spc-alpine-docker build ${{ inputs.extensions }} ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_BUILD_CLI }} ${{ env.SPC_BUILD_MICRO }} ${{ env.SPC_BUILD_FPM }}
+
+      # Upload cli executable
+      - if: ${{ inputs.build-cli == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/php
+
+      # Upload micro self-extracted executable
+      - if: ${{ inputs.build-micro == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: micro-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/micro.sfx
+
+      # Upload fpm executable
+      - if: ${{ inputs.build-fpm == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-fpm-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/php-fpm
+
+      # Upload extensions metadata
+      - uses: actions/upload-artifact@v3
+        with:
+          name: license-files
+          path: buildroot/license/
+      - uses: actions/upload-artifact@v3
+        with:
+          name: build-meta
+          path: |
+            buildroot/build-extensions.json
+            buildroot/build-libraries.json
+

.github/workflows/build-macos-x86_64.yml

@@ -0,0 +1,117 @@
+name: CI on x86_64 macOS
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        required: true
+        description: php version to compile
+        default: '8.2'
+        type: choice
+        options:
+          - '8.2'
+          - '8.1'
+          - '8.0'
+          - '7.4'
+      build-cli:
+        description: build cli binary
+        default: true
+        type: boolean
+      build-micro:
+        description: build phpmicro binary
+        type: boolean
+      build-fpm:
+        description: build fpm binary
+        type: boolean
+      extensions:
+        description: extensions to compile (comma separated)
+        required: true
+        type: string
+      debug:
+        type: boolean
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  build:
+    name: build ${{ inputs.version }} on macOS x86_64
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v3
+
+      # Install macOS missing packages and mark os suffix
+      - run: |
+          brew install automake gzip
+          echo "SPC_BUILD_OS=macos" >> $GITHUB_ENV
+
+      # Cache composer dependencies
+      - id: cache-composer-deps
+        uses: actions/cache@v3
+        with:
+          path: vendor
+          key: composer-dependencies
+
+      # If there's no Composer cache, install dependencies
+      - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
+        run: composer update --no-dev --classmap-authoritative
+
+      # Cache downloaded source
+      - id: cache-download
+        uses: actions/cache@v3
+        with:
+          path: downloads
+          key: php-${{ inputs.version }}-dependencies
+
+      # With or without debug
+      - if: inputs.debug == true
+        run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
+
+      # With target select: cli, micro or both
+      - if: ${{ inputs.build-cli == true }}
+        run: echo "SPC_BUILD_CLI=--build-cli" >> $GITHUB_ENV
+      - if: ${{ inputs.build-micro == true }}
+        run: echo "SPC_BUILD_MICRO=--build-micro" >> $GITHUB_ENV
+      - if: ${{ inputs.build-fpm == true }}
+        run: echo "SPC_BUILD_FPM=--build-fpm" >> $GITHUB_ENV
+
+      # If there's no dependencies cache, fetch sources, with or without debug
+      - if: steps.cache-download.outputs.cache-hit != 'true'
+        run: ./bin/spc download --with-php=${{ inputs.version }} --all ${{ env.SPC_BUILD_DEBUG }}
+
+      # Run build command
+      - run: ./bin/spc build ${{ inputs.extensions }} ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_BUILD_CLI }} ${{ env.SPC_BUILD_MICRO }} ${{ env.SPC_BUILD_FPM }}
+
+      # Upload cli executable
+      - if: ${{ inputs.build-cli == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/php
+
+      # Upload micro self-extracted executable
+      - if: ${{ inputs.build-micro == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: micro-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/micro.sfx
+
+      # Upload fpm executable
+      - if: ${{ inputs.build-fpm == true }}
+        uses: actions/upload-artifact@v3
+        with:
+          name: php-fpm-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          path: buildroot/bin/php-fpm
+
+      # Upload extensions metadata
+      - uses: actions/upload-artifact@v3
+        with:
+          name: license-files
+          path: buildroot/license/
+      - uses: actions/upload-artifact@v3
+        with:
+          name: build-meta
+          path: |
+            buildroot/build-extensions.json
+            buildroot/build-libraries.json
+

.github/workflows/download-cache.yml

@@ -0,0 +1,40 @@
+name: archive download sources weekly
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: "* 14 * * 5"
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  download:
+    name: cache download sources
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php-version: [ "8.0", "8.1", "8.2" ]
+    steps:
+      - uses: actions/checkout@v3
+
+      # Cache composer dependencies
+      - id: cache-composer-deps
+        uses: actions/cache@v3
+        with:
+          path: vendor
+          key: composer-dependencies
+
+      # If there's no Composer cache, install dependencies
+      - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
+        run: composer update --no-dev
+
+      # If there's no dependencies cache, fetch sources, with or without debug
+      - if: steps.cache-download.outputs.cache-hit != 'true'
+        run: ./bin/spc download --with-php=${{ matrix.php-version }} --all --debug
+
+      # Upload downloaded files
+      - uses: actions/upload-artifact@v3
+        with:
+          name: download-files-${{ matrix.php-version }}
+          path: downloads/

.github/workflows/release-build.yml

@@ -0,0 +1,47 @@
+name: Upload SPC Binary (Release)
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+jobs:
+  build-release-artifacts:
+    name: "Upload SPC Binary (Release)"
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        operating-system:
+          - "linux-x86_64"
+          - "macos-x86_64"
+          - "linux-aarch64"
+          - "macos-aarch64"
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+
+      - name: Reuse static-php-cli-hosted artifacts
+        uses: dawidd6/action-download-artifact@v2
+        with:
+          repo: crazywhalecc/static-php-cli-hosted
+          branch: master
+          workflow: build-spc-release.yml
+          name: "spc-${{ matrix.operating-system }}"
+
+      - name: "Archive Executable"
+        run: |
+          tar -czf spc-${{ matrix.operating-system }}.tar.gz spc
+          echo "filename=spc-${{ matrix.operating-system }}.tar.gz" >> $GITHUB_ENV
+
+      - name: upload binaries to release
+        uses: softprops/action-gh-release@v1
+        if: ${{startsWith(github.ref, 'refs/tags/') }}
+        with:
+          files: ${{ env.filename }}
+
+      - name: "Upload Artifact"
+        uses: actions/upload-artifact@v3
+        with:
+          path: spc
+          name: spc-${{ matrix.operating-system }}

.github/workflows/tests.yml

@@ -0,0 +1,98 @@
+name: Tests
+
+on:
+    push:
+        branches: [ "main" ]
+    pull_request:
+        branches: [ "main" ]
+
+permissions:
+    contents: read
+
+jobs:
+    php-cs-fixer:
+        runs-on: ubuntu-latest
+        timeout-minutes: 10
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: '8.1'
+                  extensions: curl, openssl, mbstring
+                  ini-values: memory_limit=-1
+                  tools: pecl, composer, php-cs-fixer
+
+            - name: Run PHP-CS-Fixer fix
+              run: php-cs-fixer fix --dry-run --diff --ansi
+
+    phpstan:
+        runs-on: ubuntu-latest
+        timeout-minutes: 10
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: '8.1'
+                  extensions: curl, openssl, mbstring
+                  ini-values: memory_limit=-1
+                  tools: composer
+
+            - name: Cache Composer packages
+              id: composer-cache
+              uses: actions/cache@v3
+              with:
+                  path: vendor
+                  key: ${{ runner.os }}-phpstan-${{ hashFiles('**/composer.lock') }}
+                  restore-keys: |
+                      ${{ runner.os }}-phpstan-
+
+            - name: Install Dependencies
+              run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+            - name: Run phpstan
+              run: vendor/bin/phpstan analyse
+
+    phpunit:
+        name: PHPUnit (PHP ${{ matrix.php }})
+        runs-on: ubuntu-latest
+        timeout-minutes: 10
+        strategy:
+            matrix:
+                include:
+                    - php: '8.1'
+                    - php: '8.2'
+            fail-fast: false
+
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Setup PHP
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: "${{ matrix.php }}"
+                  tools: pecl, composer
+                  extensions: curl, openssl, mbstring
+                  ini-values: memory_limit=-1
+
+            - name: Cache Composer packages
+              id: composer-cache
+              uses: actions/cache@v3
+              with:
+                  path: vendor
+                  key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
+                  restore-keys: |
+                      ${{ runner.os }}-php-
+
+            - name: Install Dependencies
+              run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+            - name: Run PHPUnit tests
+              run: |
+                  vendor/bin/phpunit tests/ --no-coverage

.gitignore

@@ -4,8 +4,7 @@ docker/libraries/
 docker/extensions/
 docker/source/
 
-# Composer file
-composer.lock
+# Vendor files
 /vendor/
 
 # default source extract directory
@@ -17,5 +16,15 @@ composer.lock
 # default source build root directory
 /buildroot/
 
-# php cs fixer cache file
+# tools cache files
 .php-cs-fixer.cache
+.phpunit.result.cache
+
+# exclude self-runtime
+/bin/*
+!/bin/spc
+!/bin/setup-runtime
+!/bin/spc-alpine-docker
+
+# default test directory
+/tests/var/

.php-cs-fixer.php

@@ -65,5 +65,5 @@ return (new PhpCsFixer\Config())
         'phpdoc_var_without_name' => false,
     ])
     ->setFinder(
-        PhpCsFixer\Finder::create()->in(__DIR__ . '/src')
+        PhpCsFixer\Finder::create()->in([__DIR__ . '/src', __DIR__ . '/tests/SPC'])
     );

README-en.md

@@ -1,121 +1,3 @@
 # static-php-cli
 
-Compile A Statically Linked PHP With Swoole and other Extensions.
-
-Compile a purely static PHP binary file with various extensions to make PHP-cli applications more portable! 
-
-You can also use the micro binary file to package PHP source code and binary files into one for distribution!
-
-Note: only support cli SAPI, not support fpm, cgi.
-
-## Compilation Requirements
-
-Yes, this project is written in PHP, pretty funny.
-But php-static-cli only requires an environment above PHP 8.0.
-
-- Linux
-  - Supported arch: aarch64, amd64
-  - Supported distributions: alpine, ubuntu, centos
-  - Requirements: (TODO)
-- macOS
-  - Supported arch: arm64, x86_64
-  - Requirements: make, bison, flex, pkg-config, git, autoconf, automake, tar, unzip, xz, gzip, bzip2, cmake
-- Windows
-  - Supported arch: x86_64
-  - Requirements: (TODO)
-- PHP
-  - Supported version: 8.0, 8.1, 8.2
-
-## Usage (WIP)
-
-After stable release for this project, a single phar and single binary for this tool will be published.
-
-And currently you may need to clone this branch and edit GitHub Action to build.
-
-### Compilation
-
-```bash
-chmod +x spc
-# fetch all libraries
-./spc fetch --all
-# with bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl extension, build both CLI and phpmicro SAPI
-./spc build bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl --build-all
-```
-
-### php-cli Usage
-
-When using the parameter `--build-all` or not adding the `--build-micro` parameter, 
-the final compilation result will output a binary file named `./php`, 
-which can be distributed and used directly. 
-This file will be located in the directory `source/php-src/sapi/cli/`, simply copy it out for use.
-
-```bash
-./php -v
-./php -m
-./php your_code.php
-```
-
-### micro.sfx Usage
-
-When using the parameter `--build-all` or `--build-micro`, 
-the final compilation result will output a file named `./micro.sfx`, 
-which needs to be used with your PHP source code like `code.php`. 
-This file will be located in the directory `source/php-src/sapi/micro/`, simply copy it out for use.
-
-Prepare your project source code, which can be a single PHP file or a Phar file, for use.
-
-```bash
-echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
-cat micro.sfx code.php > single-app && chmod +x single-app
-./single-app
-
-# If packing a PHAR file, simply replace code.php with the Phar file path.
-```
-
-> In some cases, PHAR files may not run in a micro environment.
-
-## Current Status
-
-- [X] Basic CLI framework (by symfony/console)
-- [ ] Linux support
-- [X] macOS support
-- [X] Exception handler
-- [ ] Windows support
-- [X] PHP 7.4 support
-
-## Supported Extensions (WIP)
-
-[Support Extension List](/ext-support.md)
-
-## Contribution
-
-Currently, there are only a few supported extensions. 
-If the extension you need is missing, you can create an issue. 
-If you are familiar with this project, you are also welcome to initiate a pull request.
-
-The basic principles for contributing are as follows:
-
-- This project uses php-cs-fixer and phpstan as code formatting tools. Before contributing, please run `composer analyze` and `composer cs-fix` on the updated code.
-- If other open source libraries are involved, the corresponding licenses should be provided. 
-    Also, configuration files should be sorted using the command `sort-config` after modification.
-    For more information about sorting commands, see the documentation.
-- Naming conventions should be followed, such as using the extension name registered in PHP for the extension name itself, 
-    and external library names should follow the project's own naming conventions. For internal logic functions, class names, variables, etc., 
-    camelCase and underscore formats should be followed, and mixing within the same module is prohibited.
-- When compiling external libraries and creating patches, compatibility with different operating systems should be considered.
-
-## Open-Source License
-
-This project is based on the tradition of using the MIT License for old versions, 
-while the new version references source code from some other projects. 
-Special thanks to:
-
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs) (Mulun Permissive License)
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli) (Apache 2.0 LICENSE+SWOOLE-CLI LICENSE)
-
-Due to the special nature of this project, 
-many other open source projects such as curl and protobuf will be used during the project compilation process, 
-and they all have their own open source licenses.
-
-Please use the `dump-license`(TODO) command to export the open source licenses used in the project after compilation, 
-and comply with the corresponding project's LICENSE.
+English README has been moved to [README.md](README.md).

README-zh.md

@@ -0,0 +1,253 @@
+# static-php-cli
+
+Build single static PHP binary, with PHP project together, with popular extensions included.
+
+🌐 **[中文](README-zh.md)** | **[English](README.md)**
+
+编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！（cli SAPI）
+
+<img width="600" alt="截屏2023-05-02 15 53 13" src="https://user-images.githubusercontent.com/20330940/235610282-23e58d68-bd35-4092-8465-171cff2d5ba8.png">
+
+同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！（micro SAPI）
+
+<img width="600" alt="截屏2023-05-02 15 52 33" src="https://user-images.githubusercontent.com/20330940/235610318-2ef4e3f1-278b-4ca4-99f4-b38120efc395.png">
+
+> 该 SAPI 源自 [dixyes/phpmicro](https://github.com/dixyes/phpmicro) 的 [Fork 仓库](https://github.com/crazywhalecc/phpmicro)。
+
+[![Version](https://img.shields.io/badge/Version-2.0--rc7-pink.svg?style=flat-square)]()
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)]()
+[![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build-linux-x86_64.yml?branch=refactor&label=Linux%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
+[![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build-macos-x86_64.yml?branch=refactor&label=macOS%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
+[![](https://img.shields.io/badge/Extension%20Counter-55+-yellow.svg?style=flat-square)]()
+[![](https://img.shields.io/github/search/crazywhalecc/static-php-cli/TODO?label=TODO%20Counter&style=flat-square)]()
+
+> 项目名称是 static-php-cli，但其实支持 cli、fpm、micro 和 embed SAPI 😎
+
+## 文档
+
+目前 README 编写了基本用法。有关 static-php-cli 所有的功能，请点击这里查看文档：<https://static-php.dev>。
+
+## 自托管直接下载
+
+如果你不想自行编译 PHP，可以从本项目现有的示例 Action 下载 Artifact，也可以从自托管的服务器下载：[进入](https://dl.static-php.dev/static-php-cli/common/)
+
+> 自托管的服务器默认包含的扩展有：`bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,xml,mbstring,mbregex,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,session,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip`
+
+## 使用 static-php-cli 构建 PHP
+
+### 编译环境需求
+
+是的，本项目采用 PHP 编写，编译前需要一个 PHP 环境，比较滑稽。
+但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 mbstring、pcntl 扩展和 PHP 版本大于等于 8.1 即可。
+
+下面是架构支持情况，:octocat: 代表支持 GitHub Action 构建，:computer: 代表支持本地构建，空 代表暂不支持。
+
+|         | x86_64               | aarch64              |
+|---------|----------------------|----------------------|
+| macOS   | :octocat: :computer: | :computer:           |
+| Linux   | :octocat: :computer: | :octocat: :computer: |
+| Windows |                      |                      |
+| FreeBSD | :computer:           | :computer:           |
+
+> macOS-arm64 因 GitHub 暂未提供 arm runner，如果要构建 arm 二进制，可以使用手动构建。
+
+目前支持编译的 PHP 版本为：`7.3`，`7.4`，`8.0`，`8.1`，`8.2`，`8.3`。
+
+### 支持的扩展情况
+
+请先根据下方扩展列表选择你要编译的扩展。
+
+- [扩展支持列表](https://static-php.dev/zh/guide/extensions.html)
+- [编译命令生成器](https://static-php.dev/zh/guide/cli-generator.html)
+
+> 如果这里没有你需要的扩展，可以提交 Issue。
+
+### 使用 Actions 构建
+
+使用 GitHub Action 可以方便地构建一个静态编译的 PHP，同时可以自行定义要编译的扩展。
+
+1. Fork 本项目。
+2. 进入项目的 Actions，选择 CI。
+3. 选择 `Run workflow`，填入你要编译的 PHP 版本、目标类型、扩展列表。（扩展列表使用英文逗号分割，例如 `bcmath,curl,mbstring`）
+4. 等待大约一段时间后，进入对应的任务中，获取 `Artifacts`。
+
+如果你选择了 `debug`，则会在构建时输出所有日志，包括编译的日志，以供排查错误。
+
+### 手动构建（使用 SPC 二进制）
+
+本项目提供了一个 static-php-cli 的二进制文件，你可以直接下载对应平台的二进制文件，然后使用它来构建静态的 PHP。目前 `spc` 二进制支持的平台有 Linux 和 macOS。
+
+下面是从 GitHub Action 下载的方法：
+
+1. 进入 [GitHub Action](https://github.com/crazywhalecc/static-php-cli/actions/workflows/release-build.yml)。
+2. 选择一个最新的构建任务，进入后选择 `Artifacts`，下载对应平台的二进制文件。
+3. 解压 `.zip` 文件。解压后，为其添加执行权限：`chmod +x ./spc`。
+
+你也可以从自托管的服务器下载二进制文件：[进入](https://dl.static-php.dev/static-php-cli/spc-bin/nightly/)。
+
+### 手动构建（使用源码）
+
+先克隆本项目：
+
+```bash
+git clone https://github.com/crazywhalecc/static-php-cli.git
+```
+
+如果你本机没有安装 PHP，你需要先使用包管理（例如 brew、apt、yum、apk 等）安装 php。
+
+你也可以通过 `bin/setup-runtime` 命令下载静态编译好的 php-cli 和 Composer。下载的 php 和 Composer 将保存为 `bin/php` 和 `bin/composer`。
+
+```bash
+cd static-php-cli
+chmod +x bin/setup-runtime
+./bin/setup-runtime
+
+# 使用独立的 php 运行 static-php-cli
+./bin/php bin/spc
+
+# 使用 composer
+./bin/php bin/composer
+
+# 初始化本项目
+cd static-php-cli
+composer update
+chmod +x bin/spc
+```
+
+### 使用 static-php-cli 命令行程序
+
+下面是使用 static-php-cli 编译静态 php 和 micro 的基础用法：
+
+> 如果你使用的是打包好的 `spc` 二进制，你需要将下列命令的 `bin/spc` 替换为 `./spc`。
+
+```bash
+# 检查环境依赖，并根据提示的命令安装缺失的编译工具
+./bin/spc doctor
+# 拉取所有依赖库
+./bin/spc fetch --all
+# 只拉取编译指定扩展需要的所有依赖
+./bin/spc download --for-extensions=openssl,pcntl,mbstring,pdo_sqlite
+# 构建包含 bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl 扩展的 php-cli 和 micro.sfx
+./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl" --build-cli --build-micro
+```
+
+你也可以使用参数 `--with-php=x.y` 来指定下载的 PHP 版本，目前支持 7.3 ~ 8.2：
+
+```bash
+# 优先考虑使用 >= 8.0 的 PHP 版本，因为 phpmicro 不支持在 PHP7 中构建
+./bin/spc download --with-php=8.2 --all
+```
+
+其中，目前支持构建 cli，micro，fpm 三种静态二进制，使用以下参数的一个或多个来指定编译的 SAPI：
+
+- `--build-cli`：构建 cli 二进制
+- `--build-micro`：构建 phpmicro 自执行二进制
+- `--build-fpm`：构建 fpm
+- `--build-embed`：构建 embed（libphp）
+- `--build-all`：构建所有
+
+如果出现了任何错误，可以使用 `--debug` 参数来展示完整的输出日志，以供排查错误：
+
+```bash
+./bin/spc build openssl,pcntl,mbstring --debug --build-all
+./bin/spc fetch --all --debug
+```
+
+此外，默认编译的 PHP 为 NTS 版本。如需编译线程安全版本（ZTS），只需添加参数 `--enable-zts` 即可。
+
+```bash
+./bin/spc build openssl,pcntl --build-all --enable-zts
+```
+
+同时，你也可以使用参数 `--no-strip` 来关闭裁剪，关闭裁剪后可以使用 gdb 等工具调试，但这样会让静态二进制体积变大。
+
+## 不同 SAPI 的使用
+
+### 使用 cli
+
+> php-cli 是一个静态的二进制文件，类似 Go、Rust 语言编译后的单个可移植的二进制文件。
+
+采用参数 `--build-cli` 或`--build-all` 参数时，最后编译结果会输出一个 `./php` 的二进制文件，此文件可分发、可直接使用。
+该文件编译后会存放在 `buildroot/bin/` 目录中，名称为 `php`，拷贝出来即可。
+
+```bash
+cd buildroot/bin/
+./php -v                # 检查版本
+./php -m                # 检查编译的扩展
+./php your_code.php     # 运行代码
+./php your_project.phar # 运行打包为 phar 单文件的项目
+```
+
+### 使用 micro
+
+> phpmicro 是一个提供自执行二进制 PHP 的项目，本项目依赖 phpmicro 进行编译自执行二进制。详见 [dixyes/phpmicro](https://github.com/dixyes/phpmicro)。
+
+采用项目参数 `--build-micro` 或 `--build-all` 时，最后编译结果会输出一个 `./micro.sfx` 的文件，此文件需要配合你的 PHP 源码使用。
+该文件编译后会存放在 `buildroot/bin/` 目录中，拷贝出来即可。
+
+使用时应准备好你的项目源码文件，可以是单个 PHP 文件，也可以是 Phar 文件。
+
+```bash
+echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
+cat micro.sfx code.php > single-app && chmod +x single-app
+./single-app
+```
+
+如果打包 PHAR 文件，仅需把 code.php 更换为 phar 文件路径即可。
+你可以使用 [box-project/box](https://github.com/box-project/box) 将你的 CLI 项目打包为 Phar，
+然后将它与 phpmicro 结合，生成独立可执行的二进制文件。
+
+```bash
+# 使用 static-php-cli 生成的 micro.sfx 结合，也可以直接使用 cat 命令结合它们
+bin/spc micro:combine my-app.phar
+cat buildroot/bin/micro.sfx my-app.phar > my-app && chmod +x my-app
+
+# 使用 micro:combine 结合可以将 INI 选项注入到二进制中
+bin/spc micro:combine my-app.phar -I "memory_limit=4G" -I "disable_functions=system" --output my-app-2
+```
+
+> 有些情况下的 phar 文件或 PHP 项目可能无法在 micro 环境下运行。
+
+### 使用 fpm
+
+采用项目参数 `--build-fpm` 或 `--build-all` 时，最后编译结果会输出一个 `./php-fpm` 的文件。
+该文件存放在 `buildroot/bin/` 目录，拷贝出来即可使用。
+
+在正常的 Linux 发行版和 macOS 系统中，安装 php-fpm 后包管理会自动生成默认的 fpm 配置文件。
+因为 php-fpm 必须指定配置文件才可启动，本项目编译的 php-fpm 不会带任何配置文件，所以需自行编写 `php-fpm.conf` 和 `pool.conf` 配置文件。
+
+指定 `php-fpm.conf` 可以使用命令参数 `-y`，例如：`./php-fpm -y php-fpm.conf`。
+
+### 使用 embed
+
+采用项目参数 `--build-embed` 或 `--build-all` 时，最后编译结果会输出一个 `libphp.a`、`php-config` 以及一系列头文件，存放在 `buildroot/`，你可以在你的其他代码中引入它们。
+
+如果你知道 [embed SAPI](https://github.com/php/php-src/tree/master/sapi/embed)，你应该知道如何使用它。对于有可能编译用到引入其他库的问题，你可以使用 `buildroot/bin/php-config` 来获取编译时的配置。
+
+另外，有关如何使用此功能的高级示例，请查看[如何使用它构建 FrankenPHP 的静态版本](https://github.com/dunglas/frankenphp/blob/main/docs/static.md)。
+
+## 贡献
+
+如果缺少你需要的扩展，可发起 Issue。如果你对本项目较熟悉，也欢迎为本项目发起 Pull Request。
+
+另外，添加新扩展的贡献方式，可以参考下方 `进阶`。
+
+如果你想贡献文档内容，请到项目仓库 [crazywhalecc/static-php-cli-docs](https://github.com/crazywhalecc/static-php-cli-docs) 贡献。
+
+## 赞助本项目
+
+你可以在 [我的个人赞助页](https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md) 支持我和我的项目。
+
+## 开源协议
+
+本项目依据旧版本惯例采用 MIT License 开源，部分扩展的集成编译命令参考或修改自以下项目：
+
+- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)（木兰宽松许可证）
+- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)（Apache 2.0 LICENSE、SWOOLE-CLI LICENSE）
+
+因本项目的特殊性，使用项目编译过程中会使用很多其他开源项目，例如 curl、protobuf 等，它们都有各自的开源协议。
+请在编译完成后，使用命令 `bin/spc dump-license` 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
+
+## 进阶
+
+本项目重构分支为模块化编写。如果你对本项目感兴趣，想加入开发，可以参照文档的 [贡献指南](https://static-php.dev) 贡献代码或文档。

README.md

@@ -1,108 +1,291 @@
 # static-php-cli
 
-Compile A Statically Linked PHP With Swoole and other Extensions. [English README](README-en.md)
+Build single static PHP binary, with PHP project together, with popular extensions included.
 
-编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！
+🌐 **[中文](README-zh.md)** | **[English](README.md)**
 
-同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！
+The project name is static-php-cli, but it actually supports cli, fpm, micro and embed SAPI 😎
 
-注：只能编译 CLI 模式，暂不支持 CGI 和 FPM 模式。
+Compile a purely static php-cli binary file with various extensions to make PHP applications more portable! (cli SAPI)
 
-[![License](https://img.shields.io/badge/License-MIT-blue.svg)]()
+<img width="600" alt="2023-05-02 15 53 13" src="https://user-images.githubusercontent.com/20330940/235610282-23e58d68-bd35-4092-8465-171cff2d5ba8.png">
 
-## 编译环境需求
+You can also use the micro binary file to combine php binary and php source code into one for distribution! (micro SAPI)
 
-是的，本项目采用 PHP 编写，编译前需要一个 PHP 环境，比较滑稽。
-但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 tokenizer 扩展和 PHP 版本大于等于 8.0 即可。
+<img width="600" alt="2023-05-02 15 52 33" src="https://user-images.githubusercontent.com/20330940/235610318-2ef4e3f1-278b-4ca4-99f4-b38120efc395.png">
 
-- Linux
-    - 支持架构: aarch64, amd64
-    - 支持发行版: alpine, ubuntu, centos
-    - 依赖工具: make, bison, flex, pkg-config, git, autoconf, automake, tar, unzip, gzip, bzip2, cmake
-- macOS
-    - 支持架构: arm64, x86_64
-    - 依赖工具: make, bison, flex, pkg-config, git, autoconf, automake, tar, unzip, xz, gzip, bzip2, cmake
-- Windows
-    - 支持架构: x86_64
-    - 依赖工具: (TODO)
-- PHP
-    - 支持版本: 8.0, 8.1, 8.2
+> This SAPI feature is from the [Fork](https://github.com/crazywhalecc/phpmicro) of [dixyes/phpmicro](https://github.com/dixyes/phpmicro).
 
-## 使用（WIP）
+[![Version](https://img.shields.io/badge/Version-2.0--rc7-pink.svg?style=flat-square)]()
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)]()
+[![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build-linux-x86_64.yml?branch=refactor&label=Linux%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
+[![](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/build-macos-x86_64.yml?branch=refactor&label=macOS%20Build&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/build.yml)
 
-> 你正在看的是重构后的 static-php-cli 编译项目，新项目还未完全重构，所以还有大量的扩展没有完成。
-> 你可以阅读使用 bash 编写的仅为 Linux 系统使用的静态编译脚本和 Docker，详见 bash-version 分支。 旧版本未来将会切换为次要版本，提供有限支持。
+[![](https://img.shields.io/badge/Extension%20Counter-55+-yellow.svg?style=flat-square)]()
+[![](https://img.shields.io/github/search/crazywhalecc/static-php-cli/TODO?label=TODO%20Counter&style=flat-square)]()
 
-未来会提供一个直接可使用的 phar 包和一个 phpmicro 打包的二进制文件，你可以直接从 Release 中获取并使用：
+## Docs
 
-### 编译
+The current README contains basic usage. For all the features of static-php-cli,
+see <https://static-php.dev>.
+
+## Direct Download
+
+If you don't want to compile yourself, you can download example pre-compiled artifact from Actions, or from self-hosted server: [Here](https://dl.static-php.dev/static-php-cli/common/)
+
+> self-hosted server contains extensions: `bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,xml,mbstring,mbregex,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,session,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip`
+
+## Use static-php-cli to build PHP
+
+### Compilation Requirements
+
+Yes, this project is written in PHP, pretty funny.
+But static-php-cli runtime only requires an environment above PHP 8.1 and `mbstring`, `pcntl` extension.
+
+Here is the architecture support status, where :octocat: represents support for GitHub Action builds,
+:computer: represents support for local manual builds, and blank represents not currently supported.
+
+|         | x86_64               | aarch64              |
+|---------|----------------------|----------------------|
+| macOS   | :octocat: :computer: | :computer:           |
+| Linux   | :octocat: :computer: | :octocat: :computer: |
+| Windows |                      |                      |
+| FreeBSD | :computer:           | :computer:           |
+
+> macOS-arm64 is not supported for GitHub Actions, if you are going to build on arm, you can build it manually on your own machine.
+
+Currently supported PHP versions for compilation are: `7.3`, `7.4`, `8.0`, `8.1`, `8.2`, `8.3`.
+
+### Supported Extensions
+
+Please first select the extension you want to compile based on the extension list below.
+
+- [Supported Extension List](https://static-php.dev/en/guide/extensions.html)
+- [Command Generator](https://static-php.dev/en/guide/cli-generator.html)
+
+> If an extension you need is missing, you can submit an issue.
+
+### GitHub Actions Build
+
+Use GitHub Action to easily build a statically compiled PHP,
+and at the same time define the extensions to be compiled by yourself.
+
+1. Fork me.
+2. Go to the Actions of the project and select `CI`.
+3. Select `Run workflow`, fill in the PHP version you want to compile, the target type, and the list of extensions. (extensions comma separated, e.g. `bcmath,curl,mbstring`)
+4. After waiting for about a period of time, enter the corresponding task and get `Artifacts`.
+
+If you enable `debug`, all logs will be output at build time, including compiled logs, for troubleshooting.
+
+- When using ubuntu-latest, it will build linux-x86_64 binary.
+- When using macos-latest, it will build macOS-x86_64 binary.
+
+### Manual build (using SPC binary)
+
+This project provides a binary file of static-php-cli.
+You can directly download the binary file of the corresponding platform and then use it to build static PHP.
+Currently, the platforms supported by `spc` binary are Linux and macOS.
+
+Here's how to download from GitHub Actions:
+
+1. Enter [GitHub Actions](https://github.com/crazywhalecc/static-php-cli/actions/workflows/release-build.yml).
+2. Select the latest build task, select `Artifacts`, and download the binary file of the corresponding platform.
+3. Unzip the `.zip` file. After decompressing, add execution permissions to it: `chmod +x ./spc`.
+
+You can also download binaries from a self-hosted server: [enter](https://dl.static-php.dev/static-php-cli/spc-bin/nightly/).
+
+> SPC single-file binary is built by phpmicro and box.
+
+### Manual build (using source code)
+
+Clone repo first:
 
 ```bash
-chmod +x spc
-# 拉取所有依赖库
-./spc fetch --all
-# 构建包含 bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl 扩展的 php-cli 和 micro.sfx
-./spc build "bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl" --build-all
+git clone https://github.com/crazywhalecc/static-php-cli.git
 ```
 
-### 使用 php-cli
+If you have not installed php on your system, you can use package management to install PHP (such as brew, apt, yum, apk etc.).
 
-采用参数 `--build-all` 或不添加 `--build-micro` 参数时，最后编译结果会输出一个 `./php` 的二进制文件，此文件可分发、可直接使用。
-该文件编译后会存放在 `source/php-src/sapi/cli/` 目录中，拷贝出来即可。
+And you can also download single-file php binary and composer using command `bin/setup-runtime`.
+The PHP runtime for static-php-cli itself will be downloaded at `bin/php`, and composer is at `bin/composer`.
 
 ```bash
-./php -v
-./php -m
-./php your_code.php
+cd static-php-cli
+chmod +x bin/setup-runtime
+# It will download php-cli from self-hosted server and composer from getcomposer.org
+./bin/setup-runtime
+
+# Use this php runtime to run static-php-cli compiler
+./bin/php bin/spc
+
+# Use composer
+./bin/php bin/composer
+
+# Initialize this project
+cd static-php-cli
+composer update
+chmod +x bin/spc
 ```
 
-### 使用 micro.sfx
+### Use static-php-cli
 
-采用项目参数 `--build-all` 或 `--build-micro` 时，最后编译结果会输出一个 `./micro.sfx` 的文件，此文件需要配合你的 PHP 源码使用。
-该文件编译后会存放在 `source/php-src/sapi/micro/` 目录中，拷贝出来即可。
+Basic usage for building php and micro with some extensions:
 
-使用时应准备好你的项目源码文件，可以是单个 PHP 文件，也可以是 Phar 文件。
+> If you are using the packaged `spc` binary, you need to replace `bin/spc` with `./spc` in the following commands.
+
+```bash
+# Check system tool dependencies, fix them automatically
+./bin/spc doctor
+# fetch all libraries
+./bin/spc download --all
+# only fetch necessary sources by needed extensions
+./bin/spc download --for-extensions=openssl,pcntl,mbstring,pdo_sqlite
+# with bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl extension, build both CLI and phpmicro SAPI
+./bin/spc build bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl --build-cli --build-micro
+```
+
+You can also use the parameter `--with-php=x.y` to specify the downloaded PHP version, currently supports 7.4 ~ 8.2:
+
+```bash
+# Using PHP >= 8.0 is recommended, because PHP7 cannot use phpmicro
+./bin/spc fetch --with-php=8.2 --all
+```
+
+Now we support `cli`, `micro`, `fpm`, you can use one or more of the following parameters to specify the compiled SAPI:
+
+- `--build-cli`: build static cli executable
+- `--build-micro`: build static phpmicro self-extracted executable
+- `--build-fpm`: build static fpm binary
+- `--build-embed`: build embed (libphp)
+- `--build-all`: build all
+
+If anything goes wrong, use `--debug` option to display full terminal output:
+
+```bash
+./bin/spc build openssl,pcntl,mbstring --debug --build-all
+./bin/spc fetch --all --debug
+```
+
+In addition, we build NTS by default. If you are going to build ZTS version, just add `--enable-zts` option.
+
+```bash
+./bin/spc build openssl,pcntl --build-all --enable-zts
+```
+
+Adding option `--no-strip` can produce binaries with debug symbols, in order to debug (using gdb). Disabling strip will increase the size of static binary.
+
+## Different SAPI Usage
+
+### Use cli
+
+> php-cli is a single static binary, you can use it like normal php installed on your system.
+
+When using the parameter `--build-cli` or `--build-all`,
+the final compilation result will output a binary file named `./php`,
+which can be distributed and used directly.
+This file will be located in the directory `buildroot/bin/`, copy it out for use.
+
+```bash
+cd buildroot/bin/
+./php -v                # check version
+./php -m                # check extensions
+./php your_code.php     # run your php code
+./php your_project.phar # run your phar (project archive)
+```
+
+### Use micro
+
+> phpmicro is a SelF-extracted eXecutable SAPI module,
+> provided by [phpmicro](https://github.com/dixyes/phpmicro) project.
+> But this project is using a [fork](https://github.com/crazywhalecc/phpmicro) of phpmicro, because we need to add some features to it.
+> It can put php runtime and your source code together.
+
+When using the parameter `--build-all` or `--build-micro`,
+the final compilation result will output a file named `./micro.sfx`,
+which needs to be used with your PHP source code like `code.php`.
+This file will be located in the path `buildroot/bin/micro.sfx`, simply copy it out for use.
+
+Prepare your project source code, which can be a single PHP file or a Phar file, for use.
 
 ```bash
 echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
 cat micro.sfx code.php > single-app && chmod +x single-app
 ./single-app
-
-# 如果打包 PHAR 文件，仅需把 code.php 更换为 phar 文件路径即可
 ```
 
-> 有些情况下的 phar 文件可能无法在 micro 环境下运行。
+If you package a PHAR file, just replace `code.php` with the phar file path.
+You can use [box-project/box](https://github.com/box-project/box) to package your CLI project as Phar,
+It is then combined with phpmicro to produce a standalone executable binary.
 
-## 项目支持情况（WIP）
+```bash
+# Use the micro.sfx generated by static-php-cli to combine,
+bin/spc micro:combine my-app.phar
+# or you can directly use the cat command to combine them.
+cat buildroot/bin/micro.sfx my-app.phar > my-app && chmod +x my-app
 
-- [X] 基础结构编写（采用 symfony/console`）
-- [X] 错误处理
-- [X] macOS 支持
-- [ ] Windows 支持
-- [ ] Linux 支持
-- [X] PHP 7.4 支持
+# Use micro:combine combination to inject INI options into the binary.
+bin/spc micro:combine my-app.phar -I "memory_limit=4G" -I "disable_functions=system" --output my-app-2
+```
 
-## 支持的扩展情况（WIP）
+> In some cases, PHAR files may not run in a micro environment.
 
-[扩展支持列表](/ext-support.md)
+### Use fpm
 
-## 贡献
+When using the parameter `--build-all` or `--build-fpm`,
+the final compilation result will output a file named `./php-fpm`,
+This file will be located in the path `buildroot/bin/`, simply copy it out for use.
 
-目前支持的扩展较少，如果缺少你需要的扩展，可发起 Issue。如果你对本项目较熟悉，也欢迎为本项目发起 Pull Request。
+In normal Linux distributions and macOS systems, the package manager will automatically generate a default fpm configuration file after installing php-fpm.
+Because php-fpm must specify a configuration file before running, the php-fpm compiled by this project will not have any configuration files, so you need to write `php-fpm.conf` and `pool.conf` configuration files yourself.
 
-贡献基本原则如下：
+Specifying `php-fpm.conf` can use the command parameter `-y`, for example: `./php-fpm -y php-fpm.conf`.
 
-- 项目采用了 php-cs-fixer、phpstan 作为代码规范工具，贡献前请对更新的代码执行 `composer analyze` 和 `composer cs-fix`。
-- 涉及到其他开源库的部分应提供对应库的协议，同时对配置文件在修改后采用命令 `sort-config` 排序。有关排序的命令，见文档。
-- 应遵循命名规范，例如扩展名称应采取 PHP 内注册的扩展名本身，外部库名应遵循项目本身的名称，内部逻辑的函数、类名、变量等应遵循驼峰、下划线等格式，禁止同一模块混用。
-- 涉及编译外部库的命令和 Patch 时应注意兼容不同操作系统。
+### Use embed
 
-## 开源协议
+When using the project parameters `--build-embed` or `--build-all`,
+the final compilation result will output a `libphp.a`, `php-config` and a series of header files,
+stored in `buildroot/`. You can introduce them in your other projects.
 
-本项目依据旧版本惯例采用 MIT License 开源，新版本采用了部分项目的源代码做参考，特别感谢：
+If you know [embed SAPI](https://github.com/php/php-src/tree/master/sapi/embed), you should know how to use it.
+You may require the introduction of other libraries during compilation,
+you can use `buildroot/bin/php-config` to obtain the compile-time configuration.
 
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)（木兰宽松许可证）
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)（Apache 2.0 LICENSE+SWOOLE-CLI LICENSE）
+For an advanced example of how to use this feature, take a look at [how to use it to build a static version of FrankenPHP](https://github.com/dunglas/frankenphp/blob/main/docs/static.md).
 
-因本项目的特殊性，使用项目编译过程中会使用很多其他开源项目，例如 curl、protobuf 等，它们都有各自的开源协议。
-请在编译完成后，使用命令 `dump-license`(TODO) 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
+## Contribution
+
+If the extension you need is missing, you can create an issue.
+If you are familiar with this project, you are also welcome to initiate a pull request.
+
+If you want to contribute document content, please go to [crazywhalecc/static-php-cli-docs](https://github.com/crazywhalecc/static-php-cli-docs).
+
+Part of the English document is written by me, and part is translated by Google,
+and there may be inaccurate descriptions, strange or offensive expressions.
+If you are a native English speaker, some corrections to the documentation are welcome.
+
+
+## Sponsor this project
+
+You can sponsor my project on [this page](https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md).
+
+## Open-Source License
+
+This project itself is based on MIT License,
+some newly added extensions and dependencies may originate from the following projects (including but not limited to),
+and the headers of these code files will also be given additional instructions LICENSE and AUTHOR:
+
+- [dixyes/lwmbs](https://github.com/dixyes/lwmbs) (Mulun Permissive License)
+- [swoole/swoole-cli](https://github.com/swoole/swoole-cli) (Apache 2.0 LICENSE+SWOOLE-CLI LICENSE)
+
+Due to the special nature of this project,
+many other open source projects such as curl and protobuf will be used during the project compilation process,
+and they all have their own open source licenses.
+
+Please use the `bin/spc dump-license` command to export the open source licenses used in the project after compilation,
+and comply with the corresponding project's LICENSE.
+
+## Advanced
+
+The refactoring branch of this project is written modularly.
+If you are interested in this project and want to join the development,
+you can refer to the [Contribution Guide](https://static-php.dev) of the documentation to contribute code or documentation.

bin/setup-runtime

@@ -0,0 +1,75 @@
+#!/usr/bin/env sh
+
+# set error-quit, verbose, non-variable-quit
+set -eu
+# see what system used
+__OS__=$(uname -s)
+# see what arch used
+__ARCH__=$(uname -m)
+# format arch name
+case $__ARCH__ in
+arm64 | aarch64) __ARCH__=aarch64 ;;
+x86_64|x64) __ARCH__=x86_64 ;;
+*) ;;
+esac
+
+# format uname
+case $__OS__ in
+Darwin) __OS_FIXED__=macos ;;
+Linux) __OS_FIXED__=linux ;;
+*) echo "Current OS is not supported" && exit 1 ;;
+esac
+
+# set project dir
+__DIR__=$(cd "$(dirname "$0")" && pwd)
+__PROJECT__=$(cd "${__DIR__}"/../ && pwd)
+
+# set download dir
+__PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/common/php-8.2.10-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+__COMPOSER_URL__="https://getcomposer.org/download/latest-stable/composer.phar"
+
+# use china mirror
+# bash bin/setup-runtime --mirror china
+mirror=''
+while [ $# -gt 0 ]; do
+  case "$1" in
+  --mirror)
+    mirror="$2"
+    shift
+    ;;
+  --*)
+    echo "Illegal option $1"
+    ;;
+  esac
+  shift $(($# > 0 ? 1 : 0))
+done
+
+case "$mirror" in
+china)
+  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/common/php-8.2.10-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+  __COMPOSER_URL__="https://mirrors.aliyun.com/composer/composer.phar"
+  ;;
+
+esac
+
+if ! command -v curl > /dev/null && command -v apk > /dev/null; then
+  apk add --no-cache curl
+fi
+
+test -d "${__PROJECT__}"/downloads || mkdir "${__PROJECT__}"/downloads
+# download static php binary
+test -f "${__PROJECT__}"/downloads/runtime.tar.gz || { echo "Downloading $__PHP_RUNTIME_URL__ ..." && curl -#fSL -o "${__PROJECT__}"/downloads/runtime.tar.gz "$__PHP_RUNTIME_URL__" ; }
+test -f "${__DIR__}"/php || { tar -xf "${__PROJECT__}"/downloads/runtime.tar.gz -C "${__DIR__}"/ ; }
+chmod +x "${__DIR__}"/php
+# download composer
+test -f "${__DIR__}"/composer || curl -#fSL -o "${__DIR__}"/composer "$__COMPOSER_URL__"
+chmod +x "${__DIR__}"/composer
+# sanity check for php and composer
+"${__DIR__}"/php -v >/dev/null || { echo "Failed to run php" && exit 1; }
+"${__DIR__}"/php "${__DIR__}"/composer --version >/dev/null || { echo "Failed to run composer" && exit 1; }
+
+echo "Setup runtime OK!"
+echo "runtime bin path needs to add manually by command below:"
+echo ""
+echo "    export PATH=\"${__DIR__}:\$PATH\""
+echo ""

bin/spc

@@ -1,6 +1,9 @@
-#!php
+#!/usr/bin/env php
 <?php
 
+use SPC\ConsoleApplication;
+use SPC\exception\ExceptionHandler;
+
 require_once __DIR__ . '/../vendor/autoload.php';
 
 // 防止 Micro 打包状态下不支持中文的显示（虽然这个项目目前好像没输出过中文？）
@@ -8,9 +11,8 @@ if (PHP_OS_FAMILY === 'Windows' && Phar::running()) {
     exec('CHCP 65001');
 }
 
-// 跑，反正一条命令跑就对了
 try {
-    (new \SPC\ConsoleApplication())->run();
+    (new ConsoleApplication())->run();
 } catch (Exception $e) {
-    \SPC\exception\ExceptionHandler::getInstance()->handle($e);
+    ExceptionHandler::getInstance()->handle($e);
 }

bin/spc-alpine-docker

@@ -0,0 +1,112 @@
+#!/usr/bin/env sh
+
+# This file is using docker to run commands
+
+# Detect docker can run
+if ! which docker >/dev/null; then
+  echo "Docker is not installed, please install docker first !"
+  exit 1
+fi
+DOCKER_EXECUTABLE="docker"
+# shellcheck disable=SC2046
+if [ $(id -u) -ne 0 ]; then
+    if ! docker info > /dev/null 2>&1; then
+        if [ "$SPC_USE_SUDO" != "yes" ]; then
+            echo "Docker command requires sudo"
+            # shellcheck disable=SC2039
+            echo -n 'To use sudo to run docker, run "export SPC_USE_SUDO=yes" and run command again'
+            exit 1
+        fi
+        DOCKER_EXECUTABLE="sudo docker"
+    fi
+fi
+
+
+
+# to check if qemu-docker run
+if [ "$SPC_USE_ARCH" = "" ]; then
+    SPC_USE_ARCH=x86_64
+fi
+case $SPC_USE_ARCH in
+x86_64)
+    ALPINE_FROM=alpine:edge
+    ;;
+aarch64)
+    ALPINE_FROM=multiarch/alpine:aarch64-edge
+    # shellcheck disable=SC2039
+    echo -e "\e[033m* Using different arch needs to setup qemu-static for docker !\e[0m"
+    $DOCKER_EXECUTABLE run --rm --privileged multiarch/qemu-user-static:register --reset > /dev/null
+    ;;
+*)
+    echo "Current arch is not supported to run in docker: $SPC_USE_ARCH"
+    exit 1
+    ;;
+esac
+
+if [ "$SPC_USE_MIRROR" = "yes" ]; then
+    SPC_USE_MIRROR="RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories"
+else
+    SPC_USE_MIRROR="RUN echo 'Using original repo'"
+fi
+
+# Detect docker env is setup
+if ! $DOCKER_EXECUTABLE images | grep -q cwcc-spc-$SPC_USE_ARCH; then
+    echo "Docker container does not exist. Building docker image ..."
+    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH -f- . <<EOF
+FROM $ALPINE_FROM
+$SPC_USE_MIRROR
+RUN apk update; \
+    apk add --no-cache \
+        autoconf \
+        automake \
+        gettext \
+        bash \
+        binutils \
+        bison \
+        build-base \
+        cmake \
+        curl \
+        file \
+        flex \
+        g++ \
+        gcc \
+        git \
+        jq \
+        libgcc \
+        libstdc++ \
+        linux-headers \
+        m4 \
+        make \
+        php82 \
+        php82-common \
+        php82-pcntl \
+        php82-phar \
+        php82-posix \
+        php82-sodium \
+        php82-tokenizer \
+        php82-dom \
+        php82-xml \
+        php82-xmlwriter \
+        composer \
+        pkgconfig \
+        wget \
+        xz
+
+WORKDIR /app
+ADD ./src /app/src
+COPY ./composer.* /app/
+ADD ./bin /app/bin
+RUN composer install --no-dev --classmap-authoritative
+EOF
+fi
+
+# Check if in ci (local terminal can execute with -it)
+if [ -t 0 ]; then
+    INTERACT=-it
+else
+    INTERACT=''
+fi
+
+# Run docker
+# shellcheck disable=SC2068
+$DOCKER_EXECUTABLE run --rm $INTERACT -e SPC_FIX_DEPLOY_ROOT="$(pwd)" -v "$(pwd)"/config:/app/config -v "$(pwd)"/src:/app/src -v "$(pwd)"/buildroot:/app/buildroot -v "$(pwd)"/source:/app/source -v "$(pwd)"/downloads:/app/downloads cwcc-spc-$SPC_USE_ARCH bin/spc $@

box.json

@@ -0,0 +1,19 @@
+{
+  "alias": "spc-php.phar",
+  "banner": false,
+  "blacklist": [
+    ".github"
+  ],
+  "directories": [
+    "config",
+    "src",
+    "vendor/psr",
+    "vendor/laravel/prompts",
+    "vendor/illuminate",
+    "vendor/symfony",
+    "vendor/zhamao"
+  ],
+  "git-commit-short": "git_commit_short",
+  "metadata": "ConsoleApplication::VERSION",
+  "output": "spc.phar"
+}

composer.json

@@ -9,19 +9,21 @@
         }
     ],
     "require": {
-        "php": ">= 8.0",
-        "ext-tokenizer": "*",
-        "ext-iconv": "*",
-        "symfony/console": "^6 || ^5 || ^4",
-        "zhamao/logger": "^1.0",
-        "crazywhalecc/cli-helper": "^0.1.0",
-        "nunomaduro/collision": "*"
+        "php": ">= 8.1",
+        "ext-mbstring": "*",
+        "ext-pcntl": "*",
+        "laravel/prompts": "^0.1.12",
+        "symfony/console": "^5.4 || ^6 || ^7",
+        "zhamao/logger": "^1.0"
     },
     "require-dev": {
-        "friendsofphp/php-cs-fixer": "^3.2 != 3.7.0",
-        "phpstan/phpstan": "^1.1",
         "captainhook/captainhook": "^5.10",
-        "captainhook/plugin-composer": "^5.3"
+        "captainhook/plugin-composer": "^5.3",
+        "friendsofphp/php-cs-fixer": "^3.25",
+        "humbug/box": "^4.3",
+        "nunomaduro/collision": "^7.8",
+        "phpstan/phpstan": "^1.10",
+        "phpunit/phpunit": "^10.3"
     },
     "autoload": {
         "psr-4": {
@@ -32,13 +34,19 @@
             "src/globals/functions.php"
         ]
     },
+    "autoload-dev": {
+        "psr-4": {
+            "SPC\\Tests\\": "tests/SPC"
+        }
+    },
     "bin": [
         "bin/spc"
     ],
     "scripts": {
         "analyse": "phpstan analyse --memory-limit 300M",
         "cs-fix": "php-cs-fixer fix",
-        "test": "bin/phpunit --no-coverage"
+        "test": "vendor/bin/phpunit tests/ --no-coverage",
+        "build:phar": "vendor/bin/box compile"
     },
     "config": {
         "allow-plugins": {

config/ext.json

@@ -1,10 +1,14 @@
 {
+    "apcu": {
+        "type": "external",
+        "source": "apcu"
+    },
     "bcmath": {
         "type": "builtin"
     },
     "bz2": {
         "type": "builtin",
-        "arg-type": "custom",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "bzip2"
         ]
@@ -28,24 +32,32 @@
     },
     "dom": {
         "type": "builtin",
+        "arg-type": "custom",
         "arg-type-windows": "with",
         "lib-depends": [
             "libxml2",
             "zlib"
         ]
     },
-    "enchant": {
-        "type": "builtin",
-        "arg-type": "with",
+    "event": {
+        "type": "external",
+        "source": "ext-event",
+        "arg-type": "custom",
         "lib-depends": [
-            "enchant2"
+            "libevent"
+        ],
+        "ext-depends": [
+            "openssl"
+        ],
+        "ext-suggests": [
+            "sockets"
         ]
     },
     "exif": {
         "type": "builtin"
     },
     "ffi": {
-        "arg-type": "with",
+        "arg-type": "custom",
         "type": "builtin",
         "lib-depends": [
             "libffi"
@@ -65,31 +77,20 @@
     },
     "gd": {
         "type": "builtin",
+        "arg-type": "custom",
         "arg-type-windows": "with",
         "lib-depends": [
             "zlib",
             "libpng"
         ],
+        "ext-depends": [
+            "zlib"
+        ],
         "lib-suggests": [
-            "gd",
             "libavif",
             "libwebp",
             "libjpeg",
-            "xpm",
             "freetype"
-        ],
-        "lib-depends-windows": [
-            "libiconv",
-            "freetype",
-            "libjpeg",
-            "zlib",
-            "libpng",
-            "xpm"
-        ],
-        "lib-suggests-windows": [
-            "gd",
-            "libavif",
-            "libwebp"
         ]
     },
     "gettext": {
@@ -99,20 +100,36 @@
             "gettext"
         ]
     },
+    "glfw": {
+        "type": "external",
+        "arg-type": "custom",
+        "source": "ext-glfw",
+        "lib-depends": [
+            "glfw"
+        ]
+    },
     "gmp": {
         "type": "builtin",
-        "arg-type": "none",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "gmp"
         ]
     },
     "iconv": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends-windows": [
             "libiconv"
         ]
     },
+    "imagick": {
+        "type": "external",
+        "source": "ext-imagick",
+        "arg-type": "custom",
+        "lib-depends": [
+            "imagemagick"
+        ]
+    },
     "imap": {
         "type": "builtin",
         "arg-type": "with",
@@ -123,6 +140,10 @@
             "kerberos"
         ]
     },
+    "inotify": {
+        "type": "external",
+        "source": "inotify"
+    },
     "intl": {
         "type": "builtin",
         "lib-depends": [
@@ -131,23 +152,67 @@
     },
     "ldap": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "ldap"
+        ],
+        "lib-suggests": [
+            "gmp",
+            "libsodium"
+        ],
+        "ext-suggests": [
+            "openssl"
         ]
     },
     "mbregex": {
         "type": "builtin",
-        "lib-depends": [
-            "onig"
+        "arg-type": "custom",
+        "ext-depends": [
+            "mbstring"
         ]
     },
     "mbstring": {
         "type": "builtin",
+        "arg-type": "custom",
         "lib-depends": [
             "onig"
         ]
     },
+    "memcache": {
+        "type": "external",
+        "source": "ext-memcache",
+        "arg-type": "custom",
+        "lib-depends": [
+            "zlib"
+        ],
+        "ext-depends": [
+            "session"
+        ]
+    },
+    "memcached": {
+        "type": "external",
+        "source": "memcached",
+        "arg-type": "custom",
+        "cpp-extension": true,
+        "lib-depends": [
+            "libmemcached"
+        ],
+        "ext-depends": [
+            "session",
+            "zlib"
+        ]
+    },
+    "mongodb": {
+        "type": "external",
+        "source": "mongodb",
+        "arg-type": "custom",
+        "lib-suggests": [
+            "icu",
+            "openssl",
+            "zstd",
+            "zlib"
+        ]
+    },
     "mysqli": {
         "type": "builtin",
         "arg-type": "with",
@@ -157,16 +222,22 @@
     },
     "mysqlnd": {
         "type": "builtin",
-        "arg-type-windows": "with"
+        "arg-type-windows": "with",
+        "lib-depends": [
+            "zlib"
+        ]
     },
     "opcache": {
         "type": "builtin"
     },
     "openssl": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "custom",
         "lib-depends": [
             "openssl"
+        ],
+        "ext-depends": [
+            "zlib"
         ]
     },
     "pcntl": {
@@ -186,12 +257,13 @@
     },
     "pdo_pgsql": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "ext-depends": [
-            "pdo"
+            "pdo",
+            "pgsql"
         ],
         "lib-depends": [
-            "pq"
+            "postgresql"
         ]
     },
     "pdo_sqlite": {
@@ -205,9 +277,16 @@
             "sqlite"
         ]
     },
+    "pgsql": {
+        "type": "builtin",
+        "arg-type": "with-prefix",
+        "lib-depends": [
+            "postgresql"
+        ]
+    },
     "phar": {
         "type": "builtin",
-        "lib-suggests": [
+        "ext-depends": [
             "zlib"
         ]
     },
@@ -215,6 +294,10 @@
         "type": "builtin",
         "unix-only": true
     },
+    "protobuf": {
+        "type": "external",
+        "source": "protobuf"
+    },
     "pspell": {
         "type": "builtin",
         "arg-type": "with",
@@ -224,18 +307,18 @@
     },
     "readline": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "readline"
-        ],
-        "lib-suggests": [
-            "libedit",
-            "ncurses"
         ]
     },
     "redis": {
         "type": "external",
-        "source": "redis"
+        "source": "redis",
+        "arg-type": "custom",
+        "ext-suggests": [
+            "session"
+        ]
     },
     "session": {
         "type": "builtin"
@@ -245,11 +328,24 @@
     },
     "simplexml": {
         "type": "builtin",
+        "arg-type": "custom",
         "arg-type-windows": "with",
         "lib-depends": [
             "libxml2"
         ]
     },
+    "snappy": {
+        "type": "external",
+        "source": "ext-snappy",
+        "cpp-extension": true,
+        "arg-type": "custom",
+        "lib-depends": [
+            "snappy"
+        ],
+        "ext-suggest": [
+            "apcu"
+        ]
+    },
     "snmp": {
         "type": "builtin",
         "arg-type": "with",
@@ -259,6 +355,7 @@
     },
     "soap": {
         "type": "builtin",
+        "arg-type": "custom",
         "lib-depends": [
             "libxml2"
         ]
@@ -270,42 +367,51 @@
         "type": "builtin",
         "arg-type": "with",
         "lib-depends": [
-            "sodium"
+            "libsodium"
         ]
     },
     "sqlite3": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "sqlite"
         ]
     },
+    "ssh2": {
+        "type": "external",
+        "source": "ext-ssh2",
+        "arg-type": "with-prefix",
+        "lib-depends": [
+            "libssh2"
+        ]
+    },
     "swoole": {
         "type": "external",
         "source": "swoole",
+        "arg-type": "custom",
+        "cpp-extension": true,
         "lib-depends": [
-            "openssl",
-            "curl"
+            "openssl"
         ],
         "ext-depends": [
             "openssl"
         ],
         "ext-suggests": [
-            "curl"
+            "curl",
+            "pgsql"
         ],
         "unix-only": true
     },
     "swow": {
         "type": "external",
         "source": "swow",
-        "lib-depends": [
-            "libuv"
-        ],
+        "arg-type": "custom",
         "lib-suggests": [
             "openssl",
             "curl"
         ],
         "ext-suggests": [
+            "openssl",
             "curl"
         ]
     },
@@ -331,8 +437,18 @@
     "tokenizer": {
         "type": "builtin"
     },
+    "xlswriter": {
+        "type": "external",
+        "source": "xlswriter",
+        "arg-type": "custom",
+        "ext-depends": [
+            "zlib",
+            "zip"
+        ]
+    },
     "xml": {
         "type": "builtin",
+        "arg-type": "custom",
         "arg-type-windows": "with",
         "lib-depends": [
             "libxml2"
@@ -340,34 +456,40 @@
     },
     "xmlreader": {
         "type": "builtin",
+        "arg-type": "custom",
         "lib-depends": [
             "libxml2"
         ]
     },
     "xmlwriter": {
         "type": "builtin",
+        "arg-type": "custom",
         "lib-depends": [
             "libxml2"
         ]
     },
     "xsl": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "libxslt"
+        ],
+        "ext-depends": [
+            "xml",
+            "dom"
         ]
     },
     "yaml": {
         "type": "external",
         "source": "yaml",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "libyaml"
         ]
     },
     "zip": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "arg-type-windows": "enable",
         "lib-depends": [
             "libzip"
@@ -375,7 +497,7 @@
     },
     "zlib": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "custom",
         "arg-type-windows": "enable",
         "lib-depends": [
             "zlib"
@@ -384,8 +506,9 @@
     "zstd": {
         "type": "external",
         "source": "ext-zstd",
+        "arg-type": "custom",
         "lib-depends": [
             "zstd"
         ]
     }
-}
+}

config/lib.json

@@ -42,16 +42,14 @@
             "curl"
         ],
         "lib-depends-unix": [
+            "openssl",
             "zlib"
         ],
         "lib-suggests": [
             "libssh2",
             "brotli",
             "nghttp2",
-            "zstd",
-            "openssl",
-            "idn2",
-            "psl"
+            "zstd"
         ],
         "lib-suggests-windows": [
             "zlib",
@@ -65,9 +63,40 @@
         ],
         "frameworks": [
             "CoreFoundation",
+            "CoreServices",
             "SystemConfiguration"
         ]
     },
+    "freetype": {
+        "source": "freetype",
+        "static-libs-unix": [
+            "libfreetype.a"
+        ],
+        "headers-unix": [
+            "freetype2/freetype/freetype.h",
+            "freetype2/ft2build.h"
+        ],
+        "lib-depends": [
+            "zlib"
+        ],
+        "lib-suggests": [
+            "libpng",
+            "bzip2",
+            "brotli"
+        ]
+    },
+    "glfw": {
+        "source": "ext-glfw",
+        "static-libs-unix": [
+            "libglfw3.a"
+        ],
+        "frameworks": [
+            "CoreVideo",
+            "OpenGL",
+            "Cocoa",
+            "IOKit"
+        ]
+    },
     "gmp": {
         "source": "gmp",
         "static-libs-unix": [
@@ -80,6 +109,68 @@
             "gmp.h"
         ]
     },
+    "icu": {
+        "source": "icu",
+        "cpp-library": true,
+        "static-libs-unix": [
+            "libicui18n.a",
+            "libicuio.a",
+            "libicuuc.a",
+            "libicudata.a"
+        ]
+    },
+    "imagemagick": {
+        "source": "imagemagick",
+        "static-libs-unix": [
+            "libMagick++-7.Q16HDRI.a",
+            "libMagickWand-7.Q16HDRI.a",
+            "libMagickCore-7.Q16HDRI.a"
+        ],
+        "lib-depends": [
+            "zlib",
+            "libpng",
+            "libjpeg",
+            "libwebp",
+            "freetype"
+        ],
+        "lib-suggests": [
+            "zstd",
+            "xz",
+            "bzip2",
+            "libzip",
+            "libxml2"
+        ]
+    },
+    "ldap": {
+        "source": "ldap",
+        "static-libs-unix": [
+            "liblber.a",
+            "libldap.a"
+        ],
+        "lib-suggests": [
+            "openssl",
+            "gmp",
+            "libsodium"
+        ]
+    },
+    "libavif": {
+        "source": "libavif",
+        "static-libs-unix": [
+            "libavif.a"
+        ]
+    },
+    "libevent": {
+        "source": "libevent",
+        "static-libs-unix": [
+            "libevent.a",
+            "libevent_core.a",
+            "libevent_extra.a",
+            "libevent_openssl.a"
+        ],
+        "lib-depends": [
+            "openssl"
+        ]
+    },
     "libffi": {
         "source": "libffi",
         "static-libs-unix": [
@@ -98,11 +189,42 @@
             "ffitarget.h"
         ]
     },
-
+    "libiconv": {
+        "source": "libiconv",
+        "static-libs-unix": [
+            "libiconv.a",
+            "libcharset.a"
+        ],
+        "headers": [
+            "iconv.h",
+            "libcharset.h",
+            "localcharset.h"
+        ]
+    },
+    "libjpeg": {
+        "source": "libjpeg",
+        "static-libs-unix": [
+            "libjpeg.a",
+            "libturbojpeg.a"
+        ]
+    },
+    "libmcrypt": {
+        "source": "libmcrypt",
+        "static-libs-unix": [
+            "libmcrypt.a"
+        ]
+    },
+    "libmemcached": {
+        "source": "libmemcached",
+        "static-libs-unix": [
+            "libmemcached.a",
+            "libmemcachedutil.a"
+        ]
+    },
     "libpng": {
         "source": "libpng",
         "static-libs-unix": [
-            "libpng.a"
+            "libpng16.a"
         ],
         "static-libs-windows": [
             "libpng16_static.lib"
@@ -120,6 +242,12 @@
             "zlib"
         ]
     },
+    "libsodium": {
+        "source": "libsodium",
+        "static-libs-unix": [
+            "libsodium.a"
+        ]
+    },
     "libssh2": {
         "source": "libssh2",
         "static-libs-unix": [
@@ -140,6 +268,16 @@
             "zlib"
         ]
     },
+    "libwebp": {
+        "source": "libwebp",
+        "static-libs-unix": [
+            "libwebp.a",
+            "libwebpdecoder.a",
+            "libwebpdemux.a",
+            "libwebpmux.a",
+            "libsharpyuv.a"
+        ]
+    },
     "libxml2": {
         "source": "libxml2",
         "static-libs-unix": [
@@ -154,18 +292,30 @@
         "headers": [
             "libxml2"
         ],
-        "lib-suggests": [
-            "icu",
-            "xz",
+        "lib-depends": [
+            "libiconv",
             "zlib"
         ],
+        "lib-suggests": [
+            "xz",
+            "icu"
+        ],
         "lib-suggests-windows": [
             "icu",
             "xz",
-            "zlib",
             "pthreads4w"
         ]
     },
+    "libxslt": {
+        "source": "libxslt",
+        "static-libs-unix": [
+            "libxslt.a",
+            "libexslt.a"
+        ],
+        "lib-depends": [
+            "libxml2"
+        ]
+    },
     "libyaml": {
         "source": "libyaml",
         "static-libs-unix": [
@@ -203,26 +353,16 @@
             "openssl"
         ]
     },
-    "libmcrypt": {
-        "source": "libmcrypt",
-        "static-libs-unix": [
-            "libmcrypt.a"
-        ]
-    },
     "mcrypt": {
         "source": "mcrypt",
         "static-libs-unix": [
             "libmcrypt.a"
         ]
     },
-    "freetype": {
-        "source": "freetype",
+    "ncurses": {
+        "source": "ncurses",
         "static-libs-unix": [
-            "libfreetype.a"
-        ],
-        "headers-unix": [
-            "freetype2/freetype/freetype.h",
-            "freetype2/ft2build.h"
+            "libncurses.a"
         ]
     },
     "nghttp2": {
@@ -241,26 +381,7 @@
             "openssl"
         ],
         "lib-suggests": [
-            "libxml2",
-            "libev",
-            "libcares",
-            "libngtcp2",
-            "libnghttp3",
-            "libbpf",
-            "libevent-openssl",
-            "jansson",
-            "jemalloc",
-            "systemd",
-            "cunit"
-        ]
-    },
-    "libuv": {
-        "source": "libuv",
-        "static-libs-unix": [
-            "libuv.a"
-        ],
-        "headers": [
-            "uv.h"
+            "libxml2"
         ]
     },
     "onig": {
@@ -292,10 +413,34 @@
         "headers": [
             "openssl"
         ],
-        "lib-suggests": [
+        "lib-depends": [
             "zlib"
         ]
     },
+    "pkg-config": {
+        "source": "pkg-config"
+    },
+    "postgresql": {
+        "source": "postgresql",
+        "static-libs-unix": [
+            "libpq.a",
+            "libpgport.a",
+            "libpgcommon.a"
+        ],
+        "lib-depends": [
+            "libiconv",
+            "libxml2",
+            "openssl",
+            "zlib",
+            "readline"
+        ],
+        "lib-suggests": [
+            "icu",
+            "libxslt",
+            "ldap",
+            "zstd"
+        ]
+    },
     "pthreads4w": {
         "source": "pthreads4w",
         "static-libs-windows": [
@@ -308,6 +453,30 @@
             "semaphore.h"
         ]
     },
+    "readline": {
+        "source": "readline",
+        "static-libs-unix": [
+            "libreadline.a"
+        ],
+        "lib-depends": [
+            "ncurses"
+        ]
+    },
+    "snappy": {
+        "source": "snappy",
+        "static-libs-unix": [
+            "libsnappy.a"
+        ],
+        "headers-unix": [
+            "snappy.h",
+            "snappy-c.h",
+            "snappy-sinksource.h",
+            "snappy-stubs-public.h"
+        ],
+        "lib-depends": [
+            "zlib"
+        ]
+    },
     "sqlite": {
         "source": "sqlite",
         "static-libs-unix": [
@@ -335,6 +504,9 @@
         "headers-windows": [
             "lzma",
             "lzma.h"
+        ],
+        "lib-depends": [
+            "libiconv"
         ]
     },
     "zlib": {
@@ -371,4 +543,4 @@
             "zstd_errors.h"
         ]
     }
-}
+}

ext-support.md

@@ -1,70 +1,3 @@
 # Extension List
 
-> - yes: supported and tested
-> - untested: supported but not tested
-> - empty: not supported yet
-> - faulty with issue link: not supported yet due to issue
-
-|            | Linux | macOS                                                              | Windows |
-|------------|-------|--------------------------------------------------------------------|---------|
-| bcmath     |       | yes                                                                |         |
-| bz2        |       | untested                                                           |         |
-| calendar   |       | yes                                                                |         |
-| ctype      |       | yes                                                                |         |
-| curl       |       | yes                                                                |         |
-| date       |       | yes                                                                |         | 
-| dom        |       | untested                                                           |         |
-| event      |       |                                                                    |         |
-| exif       |       | yes                                                                |         |
-| filter     |       | yes                                                                |         |
-| fileinfo   |       |                                                                    |         |
-| ftp        |       | yes                                                                |         |
-| gd         |       | untested                                                           |         |
-| gmp        |       | untested                                                           |         |
-| hash       |       | yes                                                                |         |
-| iconv      |       |                                                                    |         |
-| inotify    |       |                                                                    |         |
-| json       |       | yes                                                                |         |
-| libxml     |       | yes                                                                |         |
-| mbstring   |       | yes                                                                |         |
-| mcrypt     |       | [faulty](https://github.com/crazywhalecc/static-php-cli/issues/32) |         |
-| mongodb    |       |                                                                    |         |
-| mysqli     |       |                                                                    |         |
-| mysqlnd    |       | yes                                                                |         |
-| openssl    |       | yes                                                                |         |
-| pcntl      |       | untested                                                           |         |
-| pcre       |       | yes                                                                |         |
-| pdo        |       | yes                                                                |         |
-| pdo_mysql  |       | yes                                                                |         |
-| pdo_sqlite |       | yes                                                                |         |
-| pdo_pgsql  |       |                                                                    |         |
-| phar       |       | yes                                                                |         |
-| posix      |       | yes                                                                |         |
-| protobuf   |       |                                                                    |         |
-| readline   |       |                                                                    |         |
-| redis      |       | yes                                                                |         |
-| Reflection |       | yes                                                                |         |
-| session    |       | yes                                                                |         |
-| shmop      |       |                                                                    |         |
-| simplexml  |       | untested                                                           |         |
-| soap       |       |                                                                    |         |
-| sockets    |       |                                                                    |         |
-| sqlite3    |       | untested                                                           |         |
-| swow       |       |                                                                    |         |
-| swoole     |       | [faulty](https://github.com/crazywhalecc/static-php-cli/issues/32) |         |
-| tokenizer  |       | yes                                                                |         |
-| xml        |       | yes                                                                |         |
-| xmlreader  |       | untested                                                           |         |
-| xmlwriter  |       | untested                                                           |         |
-| zip        |       | yes                                                                |         |
-| zlib       |       | yes                                                                |         |
-
-## Additional Requirements
-
-- phpmicro requires PHP >= 8.0
-- swoole >= 5.0 requires PHP >= 8.0
-- swow requires PHP >= 8.0
-
-## Bugs
-
-See [#32](https://github.com/crazywhalecc/static-php-cli/issues/32).
+See: [Docs - Extensions](https://static-php.dev/en/guide/extensions.html)

src/SPC/ConsoleApplication.php

@@ -4,47 +4,49 @@ declare(strict_types=1);
 
 namespace SPC;
 
-use SPC\command\DeployCommand;
-use SPC\store\FileSystem;
+use SPC\command\BuildCliCommand;
+use SPC\command\BuildLibsCommand;
+use SPC\command\dev\AllExtCommand;
+use SPC\command\dev\PhpVerCommand;
+use SPC\command\dev\SortConfigCommand;
+use SPC\command\DoctorCommand;
+use SPC\command\DownloadCommand;
+use SPC\command\DumpLicenseCommand;
+use SPC\command\ExtractCommand;
+use SPC\command\MicroCombineCommand;
 use Symfony\Component\Console\Application;
-use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Command\HelpCommand;
 use Symfony\Component\Console\Command\ListCommand;
 
 /**
- * spc 应用究级入口
+ * static-php-cli console app entry
  */
-class ConsoleApplication extends Application
+final class ConsoleApplication extends Application
 {
-    public const VERSION = '2.0-alpha1';
+    public const VERSION = '2.0.0-rc8';
 
-    /**
-     * @throws \ReflectionException
-     * @throws exception\FileSystemException
-     */
     public function __construct()
     {
         parent::__construct('static-php-cli', self::VERSION);
 
-        global $argv;
+        $this->addCommands(
+            [
+                new BuildCliCommand(),
+                new BuildLibsCommand(),
+                new DoctorCommand(),
+                new DownloadCommand(),
+                new DumpLicenseCommand(),
+                new ExtractCommand(),
+                new MicroCombineCommand(),
 
-        // 生产环境不显示详细的调试错误，只使用 symfony console 自带的错误显示
-        $this->setCatchExceptions(file_exists(ROOT_DIR . '/.prod') || !in_array('--debug', $argv));
-
-        // 通过扫描目录 src/static-php-cli/command/ 添加子命令
-        $commands = FileSystem::getClassesPsr4(ROOT_DIR . '/src/SPC/command', 'SPC\\command');
-        $this->addCommands(array_map(function ($x) { return new $x(); }, array_filter($commands, function ($y) {
-            if (is_a($y, DeployCommand::class, true) && (class_exists('\\Phar') && \Phar::running() || !class_exists('\\Phar'))) {
-                return false;
-            }
-            $reflection = new \ReflectionClass($y);
-            return !$reflection->isAbstract() && !$reflection->isInterface();
-        })));
+                // Dev commands
+                new AllExtCommand(),
+                new PhpVerCommand(),
+                new SortConfigCommand(),
+            ]
+        );
     }
 
-    /**
-     * 重载以去除一些不必要的默认命令
-     */
     protected function getDefaultCommands(): array
     {
         return [new HelpCommand(), new ListCommand()];

src/SPC/builder/BuilderBase.php

@@ -6,42 +6,41 @@ namespace SPC\builder;
 
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 use SPC\store\FileSystem;
+use SPC\store\SourceExtractor;
+use SPC\util\CustomExt;
 use SPC\util\DependencyUtil;
 
 abstract class BuilderBase
 {
-    /** @var bool 是否启用 ZTS 线程安全 */
-    public bool $zts = false;
-
-    /** @var string 编译目标架构 */
-    public string $arch;
-
-    /** @var string GNU 格式的编译目标架构 */
-    public string $gnu_arch;
-
-    /** @var int 编译进程数 */
+    /** @var int Concurrency */
     public int $concurrency = 1;
 
-    /** @var array<string, LibraryBase> 要编译的 libs 列表 */
+    /** @var array<string, LibraryBase> libraries */
     protected array $libs = [];
 
-    /** @var array<string, Extension> 要编译的扩展列表 */
+    /** @var array<string, Extension> extensions */
     protected array $exts = [];
 
-    /** @var bool 本次编译是否只编译 libs，不编译 PHP */
+    /** @var bool compile libs only (just mark it) */
     protected bool $libs_only = false;
 
+    /** @var array<string, mixed> compile options */
+    protected array $options = [];
+
     /**
-     * 构建指定列表的 libs
+     * Build libraries
      *
-     * @throws RuntimeException
+     * @param  array<string>       $libraries Libraries to build
      * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function buildLibs(array $libraries): void
     {
-        // 通过扫描目录查找 lib
+        // search all supported libs
         $support_lib_list = [];
         $classes = FileSystem::getClassesPsr4(
             ROOT_DIR . '/src/SPC/builder/' . osfamily2dir() . '/library',
@@ -53,22 +52,22 @@ abstract class BuilderBase
             }
         }
 
-        // 如果传入了空，则默认检查和安置所有支持的lib，libraries为要build的，support_lib_list为支持的列表
+        // if no libs specified, compile all supported libs
         if ($libraries === [] && $this->isLibsOnly()) {
             $libraries = array_keys($support_lib_list);
         }
 
-        // 排序 libs，根据依赖计算一个新的列表出来
-        $libraries = DependencyUtil::getLibsByDeps($libraries);
-
-        // 这里筛选 libraries，比如纯静态模式排除掉ffi
-        if (defined('BUILD_ALL_STATIC') && BUILD_ALL_STATIC) {
-            $k = array_search('libffi', $libraries, true);
-            $k !== false && array_splice($libraries, $k, 1);
+        // pkg-config must be compiled first, whether it is specified or not
+        if (!in_array('pkg-config', $libraries)) {
+            array_unshift($libraries, 'pkg-config');
         }
 
-        // 过滤不支持的库后添加
+        // append dependencies
+        $libraries = DependencyUtil::getLibsByDeps($libraries);
+
+        // add lib object for builder
         foreach ($libraries as $library) {
+            // if some libs are not supported (but in config "lib.json", throw exception)
             if (!isset($support_lib_list[$library])) {
                 throw new RuntimeException('library [' . $library . '] is in the lib.json list but not supported to compile, but in the future I will support it!');
             }
@@ -76,15 +75,17 @@ abstract class BuilderBase
             $this->addLib($lib);
         }
 
-        // 统计还没 fetch 到本地的库
-        $this->checkLibsSource();
-
-        // 计算依赖，经过这里的遍历，如果没有抛出异常，说明依赖符合要求，可以继续下面的
+        // calculate and check dependencies
         foreach ($this->libs as $lib) {
             $lib->calcDependency();
         }
+
+        // extract sources
+        SourceExtractor::initSource(libs: $libraries);
+
+        // build all libs
         foreach ($this->libs as $lib) {
-            match ($lib->tryBuild()) {
+            match ($lib->tryBuild($this->getOption('rebuild', false))) {
                 BUILD_STATUS_OK => logger()->info('lib [' . $lib::NAME . '] build success'),
                 BUILD_STATUS_ALREADY => logger()->notice('lib [' . $lib::NAME . '] already built'),
                 BUILD_STATUS_FAILED => logger()->error('lib [' . $lib::NAME . '] build failed'),
@@ -94,9 +95,9 @@ abstract class BuilderBase
     }
 
     /**
-     * 添加要编译的 Lib 库
+     * Add library to build.
      *
-     * @param LibraryBase $library Lib 库对象
+     * @param LibraryBase $library Library object
      */
     public function addLib(LibraryBase $library): void
     {
@@ -104,9 +105,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 获取要编译的 Lib 库对象
-     *
-     * @param string $name 库名称
+     * Get library object by name.
      */
     public function getLib(string $name): ?LibraryBase
     {
@@ -114,9 +113,17 @@ abstract class BuilderBase
     }
 
     /**
-     * 添加要编译的扩展
+     * Get all library objects.
      *
-     * @param Extension $extension 扩展对象
+     * @return LibraryBase[]
+     */
+    public function getLibs(): array
+    {
+        return $this->libs;
+    }
+
+    /**
+     * Add extension to build.
      */
     public function addExt(Extension $extension): void
     {
@@ -124,9 +131,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 获取要编译的扩展对象
-     *
-     * @param string $name 扩展名称
+     * Get extension object by name.
      */
     public function getExt(string $name): ?Extension
     {
@@ -134,7 +139,41 @@ abstract class BuilderBase
     }
 
     /**
-     * 设置本次 Builder 是否为仅编译库的模式
+     * Get all extension objects.
+     *
+     * @return Extension[]
+     */
+    public function getExts(): array
+    {
+        return $this->exts;
+    }
+
+    /**
+     * Check if there is a cpp extensions or libraries.
+     *
+     * @throws FileSystemException
+     * @throws WrongUsageException
+     */
+    public function hasCpp(): bool
+    {
+        // judge cpp-extension
+        $exts = array_keys($this->getExts());
+        foreach ($exts as $ext) {
+            if (Config::getExt($ext, 'cpp-extension', false) === true) {
+                return true;
+            }
+        }
+        $libs = array_keys($this->getLibs());
+        foreach ($libs as $lib) {
+            if (Config::getLib($lib, 'cpp-library', false) === true) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * Set libs only mode.
      */
     public function setLibsOnly(bool $status = true): void
     {
@@ -142,60 +181,58 @@ abstract class BuilderBase
     }
 
     /**
-     * 检验 ext 扩展列表是否合理，并声明 Extension 对象，检查扩展的依赖
+     * Verify the list of "ext" extensions for validity and declare an Extension object to check the dependencies of the extensions.
      *
      * @throws FileSystemException
      * @throws RuntimeException
+     * @throws \ReflectionException
+     * @throws WrongUsageException
      */
     public function proveExts(array $extensions): void
     {
-        if (defined('BUILD_ALL_STATIC') && BUILD_ALL_STATIC) {
-            $k = array_search('ffi', $extensions, true);
-            $k !== false && array_splice($extensions, $k, 1);
+        CustomExt::loadCustomExt();
+        SourceExtractor::initSource(sources: ['php-src']);
+        if ($this->getPHPVersionID() >= 80000) {
+            SourceExtractor::initSource(sources: ['micro']);
         }
+        SourceExtractor::initSource(exts: $extensions);
         foreach ($extensions as $extension) {
-            $ext = new Extension($extension, $this);
+            $class = CustomExt::getExtClass($extension);
+            $ext = new $class($extension, $this);
             $this->addExt($ext);
         }
 
         foreach ($this->exts as $ext) {
-            // 检查下依赖就行了，作用是导入依赖给 Extension 对象，今后可以对库依赖进行选择性处理
             $ext->checkDependency();
         }
     }
 
     /**
-     * 开始构建 PHP
-     * 构建 micro 的规则：
-     * - BUILD_MICRO_NONE(默认)：只编译 cli
-     * - BUILD_MICRO_ONLY：只编译 micro
-     * - BUILD_MICRO_BOTH：同时编译 micro 和 cli
+     * Start to build PHP
      *
-     * @param int  $build_micro_rule 规则
-     * @param bool $with_clean       是否为新构建？
-     * @param bool $bloat            保留
+     * @param int $build_target Build target, see BUILD_TARGET_*
      */
-    abstract public function buildPHP(int $build_micro_rule = BUILD_MICRO_NONE, bool $with_clean = false, bool $bloat = false);
+    abstract public function buildPHP(int $build_target = BUILD_TARGET_NONE);
 
     /**
-     * 生成依赖的扩展编译启用参数
-     * 例如 --enable-mbstring 等
+     * Generate extension enable arguments for configure.
+     * e.g. --enable-mbstring
      *
-     * @throws RuntimeException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function makeExtensionArgs(): string
     {
         $ret = [];
         foreach ($this->exts as $ext) {
-            $ret[] = $ext->getConfigureArg();
+            $ret[] = trim($ext->getConfigureArg());
         }
         logger()->info('Using configure: ' . implode(' ', $ret));
         return implode(' ', $ret);
     }
 
     /**
-     * 返回是否只编译 libs 的模式
+     * Get libs only mode.
      */
     public function isLibsOnly(): bool
     {
@@ -203,7 +240,100 @@ abstract class BuilderBase
     }
 
     /**
-     * 检查是否存在 lib 库对应的源码，如果不存在，则抛出异常
+     * Get PHP Version ID from php-src/main/php_version.h
+     *
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function getPHPVersionID(): int
+    {
+        if (!file_exists(SOURCE_PATH . '/php-src/main/php_version.h')) {
+            throw new WrongUsageException('PHP source files are not available, you need to download them first');
+        }
+
+        $file = file_get_contents(SOURCE_PATH . '/php-src/main/php_version.h');
+        if (preg_match('/PHP_VERSION_ID (\d+)/', $file, $match) !== 0) {
+            return intval($match[1]);
+        }
+
+        throw new RuntimeException('PHP version file format is malformed, please remove it and download again');
+    }
+
+    /**
+     * Get build type name string to display.
+     *
+     * @param int $type Build target type
+     */
+    public function getBuildTypeName(int $type): string
+    {
+        $ls = [];
+        if (($type & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
+            $ls[] = 'cli';
+        }
+        if (($type & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
+            $ls[] = 'micro';
+        }
+        if (($type & BUILD_TARGET_FPM) === BUILD_TARGET_FPM) {
+            $ls[] = 'fpm';
+        }
+        if (($type & BUILD_TARGET_EMBED) === BUILD_TARGET_EMBED) {
+            $ls[] = 'embed';
+        }
+        return implode(', ', $ls);
+    }
+
+    /**
+     * Get builder options (maybe changed by user)
+     *
+     * @param string $key     Option key
+     * @param mixed  $default If not exists, return this value
+     */
+    public function getOption(string $key, mixed $default = null): mixed
+    {
+        return $this->options[$key] ?? $default;
+    }
+
+    /**
+     * Get all builder options
+     */
+    public function getOptions(): array
+    {
+        return $this->options;
+    }
+
+    /**
+     * Set builder options if not exists.
+     */
+    public function setOptionIfNotExist(string $key, mixed $value): void
+    {
+        if (!isset($this->options[$key])) {
+            $this->options[$key] = $value;
+        }
+    }
+
+    /**
+     * Set builder options.
+     */
+    public function setOption(string $key, mixed $value): void
+    {
+        $this->options[$key] = $value;
+    }
+
+    public function getEnvString(array $vars = ['cc', 'cxx', 'ar', 'ld']): string
+    {
+        $env = [];
+        foreach ($vars as $var) {
+            $var = strtoupper($var);
+            if (getenv($var) !== false) {
+                $env[] = "{$var}=" . getenv($var);
+            }
+        }
+        return implode(' ', $env);
+    }
+
+    /**
+     * Check if all libs are downloaded.
+     * If not, throw exception.
      *
      * @throws RuntimeException
      */

src/SPC/builder/BuilderProvider.php

@@ -4,10 +4,12 @@ declare(strict_types=1);
 
 namespace SPC\builder;
 
+use SPC\builder\freebsd\BSDBuilder;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\builder\macos\MacOSBuilder;
-use SPC\builder\windows\WindowsBuilder;
+use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use Symfony\Component\Console\Input\InputInterface;
 
 /**
@@ -16,7 +18,9 @@ use Symfony\Component\Console\Input\InputInterface;
 class BuilderProvider
 {
     /**
+     * @throws FileSystemException
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public static function makeBuilderByInput(InputInterface $input): BuilderBase
     {
@@ -26,17 +30,10 @@ class BuilderProvider
             //    vs_ver: $input->getOption('vs-ver'),
             //    arch: $input->getOption('arch'),
             // ),
-            'Darwin' => new MacOSBuilder(
-                cc: $input->getOption('cc'),
-                cxx: $input->getOption('cxx'),
-                arch: $input->getOption('arch'),
-            ),
-            // 'Linux' => new LinuxBuilder(
-            //    cc: $input->getOption('cc'),
-            //    cxx: $input->getOption('cxx'),
-            //    arch: $input->getOption('arch'),
-            // ),
-            default => throw new RuntimeException('Current OS is not supported yet'),
+            'Darwin' => new MacOSBuilder($input->getOptions()),
+            'Linux' => new LinuxBuilder($input->getOptions()),
+            'BSD' => new BSDBuilder($input->getOptions()),
+            default => throw new WrongUsageException('Current OS "' . PHP_OS_FAMILY . '" is not supported yet'),
         };
     }
 }

src/SPC/builder/Extension.php

@@ -6,6 +6,7 @@ namespace SPC\builder;
 
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 
 class Extension
@@ -13,8 +14,9 @@ class Extension
     protected array $dependencies = [];
 
     /**
-     * @throws RuntimeException
      * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function __construct(protected string $name, protected BuilderBase $builder)
     {
@@ -32,17 +34,19 @@ class Extension
     /**
      * 获取开启该扩展的 PHP 编译添加的参数
      *
-     * @throws FileSystemException|RuntimeException
+     * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function getConfigureArg(): string
     {
         $arg = $this->getEnableArg();
         switch (PHP_OS_FAMILY) {
             case 'Windows':
-                $arg .= $this->getWindowsConfigureArg();
+                $arg = $this->getWindowsConfigureArg();
                 break;
             case 'Darwin':
             case 'Linux':
+            case 'BSD':
                 $arg .= $this->getUnixConfigureArg();
                 break;
         }
@@ -53,16 +57,17 @@ class Extension
      * 根据 ext 的 arg-type 获取对应开启的参数，一般都是 --enable-xxx 和 --with-xxx
      *
      * @throws FileSystemException
-     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function getEnableArg(): string
     {
         $_name = str_replace('_', '-', $this->name);
         return match ($arg_type = Config::getExt($this->name, 'arg-type', 'enable')) {
-            'enable' => '--enable-' . $_name,
-            'with' => '--with-' . $_name,
+            'enable' => '--enable-' . $_name . ' ',
+            'with' => '--with-' . $_name . ' ',
+            'with-prefix' => '--with-' . $_name . '="' . BUILD_ROOT_PATH . '" ',
             'none', 'custom' => '',
-            default => throw new RuntimeException("argType does not accept {$arg_type}, use [enable/with] ."),
+            default => throw new WrongUsageException("argType does not accept {$arg_type}, use [enable/with/with-prefix] ."),
         };
     }
 
@@ -83,6 +88,7 @@ class Extension
      *
      * @throws RuntimeException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function checkDependency(): static
     {
@@ -111,6 +117,52 @@ class Extension
         return $this->name;
     }
 
+    /**
+     * returns extension dist name
+     */
+    public function getDistName(): string
+    {
+        return $this->name;
+    }
+
+    public function getWindowsConfigureArg(): string
+    {
+        return '';
+        // Windows is not supported yet
+    }
+
+    public function getUnixConfigureArg(): string
+    {
+        return '';
+    }
+
+    /**
+     * Patch code before ./buildconf
+     * If you need to patch some code, overwrite this and return true
+     */
+    public function patchBeforeBuildconf(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Patch code before ./configure
+     * If you need to patch some code, overwrite this and return true
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Patch code before make
+     * If you need to patch some code, overwrite this and return true
+     */
+    public function patchBeforeMake(): bool
+    {
+        return false;
+    }
+
     /**
      * @throws RuntimeException
      */
@@ -143,145 +195,6 @@ class Extension
         }
     }
 
-    private function getWindowsConfigureArg(): string
-    {
-        $arg = '';
-        switch ($this->name) {
-            case 'redis':
-                // $arg = '--enable-redis';
-                // if ($this->builder->getLib('zstd')) {
-                //     $arg .= ' --enable-redis-zstd --with-libzstd ';
-                // }
-                break;
-            case 'xml':
-            case 'soap':
-            case 'xmlreader':
-            case 'xmlwriter':
-            case 'dom':
-                $arg .= ' --with-libxml ';
-                break;
-            case 'swow':
-                if ($this->builder->getLib('openssl')) {
-                    $arg .= ' --enable-swow-ssl';
-                }
-                if ($this->builder->getLib('curl')) {
-                    $arg .= ' --enable-swow-curl';
-                }
-                break;
-        }
-        return $arg;
-    }
-
-    private function getUnixConfigureArg(): string
-    {
-        $arg = '';
-        switch ($this->name) {
-            /*case 'event':
-                $arg = ' --with-event-core --with-event-libevent-dir="' . BUILD_ROOT_PATH . '"';
-                if ($this->builder->getLib('openssl')) {
-                    $arg .= ' --with-event-openssl --with-openssl-dir="' . BUILD_ROOT_PATH . '"';
-                }
-                break;*/
-            case 'mbstring':
-                $arg = ' --disable-mbregex ONIG_CFLAGS=-I"' . BUILD_ROOT_PATH . '" ' .
-                'ONIG_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'gmp':
-                $arg = ' --with-gmp="' . BUILD_ROOT_PATH . '" ';
-                break;
-            case 'sqlite3':
-                $arg = ' --with-sqlite3="' . BUILD_ROOT_PATH . '" ' .
-                'SQLITE_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                'SQLITE_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'redis':
-                $arg = ' --enable-redis --disable-redis-session';
-                if ($this->builder->getLib('zstd')) {
-                    $arg .= ' --enable-redis-zstd --with-libzstd="' . BUILD_ROOT_PATH . '" ';
-                }
-                break;
-            case 'yaml':
-                $arg .= ' --with-yaml="' . BUILD_ROOT_PATH . '" ';
-                break;
-            case 'zstd':
-                $arg .= ' --with-libzstd';
-                break;
-            case 'bz2':
-                $arg = ' --with-bz2="' . BUILD_ROOT_PATH . '" ';
-                break;
-            case 'openssl':
-                $arg .= ' ' .
-                    'OPENSSL_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'OPENSSL_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'curl':
-                $arg .= ' ' .
-                    'CURL_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'CURL_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'gd':
-                if ($this->builder->getLib('freetype')) {
-                    $arg .= ' --with-freetype ' .
-                    'FREETYPE2_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '/freetype2" ' .
-                    'FREETYPE2_LIBS="' . $this->getLibFilesString() . '" ';
-                }
-                $arg .= ' ' .
-                    'PNG_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'PNG_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-                // TODO: other libraries
-            case 'phar':
-            case 'zlib':
-                $arg .= ' ' .
-                    'ZLIB_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'ZLIB_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'xml': // xml may use expat
-                if ($this->getLibraryDependencies()['expat'] ?? null) {
-                    $arg .= ' --with-expat="' . BUILD_ROOT_PATH . '" ' .
-                        'EXPAT_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                        'EXPAT_LIBS="' . $this->getLibFilesString() . '" ';
-                    break;
-                }
-                // no break
-            case 'soap':
-            case 'xmlreader':
-            case 'xmlwriter':
-            case 'dom':
-                $arg .= ' --with-libxml="' . BUILD_ROOT_PATH . '" ' .
-                    'LIBXML_CFLAGS=-I"' . realpath('include/libxml2') . '" ' .
-                    'LIBXML_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'ffi':
-                $arg .= ' ' .
-                    'FFI_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'FFI_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'zip':
-                $arg .= ' ' .
-                    'LIBZIP_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'LIBZIP_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'mbregex':
-                $arg .= ' ' .
-                    'ONIG_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ' .
-                    'ONIG_LIBS="' . $this->getLibFilesString() . '" ';
-                break;
-            case 'swow':
-                $arg .= $this->builder->getLib('openssl') ? ' --enable-swow-ssl' : ' --disable-swow-ssl';
-                $arg .= $this->builder->getLib('curl') ? ' --enable-swow-curl' : ' --disable-swow-curl';
-                $arg .= ' SWOW_UV_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '" ';
-                break;
-            case 'swoole':
-                if ($this->builder->getLib('openssl')) {
-                    $arg .= ' --enable-openssl';
-                } else {
-                    $arg .= ' --disable-openssl --without-openssl';
-                }
-        }
-        return $arg;
-    }
-
     private function getLibraryDependencies(bool $recursive = false): array
     {
         $ret = array_filter($this->dependencies, fn ($x) => $x instanceof LibraryBase);

src/SPC/builder/LibraryBase.php

@@ -6,22 +6,20 @@ namespace SPC\builder;
 
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 
-/**
- * Lib 库的基类操作对象
- */
 abstract class LibraryBase
 {
-    /** @var string lib 依赖名称，必须重写 */
+    /** @var string */
     public const NAME = 'unknown';
 
-    /** @var string lib 依赖的根目录 */
     protected string $source_dir;
 
-    /** @var array 依赖列表 */
     protected array $dependencies = [];
 
+    protected bool $patched = false;
+
     /**
      * @throws RuntimeException
      */
@@ -34,7 +32,7 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取 lib 库的根目录
+     * Get current lib source root dir.
      */
     public function getSourceDir(): string
     {
@@ -42,10 +40,9 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取当前 lib 库的所有依赖列表
+     * Get current lib dependencies.
      *
-     * @param  bool                       $recursive 是否递归获取（默认为 False）
-     * @return array<string, LibraryBase> 依赖的 Map
+     * @return array<string, LibraryBase>
      */
     public function getDependencies(bool $recursive = false): array
     {
@@ -54,7 +51,6 @@ abstract class LibraryBase
             return $this->dependencies;
         }
 
-        // 下面为递归获取依赖列表，根据依赖顺序
         $deps = [];
 
         $added = 1;
@@ -77,20 +73,21 @@ abstract class LibraryBase
     }
 
     /**
-     * 计算依赖列表，不符合依赖将抛出异常
+     * Calculate dependencies for current library.
      *
      * @throws RuntimeException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function calcDependency(): void
     {
-        // 先从配置文件添加依赖，这里根据不同的操作系统分别选择不同的元信息
+        // Add dependencies from the configuration file. Here, choose different metadata based on the operating system.
         /*
-        选择规则：
-            如果是 Windows 系统，则依次尝试有无 lib-depends-windows、lib-depends-win、lib-depends。
-            如果是 macOS 系统，则依次尝试 lib-depends-darwin、lib-depends-unix、lib-depends。
-            如果是 Linux 系统，则依次尝试 lib-depends-linux、lib-depends-unix、lib-depends。
-         */
+        Rules:
+            If it is a Windows system, try the following dependencies in order: lib-depends-windows, lib-depends-win, lib-depends.
+            If it is a macOS system, try the following dependencies in order: lib-depends-darwin, lib-depends-unix, lib-depends.
+            If it is a Linux system, try the following dependencies in order: lib-depends-linux, lib-depends-unix, lib-depends.
+        */
         foreach (Config::getLib(static::NAME, 'lib-depends', []) as $dep_name) {
             $this->addLibraryDependency($dep_name);
         }
@@ -100,11 +97,10 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取当前库编译出来获取到的静态库文件列表
+     * Get config static libs.
      *
-     * @return string[]            获取编译出来后的需要的静态库文件列表
      * @throws FileSystemException
-     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function getStaticLibs(): array
     {
@@ -112,11 +108,10 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取当前 lib 编译出来的 C Header 文件列表
+     * Get config headers.
      *
-     * @return string[]            获取编译出来后需要的 C Header 文件列表
      * @throws FileSystemException
-     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function getHeaders(): array
     {
@@ -124,67 +119,89 @@ abstract class LibraryBase
     }
 
     /**
-     * 证明该库是否已编译好且就绪，如果没有就绪，内部会调用 build 来进行构建该库
+     * Try to build this library, before build, we check first.
+     *
+     * BUILD_STATUS_OK if build success
+     * BUILD_STATUS_ALREADY if already built
+     * BUILD_STATUS_FAILED if build failed
      *
      * @throws RuntimeException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function tryBuild(bool $force_build = false): int
     {
-        // 传入 true，表明直接编译
+        if (file_exists($this->source_dir . '/.spc.patched')) {
+            $this->patched = true;
+        }
+        // force means just build
         if ($force_build) {
+            logger()->info('Building required library [' . static::NAME . ']');
+            if (!$this->patched && $this->patchBeforeBuild()) {
+                file_put_contents($this->source_dir . '/.spc.patched', 'PATCHED!!!');
+            }
             $this->build();
             return BUILD_STATUS_OK;
         }
 
-        // 看看这些库是不是存在，如果不存在，则调用编译并返回结果状态
+        // check if these libraries exist, if not, invoke compilation and return the result status
         foreach ($this->getStaticLibs() as $name) {
             if (!file_exists(BUILD_LIB_PATH . "/{$name}")) {
                 $this->tryBuild(true);
                 return BUILD_STATUS_OK;
             }
         }
-        // 头文件同理
+        // header files the same
         foreach ($this->getHeaders() as $name) {
             if (!file_exists(BUILD_INCLUDE_PATH . "/{$name}")) {
                 $this->tryBuild(true);
                 return BUILD_STATUS_OK;
             }
         }
-        // 到这里说明所有的文件都存在，就跳过编译
+        // pkg-config is treated specially. If it is pkg-config, check if the pkg-config binary exists
+        if (static::NAME === 'pkg-config' && !file_exists(BUILD_ROOT_PATH . '/bin/pkg-config')) {
+            $this->tryBuild(true);
+            return BUILD_STATUS_OK;
+        }
+        // if all the files exist at this point, skip the compilation process
         return BUILD_STATUS_ALREADY;
     }
 
     /**
-     * 获取构建当前 lib 的 Builder 对象
+     * Patch before build, overwrite this and return true to patch libs.
+     */
+    public function patchBeforeBuild(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get current builder object.
      */
     abstract public function getBuilder(): BuilderBase;
 
     /**
-     * 构建该库需要调用的命令和操作
+     * Build this library.
      *
      * @throws RuntimeException
      */
     abstract protected function build();
 
     /**
-     * 添加 lib 库的依赖库
+     * Add lib dependency
      *
-     * @param  string           $name     依赖名称
-     * @param  bool             $optional 是否是可选依赖（默认为 False）
      * @throws RuntimeException
      */
     protected function addLibraryDependency(string $name, bool $optional = false): void
     {
-        // Log::i("add $name as dep of {$this->name}");
         $dep_lib = $this->getBuilder()->getLib($name);
-        if (!$dep_lib) {
-            if (!$optional) {
-                throw new RuntimeException(static::NAME . " requires library {$name}");
-            }
-            logger()->debug('enabling ' . static::NAME . " without {$name}");
-        } else {
+        if ($dep_lib) {
             $this->dependencies[$name] = $dep_lib;
+            return;
         }
+        if (!$optional) {
+            throw new RuntimeException(static::NAME . " requires library {$name}");
+        }
+        logger()->debug('enabling ' . static::NAME . " without {$name}");
     }
 }

src/SPC/builder/extension/bz2.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\builder\macos\MacOSBuilder;
+use SPC\exception\FileSystemException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('bz2')]
+class bz2 extends Extension
+{
+    /**
+     * @throws FileSystemException
+     * @throws WrongUsageException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        $frameworks = $this->builder instanceof MacOSBuilder ? ' ' . $this->builder->getFrameworks(true) . ' ' : '';
+        FileSystem::replaceFileRegex(SOURCE_PATH . '/php-src/configure', '/-lbz2/', $this->getLibFilesString() . $frameworks);
+        return true;
+    }
+}

src/SPC/builder/extension/curl.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\builder\macos\MacOSBuilder;
+use SPC\exception\FileSystemException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('curl')]
+class curl extends Extension
+{
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeBuildconf(): bool
+    {
+        logger()->info('patching before-configure for curl checks');
+        $file1 = "AC_DEFUN([PHP_CHECK_LIBRARY], [\n  $3\n])";
+        $files = FileSystem::readFile(SOURCE_PATH . '/php-src/ext/curl/config.m4');
+        $file2 = 'AC_DEFUN([PHP_CHECK_LIBRARY], [
+  save_old_LDFLAGS=$LDFLAGS
+  ac_stuff="$5"
+
+  save_ext_shared=$ext_shared
+  ext_shared=yes
+  PHP_EVAL_LIBLINE([$]ac_stuff, LDFLAGS)
+  AC_CHECK_LIB([$1],[$2],[
+    LDFLAGS=$save_old_LDFLAGS
+    ext_shared=$save_ext_shared
+    $3
+  ],[
+    LDFLAGS=$save_old_LDFLAGS
+    ext_shared=$save_ext_shared
+    unset ac_cv_lib_$1[]_$2
+    $4
+  ])dnl
+])';
+        file_put_contents(SOURCE_PATH . '/php-src/ext/curl/config.m4', $file1 . "\n" . $files . "\n" . $file2);
+        return true;
+    }
+
+    /**
+     * @throws FileSystemException
+     * @throws WrongUsageException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        $frameworks = $this->builder instanceof MacOSBuilder ? ' ' . $this->builder->getFrameworks(true) . ' ' : '';
+        FileSystem::replaceFileRegex(SOURCE_PATH . '/php-src/configure', '/-lcurl/', $this->getLibFilesString() . $frameworks);
+        return true;
+    }
+}

src/SPC/builder/extension/enchant.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('enchant')]
+class enchant extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $glibs = [
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgio-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libglib-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgmodule-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgobject-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libgthread-2.0.a',
+            '/Users/jerry/project/git-project/static-php-cli/buildroot/lib/libintl.a',
+        ];
+        $arg = '--with-enchant="' . BUILD_ROOT_PATH . '"';
+        $arg .= ' ENCHANT2_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '/enchant-2"';
+        $arg .= ' ENCHANT2_LIBS="' . $this->getLibFilesString() . '"';
+        $arg .= ' GLIB_CFLAGS=-I"' . BUILD_INCLUDE_PATH . '"';
+        $arg .= ' GLIB_LIBS="' . implode(' ', $glibs) . '"';
+        return $arg;
+    }
+}

src/SPC/builder/extension/event.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('event')]
+class event extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--with-event-core --with-event-extra --with-event-libevent-dir=' . BUILD_ROOT_PATH;
+        if ($this->builder->getLib('openssl')) {
+            $arg .= ' --with-event-openssl=' . BUILD_ROOT_PATH;
+        }
+        if ($this->builder->getExt('sockets')) {
+            $arg .= ' --enable-event-sockets';
+        } else {
+            $arg .= ' --disable-event-sockets';
+        }
+        return $arg;
+    }
+
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        FileSystem::replaceFileRegex(SOURCE_PATH . '/php-src/configure', '/-levent_openssl/', $this->getLibFilesString());
+        return true;
+    }
+}

src/SPC/builder/extension/ffi.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('ffi')]
+class ffi extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-ffi --enable-zend-signals';
+    }
+}

src/SPC/builder/extension/gd.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('gd')]
+class gd extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-gd';
+        $arg .= $this->builder->getLib('freetype') ? ' --with-freetype' : '';
+        $arg .= $this->builder->getLib('libjpeg') ? ' --with-jpeg' : '';
+        $arg .= $this->builder->getLib('libwebp') ? ' --with-webp' : '';
+        $arg .= $this->builder->getLib('libavif') ? ' --with-avif' : '';
+        return $arg;
+    }
+}

src/SPC/builder/extension/glfw.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('glfw')]
+class glfw extends Extension
+{
+    /**
+     * @throws RuntimeException
+     */
+    public function patchBeforeBuildconf(): bool
+    {
+        FileSystem::copyDir(SOURCE_PATH . '/ext-glfw', SOURCE_PATH . '/php-src/ext/glfw');
+        return true;
+    }
+
+    public function getUnixConfigureArg(): string
+    {
+        return '--enable-glfw --with-glfw-dir=' . BUILD_ROOT_PATH;
+    }
+}

src/SPC/builder/extension/iconv.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\builder\macos\MacOSBuilder;
+use SPC\util\CustomExt;
+
+#[CustomExt('iconv')]
+class iconv extends Extension
+{
+    public function patchBeforeConfigure(): bool
+    {
+        // macOS need to link iconv dynamically, we add it to extra-libs
+        if (!$this->builder instanceof MacOSBuilder) {
+            return false;
+        }
+        $extra_libs = $this->builder->getOption('extra-libs', '');
+        if (!str_contains($extra_libs, '-liconv')) {
+            $extra_libs .= ' -liconv';
+        }
+        $this->builder->setOption('extra-libs', $extra_libs);
+        return true;
+    }
+}

src/SPC/builder/extension/imagick.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('imagick')]
+class imagick extends Extension
+{
+    public function patchBeforeMake(): bool
+    {
+        // imagick may call omp_pause_all which requires -lgomp
+        $extra_libs = $this->builder->getOption('extra-libs', '');
+        $extra_libs .= ' -lgomp ';
+        $this->builder->setOption('extra-libs', $extra_libs);
+        return true;
+    }
+
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-imagick=' . BUILD_ROOT_PATH;
+    }
+}

src/SPC/builder/extension/mbregex.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('mbregex')]
+class mbregex extends Extension
+{
+    public function getDistName(): string
+    {
+        return 'mbstring';
+    }
+
+    public function getConfigureArg(): string
+    {
+        return '';
+    }
+}

src/SPC/builder/extension/mbstring.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('mbstring')]
+class mbstring extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-mbstring';
+        if ($this->builder->getExt('mbregex') === null) {
+            $arg .= ' --disable-mbregex';
+        }
+        return $arg;
+    }
+}

src/SPC/builder/extension/memcache.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('memcache')]
+class memcache extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--enable-memcache --with-zlib-dir=' . BUILD_ROOT_PATH;
+    }
+
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeBuildconf(): bool
+    {
+        FileSystem::replaceFileStr(
+            SOURCE_PATH . '/php-src/ext/memcache/config9.m4',
+            'if test -d $abs_srcdir/src ; then',
+            'if test -d $abs_srcdir/main ; then'
+        );
+        FileSystem::replaceFileStr(
+            SOURCE_PATH . '/php-src/ext/memcache/config9.m4',
+            'export CPPFLAGS="$CPPFLAGS $INCLUDES"',
+            'export CPPFLAGS="$CPPFLAGS $INCLUDES -I$abs_srcdir/main"'
+        );
+        // add for in-tree building
+        file_put_contents(
+            SOURCE_PATH . '/php-src/ext/memcache/php_memcache.h',
+            <<<'EOF'
+#ifndef PHP_MEMCACHE_H
+#define PHP_MEMCACHE_H
+
+extern zend_module_entry memcache_module_entry;
+#define phpext_memcache_ptr &memcache_module_entry
+
+#endif
+EOF
+        );
+        return true;
+    }
+}

src/SPC/builder/extension/memcached.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('memcached')]
+class memcached extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $rootdir = BUILD_ROOT_PATH;
+        return "--enable-memcached --with-zlib-dir={$rootdir} --with-libmemcached-dir={$rootdir} --disable-memcached-sasl --enable-memcached-json";
+    }
+}

src/SPC/builder/extension/mongodb.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('mongodb')]
+class mongodb extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = ' --enable-mongodb ';
+        $arg .= ' --with-mongodb-system-libs=no --with-mongodb-client-side-encryption=no ';
+        $arg .= ' --with-mongodb-sasl=no  ';
+        if ($this->builder->getLib('openssl')) {
+            $arg .= '--with-mongodb-ssl=openssl';
+        }
+        $arg .= $this->builder->getLib('icu') ? ' --with-mongodb-icu=yes ' : ' --with-mongodb-icu=no ';
+        $arg .= $this->builder->getLib('zstd') ? ' --with-mongodb-zstd=yes ' : ' --with-mongodb-zstd=no ';
+        // $arg .= $this->builder->getLib('snappy') ? ' --with-mongodb-snappy=yes ' : ' --with-mongodb-snappy=no ';
+        $arg .= $this->builder->getLib('zlib') ? ' --with-mongodb-zlib=yes ' : ' --with-mongodb-zlib=bundled ';
+        return $arg;
+    }
+}

src/SPC/builder/extension/opcache.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('opcache')]
+class opcache extends Extension
+{
+    public function getDistName(): string
+    {
+        return 'Zend Opcache';
+    }
+}

src/SPC/builder/extension/openssl.php

@@ -0,0 +1,30 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('openssl')]
+class openssl extends Extension
+{
+    public function patchBeforeMake(): bool
+    {
+        // patch openssl3 with php8.0 bug
+        if (file_exists(SOURCE_PATH . '/openssl/VERSION.dat') && $this->builder->getPHPVersionID() < 80100) {
+            $openssl_c = file_get_contents(SOURCE_PATH . '/php-src/ext/openssl/openssl.c');
+            $openssl_c = preg_replace('/REGISTER_LONG_CONSTANT\s*\(\s*"OPENSSL_SSLV23_PADDING"\s*.+;/', '', $openssl_c);
+            file_put_contents(SOURCE_PATH . '/php-src/ext/openssl/openssl.c', $openssl_c);
+            return true;
+        }
+
+        return false;
+    }
+
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-openssl=' . BUILD_ROOT_PATH . ' --with-openssl-dir=' . BUILD_ROOT_PATH;
+    }
+}

src/SPC/builder/extension/pdo_sqlite.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('pdo_sqlite')]
+class pdo_sqlite extends Extension
+{
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/php-src/configure',
+            '/sqlite3_column_table_name=yes/',
+            'sqlite3_column_table_name=no'
+        );
+        return true;
+    }
+}

src/SPC/builder/extension/pgsql.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('pgsql')]
+class pgsql extends Extension
+{
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/php-src/configure',
+            '/-lpq/',
+            $this->getLibFilesString()
+        );
+        return true;
+    }
+}

src/SPC/builder/extension/readline.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('readline')]
+class readline extends Extension
+{
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/php-src/configure',
+            '/-lncurses/',
+            $this->getLibFilesString()
+        );
+        return true;
+    }
+}

src/SPC/builder/extension/redis.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('redis')]
+class redis extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-redis';
+        if (!$this->builder->getExt('session')) {
+            $arg .= ' --disable-redis-session';
+        } else {
+            $arg .= ' --enable-redis-session';
+        }
+        if ($this->builder->getLib('zstd')) {
+            $arg .= ' --enable-redis-zstd --with-libzstd="' . BUILD_ROOT_PATH . '"';
+        }
+        return $arg;
+    }
+}

src/SPC/builder/extension/snappy.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\builder\macos\MacOSBuilder;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('snappy')]
+class snappy extends Extension
+{
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/php-src/configure',
+            '/-lsnappy/',
+            $this->getLibFilesString() . ($this->builder instanceof MacOSBuilder ? ' -lc++' : ' -lstdc++')
+        );
+        return true;
+    }
+
+    public function getUnixConfigureArg(): string
+    {
+        return '--enable-snappy --with-snappy-includedir="' . BUILD_ROOT_PATH . '"';
+    }
+}

src/SPC/builder/extension/ssh2.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
+use SPC\util\CustomExt;
+
+#[CustomExt('ssh2')]
+class ssh2 extends Extension
+{
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeConfigure(): bool
+    {
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/php-src/configure',
+            '/-lssh2/',
+            $this->getLibFilesString()
+        );
+        return true;
+    }
+}

src/SPC/builder/extension/swoole.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('swoole')]
+class swoole extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-swoole';
+        $arg .= $this->builder->getExt('pgsql') ? ' --enable-swoole-pgsql' : ' --disable-swoole-pgsql';
+        $arg .= $this->builder->getLib('openssl') ? ' --enable-openssl' : ' --disable-openssl --without-openssl';
+        $arg .= $this->builder->getLib('brotli') ? (' --enable-brotli --with-brotli-dir=' . BUILD_ROOT_PATH) : '';
+        // curl hook is buggy for static php
+        $arg .= ' --disable-swoole-curl';
+        return $arg;
+    }
+}

src/SPC/builder/extension/swow.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\util\CustomExt;
+
+#[CustomExt('swow')]
+class swow extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        $arg = '--enable-swow';
+        $arg .= $this->builder->getLib('openssl') ? ' --enable-swow-ssl' : ' --disable-swow-ssl';
+        $arg .= $this->builder->getLib('curl') ? ' --enable-swow-curl' : ' --disable-swow-curl';
+        return $arg;
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function patchBeforeBuildconf(): bool
+    {
+        if ($this->builder->getPHPVersionID() >= 80000 && !is_link(SOURCE_PATH . '/php-src/ext/swow')) {
+            if (PHP_OS_FAMILY === 'Windows') {
+                f_passthru('cd ' . SOURCE_PATH . '/php-src/ext && mklink /D swow swow-src\ext');
+            } else {
+                f_passthru('cd ' . SOURCE_PATH . '/php-src/ext && ln -s swow-src/ext swow');
+            }
+            return true;
+        }
+        return false;
+    }
+}

src/SPC/builder/extension/xlswriter.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('xlswriter')]
+class xlswriter extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-xlswriter --enable-reader';
+    }
+}

src/SPC/builder/extension/xml.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
+use SPC\util\CustomExt;
+
+#[CustomExt('xml')]
+#[CustomExt('soap')]
+#[CustomExt('xmlreader')]
+#[CustomExt('xmlwriter')]
+#[CustomExt('dom')]
+#[CustomExt('simplexml')]
+class xml extends Extension
+{
+    /**
+     * @throws RuntimeException
+     */
+    public function getUnixConfigureArg(): string
+    {
+        $arg = match ($this->name) {
+            'xml' => '--enable-xml',
+            'soap' => '--enable-soap',
+            'xmlreader' => '--enable-xmlreader',
+            'xmlwriter' => '--enable-xmlwriter',
+            'dom' => '--enable-dom',
+            'simplexml' => '--enable-simplexml',
+            default => throw new RuntimeException('Not accept non-xml extension'),
+        };
+        $arg .= ' --with-libxml="' . BUILD_ROOT_PATH . '"';
+        return $arg;
+    }
+}

src/SPC/builder/extension/zlib.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('zlib')]
+class zlib extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--with-zlib --with-zlib-dir="' . BUILD_ROOT_PATH . '"';
+    }
+}

src/SPC/builder/extension/zstd.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+
+#[CustomExt('zstd')]
+class zstd extends Extension
+{
+    public function getUnixConfigureArg(): string
+    {
+        return '--enable-zstd --with-libzstd="' . BUILD_ROOT_PATH . '"';
+    }
+}

src/SPC/builder/freebsd/BSDBuilder.php

@@ -0,0 +1,253 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\traits\UnixBuilderTrait;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+use SPC\store\SourcePatcher;
+
+class BSDBuilder extends BuilderBase
+{
+    /** Unix compatible builder methods */
+    use UnixBuilderTrait;
+
+    /** @var bool Micro patch phar flag */
+    private bool $phar_patched = false;
+
+    /**
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     * @throws FileSystemException
+     */
+    public function __construct(array $options = [])
+    {
+        $this->options = $options;
+
+        // ---------- set necessary options ----------
+        // set C Compiler (default: clang)
+        f_putenv('CC=' . $this->getOption('cc', 'clang'));
+        // set C++ Composer (default: clang++)
+        f_putenv('CXX=' . $this->getOption('cxx', 'clang++'));
+        // set PATH
+        f_putenv('PATH=' . BUILD_ROOT_PATH . '/bin:' . getenv('PATH'));
+        // set PKG_CONFIG
+        f_putenv('PKG_CONFIG=' . BUILD_ROOT_PATH . '/bin/pkg-config');
+        // set PKG_CONFIG_PATH
+        f_putenv('PKG_CONFIG_PATH=' . BUILD_LIB_PATH . '/pkgconfig/');
+
+        // set arch (default: current)
+        $this->setOptionIfNotExist('arch', php_uname('m'));
+        $this->setOptionIfNotExist('gnu-arch', arch2gnu($this->getOption('arch')));
+
+        // ---------- set necessary compile environments ----------
+        // concurrency
+        $this->concurrency = SystemUtil::getCpuCount();
+        // cflags
+        $this->arch_c_flags = SystemUtil::getArchCFlags($this->getOption('arch'));
+        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->getOption('arch'));
+        // cmake toolchain
+        $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile('BSD', $this->getOption('arch'), $this->arch_c_flags);
+
+        // create pkgconfig and include dir (some libs cannot create them automatically)
+        f_mkdir(BUILD_LIB_PATH . '/pkgconfig', recursive: true);
+        f_mkdir(BUILD_INCLUDE_PATH, recursive: true);
+    }
+
+    /**
+     * Just start to build statically linked php binary
+     *
+     * @param  int                 $build_target build target
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
+    {
+        // ---------- Update extra-libs ----------
+        $extra_libs = $this->getOption('extra-libs', '');
+        // add libc++, some extensions or libraries need it (C++ cannot be linked statically)
+        $extra_libs .= (empty($extra_libs) ? '' : ' ') . ($this->hasCpp() ? '-lc++ ' : '');
+        if (!$this->getOption('bloat', false)) {
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', $this->getAllStaticLibFiles());
+        } else {
+            logger()->info('bloat linking');
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', array_map(fn ($x) => "-Wl,-force_load,{$x}", array_filter($this->getAllStaticLibFiles())));
+        }
+        $this->setOption('extra-libs', $extra_libs);
+
+        SourcePatcher::patchBeforeBuildconf($this);
+
+        shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
+
+        SourcePatcher::patchBeforeConfigure($this);
+
+        $json_74 = $this->getPHPVersionID() < 80000 ? '--enable-json ' : '';
+        $zts = $this->getOption('enable-zts', false) ? '--enable-zts --disable-zend-signals ' : '';
+
+        $enableCli = ($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI;
+        $enableFpm = ($build_target & BUILD_TARGET_FPM) === BUILD_TARGET_FPM;
+        $enableMicro = ($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO;
+        $enableEmbed = ($build_target & BUILD_TARGET_EMBED) === BUILD_TARGET_EMBED;
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec(
+                './configure ' .
+                '--prefix= ' .
+                '--with-valgrind=no ' .     // Not detect memory leak
+                '--enable-shared=no ' .
+                '--enable-static=yes ' .
+                "CFLAGS='{$this->arch_c_flags} -Werror=unknown-warning-option' " .
+                '--disable-all ' .
+                '--disable-cgi ' .
+                '--disable-phpdbg ' .
+                ($enableCli ? '--enable-cli ' : '--disable-cli ') .
+                ($enableFpm ? '--enable-fpm ' : '--disable-fpm ') .
+                ($enableEmbed ? '--enable-embed=static ' : '--disable-embed ') .
+                ($enableMicro ? '--enable-micro ' : '--disable-micro ') .
+                $json_74 .
+                $zts .
+                $this->makeExtensionArgs()
+            );
+
+        SourcePatcher::patchBeforeMake($this);
+
+        $this->cleanMake();
+
+        if ($enableCli) {
+            logger()->info('building cli');
+            $this->buildCli();
+        }
+        if ($enableFpm) {
+            logger()->info('building fpm');
+            $this->buildFpm();
+        }
+        if ($enableMicro) {
+            logger()->info('building micro');
+            $this->buildMicro();
+        }
+        if ($enableEmbed) {
+            logger()->info('building embed');
+            if ($enableMicro) {
+                FileSystem::replaceFileStr(SOURCE_PATH . '/php-src/Makefile', 'OVERALL_TARGET =', 'OVERALL_TARGET = libphp.la');
+            }
+            $this->buildEmbed();
+        }
+
+        if (php_uname('m') === $this->getOption('arch')) {
+            $this->sanityCheck($build_target);
+        }
+    }
+
+    /**
+     * Build cli sapi
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildCli(): void
+    {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a",
+        ]);
+
+        $shell = shell()->cd(SOURCE_PATH . '/php-src');
+        $shell->exec('sed -ie "s|//lib|/lib|g" Makefile');
+        $shell->exec("make -j{$this->concurrency} {$vars} cli");
+        if (!$this->getOption('no-strip', false)) {
+            $shell->exec('strip sapi/cli/php');
+        }
+        $this->deployBinary(BUILD_TARGET_CLI);
+    }
+
+    /**
+     * Build phpmicro sapi
+     *
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function buildMicro(): void
+    {
+        if ($this->getPHPVersionID() < 80000) {
+            throw new WrongUsageException('phpmicro only support PHP >= 8.0!');
+        }
+        if ($this->getExt('phar')) {
+            $this->phar_patched = true;
+            SourcePatcher::patchMicro(['phar']);
+        }
+
+        $enable_fake_cli = $this->getOption('with-micro-fake-cli', false) ? ' -DPHP_MICRO_FAKE_CLI' : '';
+        $vars = [
+            // with debug information, optimize for size, remove identifiers, patch fake cli for micro
+            'EXTRA_CFLAGS' => '-g -Os' . $enable_fake_cli,
+            // link resolv library (macOS needs it)
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a",
+        ];
+        $vars = SystemUtil::makeEnvVarString($vars);
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec("make -j{$this->concurrency} {$vars} micro");
+
+        if (!$this->getOption('no-strip', false)) {
+            shell()->cd(SOURCE_PATH . '/php-src/sapi/micro')->exec('strip --strip-all micro.sfx');
+        }
+        $this->deployBinary(BUILD_TARGET_MICRO);
+
+        if ($this->phar_patched) {
+            SourcePatcher::patchMicro(['phar'], true);
+        }
+    }
+
+    /**
+     * Build fpm sapi
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildFpm(): void
+    {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a", // link resolv library (macOS needs it)
+        ]);
+
+        $shell = shell()->cd(SOURCE_PATH . '/php-src');
+        $shell->exec("make -j{$this->concurrency} {$vars} fpm");
+        if (!$this->getOption('no-strip', false)) {
+            $shell->exec('strip sapi/fpm/php-fpm');
+        }
+        $this->deployBinary(BUILD_TARGET_FPM);
+    }
+
+    /**
+     * Build embed sapi
+     *
+     * @throws RuntimeException
+     */
+    public function buildEmbed(): void
+    {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} /usr/lib/libm.a", // link resolv library (macOS needs it)
+        ]);
+
+        shell()
+            ->cd(SOURCE_PATH . '/php-src')
+            ->exec('make INSTALL_ROOT=' . BUILD_ROOT_PATH . " -j{$this->concurrency} {$vars} install")
+            // Workaround for https://github.com/php/php-src/issues/12082
+            ->exec('rm -Rf ' . BUILD_ROOT_PATH . '/lib/php-o')
+            ->exec('mkdir ' . BUILD_ROOT_PATH . '/lib/php-o')
+            ->cd(BUILD_ROOT_PATH . '/lib/php-o')
+            ->exec('ar x ' . BUILD_ROOT_PATH . '/lib/libphp.a')
+            ->exec('rm ' . BUILD_ROOT_PATH . '/lib/libphp.a')
+            ->exec('ar rcs ' . BUILD_ROOT_PATH . '/lib/libphp.a *.o')
+            ->exec('rm -Rf ' . BUILD_ROOT_PATH . '/lib/php-o');
+    }
+}

src/SPC/builder/freebsd/SystemUtil.php

@@ -0,0 +1,46 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd;
+
+use SPC\builder\traits\UnixSystemUtilTrait;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class SystemUtil
+{
+    /** Unix System Util Compatible */
+    use UnixSystemUtilTrait;
+
+    /**
+     * Get Logic CPU Count for macOS
+     *
+     * @throws RuntimeException
+     */
+    public static function getCpuCount(): int
+    {
+        [$ret, $output] = shell()->execWithResult('sysctl -n hw.ncpu');
+        if ($ret !== 0) {
+            throw new RuntimeException('Failed to get cpu count');
+        }
+
+        return (int) $output[0];
+    }
+
+    /**
+     * Get Target Arch CFlags
+     *
+     * @param  string              $arch Arch Name
+     * @return string              return Arch CFlags string
+     * @throws WrongUsageException
+     */
+    public static function getArchCFlags(string $arch): string
+    {
+        return match ($arch) {
+            'amd64', 'x86_64' => '--target=x86_64-unknown-freebsd',
+            'arm64','aarch64' => '--target=aarch-unknown-freebsd',
+            default => throw new WrongUsageException('unsupported arch: ' . $arch),
+        };
+    }
+}

src/SPC/builder/freebsd/library/BSDLibraryBase.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\freebsd\BSDBuilder;
+use SPC\builder\LibraryBase;
+use SPC\builder\traits\UnixLibraryTrait;
+
+abstract class BSDLibraryBase extends LibraryBase
+{
+    use UnixLibraryTrait;
+
+    protected array $headers;
+
+    public function __construct(protected BSDBuilder $builder)
+    {
+        parent::__construct();
+    }
+
+    public function getBuilder(): BuilderBase
+    {
+        return $this->builder;
+    }
+}

src/SPC/builder/freebsd/library/bzip2.php

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

src/SPC/builder/freebsd/library/curl.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+class curl extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\curl;
+
+    public const NAME = 'curl';
+
+    public function getStaticLibFiles(string $style = 'autoconf', bool $recursive = true): string
+    {
+        $libs = parent::getStaticLibFiles($style, $recursive);
+        if ($this->builder->getLib('openssl')) {
+            $this->builder->setOption('extra-libs', $this->builder->getOption('extra-libs') . ' /usr/lib/libpthread.a /usr/lib/libdl.a');
+        }
+        return $libs;
+    }
+}

src/SPC/builder/freebsd/library/onig.php

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

src/SPC/builder/freebsd/library/openssl.php

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+use SPC\builder\macos\library\MacOSLibraryBase;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class openssl extends BSDLibraryBase
+{
+    public const NAME = 'openssl';
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
+    {
+        [$lib,,$destdir] = SEPARATED_PATH;
+
+        // lib:zlib
+        $extra = '';
+        $ex_lib = '';
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof MacOSLibraryBase) {
+            $extra = 'zlib';
+            $ex_lib = trim($zlib->getStaticLibFiles() . ' ' . $ex_lib);
+        }
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "./Configure no-shared {$extra} " .
+                '--prefix=/ ' . // use prefix=/
+                "--libdir={$lib} " .
+                '--openssldir=/etc/ssl ' .
+                'BSD-' . arch2gnu($this->builder->getOption('arch'))
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")
+            ->exec("make install_sw DESTDIR={$destdir}");
+        $this->patchPkgconfPrefix(['libssl.pc', 'openssl.pc', 'libcrypto.pc']);
+    }
+}

src/SPC/builder/freebsd/library/pkgconfig.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\freebsd\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class pkgconfig extends BSDLibraryBase
+{
+    use \SPC\builder\unix\library\pkgconfig;
+
+    public const NAME = 'pkg-config';
+}

src/SPC/builder/freebsd/library/zlib.php

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

src/SPC/builder/linux/LinuxBuilder.php

@@ -0,0 +1,331 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\linux\library\LinuxLibraryBase;
+use SPC\builder\traits\UnixBuilderTrait;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+use SPC\store\SourcePatcher;
+
+class LinuxBuilder extends BuilderBase
+{
+    /** Unix compatible builder methods */
+    use UnixBuilderTrait;
+
+    /** @var array Tune cflags */
+    public array $tune_c_flags;
+
+    /** @var bool Micro patch phar flag */
+    private bool $phar_patched = false;
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function __construct(array $options = [])
+    {
+        $this->options = $options;
+
+        // ---------- set necessary options ----------
+        // set C/C++ compilers (default: alpine: gcc, others: musl-cross-make)
+        if (SystemUtil::isMuslDist()) {
+            f_putenv("CC={$this->getOption('cc', 'gcc')}");
+            f_putenv("CXX={$this->getOption('cxx', 'g++')}");
+            f_putenv("AR={$this->getOption('ar', 'ar')}");
+            f_putenv("LD={$this->getOption('ld', 'ld.gold')}");
+        } else {
+            $arch = arch2gnu(php_uname('m'));
+            f_putenv("CC={$this->getOption('cc', "{$arch}-linux-musl-gcc")}");
+            f_putenv("CXX={$this->getOption('cxx', "{$arch}-linux-musl-g++")}");
+            f_putenv("AR={$this->getOption('ar', "{$arch}-linux-musl-ar")}");
+            f_putenv("LD={$this->getOption('ld', 'ld.gold')}");
+            f_putenv("PATH=/usr/local/musl/bin:/usr/local/musl/{$arch}-linux-musl/bin:" . BUILD_ROOT_PATH . '/bin:' . getenv('PATH'));
+
+            // set library path, some libraries need it. (We cannot use `putenv` here, because cmake will be confused)
+            $this->setOptionIfNotExist('library_path', "LIBRARY_PATH=/usr/local/musl/{$arch}-linux-musl/lib");
+            $this->setOptionIfNotExist('ld_library_path', "LD_LIBRARY_PATH=/usr/local/musl/{$arch}-linux-musl/lib");
+
+            // check musl-cross make installed if we use musl-cross-make
+            if (str_ends_with(getenv('CC'), 'linux-musl-gcc') && !file_exists("/usr/local/musl/bin/{$arch}-linux-musl-gcc")) {
+                throw new WrongUsageException('musl-cross-make not installed, please install it first. (You can use `doctor` command to install it)');
+            }
+        }
+
+        // set PKG_CONFIG
+        f_putenv('PKG_CONFIG=' . BUILD_ROOT_PATH . '/bin/pkg-config');
+        // set PKG_CONFIG_PATH
+        f_putenv('PKG_CONFIG_PATH=' . BUILD_LIB_PATH . '/pkgconfig');
+
+        // set arch (default: current)
+        $this->setOptionIfNotExist('arch', php_uname('m'));
+        $this->setOptionIfNotExist('gnu-arch', arch2gnu($this->getOption('arch')));
+
+        // concurrency
+        $this->concurrency = SystemUtil::getCpuCount();
+        // cflags
+        $this->arch_c_flags = SystemUtil::getArchCFlags(getenv('CC'), $this->getOption('arch'));
+        $this->arch_cxx_flags = SystemUtil::getArchCFlags(getenv('CXX'), $this->getOption('arch'));
+        $this->tune_c_flags = SystemUtil::checkCCFlags(SystemUtil::getTuneCFlags($this->getOption('arch')), getenv('CC'));
+        // cmake toolchain
+        $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile(
+            'Linux',
+            $this->getOption('arch'),
+            $this->arch_c_flags,
+            getenv('CC'),
+            getenv('CXX'),
+        );
+
+        // cross-compiling is not supported yet
+        /*if (php_uname('m') !== $this->arch) {
+            $this->cross_compile_prefix = SystemUtil::getCrossCompilePrefix($this->cc, $this->arch);
+            logger()->info('using cross compile prefix: ' . $this->cross_compile_prefix);
+            $this->configure_env .= " CROSS_COMPILE='{$this->cross_compile_prefix}'";
+        }*/
+
+        // create pkgconfig and include dir (some libs cannot create them automatically)
+        f_mkdir(BUILD_LIB_PATH . '/pkgconfig', recursive: true);
+        f_mkdir(BUILD_INCLUDE_PATH, recursive: true);
+    }
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function makeAutoconfArgs(string $name, array $libSpecs): string
+    {
+        $ret = '';
+        foreach ($libSpecs as $libName => $arr) {
+            $lib = $this->getLib($libName);
+
+            $arr = $arr ?? [];
+
+            $disableArgs = $arr[0] ?? null;
+            $prefix = $arr[1] ?? null;
+            if ($lib instanceof LinuxLibraryBase) {
+                logger()->info("{$name} \033[32;1mwith\033[0;1m {$libName} support");
+                $ret .= $lib->makeAutoconfEnv($prefix) . ' ';
+            } else {
+                logger()->info("{$name} \033[31;1mwithout\033[0;1m {$libName} support");
+                $ret .= ($disableArgs ?? "--with-{$libName}=no") . ' ';
+            }
+        }
+        return rtrim($ret);
+    }
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     * @throws WrongUsageException
+     */
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
+    {
+        // ---------- Update extra-libs ----------
+        $extra_libs = $this->getOption('extra-libs', '');
+        // non-bloat linking
+        if (!$this->getOption('bloat', false)) {
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', $this->getAllStaticLibFiles());
+        } else {
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", array_filter($this->getAllStaticLibFiles())));
+        }
+        // add libstdc++, some extensions or libraries need it
+        $extra_libs .= (empty($extra_libs) ? '' : ' ') . ($this->hasCpp() ? '-lstdc++ ' : '');
+        $this->setOption('extra-libs', $extra_libs);
+
+        $cflags = $this->arch_c_flags;
+
+        // prepare build php envs
+        $envs_build_php = SystemUtil::makeEnvVarString([
+            'CFLAGS' => $cflags,
+            'LIBS' => '-ldl -lpthread',
+        ]);
+
+        SourcePatcher::patchBeforeBuildconf($this);
+
+        shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
+
+        SourcePatcher::patchBeforeConfigure($this);
+
+        $phpVersionID = $this->getPHPVersionID();
+        $json_74 = $phpVersionID < 80000 ? '--enable-json ' : '';
+
+        if ($this->getOption('enable-zts', false)) {
+            $maxExecutionTimers = $phpVersionID >= 80100 ? '--enable-zend-max-execution-timers ' : '';
+            $zts = '--enable-zts --disable-zend-signals ';
+        } else {
+            $maxExecutionTimers = '';
+            $zts = '';
+        }
+        $disable_jit = $this->getOption('disable-opcache-jit', false) ? '--disable-opcache-jit ' : '';
+
+        $enableCli = ($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI;
+        $enableFpm = ($build_target & BUILD_TARGET_FPM) === BUILD_TARGET_FPM;
+        $enableMicro = ($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO;
+        $enableEmbed = ($build_target & BUILD_TARGET_EMBED) === BUILD_TARGET_EMBED;
+
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec(
+                "{$this->getOption('ld_library_path')} " .
+                './configure ' .
+                '--prefix= ' .
+                '--with-valgrind=no ' .
+                '--enable-shared=no ' .
+                '--enable-static=yes ' .
+                '--disable-all ' .
+                '--disable-cgi ' .
+                '--disable-phpdbg ' .
+                ($enableCli ? '--enable-cli ' : '--disable-cli ') .
+                ($enableFpm ? '--enable-fpm ' : '--disable-fpm ') .
+                ($enableEmbed ? '--enable-embed=static ' : '--disable-embed ') .
+                ($enableMicro ? '--enable-micro=all-static ' : '--disable-micro ') .
+                $disable_jit .
+                $json_74 .
+                $zts .
+                $maxExecutionTimers .
+                $this->makeExtensionArgs() . ' ' .
+                $envs_build_php
+            );
+
+        SourcePatcher::patchBeforeMake($this);
+
+        $this->cleanMake();
+
+        if ($enableCli) {
+            logger()->info('building cli');
+            $this->buildCli();
+        }
+        if ($enableFpm) {
+            logger()->info('building fpm');
+            $this->buildFpm();
+        }
+        if ($enableMicro) {
+            logger()->info('building micro');
+            $this->buildMicro();
+        }
+        if ($enableEmbed) {
+            logger()->info('building embed');
+            if ($enableMicro) {
+                FileSystem::replaceFileStr(SOURCE_PATH . '/php-src/Makefile', 'OVERALL_TARGET =', 'OVERALL_TARGET = libphp.la');
+            }
+            $this->buildEmbed();
+        }
+
+        if (php_uname('m') === $this->getOption('arch')) {
+            $this->sanityCheck($build_target);
+        }
+    }
+
+    /**
+     * Build cli sapi
+     *
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function buildCli(): void
+    {
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars());
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec("make -j{$this->concurrency} {$vars} cli");
+
+        if (!$this->getOption('no-strip', false)) {
+            shell()->cd(SOURCE_PATH . '/php-src/sapi/cli')->exec('strip --strip-all php');
+        }
+
+        $this->deployBinary(BUILD_TARGET_CLI);
+    }
+
+    /**
+     * Build phpmicro sapi
+     *
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function buildMicro(): void
+    {
+        if ($this->getPHPVersionID() < 80000) {
+            throw new WrongUsageException('phpmicro only support PHP >= 8.0!');
+        }
+        if ($this->getExt('phar')) {
+            $this->phar_patched = true;
+            SourcePatcher::patchMicro(['phar']);
+        }
+
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars([
+            'EXTRA_CFLAGS' => $this->getOption('with-micro-fake-cli', false) ? ' -DPHP_MICRO_FAKE_CLI' : '',
+        ]));
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec("make -j{$this->concurrency} {$vars} micro");
+
+        if (!$this->getOption('no-strip', false)) {
+            shell()->cd(SOURCE_PATH . '/php-src/sapi/micro')->exec('strip --strip-all micro.sfx');
+        }
+
+        $this->deployBinary(BUILD_TARGET_MICRO);
+
+        if ($this->phar_patched) {
+            SourcePatcher::patchMicro(['phar'], true);
+        }
+    }
+
+    /**
+     * Build fpm sapi
+     *
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    public function buildFpm(): void
+    {
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars());
+        shell()->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec("make -j{$this->concurrency} {$vars} fpm");
+
+        if (!$this->getOption('no-strip', false)) {
+            shell()->cd(SOURCE_PATH . '/php-src/sapi/fpm')->exec('strip --strip-all php-fpm');
+        }
+
+        $this->deployBinary(BUILD_TARGET_FPM);
+    }
+
+    /**
+     * Build embed sapi
+     *
+     * @throws RuntimeException
+     */
+    public function buildEmbed(): void
+    {
+        $vars = SystemUtil::makeEnvVarString($this->getBuildVars());
+
+        shell()
+            ->cd(SOURCE_PATH . '/php-src')
+            ->exec('sed -i "s|//lib|/lib|g" Makefile')
+            ->exec('make INSTALL_ROOT=' . BUILD_ROOT_PATH . " -j{$this->concurrency} {$vars} install");
+    }
+
+    private function getBuildVars($input = []): array
+    {
+        $use_lld = '';
+        if (str_ends_with(getenv('CC'), 'clang') && SystemUtil::findCommand('lld')) {
+            $use_lld = '-Xcompiler -fuse-ld=lld';
+        }
+        $optimization = $this->getOption('no-strip', false) ? '-g -O0' : '-g0 -Os';
+        $cflags = isset($input['EXTRA_CFLAGS']) && $input['EXTRA_CFLAGS'] ? " {$input['EXTRA_CFLAGS']}" : '';
+        $libs = isset($input['EXTRA_LIBS']) && $input['EXTRA_LIBS'] ? " {$input['EXTRA_LIBS']}" : '';
+        $ldflags = isset($input['EXTRA_LDFLAGS_PROGRAM']) && $input['EXTRA_LDFLAGS_PROGRAM'] ? " {$input['EXTRA_LDFLAGS_PROGRAM']}" : '';
+        return [
+            'EXTRA_CFLAGS' => "{$optimization} -fno-ident -fPIE " . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . $cflags,
+            'EXTRA_LIBS' => $this->getOption('extra-libs', '') . $libs,
+            'EXTRA_LDFLAGS_PROGRAM' => "{$use_lld} -all-static" . $ldflags,
+        ];
+    }
+}

src/SPC/builder/linux/SystemUtil.php

@@ -0,0 +1,212 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux;
+
+use SPC\builder\traits\UnixSystemUtilTrait;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class SystemUtil
+{
+    use UnixSystemUtilTrait;
+
+    /** @noinspection PhpMissingBreakStatementInspection */
+    public static function getOSRelease(): array
+    {
+        $ret = [
+            'dist' => 'unknown',
+            'ver' => 'unknown',
+        ];
+        switch (true) {
+            case file_exists('/etc/centos-release'):
+                $lines = file('/etc/centos-release');
+                goto rh;
+            case file_exists('/etc/redhat-release'):
+                $lines = file('/etc/redhat-release');
+                rh:
+                foreach ($lines as $line) {
+                    if (preg_match('/release\s+(\d*(\.\d+)*)/', $line, $matches)) {
+                        $ret['dist'] = 'redhat';
+                        $ret['ver'] = $matches[1];
+                    }
+                }
+                break;
+            case file_exists('/etc/os-release'):
+                $lines = file('/etc/os-release');
+                foreach ($lines as $line) {
+                    if (preg_match('/^ID=(.*)$/', $line, $matches)) {
+                        $ret['dist'] = $matches[1];
+                    }
+                    if (preg_match('/^VERSION_ID=(.*)$/', $line, $matches)) {
+                        $ret['ver'] = $matches[1];
+                    }
+                }
+                $ret['dist'] = trim($ret['dist'], '"\'');
+                $ret['ver'] = trim($ret['ver'], '"\'');
+                if (strcasecmp($ret['dist'], 'centos') === 0) {
+                    $ret['dist'] = 'redhat';
+                }
+                break;
+        }
+        return $ret;
+    }
+
+    public static function isMuslDist(): bool
+    {
+        return static::getOSRelease()['dist'] === 'alpine';
+    }
+
+    public static function getCpuCount(): int
+    {
+        $ncpu = 1;
+
+        if (is_file('/proc/cpuinfo')) {
+            $cpuinfo = file_get_contents('/proc/cpuinfo');
+            preg_match_all('/^processor/m', $cpuinfo, $matches);
+            $ncpu = count($matches[0]);
+        }
+
+        return $ncpu;
+    }
+
+    /**
+     * @throws RuntimeException
+     */
+    public static function getCCType(string $cc): string
+    {
+        return match (true) {
+            str_ends_with($cc, 'c++'), str_ends_with($cc, 'cc'), str_ends_with($cc, 'g++'), str_ends_with($cc, 'gcc') => 'gcc',
+            $cc === 'clang++', $cc === 'clang', str_starts_with($cc, 'musl-clang') => 'clang',
+            default => throw new RuntimeException("unknown cc type: {$cc}"),
+        };
+    }
+
+    /**
+     * @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' => [
+                '-march=corei7',
+                '-mtune=core-avx2',
+            ],
+            '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
+     */
+    public static function getCrossCompilePrefix(string $cc, string $arch): string
+    {
+        return match (static::getCCType($cc)) {
+            // guessing clang toolchains
+            'clang' => match ($arch) {
+                'x86_64' => 'x86_64-linux-gnu-',
+                'arm64', 'aarch64' => 'aarch64-linux-gnu-',
+                default => throw new RuntimeException('unsupported arch: ' . $arch),
+            },
+            // remove gcc postfix
+            'gcc' => str_replace('-cc', '', str_replace('-gcc', '', $cc)) . '-',
+            default => throw new RuntimeException('unsupported cc'),
+        };
+    }
+
+    public static function findStaticLib(string $name): ?array
+    {
+        $paths = getenv('LIBPATH');
+        if (!$paths) {
+            $paths = '/lib:/lib64:/usr/lib:/usr/lib64:/usr/local/lib:/usr/local/lib64:';
+        }
+        foreach (explode(':', $paths) as $path) {
+            if (file_exists("{$path}/{$name}")) {
+                return ["{$path}", "{$name}"];
+            }
+        }
+        return null;
+    }
+
+    /** @noinspection PhpUnused */
+    public static function findStaticLibs(array $names): ?array
+    {
+        $ret = [];
+        foreach ($names as $name) {
+            $path = static::findStaticLib($name);
+            if (!$path) {
+                logger()->warning("static library {$name} not found");
+                return null;
+            }
+            $ret[] = $path;
+        }
+        return $ret;
+    }
+
+    public static function findHeader(string $name): ?array
+    {
+        $paths = getenv('INCLUDEPATH');
+        if (!$paths) {
+            $paths = '/include:/usr/include:/usr/local/include';
+        }
+        foreach (explode(':', $paths) as $path) {
+            if (file_exists("{$path}/{$name}") || is_dir("{$path}/{$name}")) {
+                return ["{$path}", "{$name}"];
+            }
+        }
+        return null;
+    }
+
+    /** @noinspection PhpUnused */
+    public static function findHeaders(array $names): ?array
+    {
+        $ret = [];
+        foreach ($names as $name) {
+            $path = static::findHeader($name);
+            if (!$path) {
+                logger()->warning("header {$name} not found");
+                return null;
+            }
+            $ret[] = $path;
+        }
+        return $ret;
+    }
+}

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

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\builder\BuilderBase;
+use SPC\builder\LibraryBase;
+use SPC\builder\linux\LinuxBuilder;
+use SPC\builder\traits\UnixLibraryTrait;
+
+abstract class LinuxLibraryBase extends LibraryBase
+{
+    use UnixLibraryTrait;
+
+    protected array $static_libs = [];
+
+    protected array $headers;
+
+    protected array $pkgconfs;
+
+    /**
+     * 依赖的名字及是否可选，例如：curl => true，代表依赖 curl 但可选
+     */
+    protected array $dep_names;
+
+    public function __construct(protected LinuxBuilder $builder)
+    {
+        parent::__construct();
+    }
+
+    public function getBuilder(): BuilderBase
+    {
+        return $this->builder;
+    }
+}

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

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

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

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

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

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+class curl extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\curl;
+
+    public const NAME = 'curl';
+
+    public function getStaticLibFiles(string $style = 'autoconf', bool $recursive = true): string
+    {
+        $libs = parent::getStaticLibFiles($style, $recursive);
+        if ($this->builder->getLib('openssl')) {
+            $libs .= ' -ldl -lpthread';
+        }
+        return $libs;
+    }
+}

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

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

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class gmp extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\gmp;
+
+    public const NAME = 'gmp';
+}

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

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+class icu extends LinuxLibraryBase
+{
+    public const NAME = 'icu';
+
+    protected function build(): void
+    {
+        $cppflags = 'CPPFLAGS="-DU_CHARSET_IS_UTF8=1  -DU_USING_ICU_NAMESPACE=1  -DU_STATIC_IMPLEMENTATION=1"';
+        $cxxflags = 'CXXFLAGS="-std=c++11"';
+        $ldflags = 'LDFLAGS="-static"';
+        shell()->cd($this->source_dir . '/source')
+            ->exec(
+                "{$cppflags} {$cxxflags} {$ldflags} " .
+                './runConfigureICU Linux ' .
+                '--enable-static ' .
+                '--disable-shared ' .
+                '--with-data-packaging=static ' .
+                '--enable-release=yes ' .
+                '--enable-extras=yes ' .
+                '--enable-icuio=yes ' .
+                '--enable-dyload=no ' .
+                '--enable-tools=yes ' .
+                '--enable-tests=no ' .
+                '--enable-samples=no ' .
+                '--prefix=' . BUILD_ROOT_PATH
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install');
+    }
+}

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * a template library class for unix
+ */
+class imagemagick extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\imagemagick;
+
+    public const NAME = 'imagemagick';
+}

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

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

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

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

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

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

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

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+class libffi extends LinuxLibraryBase
+{
+    public const NAME = 'libffi';
+
+    /**
+     * @throws RuntimeException
+     */
+    public function build(): void
+    {
+        [$lib, , $destdir] = SEPARATED_PATH;
+
+        /*$env = $this->builder->pkgconf_env . ' CFLAGS="' . $this->builder->arch_c_flags . '"';
+
+        $env .= match ($this->builder->libc) {
+            'musl_wrapper' => " CC='{$this->builder->getOption('cc')} --static -idirafter " . BUILD_INCLUDE_PATH .
+                ($this->builder->getOption('arch') === php_uname('m') ? '-idirafter /usr/include/ ' : '') .
+                "-idirafter /usr/include/{$this->builder->getOption('arch')}-linux-gnu/'",
+            'musl', 'glibc' => " CC='{$this->builder->getOption('cc')}'",
+            default => throw new RuntimeException('unsupported libc: ' . $this->builder->libc),
+        };*/
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                './configure ' .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->getOption('arch')}-unknown-linux " .
+                "--target={$this->builder->getOption('arch')}-unknown-linux " .
+                '--prefix= ' . // use prefix=/
+                "--libdir={$lib}"
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+
+        if (is_file(BUILD_ROOT_PATH . '/lib64/libffi.a')) {
+            copy(BUILD_ROOT_PATH . '/lib64/libffi.a', BUILD_ROOT_PATH . '/lib/libffi.a');
+            unlink(BUILD_ROOT_PATH . '/lib64/libffi.a');
+        }
+        $this->patchPkgconfPrefix(['libffi.pc']);
+    }
+}

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

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

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

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

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

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\RuntimeException;
+
+/**
+ * gmp is a template library class for unix
+ */
+class libmemcached extends LinuxLibraryBase
+{
+    public const NAME = 'libmemcached';
+
+    public function build()
+    {
+        throw new RuntimeException('libmemcached is currently not supported on Linux platform');
+    }
+}

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

@@ -0,0 +1,62 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class libpng extends LinuxLibraryBase
+{
+    public const NAME = 'libpng';
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function build(): void
+    {
+        $optimizations = match ($this->builder->getOption('arch')) {
+            'x86_64' => '--enable-intel-sse ',
+            'arm64' => '--enable-arm-neon ',
+            default => '',
+        };
+        shell()->cd($this->source_dir)
+            ->exec('chmod +x ./configure')
+            ->exec('chmod +x ./install-sh')
+            ->exec(
+                'LDFLAGS="-L' . BUILD_LIB_PATH . '" ' .
+                './configure ' .
+                '--disable-shared ' .
+                '--enable-static ' .
+                '--enable-hardware-optimizations ' .
+                '--with-zlib-prefix="' . BUILD_ROOT_PATH . '" ' .
+                $optimizations .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} DEFAULT_INCLUDES='-I{$this->source_dir} -I" . BUILD_INCLUDE_PATH . "' LIBS= libpng16.la")
+            ->exec('make install-libLTLIBRARIES install-data-am DESTDIR=' . BUILD_ROOT_PATH);
+        $this->patchPkgconfPrefix(['libpng16.pc'], PKGCONF_PATCH_PREFIX);
+        $this->cleanLaFiles();
+    }
+}

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

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

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

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

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

@@ -0,0 +1,28 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+class libwebp extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\libwebp;
+
+    public const NAME = 'libwebp';
+}

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

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+
+class libxml2 extends LinuxLibraryBase
+{
+    public const NAME = 'libxml2';
+
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    public function build(): void
+    {
+        $enable_zlib = $this->builder->getLib('zlib') ? 'ON' : 'OFF';
+        $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
+        $enable_xz = $this->builder->getLib('xz') ? 'ON' : 'OFF';
+
+        FileSystem::resetDir($this->source_dir . '/build');
+        shell()->cd($this->source_dir . '/build')
+            ->exec(
+                'cmake ' .
+                "{$this->builder->makeCmakeArgs()} " .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DIconv_IS_BUILT_IN=OFF ' .
+                '-DLIBXML2_WITH_ICONV=ON ' .
+                "-DLIBXML2_WITH_ZLIB={$enable_zlib} " .
+                "-DLIBXML2_WITH_ICU={$enable_icu} " .
+                "-DLIBXML2_WITH_LZMA={$enable_xz} " .
+                '-DLIBXML2_WITH_PYTHON=OFF ' .
+                '-DLIBXML2_WITH_PROGRAMS=OFF ' .
+                '-DLIBXML2_WITH_TESTS=OFF ' .
+                '..'
+            )
+            ->exec("cmake --build . -j {$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . BUILD_ROOT_PATH);
+
+        FileSystem::replaceFileStr(
+            BUILD_LIB_PATH . '/pkgconfig/libxml-2.0.pc',
+            '-licudata -licui18n -licuuc',
+            '-licui18n -licuuc -licudata'
+        );
+    }
+}

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class libxslt extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\libxslt;
+
+    public const NAME = 'libxslt';
+}

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

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

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

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

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class ncurses extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\ncurses;
+
+    public const NAME = 'ncurses';
+}

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

@@ -0,0 +1,72 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class nghttp2 extends LinuxLibraryBase
+{
+    public const NAME = 'nghttp2';
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function build(): void
+    {
+        $args = $this->builder->makeAutoconfArgs(static::NAME, [
+            'zlib' => null,
+            'openssl' => null,
+            'libxml2' => null,
+            'libev' => null,
+            'libcares' => null,
+            'libngtcp2' => null,
+            'libnghttp3' => null,
+            'libbpf' => null,
+            'libevent-openssl' => null,
+            'jansson' => null,
+            'jemalloc' => null,
+            'systemd' => null,
+            'cunit' => null,
+        ]);
+
+        [,,$destdir] = SEPARATED_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                './configure ' .
+                '--enable-static ' .
+                '--disable-shared ' .
+                "--host={$this->builder->getOption('gnu-arch')}-unknown-linux " .
+                '--enable-lib-only ' .
+                '--with-boost=no ' .
+                $args . ' ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec("make install DESTDIR={$destdir}");
+        $this->patchPkgconfPrefix(['libnghttp2.pc']);
+    }
+}

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

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

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

@@ -0,0 +1,80 @@
+<?php
+/**
+ * Copyright (c) 2022 Yun Dou <dixyes@gmail.com>
+ *
+ * lwmbs is licensed under Mulan PSL v2. You can use this
+ * software according to the terms and conditions of the
+ * Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at:
+ *
+ * http://license.coscl.org.cn/MulanPSL2
+ *
+ * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS,
+ * WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
+ * INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
+ * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
+ *
+ * See the Mulan PSL v2 for more details.
+ */
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+use SPC\builder\linux\SystemUtil;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
+class openssl extends LinuxLibraryBase
+{
+    public const NAME = 'openssl';
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function build(): void
+    {
+        [,,$destdir] = SEPARATED_PATH;
+
+        $extra = '';
+        $ex_lib = '-ldl -pthread';
+
+        $env = "CFLAGS='{$this->builder->arch_c_flags}'";
+        $env .= " CC='" . getenv('CC') . ' -static -idirafter ' . BUILD_INCLUDE_PATH .
+            ' -idirafter /usr/include/ ' .
+            ' -idirafter /usr/include/' . $this->builder->getOption('arch') . '-linux-gnu/ ' .
+            "' ";
+        // lib:zlib
+        $zlib = $this->builder->getLib('zlib');
+        if ($zlib instanceof LinuxLibraryBase) {
+            $extra = 'zlib';
+            $ex_lib = trim($zlib->getStaticLibFiles() . ' ' . $ex_lib);
+            $zlib_extra =
+                '--with-zlib-include=' . BUILD_INCLUDE_PATH . ' ' .
+                '--with-zlib-lib=' . BUILD_LIB_PATH . ' ';
+        } else {
+            $zlib_extra = '';
+        }
+
+        $ex_lib = trim($ex_lib);
+
+        $clang_postfix = SystemUtil::getCCType(getenv('CC')) === 'clang' ? '-clang' : '';
+
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$env} ./Configure no-shared {$extra} " .
+                '--prefix=/ ' .
+                '--libdir=lib ' .
+                '-static ' .
+                "{$zlib_extra}" .
+                'no-legacy ' .
+                "linux-{$this->builder->getOption('arch')}{$clang_postfix}"
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")
+            ->exec("make install_sw DESTDIR={$destdir}");
+        $this->patchPkgconfPrefix(['libssl.pc', 'openssl.pc', 'libcrypto.pc']);
+    }
+}

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class pkgconfig extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\pkgconfig;
+
+    public const NAME = 'pkg-config';
+}

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

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

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

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class readline extends LinuxLibraryBase
+{
+    use \SPC\builder\unix\library\readline;
+
+    public const NAME = 'readline';
+}

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

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

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

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

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

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

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

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