diff --git a/README-zh.md b/README-zh.md
index 8dc8d0a3..d75d0793 100755
--- a/README-zh.md
+++ b/README-zh.md
@@ -1,172 +1,150 @@
-# StaticPHP
-
-[](README.md)
-[](README-zh.md)
-[](https://github.com/crazywhalecc/static-php-cli/releases)
-[](https://github.com/crazywhalecc/static-php-cli/actions/workflows/tests.yml)
-[](https://github.com/crazywhalecc/static-php-cli/blob/main/LICENSE)
-
-**StaticPHP** 是一个用于构建静态编译可执行文件(包括 PHP、扩展等)的强大工具。
-
-## 特性
-
-- :elephant: **支持多 PHP 版本** - 支持 PHP 8.1, 8.2, 8.3, 8.4, 8.5
-- :handbag: **单文件 PHP 可执行文件** - 构建零依赖的独立 PHP
-- :hamburger: **phpmicro 集成** - 构建 **[phpmicro](https://github.com/dixyes/phpmicro)** 自解压可执行文件(将 PHP 二进制文件和源代码合并为一个文件)
-- :pill: **智能环境检查器** - 自动构建环境检查器,具备自动修复功能
-- :zap: **跨平台支持** - 支持 Linux、macOS、FreeBSD 和 Windows
-- :wrench: **可配置补丁** - 可自定义的源代码补丁系统
-- :books: **智能依赖管理** - 自动处理构建依赖
-- 📦 **自包含工具** - 提供使用 [box](https://github.com/box-project/box) 构建的 `spc` 可执行文件
-- :fire: **广泛的扩展支持** - 支持 75+ 流行 [扩展](https://static-php.dev/zh/guide/extensions.html)
-- :floppy_disk: **UPX 压缩** - 减小二进制文件大小 30-50%(仅 Linux/Windows)
-
-**单文件独立 php-cli:**
-
-
-
-**使用 phpmicro 将 PHP 代码与 PHP 解释器结合:**
-
-
-
-## 快速开始
-
-### 1. 下载 spc 二进制文件
-
-```bash
-# Linux x86_64
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-linux-x86_64
-# Linux aarch64
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-linux-aarch64
-# macOS x86_64 (Intel)
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-macos-x86_64
-# macOS aarch64 (Apple)
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-macos-aarch64
-# Windows (x86_64, win10 build 17063 或更高版本,请先安装 VS2022)
-curl.exe -fsSL -o spc.exe https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-windows-x64.exe
-```
-
-对于 macOS 和 Linux,请先添加执行权限:
-
-```bash
-chmod +x ./spc
-```
-
-### 2. 构建静态 PHP
-
-首先,创建一个 `craft.yml` 文件,并从 [扩展列表](https://static-php.dev/zh/guide/extensions.html) 或 [命令生成器](https://static-php.dev/zh/guide/cli-generator.html) 中指定要包含的扩展:
-
-```yml
-# PHP 版本支持:8.1, 8.2, 8.3, 8.4, 8.5
-php-version: 8.4
-# 在此处放置您的扩展列表
-extensions: "apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,gd,iconv,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,readline,redis,session,simplexml,sockets,sodium,sqlite3,tokenizer,xml,xmlreader,xmlwriter,xsl,zip,zlib"
-sapi:
- - cli
- - micro
- - fpm
-download-options:
- prefer-pre-built: true
-```
-
-运行命令:
-
-```bash
-./spc craft
-
-# 输出完整控制台日志
-./spc craft --debug
-```
-
-### 3. 静态 PHP 使用
-
-现在您可以将 StaticPHP 构建的二进制文件复制到另一台机器上,无需依赖即可运行:
-
-```
-# php-cli
-buildroot/bin/php -v
-
-# phpmicro
-echo ' a.php
-./spc micro:combine a.php -O my-app
-./my-app
-
-# php-fpm
-buildroot/bin/php-fpm -v
-```
-
-## 文档
-
-当前 README 包含基本用法。有关 StaticPHP 的所有功能,
-请访问 。
-
-## 直接下载
-
-如果您不想构建或想先测试,可以从 [Actions](https://github.com/static-php/static-php-cli-hosted/actions/workflows/build-php-bulk.yml) 下载示例预编译工件,或从自托管服务器下载。
-
-以下是几个具有不同扩展组合的预编译静态 PHP 二进制文件,
-您可以根据需要直接下载。
-
-| 组合名称 | 扩展数量 | 系统 | 备注 |
-|----------------------------------------------------------------------|----------------------------------------------------------------------------|--------------|--------------------|
-| [common](https://dl.static-php.dev/static-php-cli/common/) | [30+](https://dl.static-php.dev/static-php-cli/common/README.txt) | Linux, macOS | 二进制文件大小约为 7.5MB |
-| [bulk](https://dl.static-php.dev/static-php-cli/bulk/) | [50+](https://dl.static-php.dev/static-php-cli/bulk/README.txt) | Linux, macOS | 二进制文件大小约为 25MB |
-| [gnu-bulk](https://dl.static-php.dev/static-php-cli/gnu-bulk/) | [50+](https://dl.static-php.dev/static-php-cli/bulk/README.txt) | Linux, macOS | 使用 glibc 的 bulk 组合 |
-| [minimal](https://dl.static-php.dev/static-php-cli/minimal/) | [5](https://dl.static-php.dev/static-php-cli/minimal/README.txt) | Linux, macOS | 二进制文件大小约为 3MB |
-| [spc-min](https://dl.static-php.dev/static-php-cli/windows/spc-min/) | [5](https://dl.static-php.dev/static-php-cli/windows/spc-min/README.txt) | Windows | 二进制文件大小约为 3MB |
-| [spc-max](https://dl.static-php.dev/static-php-cli/windows/spc-max/) | [40+](https://dl.static-php.dev/static-php-cli/windows/spc-max/README.txt) | Windows | 二进制文件大小约为 8.5MB |
-
-> Linux 和 Windows 支持对二进制文件进行 UPX 压缩,可以将二进制文件大小减少 30% 到 50%。
-> macOS 不支持 UPX 压缩,因此 mac 的预构建二进制文件大小较大。
-
-### 在线构建(使用 GitHub Actions)
-
-上方直接下载的二进制不能满足需求时,可使用 GitHub Action 可以轻松构建静态编译的 PHP,
-同时自行定义要编译的扩展。
-
-1. Fork 本项目。
-2. 进入项目的 Actions 并选择 `CI`。
-3. 选择 `Run workflow`,填入您要编译的 PHP 版本、目标类型和扩展列表。(扩展用逗号分隔,例如 `bcmath,curl,mbstring`)
-4. 等待一段时间后,进入相应的任务并获取 `Artifacts`。
-
-如果您启用 `debug`,构建时将输出所有日志,包括编译日志,以便故障排除。
-
-## 贡献
-
-如果您需要的扩展缺失,可以创建 issue。
-如果您熟悉本项目,也欢迎发起 pull request。
-
-如果您想贡献文档,请直接编辑 `docs/` 目录。
-
-现在有一个 [static-php](https://github.com/static-php) 组织,用于存储与项目相关的仓库。
-
-## 赞助本项目
-
-您可以从 [GitHub Sponsor](https://github.com/crazywhalecc) 赞助我或我的项目。您捐赠的一部分将用于维护 **static-php.dev** 服务器。
-
-**特别感谢以下赞助商**:
-
-
-
-
-
-## 开源许可证
-
-本项目本身基于 MIT 许可证,
-一些新添加的扩展和依赖可能来自其他项目,
-这些代码文件的头部也会给出额外的许可证和作者说明。
-
-这些是类似的项目:
-
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)
-
-本项目使用了 [dixyes/lwmbs](https://github.com/dixyes/lwmbs) 的一些代码,例如 Windows 静态构建目标和 libiconv 支持。
-lwmbs 基于 [Mulan PSL 2](http://license.coscl.org.cn/MulanPSL2) 许可证。
-
-由于本项目的特殊性,
-项目编译过程中会使用许多其他开源项目,如 curl 和 protobuf,
-它们都有自己的开源许可证。
-
-请在编译后使用 `bin/spc dump-license` 命令导出项目中使用的开源许可证,
-并遵守相应项目的 LICENSE。
+# StaticPHP
+
+[](README-zh.md)
+[](README.md)
+[](https://github.com/crazywhalecc/static-php-cli/releases)
+[](https://github.com/crazywhalecc/static-php-cli/actions/workflows/tests.yml)
+[](https://github.com/crazywhalecc/static-php-cli/blob/main/LICENSE)
+
+**StaticPHP** 是一个强大的工具,用于构建可移植的可执行文件,包括 PHP、扩展等。
+
+## 特性
+
+- :elephant: 支持多个 PHP 版本 - PHP 8.1, 8.2, 8.3, 8.4, 8.5
+- :handbag: 构建零依赖的单文件 PHP 可执行程序
+- :hamburger: 构建 **[phpmicro](https://github.com/static-php/phpmicro)** 自解压可执行文件(将 PHP 二进制和源码合并为单个文件)
+- :pill: 自动构建环境检查器,支持自动修复
+- :zap: 支持 `Linux`、`macOS`、`Windows`
+- :wrench: 通过 vendor 模式和自定义注册表实现便捷扩展
+- :books: 智能依赖管理
+- 📦 自包含 `spc` 可执行文件,便于自安装
+- :fire: 支持 100+ 热门 [PHP 扩展](https://static-php.dev/en/guide/extensions.html)
+- :floppy_disk: 支持 UPX 压缩(二进制体积可缩小 30-50%)
+
+**单文件独立 php-cli:**
+
+
+
+**使用 phpmicro 将 PHP 代码与 PHP 解释器结合:**
+
+
+
+## 快速开始
+
+### 1. 下载 spc 二进制
+
+```bash
+# For Linux x86_64
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-linux-x86_64
+# For Linux aarch64
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-linux-aarch64
+# macOS x86_64 (Intel)
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-macos-x86_64
+# macOS aarch64 (Apple)
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-macos-aarch64
+# Windows (x86_64, win10 build 17063 or later, please install VS2022 first)
+curl.exe -fsSL -o spc.exe https://dl.static-php.dev/v3/spc-release/latest/spc-windows-x64.exe
+```
+
+对于 macOS 和 Linux,请先添加可执行权限:
+
+```bash
+chmod +x ./spc
+```
+
+### 2. 构建静态 PHP
+
+首先,创建 `craft.yml` 文件,并从 [扩展列表](https://static-php.dev/en/guide/extensions.html) 或 [命令生成器](https://static-php.dev/en/guide/cli-generator.html) 指定要包含的扩展:
+
+```yml
+# PHP version support: 8.1, 8.2, 8.3, 8.4, 8.5
+php-version: 8.5
+# Put your extension list here
+extensions: "apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,gd,iconv,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,readline,redis,session,simplexml,sockets,sodium,sqlite3,tokenizer,xml,xmlreader,xmlwriter,xsl,zip,zlib"
+sapi:
+ - cli
+ - micro
+download-options:
+ parallel: 10
+```
+
+运行命令:
+
+```bash
+./spc craft
+
+# 输出完整控制台日志
+./spc craft -vvv
+```
+
+### 3. 静态 PHP 使用
+
+现在你可以将 StaticPHP 构建的二进制复制到另一台机器并在无依赖环境下运行:
+
+```
+# php-cli
+buildroot/bin/php -v
+
+# phpmicro
+echo ' a.php
+./spc micro:combine a.php -O my-app
+./my-app
+```
+
+## 文档
+
+当前 README 包含基础用法。有关 StaticPHP 的完整功能集,
+请访问 。
+
+## 直接下载
+
+如果你暂时不想构建,或只想先测试,可以从 [Actions](https://github.com/static-php/static-php-cli-hosted/actions/workflows/build-php-bulk.yml) 下载示例预编译产物,或从自托管服务器下载。
+
+我们为每个 PHP 版本提供 2 种扩展集合:
+
+- **gigantic**:尽可能包含更多扩展,二进制大小约 100-150MB。
+- **base**:仅包含 StaticPHP 自身使用的少量扩展,二进制大小约 10MB。
+
+> WIP
+
+### 在线构建(使用 GitHub Actions)
+
+当上方直接下载的二进制无法满足你的需求时,
+你可以使用 GitHub Actions 轻松构建静态编译的 PHP,
+并同时自定义要编译的扩展列表。
+
+1. Fork 此仓库。
+2. 进入项目的 Actions 并选择 `CI`。
+3. 选择 `Run workflow`,填写你要编译的 PHP 版本、目标类型和扩展列表。(扩展用逗号分隔,例如 `bcmath,curl,mbstring`)
+4. 等待工作流执行完成后,进入对应运行记录并下载 `Artifacts`。
+
+如果你启用 `debug`,构建时将输出所有日志,包括编译日志,便于排查问题。
+
+> 我们也计划在未来提供可复用的 GitHub Actions 工作流,
+> 这样你无需 fork 本项目,也能在自己的仓库中轻松构建 static PHP。
+
+## 贡献
+
+如果你需要的扩展缺失,可以创建 issue。
+如果你熟悉本项目,也欢迎发起 pull request。
+
+如果你想贡献文档,请直接编辑 `docs/`。
+
+## 赞助本项目
+
+你可以通过 [GitHub Sponsor](https://github.com/crazywhalecc) 赞助我或我的项目。你捐赠的一部分将用于维护 **static-php.dev** 服务器。
+
+**特别感谢以下赞助商:**
+
+
+
+
+
+## 开源许可证
+
+本项目本身采用 MIT 许可证。
+一些新添加的扩展和依赖可能来自其他项目。
+这些源码文件头部也可能包含额外的 LICENSE 和 AUTHOR 信息。
+
+请在编译后使用 `bin/spc dump-license` 命令导出项目中使用的开源许可证,
+并遵守对应项目的 LICENSE。
diff --git a/README.md b/README.md
index 1d355c46..7c3af6b0 100755
--- a/README.md
+++ b/README.md
@@ -12,13 +12,13 @@
- :elephant: Support multiple PHP versions - PHP 8.1, 8.2, 8.3, 8.4, 8.5
- :handbag: Build single-file PHP executable with zero dependencies
-- :hamburger:Build **[phpmicro](https://github.com/dixyes/phpmicro)** self-extracting executables (combines PHP binary and source code into one file)
+- :hamburger: Build **[phpmicro](https://github.com/static-php/phpmicro)** self-extracting executables (combines PHP binary and source code into one file)
- :pill: Automatic build environment checker with auto-fix capabilities
-- :zap: `Linux`, `macOS`, `FreeBSD`, `Windows` support
-- :wrench: Configurable source code patching
+- :zap: `Linux`, `macOS`, `Windows` support
+- :wrench: Easy to extend with vendor mode and custom registries
- :books: Intelligent dependency management
-- 📦 Self-contained `spc` executable (built with [box](https://github.com/box-project/box))
-- :fire: Support 100+ popular [extensions](https://static-php.dev/en/guide/extensions.html)
+- 📦 Self-contained `spc` executable for easy self-installation
+- :fire: Support 100+ popular [PHP extensions](https://static-php.dev/en/guide/extensions.html)
- :floppy_disk: UPX compression support (reduces binary size by 30-50%)
**Single-file standalone php-cli:**
@@ -35,15 +35,15 @@
```bash
# For Linux x86_64
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-linux-x86_64
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-linux-x86_64
# For Linux aarch64
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-linux-aarch64
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-linux-aarch64
# macOS x86_64 (Intel)
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-macos-x86_64
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-macos-x86_64
# macOS aarch64 (Apple)
-curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-macos-aarch64
+curl -fsSL -o spc https://dl.static-php.dev/v3/spc-release/latest/spc-macos-aarch64
# Windows (x86_64, win10 build 17063 or later, please install VS2022 first)
-curl.exe -fsSL -o spc.exe https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-windows-x64.exe
+curl.exe -fsSL -o spc.exe https://dl.static-php.dev/v3/spc-release/latest/spc-windows-x64.exe
```
For macOS and Linux, add execute permission first:
@@ -58,15 +58,14 @@ First, create a `craft.yml` file and specify which extensions you want to includ
```yml
# PHP version support: 8.1, 8.2, 8.3, 8.4, 8.5
-php-version: 8.4
+php-version: 8.5
# Put your extension list here
extensions: "apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,gd,iconv,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,readline,redis,session,simplexml,sockets,sodium,sqlite3,tokenizer,xml,xmlreader,xmlwriter,xsl,zip,zlib"
sapi:
- cli
- micro
- - fpm
download-options:
- prefer-pre-built: true
+ parallel: 10
```
Run command:
@@ -75,7 +74,7 @@ Run command:
./spc craft
# Output full console log
-./spc craft --debug
+./spc craft -vvv
```
### 3. Static PHP usage
@@ -90,48 +89,40 @@ buildroot/bin/php -v
echo ' a.php
./spc micro:combine a.php -O my-app
./my-app
-
-# php-fpm
-buildroot/bin/php-fpm -v
```
## Documentation
-The current README contains basic usage. For all the features of StaticPHP,
-see .
+The current README contains basic usage. For the complete feature set of StaticPHP,
+see .
## Direct Download
-If you don't want to build or want to test first, you can download example pre-compiled artifact from [Actions](https://github.com/static-php/static-php-cli-hosted/actions/workflows/build-php-bulk.yml), or from self-hosted server.
+If you do not want to build yet or just want to test first, you can download example pre-compiled artifacts from [Actions](https://github.com/static-php/static-php-cli-hosted/actions/workflows/build-php-bulk.yml) or from a self-hosted server.
-Below are several precompiled static-php binaries with different extension combinations,
-which can be downloaded directly according to your needs.
+We offer 2 types of extension sets for each PHP version:
-| Combination | Extension Count | OS | Comment |
-|----------------------------------------------------------------------|----------------------------------------------------------------------------|--------------|--------------------------------|
-| [common](https://dl.static-php.dev/static-php-cli/common/) | [30+](https://dl.static-php.dev/static-php-cli/common/README.txt) | Linux, macOS | The binary size is about 7.5MB |
-| [bulk](https://dl.static-php.dev/static-php-cli/bulk/) | [50+](https://dl.static-php.dev/static-php-cli/bulk/README.txt) | Linux, macOS | The binary size is about 25MB |
-| [gnu-bulk](https://dl.static-php.dev/static-php-cli/gnu-bulk/) | [50+](https://dl.static-php.dev/static-php-cli/bulk/README.txt) | Linux, macOS | Using shared glibc |
-| [minimal](https://dl.static-php.dev/static-php-cli/minimal/) | [5](https://dl.static-php.dev/static-php-cli/minimal/README.txt) | Linux, macOS | The binary size is about 3MB |
-| [spc-min](https://dl.static-php.dev/static-php-cli/windows/spc-min/) | [5](https://dl.static-php.dev/static-php-cli/windows/spc-min/README.txt) | Windows | The binary size is about 3MB |
-| [spc-max](https://dl.static-php.dev/static-php-cli/windows/spc-max/) | [40+](https://dl.static-php.dev/static-php-cli/windows/spc-max/README.txt) | Windows | The binary size is about 8.5MB |
+- **gigantic**: Includes as many extensions as possible, the binary size is about 100-150MB.
+- **base**: Only includes a few extensions used by StaticPHP itself, the binary size is about 10MB.
-> Linux and Windows supports UPX compression for binaries, which can reduce the size of the binary by 30% to 50%.
-> macOS does not support UPX compression, so the size of the pre-built binaries for mac is larger.
+> WIP
### Build Online (using GitHub Actions)
-When the above direct download binaries cannot meet your needs,
-you can use GitHub Action to easily build a statically compiled PHP,
-and at the same time define the extensions to be compiled by yourself.
+When the direct-download binaries above cannot meet your needs,
+you can use GitHub Actions to easily build a statically compiled PHP
+while defining your own extension list.
-1. Fork me.
+1. Fork this repository.
2. Go to the Actions of the project and select `CI`.
3. Select `Run workflow`, fill in the PHP version you want to compile, the target type, and the list of extensions. (extensions comma separated, e.g. `bcmath,curl,mbstring`)
-4. After waiting for about a period of time, enter the corresponding task and get `Artifacts`.
+4. After waiting for the workflow to finish, open the corresponding run and download `Artifacts`.
If you enable `debug`, all logs will be output at build time, including compiled logs, for troubleshooting.
+> We are also planning to provide a reusable GitHub Actions workflow in the future,
+> so that you can easily build static PHP in your own repository, without forking this project.
+
## Contribution
If the extension you need is missing, you can create an issue.
@@ -139,8 +130,6 @@ If you are familiar with this project, you are also welcome to initiate a pull r
If you want to contribute documentation, please just edit in `docs/`.
-Now there is a [static-php](https://github.com/static-php) organization, which is used to store the repo related to the project.
-
## Sponsor this project
You can sponsor me or my project from [GitHub Sponsor](https://github.com/crazywhalecc). A portion of your donation will be used to maintain the **static-php.dev** server.
@@ -153,21 +142,9 @@ You can sponsor me or my project from [GitHub Sponsor](https://github.com/crazyw
## Open-Source License
-This project itself is based on MIT License,
-some newly added extensions and dependencies may originate from the the other projects,
-and the headers of these code files will also be given additional instructions LICENSE and AUTHOR.
-
-These are similar projects:
-
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)
-
-The project uses some code from [dixyes/lwmbs](https://github.com/dixyes/lwmbs), such as windows static build target and libiconv support.
-lwmbs is licensed under the [Mulan PSL 2](http://license.coscl.org.cn/MulanPSL2).
-
-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.
+This project itself is licensed under MIT.
+Some newly added extensions and dependencies may originate from other projects.
+The headers of those source files may also include additional LICENSE and AUTHOR information.
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.