cs fix (#166)

Removed unsupported Symfony versions
Bump minimal version of dev dependencies to the latest supported

.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-x86_64.yml

@@ -40,11 +40,6 @@ jobs:
     steps:
       - uses: actions/checkout@v3
 
-      # Install Ubuntu missing packages and mark os suffix
-      - run: |
-          sudo apt install musl-tools -y
-          echo "SPC_BUILD_OS=linux" >> $GITHUB_ENV
-
       # Cache composer dependencies
       - id: cache-composer-deps
         uses: actions/cache@v3
@@ -54,7 +49,7 @@ jobs:
 
       # If there's no Composer cache, install dependencies
       - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
-        run: composer update --no-dev
+        run: composer update --no-dev --classmap-authoritative
 
       # Cache downloaded source
       - id: cache-download
@@ -77,10 +72,10 @@ jobs:
 
       # 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 download --with-php=${{ inputs.version }} --all ${{ env.SPC_BUILD_DEBUG }}
+        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 build ${{ inputs.extensions }} ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_BUILD_CLI }} ${{ env.SPC_BUILD_MICRO }} ${{ env.SPC_BUILD_FPM }}
+      - 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 }}
@@ -115,8 +110,3 @@ jobs:
             buildroot/build-extensions.json
             buildroot/build-libraries.json
 
-      # Upload downloaded files
-      - uses: actions/upload-artifact@v3
-        with:
-          name: download-files
-          path: downloads/

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

@@ -54,7 +54,7 @@ jobs:
 
       # If there's no Composer cache, install dependencies
       - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
-        run: composer update --no-dev
+        run: composer update --no-dev --classmap-authoritative
 
       # Cache downloaded source
       - id: cache-download
@@ -115,8 +115,3 @@ jobs:
             buildroot/build-extensions.json
             buildroot/build-libraries.json
 
-      # Upload downloaded files
-      - uses: actions/upload-artifact@v3
-        with:
-          name: download-files
-          path: downloads/

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

@@ -17,11 +17,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,30 +1,30 @@
 # static-php-cli
 
-Compile A Statically Linked PHP With Swoole and other Extensions.
+Build single static PHP binary, with PHP project together, with popular extensions included.
+
+The project name is static-php-cli, but it actually supports cli, fpm, micro and embed (on the way) SAPI 😎
 
 Compile a purely static php-cli binary file with various extensions to make PHP applications more portable! (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">
+<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!
 This feature is provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro). (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">
+<img width="600" alt="2023-05-02 15 52 33" src="https://user-images.githubusercontent.com/20330940/235610318-2ef4e3f1-278b-4ca4-99f4-b38120efc395.png">
 
-> This branch is new version, if you are looking for old bash version of static-php-cli, see [bash-version](https://github.com/crazywhalecc/static-php-cli/tree/bash-version).
-
-[![Version](https://img.shields.io/badge/Version-2.0--rc1-pink.svg?style=flat-square)]()
+[![Version](https://img.shields.io/badge/Version-2.0--rc5-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-50+-yellow.svg?style=flat-square)]()
+[![](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)]()
 
 ## Compilation Requirements
 
 Yes, this project is written in PHP, pretty funny.
-But static-php-cli runtime only requires an environment above PHP 8.0 and `tokenizer`, `iconv` extension.
+But static-php-cli runtime only requires an environment above PHP 8.1 and `mbstring`, `pcntl` extension.
 
 Here is the architecture support status, where `CI` represents support for GitHub Action builds, 
 `Local` represents support for local builds, and blank represents not currently supported.
@@ -37,9 +37,13 @@ Here is the architecture support status, where `CI` represents support for GitHu
 
 > 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.4`, `8.0`, `8.1`, `8.2`.
+Currently supported PHP versions for compilation are: `7.3`, `7.4`, `8.0`, `8.1`, `8.2`, `8.3`.
 
-## Usage
+## Docs
+
+docs here: <https://static-php-cli.zhamao.me>.
+
+## Simple Usage
 
 Please first select the extension you want to compile based on the extension list below.
 
@@ -51,7 +55,7 @@ If you don't compile yourself, you can download pre-compiled artifact from Actio
 
 ### Supported Extensions
 
-[Supported Extension List](/ext-support.md)
+[Supported Extension List](https://static-php-cli.zhamao.me/en/guide/extensions.html)
 
 > If there is no extension you need here, you can submit an issue.
 
@@ -78,13 +82,15 @@ Clone repo first:
 git clone https://github.com/crazywhalecc/static-php-cli.git
 ```
 
-If you have not installed php on your system, you can download single-file php binary and composer first.
+If you have not installed php on your system, you can use package management to install PHP (such as brew, apt, yum, apk etc.).
 
+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
 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
@@ -100,7 +106,7 @@ Basic usage for building php and micro with some extensions:
 cd static-php-cli
 composer update
 chmod +x bin/spc
-# Check system tool dependencies, fix them automatically (only support macOS) (TODO: Linux distro support)
+# Check system tool dependencies, fix them automatically
 ./bin/spc doctor
 # fetch all libraries
 ./bin/spc fetch --all
@@ -111,7 +117,7 @@ chmod +x bin/spc
 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 7.4 cannot use phpmicro
+# Using PHP >= 8.0 is recommended, because PHP7 cannot use phpmicro
 ./bin/spc fetch --with-php=8.2 --all
 ```
 
@@ -129,6 +135,14 @@ If anything goes wrong, use `--debug` option to display full terminal output:
 ./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.
+
 ### php-cli Usage
 
 > php-cli is a single static binary, you can use it like normal php installed on your system.
@@ -148,7 +162,7 @@ cd buildroot/bin/
 
 ### micro.sfx Usage
 
-> phpmicro is a Self-Extracted Executable SAPI module, 
+> phpmicro is a SelF-extracted eXecutable SAPI module, 
 > provided by [dixyes/phpmicro](https://github.com/dixyes/phpmicro). 
 > It can put php runtime and your source code together.
 
@@ -180,18 +194,6 @@ Because php-fpm must specify a configuration file before running, the php-fpm co
 
 Specifying `php-fpm.conf` can use the command parameter `-y`, for example: `./php-fpm -y php-fpm.conf`.
 
-## Current Status
-
-- [X] Basic CLI framework (by `symfony/console`)
-- [X] Linux support
-- [X] macOS support
-- [X] Exception handler
-- [ ] Windows support
-- [X] PHP 7.4 support
-- [X] fpm support
-
-More functions and features are coming soon, Bugs and TODOs: https://github.com/crazywhalecc/static-php-cli/issues/32
-
 ## Contribution
 
 Currently, there are only a few supported extensions. 
@@ -209,10 +211,22 @@ The basic principles for contributing are as follows:
     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.
 
+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 is based on the tradition of using the MIT License for old versions, 
-while the new version references source code from some other projects:
+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)
@@ -221,11 +235,11 @@ 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, 
+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
 
-This project is pure open source project, and some modules are separated for developing.
-
-This section will be improved after refactor version released.
+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-cli.zhamao.me) of the documentation to contribute code or documentation.

README.md

@@ -1,8 +1,8 @@
 # static-php-cli
 
-Compile A Statically Linked PHP With Swoole and other Extensions. 
+Build single static PHP binary, with PHP project together, with popular extensions included.
 
-If you are using English, see [English README](README-en.md).
+**If you are using English, see [English README](README-en.md).**
 
 编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！（cli SAPI）
 
@@ -12,19 +12,19 @@ If you are using English, see [English README](README-en.md).
 
 <img width="600" alt="截屏2023-05-02 15 52 33" src="https://user-images.githubusercontent.com/20330940/235610318-2ef4e3f1-278b-4ca4-99f4-b38120efc395.png">
 
-> 此分支为重构的新版，如果你在找纯 Bash 编写的旧版本，请到 [bash-version 分支](https://github.com/crazywhalecc/static-php-cli/tree/bash-version)。
-
-[![Version](https://img.shields.io/badge/Version-2.0--rc1-pink.svg?style=flat-square)]()
+[![Version](https://img.shields.io/badge/Version-2.0--rc5-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-50+-yellow.svg?style=flat-square)]()
+[![](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 😎
+
 ## 编译环境需求
 
 是的，本项目采用 PHP 编写，编译前需要一个 PHP 环境，比较滑稽。
-但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 tokenizer 扩展和 PHP 版本大于等于 8.0 即可。
+但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 mbstring、pcntl 扩展和 PHP 版本大于等于 8.1 即可。
 
 下面是架构支持情况，`CI` 代表支持 GitHub Action 构建，`Local` 代表支持本地构建，空 代表暂不支持。
 
@@ -36,7 +36,11 @@ If you are using English, see [English README](README-en.md).
 
 > macOS-arm64 因 GitHub 暂未提供 arm runner，如果要构建 arm 二进制，可以使用手动构建。
 
-目前支持编译的 PHP 版本为：`7.4`，`8.0`，`8.1`，`8.2`。
+目前支持编译的 PHP 版本为：`7.3`，`7.4`，`8.0`，`8.1`，`8.2`，`8.3`。
+
+## 文档
+
+点击这里查看文档：<https://static-php-cli.zhamao.me>。
 
 ## 使用
 
@@ -50,7 +54,7 @@ If you are using English, see [English README](README-en.md).
 
 ### 支持的扩展情况
 
-[扩展支持列表](/ext-support.md)
+[扩展支持列表](https://static-php-cli.zhamao.me/zh/guide/extensions.html)
 
 > 如果这里没有你需要的扩展，可以提交 Issue。
 
@@ -73,9 +77,9 @@ If you are using English, see [English README](README-en.md).
 git clone https://github.com/crazywhalecc/static-php-cli.git
 ```
 
-如果你本机没有安装 PHP，你可以通过命令下载静态编译好的 php-cli 和 Composer。
+如果你本机没有安装 PHP，你需要先使用包管理（例如 brew、apt、yum、apk 等）安装 php。
 
-下载的 php 和 Composer 将保存为 `bin/php` 和 `bin/composer`。
+你也可以通过 `bin/setup-runtime` 命令下载静态编译好的 php-cli 和 Composer。下载的 php 和 Composer 将保存为 `bin/php` 和 `bin/composer`。
 
 ```bash
 cd static-php-cli
@@ -96,7 +100,7 @@ chmod +x bin/setup-runtime
 cd static-php-cli
 composer update
 chmod +x bin/spc
-# 检查环境依赖，并根据提示的命令安装缺失的编译工具（目前仅支持 macOS，Linux 后续会支持）
+# 检查环境依赖，并根据提示的命令安装缺失的编译工具
 ./bin/spc doctor
 # 拉取所有依赖库
 ./bin/spc fetch --all
@@ -104,10 +108,10 @@ chmod +x bin/spc
 ./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl" --build-cli --build-micro
 ```
 
-你也可以使用参数 `--with-php=x.y` 来指定下载的 PHP 版本，目前支持 7.4 ~ 8.2：
+你也可以使用参数 `--with-php=x.y` 来指定下载的 PHP 版本，目前支持 7.3 ~ 8.3：
 
 ```bash
-# 优先考虑使用 >= 8.0 的 PHP 版本
+# 优先考虑使用 >= 8.0 的 PHP 版本，因为 phpmicro 不支持在 PHP7 中构建
 ./bin/spc fetch --with-php=8.2 --all
 ```
 
@@ -125,6 +129,14 @@ chmod +x bin/spc
 ./bin/spc fetch --all --debug
 ```
 
+此外，默认编译的 PHP 为 NTS 版本。如需编译线程安全版本（ZTS），只需添加参数 `--enable-zts` 即可。
+
+```bash
+./bin/spc build openssl,pcntl --build-all --enable-zts
+```
+
+同时，你也可以使用参数 `--no-strip` 来关闭裁剪，关闭裁剪后可以使用 gdb 等工具调试，但这样会让静态二进制体积变大。
+
 ### 使用 php-cli
 
 > php-cli 是一个静态的二进制文件，类似 Go、Rust 语言编译后的单个可移植的二进制文件。
@@ -169,18 +181,6 @@ cat micro.sfx code.php > single-app && chmod +x single-app
 
 指定 `php-fpm.conf` 可以使用命令参数 `-y`，例如：`./php-fpm -y php-fpm.conf`。
 
-## 项目支持情况
-
-- [X] 基础结构编写（采用 `symfony/console`）
-- [X] 错误处理
-- [X] macOS 支持
-- [ ] Windows 支持
-- [X] Linux 支持
-- [X] PHP 7.4 支持
-- [X] fpm 支持
-
-更多功能和特性正在陆续支持中，详见：https://github.com/crazywhalecc/static-php-cli/issues/32
-
 ## 贡献
 
 目前支持的扩展较少，如果缺少你需要的扩展，可发起 Issue。如果你对本项目较熟悉，也欢迎为本项目发起 Pull Request。
@@ -194,6 +194,12 @@ cat micro.sfx code.php > single-app && chmod +x single-app
 
 另外，添加新扩展的贡献方式，可以参考下方 `进阶`。
 
+如果你想贡献文档内容，请到项目仓库 [crazywhalecc/static-php-cli-docs](https://github.com/crazywhalecc/static-php-cli-docs) 贡献。
+
+## 赞助本项目
+
+你可以在 [我的个人赞助页](https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md) 支持我和我的项目。
+
 ## 开源协议
 
 本项目依据旧版本惯例采用 MIT License 开源，自身的部分代码引用或修改自以下项目：
@@ -202,10 +208,8 @@ cat micro.sfx code.php > single-app && chmod +x single-app
 - [swoole/swoole-cli](https://github.com/swoole/swoole-cli)（Apache 2.0 LICENSE、SWOOLE-CLI LICENSE）
 
 因本项目的特殊性，使用项目编译过程中会使用很多其他开源项目，例如 curl、protobuf 等，它们都有各自的开源协议。
-请在编译完成后，使用命令 `dump-license`(TODO) 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
+请在编译完成后，使用命令 `bin/spc dump-license` 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
 
 ## 进阶
 
-本项目重构分支为模块化编写。
-
-TODO：这部分将在基础功能完成后编写完成。
+本项目重构分支为模块化编写。如果你对本项目感兴趣，想加入开发，可以参照文档的 [贡献指南](https://static-php-cli.zhamao.me) 贡献代码或文档。

bin/setup-runtime

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env sh
 
 # set error-quit, verbose, non-variable-quit
 set -eu
@@ -22,10 +22,10 @@ esac
 
 # set project dir
 __DIR__=$(cd "$(dirname "$0")" && pwd)
-__PROJECT__=$(cd ${__DIR__}/../ && pwd)
+__PROJECT__=$(cd "${__DIR__}"/../ && pwd)
 
 # set download dir
-__PHP_RUNTIME_URL__="https://dl.zhamao.xin/static-php-cli/php-8.2.5-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+__PHP_RUNTIME_URL__="https://dl.zhamao.xin/static-php-cli/php-8.2.6-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
 __COMPOSER_URL__="https://getcomposer.org/download/latest-stable/composer.phar"
 
 # use china mirror
@@ -46,23 +46,27 @@ done
 
 case "$mirror" in
 china)
-  __PHP_RUNTIME_URL__="https://dl.zhamao.xin/static-php-cli/php-8.2.5-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+  __PHP_RUNTIME_URL__="https://dl.zhamao.xin/static-php-cli/php-8.2.6-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
   __COMPOSER_URL__="https://mirrors.aliyun.com/composer/composer.phar"
   ;;
 
 esac
 
-test -d ${__PROJECT__}/downloads || mkdir ${__PROJECT__}/downloads
+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
+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
+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; }
+"${__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:"

bin/spc

@@ -1,6 +1,9 @@
 #!/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

@@ -2,18 +2,18 @@
 
 # This file is using docker to run commands
 
-self_dir=$(cd "$(dirname "$0")";pwd)
-
 # 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
@@ -33,6 +33,7 @@ x86_64)
     ;;
 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
     ;;
@@ -51,24 +52,47 @@ 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 ..."
-    ALPINE_DOCKERFILE=$(cat << EOF
+    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH -f- . <<EOF
 FROM $ALPINE_FROM
 $SPC_USE_MIRROR
-RUN apk update
-RUN apk add bash file wget cmake gcc g++ jq autoconf git libstdc++ linux-headers make m4 libgcc binutils bison flex pkgconfig automake curl
-RUN apk add build-base xz php81 php81-common php81-pcntl php81-tokenizer php81-phar php81-posix php81-xml composer
-RUN mkdir /app
+RUN apk update; \
+    apk add --no-cache \
+        autoconf \
+        automake \
+        bash \
+        binutils \
+        bison \
+        build-base \
+        cmake \
+        composer \
+        curl \
+        file \
+        flex \
+        g++ \
+        gcc \
+        git \
+        jq \
+        libgcc \
+        libstdc++ \
+        linux-headers \
+        m4 \
+        make \
+        php81 \
+        php81-common \
+        php81-pcntl \
+        php81-phar \
+        php81-posix \
+        php81-tokenizer \
+        php81-xml \
+        pkgconfig \
+        wget \
+        xz
 WORKDIR /app
 ADD ./src /app/src
 ADD ./composer.json /app/composer.json
 ADD ./bin /app/bin
-RUN composer update --no-dev
+RUN composer update --no-dev --classmap-authoritative
 EOF
-)
-    echo "$ALPINE_DOCKERFILE" > $(pwd)/Dockerfile
-
-    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH .
-    rm $(pwd)/Dockerfile
 fi
 
 # Check if in ci (local terminal can execute with -it)
@@ -79,4 +103,5 @@ else
 fi
 
 # Run docker
-$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 $@
+# 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 $@

composer.json

@@ -9,20 +9,20 @@
         }
     ],
     "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": "*",
-        "ext-pcntl": "*"
+        "php": ">= 8.1",
+        "ext-mbstring": "*",
+        "ext-pcntl": "*",
+        "laravel/prompts": "^0.1.3",
+        "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",
+        "nunomaduro/collision": "^7.8",
+        "phpstan/phpstan": "^1.10",
+        "phpunit/phpunit": "^10.3"
     },
     "autoload": {
         "psr-4": {
@@ -33,13 +33,18 @@
             "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"
     },
     "config": {
         "allow-plugins": {

config/ext.json

@@ -100,6 +100,14 @@
             "gettext"
         ]
     },
+    "glfw": {
+        "type": "external",
+        "arg-type": "custom",
+        "source": "ext-glfw",
+        "lib-depends": [
+            "glfw"
+        ]
+    },
     "gmp": {
         "type": "builtin",
         "arg-type": "with-prefix",
@@ -138,6 +146,7 @@
     },
     "intl": {
         "type": "builtin",
+        "cpp-extension": true,
         "lib-depends": [
             "icu"
         ]
@@ -151,8 +160,9 @@
     },
     "mbregex": {
         "type": "builtin",
-        "lib-depends": [
-            "onig"
+        "arg-type": "custom",
+        "ext-depends": [
+            "mbstring"
         ]
     },
     "mbstring": {
@@ -162,10 +172,40 @@
             "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"
+        "arg-type": "custom",
+        "lib-suggests": [
+            "icu",
+            "openssl",
+            "zstd",
+            "zlib"
+        ]
     },
     "mysqli": {
         "type": "builtin",
@@ -176,7 +216,10 @@
     },
     "mysqlnd": {
         "type": "builtin",
-        "arg-type-windows": "with"
+        "arg-type-windows": "with",
+        "lib-depends": [
+            "zlib"
+        ]
     },
     "opcache": {
         "type": "builtin"
@@ -205,12 +248,13 @@
     },
     "pdo_pgsql": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "ext-depends": [
-            "pdo"
+            "pdo",
+            "pgsql"
         ],
         "lib-depends": [
-            "pq"
+            "postgresql"
         ]
     },
     "pdo_sqlite": {
@@ -224,6 +268,13 @@
             "sqlite"
         ]
     },
+    "pgsql": {
+        "type": "builtin",
+        "arg-type": "with-prefix",
+        "lib-depends": [
+            "postgresql"
+        ]
+    },
     "phar": {
         "type": "builtin",
         "ext-depends": [
@@ -255,7 +306,10 @@
     "redis": {
         "type": "external",
         "source": "redis",
-        "arg-type": "custom"
+        "arg-type": "custom",
+        "ext-suggests": [
+            "session"
+        ]
     },
     "session": {
         "type": "builtin"
@@ -271,6 +325,18 @@
             "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",
@@ -314,6 +380,7 @@
         "type": "external",
         "source": "swoole",
         "arg-type": "custom",
+        "cpp-extension": true,
         "lib-depends": [
             "openssl"
         ],
@@ -321,7 +388,8 @@
             "openssl"
         ],
         "ext-suggests": [
-            "curl"
+            "curl",
+            "pgsql"
         ],
         "unix-only": true
     },
@@ -360,6 +428,15 @@
     "tokenizer": {
         "type": "builtin"
     },
+    "xlswriter": {
+        "type": "external",
+        "source": "xlswriter",
+        "arg-type": "custom",
+        "ext-depends": [
+            "zlib",
+            "zip"
+        ]
+    },
     "xml": {
         "type": "builtin",
         "arg-type": "custom",
@@ -384,9 +461,13 @@
     },
     "xsl": {
         "type": "builtin",
-        "arg-type": "with",
+        "arg-type": "with-prefix",
         "lib-depends": [
             "libxslt"
+        ],
+        "ext-depends": [
+            "xml",
+            "dom"
         ]
     },
     "yaml": {
@@ -421,4 +502,4 @@
             "zstd"
         ]
     }
-}
+}

config/lib.json

@@ -42,14 +42,14 @@
             "curl"
         ],
         "lib-depends-unix": [
+            "openssl",
             "zlib"
         ],
         "lib-suggests": [
             "libssh2",
             "brotli",
             "nghttp2",
-            "zstd",
-            "openssl"
+            "zstd"
         ],
         "lib-suggests-windows": [
             "zlib",
@@ -84,6 +84,18 @@
             "brotli"
         ]
     },
+    "glfw": {
+        "source": "ext-glfw",
+        "static-libs-unix": [
+            "libglfw3.a"
+        ],
+        "frameworks": [
+            "CoreVideo",
+            "OpenGL",
+            "Cocoa",
+            "IOKit"
+        ]
+    },
     "gmp": {
         "source": "gmp",
         "static-libs-unix": [
@@ -96,6 +108,15 @@
             "gmp.h"
         ]
     },
+    "icu": {
+        "source": "icu",
+        "static-libs-unix": [
+            "libicui18n.a",
+            "libicuio.a",
+            "libicuuc.a",
+            "libicudata.a"
+        ]
+    },
     "imagemagick": {
         "source": "imagemagick",
         "static-libs-unix": [
@@ -179,6 +200,13 @@
             "libmcrypt.a"
         ]
     },
+    "libmemcached": {
+        "source": "libmemcached",
+        "static-libs-unix": [
+            "libmemcached.a",
+            "libmemcachedutil.a"
+        ]
+    },
     "libpng": {
         "source": "libpng",
         "static-libs-unix": [
@@ -200,6 +228,12 @@
             "zlib"
         ]
     },
+    "libsodium": {
+        "source": "libsodium",
+        "static-libs-unix": [
+            "libsodium.a"
+        ]
+    },
     "libssh2": {
         "source": "libssh2",
         "static-libs-unix": [
@@ -245,19 +279,29 @@
             "libxml2"
         ],
         "lib-depends": [
-            "libiconv"
+            "libiconv",
+            "zlib"
         ],
         "lib-suggests": [
             "xz",
-            "zlib"
+            "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": [
@@ -365,7 +409,19 @@
     "postgresql": {
         "source": "postgresql",
         "static-libs-unix": [
-            "libpg.a"
+            "libpq.a",
+            "libpgport.a",
+            "libpgcommon.a"
+        ],
+        "lib-depends": [
+            "libiconv",
+            "libxml2",
+            "openssl",
+            "zlib",
+            "readline"
+        ],
+        "lib-suggests": [
+            "icu"
         ]
     },
     "pthreads4w": {
@@ -389,6 +445,22 @@
             "ncurses"
         ]
     },
+    "snappy": {
+        "source": "snappy",
+        "static-libs-unix": [
+            "libsnappy.a"
+        ],
+        "headers-unix": [
+            "snappy-c.h",
+            "snappy-sinksource.h",
+            "snappy.h",
+            "snappy-stubs-internal.h",
+            "snappy-stubs-public.h"
+        ],
+        "lib-depends": [
+            "zlib"
+        ]
+    },
     "sqlite": {
         "source": "sqlite",
         "static-libs-unix": [
@@ -454,11 +526,5 @@
             "zstd.h",
             "zstd_errors.h"
         ]
-    },
-    "libsodium": {
-        "source": "libsodium",
-        "static-libs-unix": [
-            "libsodium.a"
-        ]
     }
-}
+}

ext-support.md

@@ -1,108 +1,3 @@
 # Extension List
 
-> - yes: supported and tested
-> - untested: supported, but not tested
-> - empty: not supported yet
-> - no with issue link: not supported yet due to issue
-> - partial with issue link: supported but not perfect due to issue
-
-|            | Linux                                                               | macOS                                                          | Windows |
-|------------|---------------------------------------------------------------------|----------------------------------------------------------------|---------|
-| apcu       | yes, untested                                                       | yes, untested                                                  |         |
-| bcmath     | yes                                                                 | yes                                                            |         |
-| bz2        | yes                                                                 | yes                                                            |         |
-| calendar   | yes                                                                 | yes                                                            |         |
-| ctype      | yes                                                                 | yes                                                            |         |
-| curl       | yes                                                                 | yes                                                            |         |
-| dba        | yes                                                                 | yes                                                            |         | 
-| dom        | yes                                                                 | yes                                                            |         |
-| enchant    |                                                                     |                                                                |         |
-| event      | yes                                                                 | yes                                                            |         |
-| exif       | yes                                                                 | yes                                                            |         |
-| ffi        |                                                                     | yes, [docs]()                                                  |         |
-| filter     | yes                                                                 | yes                                                            |         |
-| fileinfo   | yes                                                                 | yes                                                            |         |
-| ftp        | yes                                                                 | yes                                                            |         |
-| gd         | yes                                                                 | yes                                                            |         |
-| gettext    |                                                                     |                                                                |         |
-| gmp        | yes                                                                 | yes                                                            |         |
-| iconv      | yes                                                                 | yes                                                            |         |
-| imagick    | yes                                                                 | yes                                                            |         |
-| inotify    | yes                                                                 | yes                                                            |         |
-| mbstring   | yes                                                                 | yes                                                            |         |
-| mbregex    | yes                                                                 | yes                                                            |         |
-| mcrypt     |                                                                     | [no](https://github.com/crazywhalecc/static-php-cli/issues/32) |         |
-| mongodb    | yes                                                                 | yes                                                            |         |
-| mysqli     | yes                                                                 | yes                                                            |         |
-| mysqlnd    | yes                                                                 | yes                                                            |         |
-| openssl    | yes                                                                 | yes                                                            |         |
-| pcntl      | yes                                                                 | yes                                                            |         |
-| pdo        | yes                                                                 | yes                                                            |         |
-| pdo_mysql  | yes                                                                 | yes                                                            |         |
-| pdo_sqlite | yes                                                                 | yes                                                            |         |
-| pdo_pgsql  |                                                                     |                                                                |         |
-| phar       | yes                                                                 | yes                                                            |         |
-| posix      | yes                                                                 | yes                                                            |         |
-| protobuf   | yes                                                                 | yes                                                            |         |
-| readline   | yes, untested                                                       | yes, untested                                                  |         |
-| redis      | yes                                                                 | yes                                                            |         |
-| session    | yes                                                                 | yes                                                            |         |
-| shmop      | yes                                                                 | yes                                                            |         |
-| simplexml  | yes                                                                 | yes                                                            |         |
-| soap       | yes                                                                 | yes                                                            |         |
-| sockets    | yes                                                                 | yes                                                            |         |
-| sodium     | yes                                                                 | yes                                                            |         |
-| sqlite3    | yes                                                                 | yes                                                            |         |
-| ssh2       | yes, untested                                                       | yes, untested                                                  |         |
-| swow       | yes                                                                 | yes                                                            |         |
-| swoole     | [partial](https://github.com/crazywhalecc/static-php-cli/issues/51) | yes                                                            |         |
-| tokenizer  | yes                                                                 | yes                                                            |         |
-| xml        | yes                                                                 | yes                                                            |         |
-| xmlreader  | yes, untested                                                       | yes, untested                                                  |         |
-| xmlwriter  | yes, untested                                                       | yes, untested                                                  |         |
-| zip        | yes, untested                                                       | yes, untested                                                  |         |
-| zlib       | yes                                                                 | yes                                                            |         |
-| zstd       | yes                                                                 | yes                                                            |         |
-
-## Additional Requirements
-
-- phpmicro requires PHP >= 8.0
-- swoole >= 5.0 requires PHP >= 8.0
-- swow requires PHP >= 8.0
-
-## Typical Extension List Example
-
-Here are some extension list example for different use.
-
-- For general use: `"bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,ftp,filter,gd,iconv,xml,mbstring,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip"`
-- For static-php-cli self: `"posix,pcntl,phar,tokenizer,iconv,zlib"`
-- For static-php-cli self (with dev dependencies): `"posix,pcntl,phar,tokenizer,iconv,zlib,xml,dom,xmlwriter,xmlreader,fileinfo"`
-- Minimum, with no extension: `""`
-
-Compile with all supported extensions (exclude `swow`, `swoole` due to c++ extension):
-
-```bash
-bin/spc build --build-all bcmath,bz2,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,mbregex,mbstring,mongodb,mysqli,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,protobuf,redis,session,shmop,simplexml,soap,sockets,sqlite3,tokenizer,xml,xmlreader,xmlwriter,yaml,zip,zlib,zstd --with-libs=libjpeg,freetype,libwebp,libavif --debug
-```
-
-## Additional Libraries
-
-Some extensions have soft dependencies, you can enable extra features by adding these libs using `--with-libs`.
-
-For example, to compile with gd extension, with `libwebp, libgif, libavif, libjpeg, freetype` extra features:
-
-```bash
-bin/spc build gd --with-libs=libjpeg,freetype,libwebp,libavif --build-cli
-```
-
-> If you don't add them, your compilation will not enable these features.
-
-## Limitations
-
-- swow and swoole cannot be compiled at the same time.
-- openssl needs manual configuration for ssl certificate. (TODO: I will write a wiki about it)
-- some extensions need system configuration, e.g. `curl` and `openssl` will search ssl certificate on your system.
-
-## Bugs and TODOs
-
-See [#32](https://github.com/crazywhalecc/static-php-cli/issues/32).
+See: [Docs - Extensions](https://static-php-cli.zhamao.me/en/guide/extensions.html)

quickstart/linux/x86_64/README.md

@@ -1,34 +0,0 @@
-# 快速启动容器环境
-
-> 提供了 debian 11 构建 和 alpine 构建环境
-> 任意选一个就可以 
-
-## debian 11 构建环境
-
-```bash
-
-# 启动 debian 11 容器环境
-sh quickstart/linux/x86_64/run-debian-11-container.sh
-
-# 进入容器 
-sh quickstart/linux/x86_64/connection-static-php-cli.sh
-
-# 准备构建基础软件
-sh quickstart/linux/x86_64/debian-11-init.sh
-
-```
-
-## aline 构建环境
-
-```bash
-
-# 启动 alpine 容器环境
-sh quickstart/linux/x86_64/run-alpine-3.16-container.sh
-
-# 进入容器 
-sh sh quickstart/linux/x86_64/connection-static-php-cli.sh
-
-# 准备构建基础软件
-sh quickstart/linux/x86_64/alpine-3.16-init.sh
-
-```

quickstart/linux/x86_64/alpine-3.16-init.sh

@@ -1,38 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-cd ${__DIR__}
-
-
-# use china mirror
-# bash quickstart/linux/x86_64/alpine-3.16-init.sh --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)
-		test -f /etc/apk/repositories.save || cp /etc/apk/repositories /etc/apk/repositories.save
-    sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories
-		;;
-
-esac
-
-
-apk update
-
-apk add vim alpine-sdk xz autoconf automake linux-headers clang-dev clang lld libtool cmake bison re2c gettext coreutils

quickstart/linux/x86_64/connection-static-php-cli.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-
-cd ${__DIR__}
-
-docker exec -it static-php-cli-dev-1 sh

quickstart/linux/x86_64/debian-11-init.sh

@@ -1,42 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-cd ${__DIR__}
-
-# use china mirror
-# bash quickstart/linux/x86_64/debian-11-init.sh --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)
-		test -f /etc/apt/sources.list.save || cp /etc/apt/sources.list /etc/apt/sources.list.save
-    sed -i "s@deb.debian.org@mirrors.ustc.edu.cn@g" /etc/apt/sources.list && \
-    sed -i "s@security.debian.org@mirrors.ustc.edu.cn@g" /etc/apt/sources.list
-		;;
-
-esac
-
-
-apt update -y
-apt install -y git curl wget ca-certificates
-apt install -y xz-utils autoconf automake lld libtool cmake bison re2c gettext coreutils lzip zip unzip
-apt install -y pkg-config bzip2 flex
-apt install -y musl-tools g++
-apt install -y clang
-

quickstart/linux/x86_64/prepare.sh

@@ -1,25 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-__PROJECT__=$(
-  cd ${__DIR__}/../../../
-  pwd
-)
-cd ${__PROJECT__}
-
-composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
-chmod +x bin/spc
-
-./bin/spc fetch --all --debug
-
-./bin/spc list-ext
-
-
-#./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo,pdo_sqlite,ftp,curl" --cc=gcc --cxx=g++  --debug
-
-./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo,pdo_sqlite,ftp,curl" --cc=clang --cxx=clang++  --debug

quickstart/linux/x86_64/run-alpine-3.16-container.sh

@@ -1,25 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-__PROJECT__=$(
-  cd ${__DIR__}/../../../
-  pwd
-)
-cd ${__DIR__}
-
-
-{
-  docker stop static-php-cli-dev-1
-} || {
-  echo $?
-}
-cd ${__DIR__}
-IMAGE=alpine:3.16
-
-cd ${__DIR__}
-docker run --rm --name static-php-cli-dev-1 -d -v ${__PROJECT__}:/work -w /work $IMAGE tail -f /dev/null
-

quickstart/linux/x86_64/run-debian-11-container.sh

@@ -1,25 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-__PROJECT__=$(
-  cd ${__DIR__}/../../../
-  pwd
-)
-cd ${__DIR__}
-
-
-{
-  docker stop static-php-cli-dev-1
-} || {
-  echo $?
-}
-cd ${__DIR__}
-IMAGE=debian:11
-
-cd ${__DIR__}
-docker run --rm --name static-php-cli-dev-1 -d -v ${__PROJECT__}:/work -w /work $IMAGE tail -f /dev/null
-

quickstart/macOS/x86_64/prepare.sh

@@ -1,24 +0,0 @@
-#!/bin/bash
-
-set -exu
-__DIR__=$(
-  cd "$(dirname "$0")"
-  pwd
-)
-__PROJECT__=$(
-  cd ${__DIR__}/../../../
-  pwd
-)
-cd ${__PROJECT__}
-
-export PATH=${__PROJECT__}/bin/runtime:$PATH
-
-composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
-chmod +x bin/spc
-
-./bin/spc fetch --all --debug
-
-./bin/spc list-ext
-
-./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo,pdo_sqlite,ftp,curl" --cc=clang --cxx=clang++  --debug

src/SPC/ConsoleApplication.php

@@ -4,19 +4,17 @@ declare(strict_types=1);
 
 namespace SPC;
 
-use SPC\command\DeployCommand;
 use SPC\store\FileSystem;
 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
 {
-    public const VERSION = '2.0-rc1';
+    public const VERSION = '2.0-rc6';
 
     /**
      * @throws \ReflectionException
@@ -28,23 +26,26 @@ class ConsoleApplication extends Application
 
         global $argv;
 
-        // 生产环境不显示详细的调试错误，只使用 symfony console 自带的错误显示
+        // Detailed debugging errors are not displayed in the production environment. Only the error display provided by Symfony console is used.
         $this->setCatchExceptions(file_exists(ROOT_DIR . '/.prod') || !in_array('--debug', $argv));
 
-        // 通过扫描目录 src/static-php-cli/command/ 添加子命令
+        // Add subcommands by scanning the directory 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'))) {
+        $phar = class_exists('\\Phar') && \Phar::running() || !class_exists('\\Phar');
+        $commands = array_filter($commands, function ($y) use ($phar) {
+            $archive_blacklist = [
+                'SPC\command\dev\SortConfigCommand',
+                'SPC\command\DeployCommand',
+            ];
+            if ($phar && in_array($y, $archive_blacklist)) {
                 return false;
             }
             $reflection = new \ReflectionClass($y);
             return !$reflection->isAbstract() && !$reflection->isInterface();
-        })));
+        });
+        $this->addCommands(array_map(function ($x) { return new $x(); }, $commands));
     }
 
-    /**
-     * 重载以去除一些不必要的默认命令
-     */
     protected function getDefaultCommands(): array
     {
         return [new HelpCommand(), new ListCommand()];

src/SPC/builder/BuilderBase.php

@@ -9,48 +9,38 @@ 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 array<int, string> 要编译的扩展列表（仅名字列表，用于最后生成编译的扩展列表给 micro） */
-    protected array $plain_extensions = [];
-
-    /** @var bool 本次编译是否只编译 libs，不编译 PHP */
+    /** @var bool compile libs only (just mark it) */
     protected bool $libs_only = false;
 
-    /** @var bool 是否 strip 最终的二进制 */
-    protected bool $strip = true;
+    /** @var array<string, mixed> compile options */
+    protected array $options = [];
 
     /**
-     * 构建指定列表的 libs
+     * Build libraries
      *
+     * @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',
@@ -62,19 +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);
         }
+
+        // pkg-config must be compiled first, whether it is specified or not
         if (!in_array('pkg-config', $libraries)) {
             array_unshift($libraries, 'pkg-config');
         }
 
-        // 排序 libs，根据依赖计算一个新的列表出来
+        // 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!');
             }
@@ -82,14 +75,15 @@ abstract class BuilderBase
             $this->addLib($lib);
         }
 
-        // 计算依赖，经过这里的遍历，如果没有抛出异常，说明依赖符合要求，可以继续下面的
+        // calculate and check dependencies
         foreach ($this->libs as $lib) {
             $lib->calcDependency();
         }
 
-        $this->initSource(libs: $libraries);
+        // extract sources
+        SourceExtractor::initSource(libs: $libraries);
 
-        // 构建库
+        // build all libs
         foreach ($this->libs as $lib) {
             match ($lib->tryBuild()) {
                 BUILD_STATUS_OK => logger()->info('lib [' . $lib::NAME . '] build success'),
@@ -101,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
     {
@@ -111,9 +105,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 获取要编译的 Lib 库对象
-     *
-     * @param string $name 库名称
+     * Get library object by name.
      */
     public function getLib(string $name): ?LibraryBase
     {
@@ -121,9 +113,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 添加要编译的扩展
-     *
-     * @param Extension $extension 扩展对象
+     * Add extension to build.
      */
     public function addExt(Extension $extension): void
     {
@@ -131,9 +121,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 获取要编译的扩展对象
-     *
-     * @param string $name 扩展名称
+     * Get extension object by name.
      */
     public function getExt(string $name): ?Extension
     {
@@ -141,7 +129,37 @@ abstract class BuilderBase
     }
 
     /**
-     * 设置本次 Builder 是否为仅编译库的模式
+     * Get all extension objects.
+     *
+     * @return Extension[]
+     */
+    public function getExts(): array
+    {
+        return $this->exts;
+    }
+
+    /**
+     * Check if there is a cpp extension.
+     *
+     * @throws FileSystemException
+     * @throws WrongUsageException
+     */
+    public function hasCppExtension(): bool
+    {
+        // judge cpp-extension
+        $exts = array_keys($this->getExts());
+        $cpp = false;
+        foreach ($exts as $ext) {
+            if (Config::getExt($ext, 'cpp-extension', false) === true) {
+                $cpp = true;
+                break;
+            }
+        }
+        return $cpp;
+    }
+
+    /**
+     * Set libs only mode.
      */
     public function setLibsOnly(bool $status = true): void
     {
@@ -149,19 +167,21 @@ 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
     {
         CustomExt::loadCustomExt();
-        $this->initSource(sources: ['php-src']);
+        SourceExtractor::initSource(sources: ['php-src']);
         if ($this->getPHPVersionID() >= 80000) {
-            $this->initSource(sources: ['micro']);
+            SourceExtractor::initSource(sources: ['micro']);
         }
-        $this->initSource(exts: $extensions);
+        SourceExtractor::initSource(exts: $extensions);
         foreach ($extensions as $extension) {
             $class = CustomExt::getExtClass($extension);
             $ext = new $class($extension, $this);
@@ -169,27 +189,23 @@ abstract class BuilderBase
         }
 
         foreach ($this->exts as $ext) {
-            // 检查下依赖就行了，作用是导入依赖给 Extension 对象，今后可以对库依赖进行选择性处理
             $ext->checkDependency();
         }
-
-        $this->plain_extensions = $extensions;
     }
 
     /**
-     * 开始构建 PHP
+     * Start to build PHP
      *
-     * @param int  $build_target 规则
-     * @param bool $bloat        保留
+     * @param int $build_target Build target, see BUILD_TARGET_*
      */
-    abstract public function buildPHP(int $build_target = BUILD_TARGET_NONE, 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
     {
@@ -202,7 +218,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 返回是否只编译 libs 的模式
+     * Get libs only mode.
      */
     public function isLibsOnly(): bool
     {
@@ -210,7 +226,7 @@ abstract class BuilderBase
     }
 
     /**
-     * 获取当前即将编译的 PHP 的版本 ID，五位数那个
+     * Get PHP Version ID from php-src/main/php_version.h
      */
     public function getPHPVersionID(): int
     {
@@ -219,6 +235,11 @@ abstract class BuilderBase
         return intval($match[1]);
     }
 
+    /**
+     * Get build type name string to display.
+     *
+     * @param int $type Build target type
+     */
     public function getBuildTypeName(int $type): string
     {
         $ls = [];
@@ -234,13 +255,46 @@ abstract class BuilderBase
         return implode(', ', $ls);
     }
 
-    public function setStrip(bool $strip): void
+    /**
+     * 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
     {
-        $this->strip = $strip;
+        return $this->options[$key] ?? $default;
     }
 
     /**
-     * 检查是否存在 lib 库对应的源码，如果不存在，则抛出异常
+     * 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;
+    }
+
+    /**
+     * Check if all libs are downloaded.
+     * If not, throw exception.
      *
      * @throws RuntimeException
      */
@@ -261,52 +315,4 @@ abstract class BuilderBase
             );
         }
     }
-
-    protected function initSource(?array $sources = null, ?array $libs = null, ?array $exts = null): void
-    {
-        if (!file_exists(DOWNLOAD_PATH . '/.lock.json')) {
-            throw new WrongUsageException('Download lock file "downloads/.lock.json" not found, maybe you need to download sources first ?');
-        }
-        $lock = json_decode(FileSystem::readFile(DOWNLOAD_PATH . '/.lock.json'), true);
-
-        $sources_extracted = [];
-        // source check exist
-        if (is_array($sources)) {
-            foreach ($sources as $source) {
-                $sources_extracted[$source] = true;
-            }
-        }
-        // lib check source exist
-        if (is_array($libs)) {
-            foreach ($libs as $lib) {
-                // get source name for lib
-                $source = Config::getLib($lib, 'source');
-                $sources_extracted[$source] = true;
-            }
-        }
-        // ext check source exist
-        if (is_array($exts)) {
-            foreach ($exts as $ext) {
-                // get source name for ext
-                if (Config::getExt($ext, 'type') !== 'external') {
-                    continue;
-                }
-                $source = Config::getExt($ext, 'source');
-                $sources_extracted[$source] = true;
-            }
-        }
-
-        // start check
-        foreach ($sources_extracted as $source => $item) {
-            if (!isset($lock[$source])) {
-                throw new WrongUsageException('Source [' . $source . '] not downloaded, you should download it first !');
-            }
-
-            // check source dir exist
-            $check = $lock[$source]['move_path'] === null ? SOURCE_PATH . '/' . $source : SOURCE_PATH . '/' . $lock[$source]['move_path'];
-            if (!is_dir($check)) {
-                FileSystem::extractSource($source, DOWNLOAD_PATH . '/' . ($lock[$source]['filename'] ?? $lock[$source]['dirname']), $lock[$source]['move_path']);
-            }
-        }
-    }
 }

src/SPC/builder/BuilderProvider.php

@@ -6,7 +6,7 @@ namespace SPC\builder;
 
 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;
@@ -17,7 +17,9 @@ use Symfony\Component\Console\Input\InputInterface;
 class BuilderProvider
 {
     /**
+     * @throws FileSystemException
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public static function makeBuilderByInput(InputInterface $input): BuilderBase
     {
@@ -27,18 +29,8 @@ 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'),
-                zts: $input->getOption('enable-zts'),
-            ),
-            'Linux' => new LinuxBuilder(
-                cc: $input->getOption('cc'),
-                cxx: $input->getOption('cxx'),
-                arch: $input->getOption('arch'),
-                zts: $input->getOption('enable-zts'),
-            ),
+            'Darwin' => new MacOSBuilder($input->getOptions()),
+            'Linux' => new LinuxBuilder($input->getOptions()),
             default => throw new WrongUsageException('Current OS "' . PHP_OS_FAMILY . '" is not supported yet'),
         };
     }

src/SPC/builder/Extension.php

@@ -34,7 +34,7 @@ class Extension
     /**
      * 获取开启该扩展的 PHP 编译添加的参数
      *
-     * @throws FileSystemException|RuntimeException
+     * @throws FileSystemException
      * @throws WrongUsageException
      */
     public function getConfigureArg(): string
@@ -56,7 +56,6 @@ class Extension
      * 根据 ext 的 arg-type 获取对应开启的参数，一般都是 --enable-xxx 和 --with-xxx
      *
      * @throws FileSystemException
-     * @throws RuntimeException
      * @throws WrongUsageException
      */
     public function getEnableArg(): string
@@ -136,6 +135,33 @@ class Extension
         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
      */

src/SPC/builder/LibraryBase.php

@@ -7,20 +7,16 @@ namespace SPC\builder;
 use SPC\builder\macos\library\MacOSLibraryBase;
 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 = [];
 
     /**
@@ -35,7 +31,7 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取 lib 库的根目录
+     * Get current lib source root dir.
      */
     public function getSourceDir(): string
     {
@@ -43,10 +39,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
     {
@@ -55,7 +50,6 @@ abstract class LibraryBase
             return $this->dependencies;
         }
 
-        // 下面为递归获取依赖列表，根据依赖顺序
         $deps = [];
 
         $added = 1;
@@ -78,20 +72,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);
         }
@@ -101,11 +96,10 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取当前库编译出来获取到的静态库文件列表
+     * Get config static libs.
      *
-     * @return string[]            获取编译出来后的需要的静态库文件列表
      * @throws FileSystemException
-     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function getStaticLibs(): array
     {
@@ -113,11 +107,10 @@ abstract class LibraryBase
     }
 
     /**
-     * 获取当前 lib 编译出来的 C Header 文件列表
+     * Get config headers.
      *
-     * @return string[]            获取编译出来后需要的 C Header 文件列表
      * @throws FileSystemException
-     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function getHeaders(): array
     {
@@ -125,73 +118,84 @@ 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，表明直接编译
+        // force means just build
         if ($force_build) {
             logger()->info('Building required library [' . static::NAME . ']');
+            $this->patchBeforeBuild();
             $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 做特殊处理，如果是 pkg-config 就检查有没有 pkg-config 二进制
+        // pkg-config is treated specially. If it is pkg-config, check if the pkg-config binary exists
         if ($this instanceof MacOSLibraryBase && 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/event.php

@@ -5,6 +5,8 @@ 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')]
@@ -23,4 +25,13 @@ class event extends Extension
         }
         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/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,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+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
+        $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

@@ -10,6 +10,17 @@ use SPC\util\CustomExt;
 #[CustomExt('imagick')]
 class imagick extends Extension
 {
+    public function patchBeforeBuildconf(): bool
+    {
+        // linux need to link library manually, we add it to extra-libs
+        $extra_libs = $this->builder->getOption('extra-libs', '');
+        if (!str_contains($extra_libs, 'libMagickCore')) {
+            $extra_libs .= ' /usr/lib/libMagick++-7.Q16HDRI.a /usr/lib/libMagickCore-7.Q16HDRI.a /usr/lib/libMagickWand-7.Q16HDRI.a';
+        }
+        $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

@@ -14,4 +14,9 @@ class mbregex extends Extension
     {
         return 'mbstring';
     }
+
+    public function getConfigureArg(): string
+    {
+        return '';
+    }
 }

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

@@ -12,6 +12,16 @@ class mongodb extends Extension
 {
     public function getUnixConfigureArg(): string
     {
-        return '--enable-mongodb --without-mongodb-sasl';
+        $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/openssl.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\extension;
+
+use SPC\builder\Extension;
+use SPC\util\CustomExt;
+use SPC\util\Util;
+
+#[CustomExt('openssl')]
+class openssl extends Extension
+{
+    public function patchBeforeMake(): bool
+    {
+        // patch openssl3 with php8.0 bug
+        if (file_exists(SOURCE_PATH . '/openssl/VERSION.dat') && Util::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;
+    }
+}

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

@@ -12,7 +12,12 @@ class redis extends Extension
 {
     public function getUnixConfigureArg(): string
     {
-        $arg = '--enable-redis --disable-redis-session';
+        $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 . '"';
         }

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

@@ -13,6 +13,7 @@ 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

src/SPC/builder/extension/swow.php

@@ -5,7 +5,9 @@ declare(strict_types=1);
 namespace SPC\builder\extension;
 
 use SPC\builder\Extension;
+use SPC\exception\RuntimeException;
 use SPC\util\CustomExt;
+use SPC\util\Util;
 
 #[CustomExt('swow')]
 class swow extends Extension
@@ -17,4 +19,20 @@ class swow extends Extension
         $arg .= $this->builder->getLib('curl') ? ' --enable-swow-curl' : ' --disable-swow-curl';
         return $arg;
     }
+
+    /**
+     * @throws RuntimeException
+     */
+    public function patchBeforeBuildconf(): bool
+    {
+        if (Util::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/linux/LinuxBuilder.php

@@ -12,94 +12,91 @@ use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\SourcePatcher;
 
-/**
- * Linux 系统环境下的构建器
- */
 class LinuxBuilder extends BuilderBase
 {
-    /** 编译的 Unix 工具集 */
+    /** Unix compatible builder methods */
     use UnixBuilderTrait;
 
-    /** @var string[] Linux 环境下编译依赖的命令 */
-    public const REQUIRED_COMMANDS = ['make', 'bison', 'flex', 'pkg-config', 'git', 'autoconf', 'automake', 'tar', 'unzip', /* 'xz', 好像不需要 */ 'gzip', 'bzip2', 'cmake'];
-
-    /** @var string 使用的 libc */
+    /** @var string Using libc [musl,glibc] */
     public string $libc;
 
-    /** @var array 特殊架构下的 cflags */
+    /** @var array Tune cflags */
     public array $tune_c_flags;
 
-    /** @var string pkg-config 环境变量 */
+    /** @var string pkg-config env, including PKG_CONFIG_PATH, PKG_CONFIG */
     public string $pkgconf_env;
 
-    /** @var string 交叉编译变量 */
-    public string $cross_compile_prefix = '';
-
-    public string $note_section = "Je pense, donc je suis\0";
-
+    /** @var bool Micro patch phar flag */
     private bool $phar_patched = false;
 
     /**
+     * @throws FileSystemException
      * @throws RuntimeException
      * @throws WrongUsageException
      */
-    public function __construct(?string $cc = null, ?string $cxx = null, ?string $arch = null, bool $zts = false)
+    public function __construct(array $options = [])
     {
-        // 初始化一些默认参数
-        $this->cc = $cc ?? match (SystemUtil::getOSRelease()['dist']) {
+        $this->options = $options;
+
+        // ---------- set necessary options ----------
+        // set C Compiler (default: alpine: gcc, others: musl-gcc)
+        $this->setOptionIfNotExist('cc', match (SystemUtil::getOSRelease()['dist']) {
             'alpine' => 'gcc',
             default => 'musl-gcc'
-        };
-        $this->cxx = $cxx ?? 'g++';
-        $this->arch = $arch ?? php_uname('m');
-        $this->gnu_arch = arch2gnu($this->arch);
-        $this->zts = $zts;
-        $this->libc = 'musl'; // SystemUtil::selectLibc($this->cc);
+        });
+        // set C++ Compiler (default: g++)
+        $this->setOptionIfNotExist('cxx', 'g++');
+        // set arch (default: current)
+        $this->setOptionIfNotExist('arch', php_uname('m'));
+        $this->setOptionIfNotExist('gnu-arch', arch2gnu($this->getOption('arch')));
 
-        // 根据 CPU 线程数设置编译进程数
+        // ---------- set necessary compile environments ----------
+        // set libc
+        $this->libc = 'musl'; // SystemUtil::selectLibc($this->cc);
+        // concurrency
         $this->concurrency = SystemUtil::getCpuCount();
-        // 设置 cflags
-        $this->arch_c_flags = SystemUtil::getArchCFlags($this->cc, $this->arch);
-        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->cxx, $this->arch);
-        $this->tune_c_flags = SystemUtil::checkCCFlags(SystemUtil::getTuneCFlags($this->arch), $this->cc);
-        // 设置 cmake
+        // cflags
+        $this->arch_c_flags = SystemUtil::getArchCFlags($this->getOption('cc'), $this->getOption('arch'));
+        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->getOption('cxx'), $this->getOption('arch'));
+        $this->tune_c_flags = SystemUtil::checkCCFlags(SystemUtil::getTuneCFlags($this->getOption('arch')), $this->getOption('cc'));
+        // cmake toolchain
         $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile(
-            os: 'Linux',
-            target_arch: $this->arch,
-            cflags: $this->arch_c_flags,
-            cc: $this->cc,
-            cxx: $this->cxx
+            'Linux',
+            $this->getOption('arch'),
+            $this->arch_c_flags,
+            $this->getOption('cc'),
+            $this->getOption('cxx'),
         );
-        // 设置 pkgconfig
-        $this->pkgconf_env = 'PKG_CONFIG="' . BUILD_ROOT_PATH . '/bin/pkg-config" PKG_CONFIG_PATH="' . BUILD_LIB_PATH . '/pkgconfig"';
-        // 设置 configure 依赖的环境变量
-        $this->configure_env =
-            $this->pkgconf_env . ' ' .
-            "CC='{$this->cc}' " .
-            "CXX='{$this->cxx}' " .
-            (php_uname('m') === $this->arch ? '' : "CFLAGS='{$this->arch_c_flags}'");
-        // 交叉编译依赖的，TODO
-        if (php_uname('m') !== $this->arch) {
+        // pkg-config
+        $vars = [
+            'PKG_CONFIG' => BUILD_ROOT_PATH . '/bin/pkg-config',
+            'PKG_CONFIG_PATH' => BUILD_LIB_PATH . '/pkgconfig',
+        ];
+        $this->pkgconf_env = SystemUtil::makeEnvVarString($vars);
+        // configure environment
+        $this->configure_env = SystemUtil::makeEnvVarString([
+            ...$vars,
+            'CC' => $this->getOption('cc'),
+            'CXX' => $this->getOption('cxx'),
+            'PATH' => BUILD_ROOT_PATH . '/bin:' . getenv('PATH'),
+        ]);
+        // cross-compile does not support 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}'";
-        }
+        }*/
 
-        $missing = [];
-        foreach (self::REQUIRED_COMMANDS as $cmd) {
-            if (SystemUtil::findCommand($cmd) === null) {
-                $missing[] = $cmd;
-            }
-        }
-        if (!empty($missing)) {
-            throw new WrongUsageException('missing system commands: ' . implode(', ', $missing));
-        }
-
-        // 创立 pkg-config 和放头文件的目录
+        // 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 = '';
@@ -124,31 +121,22 @@ class LinuxBuilder extends BuilderBase
     /**
      * @throws RuntimeException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
-    public function buildPHP(int $build_target = BUILD_TARGET_NONE, bool $with_clean = false, bool $bloat = false)
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
     {
-        if (!$bloat) {
-            $extra_libs = implode(' ', $this->getAllStaticLibFiles());
+        // ---------- 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 {
-            logger()->info('bloat linking');
-            $extra_libs = implode(
-                ' ',
-                array_map(
-                    fn ($x) => "-Xcompiler {$x}",
-                    array_filter($this->getAllStaticLibFiles())
-                )
-            );
-        }
-        if ($this->getExt('swoole')) {
-            $extra_libs .= ' -lstdc++';
-        }
-        if ($this->getExt('imagick')) {
-            $extra_libs .= ' /usr/lib/libMagick++-7.Q16HDRI.a /usr/lib/libMagickCore-7.Q16HDRI.a /usr/lib/libMagickWand-7.Q16HDRI.a';
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", array_filter($this->getAllStaticLibFiles())));
         }
+        // add libstdc++, some extensions or libraries need it (C++ cannot be linked statically)
+        $extra_libs .= (empty($extra_libs) ? '' : ' ') . ($this->hasCppExtension() ? '-lstdc++ ' : '');
+        $this->setOption('extra-libs', $extra_libs);
 
-        $envs = $this->pkgconf_env . ' ' .
-            "CC='{$this->cc}' " .
-            "CXX='{$this->cxx}' ";
         $cflags = $this->arch_c_flags;
         $use_lld = '';
 
@@ -158,7 +146,7 @@ class LinuxBuilder extends BuilderBase
                 $cflags .= ' -static-libgcc -I"' . BUILD_INCLUDE_PATH . '"';
                 break;
             case 'musl':
-                if (str_ends_with($this->cc, 'clang') && SystemUtil::findCommand('lld')) {
+                if (str_ends_with($this->getOption('cc'), 'clang') && SystemUtil::findCommand('lld')) {
                     $use_lld = '-Xcompiler -fuse-ld=lld';
                 }
                 break;
@@ -166,18 +154,29 @@ class LinuxBuilder extends BuilderBase
                 throw new WrongUsageException('libc ' . $this->libc . ' is not implemented yet');
         }
 
-        $envs = "{$envs} CFLAGS='{$cflags}' LIBS='-ldl -lpthread'";
+        $envs = $this->pkgconf_env . ' ' . SystemUtil::makeEnvVarString([
+            'CC' => $this->getOption('cc'),
+            'CXX' => $this->getOption('cxx'),
+            'CFLAGS' => $cflags,
+            'LIBS' => '-ldl -lpthread',
+            'PATH' => BUILD_ROOT_PATH . '/bin:' . getenv('PATH'),
+        ]);
 
-        SourcePatcher::patchPHPBuildconf($this);
+        SourcePatcher::patchBeforeBuildconf($this);
 
         shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
 
-        SourcePatcher::patchPHPConfigure($this);
+        SourcePatcher::patchBeforeConfigure($this);
 
-        if ($this->getPHPVersionID() < 80000) {
-            $json_74 = '--enable-json ';
+        $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 {
-            $json_74 = '';
+            $maxExecutionTimers = '';
+            $zts = '';
         }
 
         shell()->cd(SOURCE_PATH . '/php-src')
@@ -193,24 +192,17 @@ class LinuxBuilder extends BuilderBase
                 '--enable-cli ' .
                 '--enable-fpm ' .
                 $json_74 .
+                $zts .
+                $maxExecutionTimers .
                 '--enable-micro=all-static ' .
-                ($this->zts ? '--enable-zts' : '') . ' ' .
                 $this->makeExtensionArgs() . ' ' .
                 $envs
             );
 
-        SourcePatcher::patchPHPAfterConfigure($this);
+        SourcePatcher::patchBeforeMake($this);
 
-        file_put_contents('/tmp/comment', $this->note_section);
-
-        // 清理
         $this->cleanMake();
 
-        if ($bloat) {
-            logger()->info('bloat linking');
-            $extra_libs = "-Wl,--whole-archive {$extra_libs} -Wl,--no-whole-archive";
-        }
-
         if (($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
             logger()->info('building cli');
             $this->buildCli($extra_libs, $use_lld);
@@ -224,7 +216,7 @@ class LinuxBuilder extends BuilderBase
             $this->buildMicro($extra_libs, $use_lld, $cflags);
         }
 
-        if (php_uname('m') === $this->arch) {
+        if (php_uname('m') === $this->getOption('arch')) {
             $this->sanityCheck($build_target);
         }
 
@@ -234,30 +226,34 @@ class LinuxBuilder extends BuilderBase
     }
 
     /**
+     * Build cli sapi
+     *
      * @throws RuntimeException
+     * @throws FileSystemException
      */
     public function buildCli(string $extra_libs, string $use_lld): void
     {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)),
+            'EXTRA_LIBS' => $extra_libs,
+            'EXTRA_LDFLAGS_PROGRAM' => "{$use_lld} -all-static",
+        ]);
         shell()->cd(SOURCE_PATH . '/php-src')
             ->exec('sed -i "s|//lib|/lib|g" Makefile')
-            ->exec(
-                'make -j' . $this->concurrency .
-                ' EXTRA_CFLAGS="-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . '" ' .
-                "EXTRA_LIBS=\"{$extra_libs}\" " .
-                "EXTRA_LDFLAGS_PROGRAM='{$use_lld} -all-static' " .
-                'cli'
-            );
+            ->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');
+        }
 
-        shell()->cd(SOURCE_PATH . '/php-src/sapi/cli')
-            ->exec("{$this->cross_compile_prefix}objcopy --only-keep-debug php php.debug")
-            ->exec('elfedit --output-osabi linux php')
-            ->exec("{$this->cross_compile_prefix}strip --strip-all php")
-            ->exec("{$this->cross_compile_prefix}objcopy --update-section .comment=/tmp/comment --add-gnu-debuglink=php.debug --remove-section=.note php");
         $this->deployBinary(BUILD_TARGET_CLI);
     }
 
     /**
+     * Build phpmicro sapi
+     *
      * @throws RuntimeException
+     * @throws FileSystemException
      */
     public function buildMicro(string $extra_libs, string $use_lld, string $cflags): void
     {
@@ -269,43 +265,45 @@ class LinuxBuilder extends BuilderBase
             SourcePatcher::patchMicro(['phar']);
         }
 
+        $enable_fake_cli = $this->getOption('with-micro-fake-cli', false) ? ' -DPHP_MICRO_FAKE_CLI' : '';
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . $enable_fake_cli,
+            'EXTRA_LIBS' => $extra_libs,
+            'EXTRA_LDFLAGS_PROGRAM' => "{$cflags} {$use_lld} -all-static",
+        ]);
         shell()->cd(SOURCE_PATH . '/php-src')
             ->exec('sed -i "s|//lib|/lib|g" Makefile')
-            ->exec(
-                "make -j{$this->concurrency} " .
-                'EXTRA_CFLAGS=' . quote('-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags))) . ' ' .
-                'EXTRA_LIBS=' . quote($extra_libs) . ' ' .
-                'EXTRA_LDFLAGS_PROGRAM=' . quote("{$cflags} {$use_lld}" . ' -all-static', "'") . ' ' .
-                'micro'
-            );
+            ->exec("make -j{$this->concurrency} {$vars} micro");
 
-        shell()->cd(SOURCE_PATH . '/php-src/sapi/micro')->exec("{$this->cross_compile_prefix}strip --strip-all micro.sfx");
+        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);
     }
 
     /**
-     * 构建 fpm
+     * Build fpm sapi
      *
-     * @throws FileSystemException|RuntimeException
+     * @throws FileSystemException
+     * @throws RuntimeException
      */
     public function buildFpm(string $extra_libs, string $use_lld): void
     {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)),
+            'EXTRA_LIBS' => $extra_libs,
+            'EXTRA_LDFLAGS_PROGRAM' => "{$use_lld} -all-static",
+        ]);
+
         shell()->cd(SOURCE_PATH . '/php-src')
             ->exec('sed -i "s|//lib|/lib|g" Makefile')
-            ->exec(
-                'make -j' . $this->concurrency .
-                ' EXTRA_CFLAGS="-g -Os -fno-ident ' . implode(' ', array_map(fn ($x) => "-Xcompiler {$x}", $this->tune_c_flags)) . '" ' .
-                "EXTRA_LIBS=\"{$extra_libs}\" " .
-                "EXTRA_LDFLAGS_PROGRAM='{$use_lld} -all-static' " .
-                'fpm'
-            );
+            ->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');
+        }
 
-        shell()->cd(SOURCE_PATH . '/php-src/sapi/fpm')
-            ->exec("{$this->cross_compile_prefix}objcopy --only-keep-debug php-fpm php-fpm.debug")
-            ->exec('elfedit --output-osabi linux php-fpm')
-            ->exec("{$this->cross_compile_prefix}strip --strip-all php-fpm")
-            ->exec("{$this->cross_compile_prefix}objcopy --update-section .comment=/tmp/comment --add-gnu-debuglink=php-fpm.debug --remove-section=.note php-fpm");
         $this->deployBinary(BUILD_TARGET_FPM);
     }
 }

src/SPC/builder/linux/SystemUtil.php

@@ -4,7 +4,6 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux;
 
-use JetBrains\PhpStorm\ArrayShape;
 use SPC\builder\traits\UnixSystemUtilTrait;
 use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
@@ -13,7 +12,7 @@ class SystemUtil
 {
     use UnixSystemUtilTrait;
 
-    #[ArrayShape(['dist' => 'mixed|string', 'ver' => 'mixed|string'])]
+    /** @noinspection PhpMissingBreakStatementInspection */
     public static function getOSRelease(): array
     {
         $ret = [
@@ -81,6 +80,8 @@ class SystemUtil
 
     /**
      * @throws RuntimeException
+     * @throws WrongUsageException
+     * @throws WrongUsageException
      */
     public static function getArchCFlags(string $cc, string $arch): string
     {
@@ -129,6 +130,7 @@ class SystemUtil
 
     /**
      * @throws RuntimeException
+     * @noinspection PhpUnused
      */
     public static function getCrossCompilePrefix(string $cc, string $arch): string
     {
@@ -159,6 +161,7 @@ class SystemUtil
         return null;
     }
 
+    /** @noinspection PhpUnused */
     public static function findStaticLibs(array $names): ?array
     {
         $ret = [];
@@ -187,6 +190,7 @@ class SystemUtil
         return null;
     }
 
+    /** @noinspection PhpUnused */
     public static function findHeaders(array $names): ?array
     {
         $ret = [];

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

@@ -8,7 +8,9 @@ use SPC\builder\BuilderBase;
 use SPC\builder\LibraryBase;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\builder\traits\UnixLibraryTrait;
+use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 
 abstract class LinuxLibraryBase extends LibraryBase
 {
@@ -37,12 +39,15 @@ abstract class LinuxLibraryBase extends LibraryBase
 
     /**
      * @throws RuntimeException
+     * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function tryBuild(bool $force_build = false): int
     {
         // 传入 true，表明直接编译
         if ($force_build) {
             logger()->info('Building required library [' . static::NAME . ']');
+            $this->patchBeforeBuild();
             $this->build();
             return BUILD_STATUS_OK;
         }
@@ -70,7 +75,7 @@ abstract class LinuxLibraryBase extends LibraryBase
         return BUILD_STATUS_ALREADY;
     }
 
-    protected function makeFakePkgconfs()
+    protected function makeFakePkgconfs(): void
     {
         $workspace = BUILD_ROOT_PATH;
         if ($workspace === '/') {

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

@@ -0,0 +1,34 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\linux\library;
+
+class icu extends LinuxLibraryBase
+{
+    public const NAME = 'icu';
+
+    protected function build(): void
+    {
+        $root = BUILD_ROOT_PATH;
+        $cppflag = 'CPPFLAGS="-DU_CHARSET_IS_UTF8=1  -DU_USING_ICU_NAMESPACE=1  -DU_STATIC_IMPLEMENTATION=1"';
+        shell()->cd($this->source_dir . '/source')
+            ->exec(
+                "{$this->builder->configure_env} {$cppflag} ./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={$root}"
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install');
+    }
+}

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

@@ -20,34 +20,54 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux\library;
 
+use SPC\builder\linux\SystemUtil;
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
-use SPC\store\SourcePatcher;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
 
 class libpng extends LinuxLibraryBase
 {
     public const NAME = 'libpng';
 
     /**
-     * @throws RuntimeException
      * @throws FileSystemException
      */
-    public function build()
+    public function patchBeforeBuild(): bool
     {
-        $optimizations = match ($this->builder->arch) {
+        FileSystem::replaceFileStr(
+            SOURCE_PATH . '/libpng/configure',
+            '-lz',
+            BUILD_LIB_PATH . '/libz.a'
+        );
+        if (SystemUtil::getOSRelease()['dist'] === 'alpine') {
+            FileSystem::replaceFileStr(
+                SOURCE_PATH . '/libpng/configure',
+                '-lm',
+                '/usr/lib/libm.a'
+            );
+        }
+        return true;
+    }
+
+    /**
+     * @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 => '',
         };
-
-        // patch configure
-        SourcePatcher::patchUnixLibpng();
-
         shell()->cd($this->source_dir)
             ->exec('chmod +x ./configure')
+            ->exec('chmod +x ./install-sh')
             ->exec(
                 "{$this->builder->configure_env} ./configure " .
-                "--host={$this->builder->gnu_arch}-unknown-linux " .
+                "--host={$this->builder->getOption('gnu-arch')}-unknown-linux " .
                 '--disable-shared ' .
                 '--enable-static ' .
                 '--enable-hardware-optimizations ' .

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

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace SPC\builder\linux\library;
 
+use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
@@ -13,25 +14,27 @@ class libxml2 extends LinuxLibraryBase
 
     /**
      * @throws RuntimeException
+     * @throws FileSystemException
      */
-    public function build()
+    public function build(): void
     {
         $enable_zlib = $this->builder->getLib('zlib') ? 'ON' : 'OFF';
-        $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
+        // $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
         $enable_xz = $this->builder->getLib('xz') ? 'ON' : 'OFF';
 
-        [$lib, $include, $destdir] = SEPARATED_PATH;
-
         FileSystem::resetDir($this->source_dir . '/build');
         shell()->cd($this->source_dir . '/build')
             ->exec(
                 "{$this->builder->configure_env} " . ' cmake ' .
-                "{$this->builder->makeCmakeArgs()} " .
+                "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
+                '-DCMAKE_BUILD_TYPE=Release ' .
+                '-DCMAKE_INSTALL_PREFIX=' . escapeshellarg(BUILD_ROOT_PATH) . ' ' .
                 '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DCMAKE_INSTALL_BINDIR=' . escapeshellarg(BUILD_ROOT_PATH . '/bin') . ' ' .
                 '-DLIBXML2_WITH_ICONV=ON ' .
                 '-DIconv_IS_BUILT_IN=OFF ' .
                 "-DLIBXML2_WITH_ZLIB={$enable_zlib} " .
-                "-DLIBXML2_WITH_ICU={$enable_icu} " .
+                '-DLIBXML2_WITH_ICU=OFF ' .
                 "-DLIBXML2_WITH_LZMA={$enable_xz} " .
                 '-DLIBXML2_WITH_PYTHON=OFF ' .
                 '-DLIBXML2_WITH_PROGRAMS=OFF ' .
@@ -39,15 +42,6 @@ class libxml2 extends LinuxLibraryBase
                 '..'
             )
             ->exec("cmake --build . -j {$this->builder->concurrency}")
-            ->exec("make install DESTDIR={$destdir}");
-
-        if (is_dir(BUILD_INCLUDE_PATH . '/libxml2/libxml')) {
-            if (is_dir(BUILD_INCLUDE_PATH . '/libxml')) {
-                shell()->exec('rm -rf "' . BUILD_INCLUDE_PATH . '/libxml"');
-            }
-            $path = FileSystem::convertPath(BUILD_INCLUDE_PATH . '/libxml2/libxml');
-            $dst_path = FileSystem::convertPath(BUILD_INCLUDE_PATH . '/');
-            shell()->exec('mv "' . $path . '" "' . $dst_path . '"');
-        }
+            ->exec('make install');
     }
 }

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/nghttp2.php

@@ -20,11 +20,20 @@ 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';
 
-    public function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    public function build(): void
     {
         $args = $this->builder->makeAutoconfArgs(static::NAME, [
             'zlib' => null,
@@ -49,7 +58,7 @@ class nghttp2 extends LinuxLibraryBase
                 "{$this->builder->configure_env} ./configure " .
                 '--enable-static ' .
                 '--disable-shared ' .
-                "--host={$this->builder->gnu_arch}-unknown-linux " .
+                "--host={$this->builder->getOption('gnu-arch')}-unknown-linux " .
                 '--enable-lib-only ' .
                 '--with-boost=no ' .
                 $args . ' ' .

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

@@ -23,26 +23,28 @@ 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 RuntimeException
      * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
      */
-    public function build()
+    public function build(): void
     {
-        [$lib,$include,$destdir] = SEPARATED_PATH;
+        [,,$destdir] = SEPARATED_PATH;
 
         $extra = '';
         $ex_lib = '-ldl -pthread';
 
         $env = $this->builder->pkgconf_env . " CFLAGS='{$this->builder->arch_c_flags}'";
-        $env .= " CC='{$this->builder->cc} -static -idirafter " . BUILD_INCLUDE_PATH .
+        $env .= " CC='{$this->builder->getOption('cc')} -static -idirafter " . BUILD_INCLUDE_PATH .
             ' -idirafter /usr/include/ ' .
-            ' -idirafter /usr/include/' . $this->builder->arch . '-linux-gnu/ ' .
+            ' -idirafter /usr/include/' . $this->builder->getOption('arch') . '-linux-gnu/ ' .
             "' ";
         // lib:zlib
         $zlib = $this->builder->getLib('zlib');
@@ -58,7 +60,7 @@ class openssl extends LinuxLibraryBase
 
         $ex_lib = trim($ex_lib);
 
-        $clang_postfix = SystemUtil::getCCType($this->builder->cc) === 'clang' ? '-clang' : '';
+        $clang_postfix = SystemUtil::getCCType($this->builder->getOption('cc')) === 'clang' ? '-clang' : '';
 
         shell()->cd($this->source_dir)
             ->exec(
@@ -68,7 +70,7 @@ class openssl extends LinuxLibraryBase
                 '-static ' .
                 "{$zlib_extra}" .
                 'no-legacy ' .
-                "linux-{$this->builder->arch}{$clang_postfix}"
+                "linux-{$this->builder->getOption('arch')}{$clang_postfix}"
             )
             ->exec('make clean')
             ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")

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/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/macos/MacOSBuilder.php

@@ -12,57 +12,57 @@ use SPC\exception\RuntimeException;
 use SPC\exception\WrongUsageException;
 use SPC\store\SourcePatcher;
 
-/**
- * macOS 系统环境下的构建器
- * 源于 Config，但因为感觉叫 Config 不太合适，就换成了 Builder
- */
 class MacOSBuilder extends BuilderBase
 {
-    /** 编译的 Unix 工具集 */
+    /** Unix compatible builder methods */
     use UnixBuilderTrait;
 
-    /** @var bool 标记是否 patch 了 phar */
+    /** @var bool Micro patch phar flag */
     private bool $phar_patched = false;
 
     /**
-     * @param  null|string         $cc   C编译器名称，如果不传入则默认使用clang
-     * @param  null|string         $cxx  C++编译器名称，如果不传入则默认使用clang++
-     * @param  null|string         $arch 当前架构，如果不传入则默认使用当前系统架构
      * @throws RuntimeException
      * @throws WrongUsageException
+     * @throws FileSystemException
      */
-    public function __construct(?string $cc = null, ?string $cxx = null, ?string $arch = null, bool $zts = false)
+    public function __construct(array $options = [])
     {
-        // 如果是 Debug 模式，才使用 set -x 显示每条执行的命令
-        $this->set_x = defined('DEBUG_MODE') ? 'set -x' : 'true';
-        // 初始化一些默认参数
-        $this->cc = $cc ?? 'clang';
-        $this->cxx = $cxx ?? 'clang++';
-        $this->arch = $arch ?? php_uname('m');
-        $this->gnu_arch = arch2gnu($this->arch);
-        $this->zts = $zts;
-        // 根据 CPU 线程数设置编译进程数
-        $this->concurrency = SystemUtil::getCpuCount();
-        // 设置 cflags
-        $this->arch_c_flags = SystemUtil::getArchCFlags($this->arch);
-        $this->arch_cxx_flags = SystemUtil::getArchCFlags($this->arch);
-        // 设置 cmake
-        $this->cmake_toolchain_file = SystemUtil::makeCmakeToolchainFile('Darwin', $this->arch, $this->arch_c_flags);
-        // 设置 configure 依赖的环境变量
-        $this->configure_env =
-            'PKG_CONFIG="' . BUILD_ROOT_PATH . '/bin/pkg-config" ' .
-            'PKG_CONFIG_PATH="' . BUILD_LIB_PATH . '/pkgconfig/" ' .
-            "CC='{$this->cc}' " .
-            "CXX='{$this->cxx}' " .
-            "CFLAGS='{$this->arch_c_flags} -Wimplicit-function-declaration'";
+        $this->options = $options;
 
-        // 创立 pkg-config 和放头文件的目录
+        // ---------- set necessary options ----------
+        // set C Compiler (default: clang)
+        $this->setOptionIfNotExist('cc', 'clang');
+        // set C++ Composer (default: clang++)
+        $this->setOptionIfNotExist('cxx', 'clang++');
+        // 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('Darwin', $this->getOption('arch'), $this->arch_c_flags);
+        // configure environment
+        $this->configure_env = SystemUtil::makeEnvVarString([
+            'PKG_CONFIG' => BUILD_ROOT_PATH . '/bin/pkg-config',
+            'PKG_CONFIG_PATH' => BUILD_LIB_PATH . '/pkgconfig/',
+            'CC' => $this->getOption('cc'),
+            'CXX' => $this->getOption('cxx'),
+            'CFLAGS' => "{$this->arch_c_flags} -Wimplicit-function-declaration -Os",
+            'PATH' => BUILD_ROOT_PATH . '/bin:' . getenv('PATH'),
+        ]);
+
+        // 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);
     }
 
     /**
-     * 生成库构建采用的 autoconf 参数列表
+     * [deprecated] 生成库构建采用的 autoconf 参数列表
      *
      * @param string $name      要构建的 lib 库名，传入仅供输出日志
      * @param array  $lib_specs 依赖的 lib 库的 autoconf 文件
@@ -76,7 +76,6 @@ class MacOSBuilder extends BuilderBase
             $arr = $arr ?? [];
 
             $disableArgs = $arr[0] ?? null;
-            $prefix = $arr[1] ?? null;
             if ($lib instanceof MacOSLibraryBase) {
                 logger()->info("{$name} \033[32;1mwith\033[0;1m {$libName} support");
                 $ret .= '--with-' . $libName . '=yes ';
@@ -89,9 +88,11 @@ class MacOSBuilder extends BuilderBase
     }
 
     /**
-     * 返回 macOS 系统依赖的框架列表
+     * Get dynamically linked macOS frameworks
      *
-     * @param bool $asString 是否以字符串形式返回（默认为 False）
+     * @param  bool                $asString If true, return as string
+     * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function getFrameworks(bool $asString = false): array|string
     {
@@ -118,47 +119,43 @@ class MacOSBuilder extends BuilderBase
     }
 
     /**
-     * @throws RuntimeException
+     * 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, bool $bloat = false): void
+    public function buildPHP(int $build_target = BUILD_TARGET_NONE): void
     {
-        $extra_libs = $this->getFrameworks(true) . ' ' . ($this->getExt('swoole') ? '-lc++ ' : '');
-        if (!$bloat) {
-            $extra_libs .= implode(' ', $this->getAllStaticLibFiles());
+        // ---------- Update extra-libs ----------
+        $extra_libs = $this->getOption('extra-libs', '');
+        // add macOS frameworks
+        $extra_libs .= (empty($extra_libs) ? '' : ' ') . $this->getFrameworks(true);
+        // add libc++, some extensions or libraries need it (C++ cannot be linked statically)
+        $extra_libs .= (empty($extra_libs) ? '' : ' ') . ($this->hasCppExtension() ? '-lc++ ' : '');
+        if (!$this->getOption('bloat', false)) {
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', $this->getAllStaticLibFiles());
         } else {
             logger()->info('bloat linking');
-            $extra_libs .= implode(
-                ' ',
-                array_map(
-                    fn ($x) => "-Wl,-force_load,{$x}",
-                    array_filter($this->getAllStaticLibFiles())
-                )
-            );
+            $extra_libs .= (empty($extra_libs) ? '' : ' ') . implode(' ', array_map(fn ($x) => "-Wl,-force_load,{$x}", array_filter($this->getAllStaticLibFiles())));
         }
+        $this->setOption('extra-libs', $extra_libs);
 
-        // patch before configure
-        SourcePatcher::patchPHPBuildconf($this);
+        SourcePatcher::patchBeforeBuildconf($this);
 
         shell()->cd(SOURCE_PATH . '/php-src')->exec('./buildconf --force');
 
-        SourcePatcher::patchPHPConfigure($this);
+        SourcePatcher::patchBeforeConfigure($this);
 
-        if ($this->getLib('libxml2') || $this->getExt('iconv')) {
-            $extra_libs .= ' -liconv';
-        }
-
-        if ($this->getPHPVersionID() < 80000) {
-            $json_74 = '--enable-json ';
-        } else {
-            $json_74 = '';
-        }
+        $json_74 = $this->getPHPVersionID() < 80000 ? '--enable-json ' : '';
+        $zts = $this->getOption('enable-zts', false) ? '--enable-zts --disable-zend-signals ' : '';
 
         shell()->cd(SOURCE_PATH . '/php-src')
             ->exec(
                 './configure ' .
                 '--prefix= ' .
-                '--with-valgrind=no ' .     // 不检测内存泄漏
+                '--with-valgrind=no ' .     // Not detect memory leak
                 '--enable-shared=no ' .
                 '--enable-static=yes ' .
                 "CFLAGS='{$this->arch_c_flags} -Werror=unknown-warning-option' " .
@@ -167,31 +164,31 @@ class MacOSBuilder extends BuilderBase
                 '--disable-phpdbg ' .
                 '--enable-cli ' .
                 '--enable-fpm ' .
-                $json_74 .
                 '--enable-micro ' .
-                ($this->zts ? '--enable-zts' : '') . ' ' .
+                $json_74 .
+                $zts .
                 $this->makeExtensionArgs() . ' ' .
                 $this->configure_env
             );
 
-        SourcePatcher::patchPHPAfterConfigure($this);
+        SourcePatcher::patchBeforeMake($this);
 
         $this->cleanMake();
 
         if (($build_target & BUILD_TARGET_CLI) === BUILD_TARGET_CLI) {
             logger()->info('building cli');
-            $this->buildCli($extra_libs);
+            $this->buildCli();
         }
         if (($build_target & BUILD_TARGET_FPM) === BUILD_TARGET_FPM) {
             logger()->info('building fpm');
-            $this->buildFpm($extra_libs);
+            $this->buildFpm();
         }
         if (($build_target & BUILD_TARGET_MICRO) === BUILD_TARGET_MICRO) {
             logger()->info('building micro');
-            $this->buildMicro($extra_libs);
+            $this->buildMicro();
         }
 
-        if (php_uname('m') === $this->arch) {
+        if (php_uname('m') === $this->getOption('arch')) {
             $this->sanityCheck($build_target);
         }
 
@@ -201,27 +198,32 @@ class MacOSBuilder extends BuilderBase
     }
 
     /**
-     * 构建 cli
+     * Build cli sapi
      *
      * @throws RuntimeException
      * @throws FileSystemException
      */
-    public function buildCli(string $extra_libs): void
+    public function buildCli(): void
     {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv", // link resolv library (macOS need it)
+        ]);
+
         $shell = shell()->cd(SOURCE_PATH . '/php-src');
-        $shell->exec("make -j{$this->concurrency} EXTRA_CFLAGS=\"-g -Os -fno-ident\" EXTRA_LIBS=\"{$extra_libs} -lresolv\" cli");
-        if ($this->strip) {
+        $shell->exec("make -j{$this->concurrency} {$vars} cli");
+        if (!$this->getOption('no-strip', false)) {
             $shell->exec('dsymutil -f sapi/cli/php')->exec('strip sapi/cli/php');
         }
         $this->deployBinary(BUILD_TARGET_CLI);
     }
 
     /**
-     * 构建 phpmicro
+     * Build phpmicro sapi
      *
      * @throws FileSystemException|RuntimeException
      */
-    public function buildMicro(string $extra_libs): void
+    public function buildMicro(): void
     {
         if ($this->getPHPVersionID() < 80000) {
             throw new RuntimeException('phpmicro only support PHP >= 8.0!');
@@ -231,22 +233,39 @@ class MacOSBuilder extends BuilderBase
             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 -fno-ident' . $enable_fake_cli,
+            // link resolv library (macOS need it)
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv",
+        ];
+        if (!$this->getOption('no-strip', false)) {
+            $vars['STRIP'] = 'dsymutil -f ';
+        }
+        $vars = SystemUtil::makeEnvVarString($vars);
+
         shell()->cd(SOURCE_PATH . '/php-src')
-            ->exec("make -j{$this->concurrency} EXTRA_CFLAGS=\"-g -Os -fno-ident\" EXTRA_LIBS=\"{$extra_libs} -lresolv\" " . ($this->strip ? 'STRIP="dsymutil -f " ' : '') . 'micro');
+            ->exec("make -j{$this->concurrency} {$vars} micro");
         $this->deployBinary(BUILD_TARGET_MICRO);
     }
 
     /**
-     * 构建 fpm
+     * Build fpm sapi
      *
      * @throws RuntimeException
      * @throws FileSystemException
      */
-    public function buildFpm(string $extra_libs): void
+    public function buildFpm(): void
     {
+        $vars = SystemUtil::makeEnvVarString([
+            'EXTRA_CFLAGS' => '-g -Os', // with debug information, but optimize for size
+            'EXTRA_LIBS' => "{$this->getOption('extra-libs')} -lresolv", // link resolv library (macOS need it)
+        ]);
+
         $shell = shell()->cd(SOURCE_PATH . '/php-src');
-        $shell->exec("make -j{$this->concurrency} EXTRA_CFLAGS=\"-g -Os -fno-ident\" EXTRA_LIBS=\"{$extra_libs} -lresolv\" fpm");
-        if ($this->strip) {
+        $shell->exec("make -j{$this->concurrency} {$vars} fpm");
+        if (!$this->getOption('no-strip', false)) {
             $shell->exec('dsymutil -f sapi/fpm/php-fpm')->exec('strip sapi/fpm/php-fpm');
         }
         $this->deployBinary(BUILD_TARGET_FPM);

src/SPC/builder/macos/SystemUtil.php

@@ -10,11 +10,11 @@ use SPC\exception\WrongUsageException;
 
 class SystemUtil
 {
-    /** macOS 兼容 unix 的系统工具 */
+    /** Unix System Util Compatible */
     use UnixSystemUtilTrait;
 
     /**
-     * 获取系统 CPU 逻辑内核数
+     * Get Logic CPU Count for macOS
      *
      * @throws RuntimeException
      */
@@ -29,9 +29,10 @@ class SystemUtil
     }
 
     /**
-     * 获取不同架构对应的 cflags 参数
+     * Get Target Arch CFlags
      *
-     * @param  string              $arch 架构名称
+     * @param  string              $arch Arch Name
+     * @return string              return Arch CFlags string
      * @throws WrongUsageException
      */
     public static function getArchCFlags(string $arch): string

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

@@ -8,6 +8,8 @@ use SPC\builder\BuilderBase;
 use SPC\builder\LibraryBase;
 use SPC\builder\macos\MacOSBuilder;
 use SPC\builder\traits\UnixLibraryTrait;
+use SPC\exception\FileSystemException;
+use SPC\exception\WrongUsageException;
 use SPC\store\Config;
 
 abstract class MacOSLibraryBase extends LibraryBase
@@ -27,7 +29,8 @@ abstract class MacOSLibraryBase extends LibraryBase
     }
 
     /**
-     * 获取当前 lib 库依赖的 macOS framework
+     * @throws WrongUsageException
+     * @throws FileSystemException
      */
     public function getFrameworks(): array
     {

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

@@ -20,19 +20,30 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
-use SPC\store\SourcePatcher;
+use SPC\exception\FileSystemException;
+use SPC\store\FileSystem;
 
 class curl extends MacOSLibraryBase
 {
-    use \SPC\builder\unix\library\curl {
-        build as unixBuild;
-    }
+    use \SPC\builder\unix\library\curl;
 
     public const NAME = 'curl';
 
-    protected function build()
+    /**
+     * @throws FileSystemException
+     */
+    public function patchBeforeBuild(): bool
     {
-        SourcePatcher::patchCurlMacOS();
-        $this->unixBuild();
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/curl/CMakeLists.txt',
+            '/NOT COREFOUNDATION_FRAMEWORK/m',
+            'FALSE'
+        );
+        FileSystem::replaceFileRegex(
+            SOURCE_PATH . '/curl/CMakeLists.txt',
+            '/NOT SYSTEMCONFIGURATION_FRAMEWORK/m',
+            'FALSE'
+        );
+        return true;
     }
 }

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

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
+class glfw extends MacOSLibraryBase
+{
+    public const NAME = 'glfw';
+
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build(): void
+    {
+        // compile！
+        shell()->cd(SOURCE_PATH . '/ext-glfw/vendor/glfw')
+            ->exec("{$this->builder->configure_env} cmake . {$this->builder->makeCmakeArgs()} -DBUILD_SHARED_LIBS=OFF -DGLFW_BUILD_EXAMPLES=OFF -DGLFW_BUILD_TESTS=OFF")
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . BUILD_ROOT_PATH);
+        // patch pkgconf
+        $this->patchPkgconfPrefix(['glfw3.pc']);
+    }
+}

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

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+class icu extends MacOSLibraryBase
+{
+    public const NAME = 'icu';
+
+    protected function build(): void
+    {
+        $root = BUILD_ROOT_PATH;
+        shell()->cd($this->source_dir . '/source')
+            ->exec("{$this->builder->configure_env} ./runConfigureICU MacOSX --enable-static --disable-shared --prefix={$root}")
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install');
+    }
+}

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

@@ -1,39 +1,30 @@
 <?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\macos\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
 class libffi extends MacOSLibraryBase
 {
     public const NAME = 'libffi';
 
-    protected function build()
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    protected function build(): void
     {
-        [$lib, , $destdir] = SEPARATED_PATH;
+        [, , $destdir] = SEPARATED_PATH;
         shell()->cd($this->source_dir)
             ->exec(
                 "{$this->builder->configure_env} ./configure " .
                 '--enable-static ' .
                 '--disable-shared ' .
-                "--host={$this->builder->arch}-apple-darwin " .
-                "--target={$this->builder->arch}-apple-darwin " .
+                "--host={$this->builder->getOption('arch')}-apple-darwin " .
+                "--target={$this->builder->getOption('arch')}-apple-darwin " .
                 '--prefix= ' // use prefix=/
             )
             ->exec('make clean')

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

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\macos\library;
+
+/**
+ * gmp is a template library class for unix
+ */
+class libmemcached extends MacOSLibraryBase
+{
+    public const NAME = 'libmemcached';
+
+    public function build(): void
+    {
+        $rootdir = BUILD_ROOT_PATH;
+
+        shell()->cd($this->source_dir)
+            ->exec('chmod +x configure')
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static --disable-shared ' .
+                '--disable-sasl ' .
+                "--prefix={$rootdir}"
+            )
+            ->exec('make clean')
+            ->exec('sed -ie "s/-Werror//g" ' . $this->source_dir . '/Makefile')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install');
+    }
+}

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

@@ -22,6 +22,7 @@ namespace SPC\builder\macos\library;
 
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 
 class libpng extends MacOSLibraryBase
 {
@@ -30,19 +31,21 @@ class libpng extends MacOSLibraryBase
     /**
      * @throws FileSystemException
      * @throws RuntimeException
+     * @throws WrongUsageException
      */
-    protected function build()
+    protected function build(): void
     {
-        $optimizations = match ($this->builder->arch) {
+        $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(
                 "{$this->builder->configure_env} ./configure " .
-                "--host={$this->builder->gnu_arch}-apple-darwin " .
+                "--host={$this->builder->getOption('gnu-arch')}-apple-darwin " .
                 '--disable-shared ' .
                 '--enable-static ' .
                 '--enable-hardware-optimizations ' .

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

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
+use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
@@ -13,14 +14,22 @@ class libxml2 extends MacOSLibraryBase
 
     /**
      * @throws RuntimeException
+     * @throws FileSystemException
      */
-    protected function build()
+    protected function build(): void
     {
+        // macOS need to link iconv dynamically, we add it to extra-libs
+        $extra_libs = $this->builder->getOption('extra-libs', '');
+        if (!str_contains($extra_libs, '-liconv')) {
+            $extra_libs .= ' -liconv';
+        }
+        $this->builder->setOption('extra-libs', $extra_libs);
+
         $enable_zlib = $this->builder->getLib('zlib') ? 'ON' : 'OFF';
-        $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
+        // $enable_icu = $this->builder->getLib('icu') ? 'ON' : 'OFF';
         $enable_xz = $this->builder->getLib('xz') ? 'ON' : 'OFF';
 
-        [$lib, $include, $destdir] = SEPARATED_PATH;
+        [, , $destdir] = SEPARATED_PATH;
 
         FileSystem::resetDir($this->source_dir . '/build');
         shell()->cd($this->source_dir . '/build')
@@ -31,18 +40,16 @@ class libxml2 extends MacOSLibraryBase
                 '-DBUILD_SHARED_LIBS=OFF ' .
                 '-DLIBXML2_WITH_ICONV=ON ' .
                 "-DLIBXML2_WITH_ZLIB={$enable_zlib} " .
-                "-DLIBXML2_WITH_ICU={$enable_icu} " .
+                '-DLIBXML2_WITH_ICU=OFF ' .
                 "-DLIBXML2_WITH_LZMA={$enable_xz} " .
                 '-DLIBXML2_WITH_PYTHON=OFF ' .
                 '-DLIBXML2_WITH_PROGRAMS=OFF ' .
                 '-DLIBXML2_WITH_TESTS=OFF ' .
-                '-DCMAKE_INSTALL_PREFIX=/ ' .
-                "-DCMAKE_INSTALL_LIBDIR={$lib} " .
-                "-DCMAKE_INSTALL_INCLUDEDIR={$include} " .
+                "-DCMAKE_INSTALL_PREFIX={$destdir} " .
                 "-DCMAKE_TOOLCHAIN_FILE={$this->builder->cmake_toolchain_file} " .
                 '..'
             )
             ->exec("cmake --build . -j {$this->builder->concurrency}")
-            ->exec("make install DESTDIR={$destdir}");
+            ->exec('make install');
     }
 }

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

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

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

@@ -20,11 +20,18 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
 class nghttp2 extends MacOSLibraryBase
 {
     public const NAME = 'nghttp2';
 
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build(): void
     {
         $args = $this->builder->makeAutoconfArgs(static::NAME, [
             'zlib' => null,
@@ -49,7 +56,7 @@ class nghttp2 extends MacOSLibraryBase
                 "{$this->builder->configure_env} " . ' ./configure ' .
                 '--enable-static ' .
                 '--disable-shared ' .
-                "--host={$this->builder->gnu_arch}-apple-darwin " .
+                "--host={$this->builder->getOption('gnu-arch')}-apple-darwin " .
                 '--enable-lib-only ' .
                 '--with-boost=no ' .
                 $args . ' ' .

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

@@ -20,11 +20,20 @@ declare(strict_types=1);
 
 namespace SPC\builder\macos\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+
 class openssl extends MacOSLibraryBase
 {
     public const NAME = 'openssl';
 
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
     {
         [$lib,,$destdir] = SEPARATED_PATH;
 
@@ -42,7 +51,8 @@ class openssl extends MacOSLibraryBase
                 "{$this->builder->configure_env} ./Configure no-shared {$extra} " .
                 '--prefix=/ ' . // use prefix=/
                 "--libdir={$lib} " .
-                " darwin64-{$this->builder->arch}-cc"
+                '--openssldir=/System/Library/OpenSSL ' .
+                "darwin64-{$this->builder->getOption('arch')}-cc"
             )
             ->exec('make clean')
             ->exec("make -j{$this->builder->concurrency} CNF_EX_LIBS=\"{$ex_lib}\"")

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

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

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

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

src/SPC/builder/traits/LibraryTrait.php

@@ -4,6 +4,4 @@ declare(strict_types=1);
 
 namespace SPC\builder\traits;
 
-trait LibraryTrait
-{
-}
+trait LibraryTrait {}

src/SPC/builder/traits/UnixBuilderTrait.php

@@ -7,31 +7,27 @@ namespace SPC\builder\traits;
 use SPC\builder\linux\LinuxBuilder;
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 trait UnixBuilderTrait
 {
-    /** @var string 设置的命令前缀，设置为 set -x 可以在终端打印命令 */
-    public string $set_x = 'set -x';
-
-    /** @var string C 编译器命令 */
-    public string $cc;
-
-    /** @var string C++ 编译器命令 */
-    public string $cxx;
-
-    /** @var string cflags 参数 */
+    /** @var string cflags */
     public string $arch_c_flags;
 
-    /** @var string C++ flags 参数 */
+    /** @var string C++ flags */
     public string $arch_cxx_flags;
 
     /** @var string cmake toolchain file */
     public string $cmake_toolchain_file;
 
-    /** @var string configure 环境依赖的变量 */
+    /** @var string configure environments */
     public string $configure_env;
 
+    /**
+     * @throws WrongUsageException
+     * @throws FileSystemException
+     */
     public function getAllStaticLibFiles(): array
     {
         $libs = [];
@@ -125,7 +121,7 @@ trait UnixBuilderTrait
     }
 
     /**
-     * 清理编译好的文件
+     * Run php clean
      *
      * @throws RuntimeException
      */
@@ -141,7 +137,7 @@ trait UnixBuilderTrait
     public function makeCmakeArgs(): string
     {
         [$lib, $include] = SEPARATED_PATH;
-        $extra = $this instanceof LinuxBuilder ? '-DCMAKE_C_COMPILER=' . $this->cc . ' ' : '';
+        $extra = $this instanceof LinuxBuilder ? '-DCMAKE_C_COMPILER=' . $this->getOption('cc') . ' ' : '';
         return $extra . '-DCMAKE_BUILD_TYPE=Release ' .
             '-DCMAKE_INSTALL_PREFIX=/ ' .
             "-DCMAKE_INSTALL_LIBDIR={$lib} " .

src/SPC/builder/traits/UnixLibraryTrait.php

@@ -7,6 +7,7 @@ namespace SPC\builder\traits;
 use SPC\builder\LibraryBase;
 use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 trait UnixLibraryTrait
@@ -16,6 +17,7 @@ trait UnixLibraryTrait
     /**
      * @throws RuntimeException
      * @throws FileSystemException
+     * @throws WrongUsageException
      */
     public function getStaticLibFiles(string $style = 'autoconf', bool $recursive = true): string
     {
@@ -43,6 +45,11 @@ trait UnixLibraryTrait
         return implode($sep, $ret);
     }
 
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
     public function makeAutoconfEnv(string $prefix = null): string
     {
         if ($prefix === null) {
@@ -82,7 +89,7 @@ trait UnixLibraryTrait
      * remove libtool archive files
      *
      * @throws FileSystemException
-     * @throws RuntimeException
+     * @throws WrongUsageException
      */
     public function cleanLaFiles(): void
     {

src/SPC/builder/traits/UnixSystemUtilTrait.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace SPC\builder\traits;
 
+use SPC\exception\FileSystemException;
 use SPC\store\FileSystem;
 
 /**
@@ -14,11 +15,12 @@ trait UnixSystemUtilTrait
     /**
      * 生成 toolchain.cmake，用于 cmake 构建
      *
-     * @param string      $os          操作系统代号
-     * @param string      $target_arch 目标架构
-     * @param string      $cflags      CFLAGS 参数
-     * @param null|string $cc          CC 参数（默认空）
-     * @param null|string $cxx         CXX 参数（默认空）
+     * @param  string              $os          操作系统代号
+     * @param  string              $target_arch 目标架构
+     * @param  string              $cflags      CFLAGS 参数
+     * @param  null|string         $cc          CC 参数（默认空）
+     * @param  null|string         $cxx         CXX 参数（默认空）
+     * @throws FileSystemException
      */
     public static function makeCmakeToolchainFile(
         string $os,
@@ -76,4 +78,20 @@ CMAKE;
         }
         return null;
     }
+
+    /**
+     * @param  array  $vars Variables, like: ["CFLAGS" => "-Ixxx"]
+     * @return string like: CFLAGS="-Ixxx"
+     */
+    public static function makeEnvVarString(array $vars): string
+    {
+        $str = '';
+        foreach ($vars as $key => $value) {
+            if ($str !== '') {
+                $str .= ' ';
+            }
+            $str .= $key . '=' . escapeshellarg($value);
+        }
+        return $str;
+    }
 }

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

@@ -4,10 +4,16 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait brotli
 {
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
     protected function build(): void
     {
         FileSystem::resetDir($this->source_dir . '/build-dir');

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

@@ -4,11 +4,17 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait curl
 {
-    protected function build()
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    protected function build(): void
     {
         $extra = '';
         // lib:openssl
@@ -45,6 +51,7 @@ trait curl
         FileSystem::resetDir($this->source_dir . '/build');
         // compile！
         shell()->cd($this->source_dir . '/build')
+            ->exec('sed -i.save s@\${CMAKE_C_IMPLICIT_LINK_LIBRARIES}@@ ../CMakeLists.txt')
             ->exec("{$this->builder->configure_env} cmake {$this->builder->makeCmakeArgs()} -DBUILD_SHARED_LIBS=OFF -DBUILD_CURL_EXE=OFF {$extra} ..")
             ->exec("make -j{$this->builder->concurrency}")
             ->exec('make install DESTDIR=' . BUILD_ROOT_PATH);

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

@@ -4,11 +4,19 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 trait freetype
 {
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
     {
         $suggested = $this->builder->getLib('libpng') ? '--with-png' : '--without-png';
         $suggested .= ' ';
@@ -27,9 +35,8 @@ trait freetype
             ->exec("make -j{$this->builder->concurrency}")
             ->exec('make install DESTDIR=' . BUILD_ROOT_PATH);
         $this->patchPkgconfPrefix(['freetype2.pc']);
-        FileSystem::replaceFile(
+        FileSystem::replaceFileStr(
             BUILD_ROOT_PATH . '/lib/pkgconfig/freetype2.pc',
-            REPLACE_FILE_STR,
             ' -L/lib ',
             ' -L' . BUILD_ROOT_PATH . '/lib '
         );

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

@@ -4,9 +4,16 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
 trait gmp
 {
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build(): void
     {
         shell()->cd($this->source_dir)
             ->exec(

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

@@ -4,10 +4,16 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait imagemagick
 {
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
     protected function build(): void
     {
         $extra = '--without-jxl --without-xml --without-zstd --without-x --disable-openmp ';
@@ -46,9 +52,8 @@ trait imagemagick
         ];
         $this->patchPkgconfPrefix($filelist);
         foreach ($filelist as $file) {
-            FileSystem::replaceFile(
+            FileSystem::replaceFileRegex(
                 BUILD_LIB_PATH . '/pkgconfig/' . $file,
-                REPLACE_FILE_PREG,
                 '#includearchdir=/include/ImageMagick-7#m',
                 'includearchdir=${prefix}/include/ImageMagick-7'
             );

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

@@ -4,11 +4,19 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 trait libavif
 {
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
     {
         // CMake needs a clean build directory
         FileSystem::resetDir($this->source_dir . '/build');

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

@@ -4,11 +4,17 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait libevent
 {
-    protected function build()
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    protected function build(): void
     {
         // CMake needs a clean build directory
         FileSystem::resetDir($this->source_dir . '/build');
@@ -22,12 +28,12 @@ trait libevent
                 '-DEVENT__LIBRARY_TYPE=STATIC ' .
                 '-DEVENT__DISABLE_BENCHMARK=ON ' .
                 '-DEVENT__DISABLE_THREAD_SUPPORT=ON ' .
+                '-DEVENT__DISABLE_MBEDTLS=ON ' .
                 '-DEVENT__DISABLE_TESTS=ON ' .
                 '-DEVENT__DISABLE_SAMPLES=ON ' .
                 '..'
             )
             ->exec("cmake --build . -j {$this->builder->concurrency}")
             ->exec('make install');
-        // patch pkgconfig
     }
 }

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

@@ -6,7 +6,7 @@ namespace SPC\builder\unix\library;
 
 trait libiconv
 {
-    protected function build()
+    protected function build(): void
     {
         [,,$destdir] = SEPARATED_PATH;
 

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

@@ -4,11 +4,19 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
 use SPC\store\FileSystem;
 
 trait libjpeg
 {
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
     {
         // CMake needs a clean build directory
         FileSystem::resetDir($this->source_dir . '/build');

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

@@ -6,7 +6,7 @@ namespace SPC\builder\unix\library;
 
 trait libsodium
 {
-    protected function build()
+    protected function build(): void
     {
         $root = BUILD_ROOT_PATH;
         shell()->cd($this->source_dir)

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

@@ -4,11 +4,17 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait libssh2
 {
-    protected function build()
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    protected function build(): void
     {
         $enable_zlib = $this->builder->getLib('zlib') !== null ? 'ON' : 'OFF';
 

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

@@ -4,29 +4,34 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\exception\WrongUsageException;
+use SPC\store\FileSystem;
+
 trait libwebp
 {
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     * @throws WrongUsageException
+     */
+    protected function build(): void
     {
-        [,,$destdir] = SEPARATED_PATH;
-
-        shell()->cd($this->source_dir)
-            ->exec('./autogen.sh')
+        // CMake needs a clean build directory
+        FileSystem::resetDir($this->source_dir . '/build');
+        // Start build
+        shell()->cd($this->source_dir . '/build')
             ->exec(
-                "{$this->builder->configure_env} ./configure " .
-                '--enable-static ' .
-                '--disable-shared ' .
-                '--prefix= ' .
-                '--enable-libwebpdecoder ' .
-                '--enable-libwebpextras ' .
-                '--disable-tiff ' .
-                '--disable-gl ' .
-                '--disable-sdl ' .
-                '--disable-wic'
+                "{$this->builder->configure_env} cmake " .
+                $this->builder->makeCmakeArgs() . ' ' .
+                '-DBUILD_SHARED_LIBS=OFF ' .
+                '-DWEBP_BUILD_EXTRAS=ON ' .
+                '..'
             )
-            ->exec('make clean')
-            ->exec("make -j{$this->builder->concurrency}")
-            ->exec('make install DESTDIR=' . $destdir);
+            ->exec("cmake --build . -j {$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . BUILD_ROOT_PATH);
+        // patch pkgconfig
         $this->patchPkgconfPrefix(['libsharpyuv.pc', 'libwebp.pc', 'libwebpdecoder.pc', 'libwebpdemux.pc', 'libwebpmux.pc'], PKGCONF_PATCH_PREFIX);
         $this->cleanLaFiles();
     }

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

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\unix\library;
+
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
+trait libxslt
+{
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build(): void
+    {
+        shell()->cd($this->source_dir)
+            ->exec(
+                "{$this->builder->configure_env} ./configure " .
+                '--enable-static --disable-shared ' .
+                '--without-python ' .
+                '--without-mem-debug ' .
+                '--without-crypto ' .
+                '--without-debug ' .
+                '--without-debugger ' .
+                '--with-libxml-prefix=' . escapeshellarg(BUILD_ROOT_PATH) . ' ' .
+                '--prefix='
+            )
+            ->exec('make clean')
+            ->exec("make -j{$this->builder->concurrency}")
+            ->exec('make install DESTDIR=' . escapeshellarg(BUILD_ROOT_PATH));
+        $this->patchPkgconfPrefix(['libexslt.pc']);
+    }
+}

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

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
 use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
@@ -11,8 +12,9 @@ trait libyaml
 {
     /**
      * @throws RuntimeException
+     * @throws FileSystemException
      */
-    protected function build()
+    protected function build(): void
     {
         // prepare cmake/config.h.in
         if (!is_file(SOURCE_PATH . '/libyaml/cmake/config.h.in')) {

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

@@ -4,11 +4,17 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
 use SPC\store\FileSystem;
 
 trait libzip
 {
-    protected function build()
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    protected function build(): void
     {
         $extra = '';
         // lib:bzip2

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

@@ -6,7 +6,7 @@ namespace SPC\builder\unix\library;
 
 trait ncurses
 {
-    protected function build()
+    protected function build(): void
     {
         shell()->cd($this->source_dir)
             ->exec(

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

@@ -4,9 +4,16 @@ declare(strict_types=1);
 
 namespace SPC\builder\unix\library;
 
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+
 trait onig
 {
-    protected function build()
+    /**
+     * @throws FileSystemException
+     * @throws RuntimeException
+     */
+    protected function build(): void
     {
         [,,$destdir] = SEPARATED_PATH;
 

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

@@ -6,20 +6,16 @@ namespace SPC\builder\unix\library;
 
 trait pkgconfig
 {
-    protected function build()
+    protected function build(): void
     {
         $macos_env = 'PKG_CONFIG_PATH="' . BUILD_LIB_PATH . '/pkgconfig/" ' .
-            "CC='{$this->builder->cc}' " .
-            "CXX='{$this->builder->cxx}' " .
+            "CC='{$this->builder->getOption('cc')}' " .
+            "CXX='{$this->builder->getOption('cxx')}' " .
             "CFLAGS='{$this->builder->arch_c_flags} -Wimplicit-function-declaration' ";
         $linux_env = 'PKG_CONFIG_PATH="' . BUILD_LIB_PATH . '/pkgconfig" ' .
-            "CC='{$this->builder->cc}' " .
-            "CXX='{$this->builder->cxx}' ";
+            "CC='{$this->builder->getOption('cc')}' " .
+            "CXX='{$this->builder->getOption('cxx')}' ";
 
-        $extra = match (PHP_OS_FAMILY) {
-            'Darwin' => '',
-            default => '--with-internal-glib ',
-        };
         shell()->cd($this->source_dir)
             ->exec(
                 match (PHP_OS_FAMILY) {
@@ -29,7 +25,7 @@ trait pkgconfig
                 './configure ' .
                 '--disable-shared ' .
                 '--enable-static ' .
-                $extra .
+                '--with-internal-glib ' .
                 '--prefix=' . BUILD_ROOT_PATH . ' ' .
                 '--without-sysroot ' .
                 '--without-system-include-path ' .

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

@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SPC\builder\unix\library;
+
+use SPC\builder\macos\library\MacOSLibraryBase;
+use SPC\exception\FileSystemException;
+use SPC\exception\RuntimeException;
+use SPC\store\FileSystem;
+
+trait postgresql
+{
+    /**
+     * @throws RuntimeException
+     * @throws FileSystemException
+     */
+    protected function build(): void
+    {
+        $builddir = BUILD_ROOT_PATH;
+        $env = $this->builder->configure_env;
+        $envs = $env;
+        $packages = 'openssl zlib  readline libxml-2.0'; // icu-uc icu-io icu-i18n libzstd
+
+        $pkgconfig_executable = $builddir . '/bin/pkg-config';
+        $output = shell()->execWithResult($env . " {$pkgconfig_executable} --cflags-only-I --static " . $packages);
+        if (!empty($output[1][0])) {
+            $cppflags = $output[1][0];
+            $envs .= " CPPFLAGS=\"{$cppflags}\"";
+        }
+        $output = shell()->execWithResult($env . " {$pkgconfig_executable} --libs-only-L --static " . $packages);
+        if (!empty($output[1][0])) {
+            $ldflags = $output[1][0];
+            $envs .= $this instanceof MacOSLibraryBase ? " LDFLAGS=\"{$ldflags}\" " : " LDFLAGS=\"{$ldflags} -static\" ";
+        }
+        $output = shell()->execWithResult($env . " {$pkgconfig_executable} --libs-only-l --static " . $packages);
+        if (!empty($output[1][0])) {
+            $libs = $output[1][0];
+            $envs .= " LIBS=\"{$libs}\" ";
+        }
+
+        FileSystem::resetDir($this->source_dir . '/build');
+
+        # 有静态链接配置  参考文件： src/interfaces/libpq/Makefile
+        shell()->cd($this->source_dir . '/build')
+            ->exec('sed -i.backup "s/invokes exit\'; exit 1;/invokes exit\';/"  ../src/interfaces/libpq/Makefile')
+            ->exec(' sed -i.backup "293 s/^/#$/"  ../src/Makefile.shlib')
+            ->exec('sed -i.backup "441 s/^/#$/"  ../src/Makefile.shlib');
+
+        // configure
+        shell()->cd($this->source_dir . '/build')
+            ->exec(
+                "{$envs} ../configure " .
+                "--prefix={$builddir} " .
+                '--disable-thread-safety ' .
+                '--enable-coverage=no ' .
+                '--with-ssl=openssl ' .
+                '--with-readline ' .
+                '--with-libxml ' .
+                ($this->builder->getLib('icu') ? '--with-icu ' : '--without-icu ') .
+                '--without-ldap ' .
+                '--without-libxslt ' .
+                '--without-lz4 ' .
+                '--without-zstd ' .
+                '--without-perl ' .
+                '--without-python ' .
+                '--without-pam ' .
+                '--without-ldap ' .
+                '--without-bonjour ' .
+                '--without-tcl '
+            );
+
+        // build
+        shell()->cd($this->source_dir . '/build')
+            ->exec($envs . ' make -C src/bin/pg_config install')
+            ->exec($envs . ' make -C src/include install')
+            ->exec($envs . ' make -C src/common install')
+            ->exec($envs . ' make -C src/backend/port install')
+            ->exec($envs . ' make -C src/port install')
+            ->exec($envs . ' make -C src/backend/libpq install')
+            ->exec($envs . ' make -C src/interfaces/libpq install');
+
+        // remove dynamic libs
+        shell()->cd($this->source_dir . '/build')
+            ->exec("rm -rf {$builddir}/lib/*.so.*")
+            ->exec("rm -rf {$builddir}/lib/*.so")
+            ->exec("rm -rf {$builddir}/lib/*.dylib");
+    }
+}