From 345fe783cc24b572f4214b247ed6ee1fcf6339b6 Mon Sep 17 00:00:00 2001 From: crazywhalecc Date: Sun, 21 Sep 2025 19:20:15 +0800 Subject: [PATCH] Add version table in docs --- docs/en/guide/index.md | 33 ++++++++++++++++++++++----------- docs/zh/guide/index.md | 26 ++++++++++++++++++++------ 2 files changed, 42 insertions(+), 17 deletions(-) diff --git a/docs/en/guide/index.md b/docs/en/guide/index.md index 253562b5..54e7840c 100644 --- a/docs/en/guide/index.md +++ b/docs/en/guide/index.md @@ -21,19 +21,30 @@ The following is the architecture support situation, where :gear: represents sup | Windows | :gear: :computer: | | | FreeBSD | :computer: | :computer: | -Among them, Linux is currently only tested on Ubuntu, Debian, and Alpine distributions, -and other distributions have not been tested, which cannot guarantee successful compilation. -For untested distributions, local compilation can be done using methods such as Docker to avoid environmental issues. +Current supported PHP versions for compilation: -There are two architectures for macOS: `x86_64` and `Arm`, but binaries compiled on one architecture cannot be directly used on the other architecture. -Rosetta 2 cannot guarantee that programs compiled with `Arm` architecture can fully run on `x86_64` environment. +> :warning: Partial support, there may be issues with new beta versions and old versions. +> +> :heavy_check_mark: Supported +> +> :x: Not supported -Windows currently only supports the x86_64 architecture, and does not support 32-bit x86 or arm64 architecture. +| PHP Version | Status | Comment | +|-------------|--------------------|-------------------------------------------------------------------------------------------------------------------------| +| 7.2 | :x: | | +| 7.3 | :x: | phpmicro and many extensions do not support 7.3, 7.4 versions | +| 7.4 | :x: | phpmicro and many extensions do not support 7.3, 7.4 versions | +| 8.0 | :warning: | PHP official has stopped maintaining 8.0, we no longer handle 8.0 related backport support | +| 8.1 | :warning: | PHP official only provides security updates for 8.1, we no longer handle 8.1 related backport support after 8.5 release | +| 8.2 | :heavy_check_mark: | | +| 8.3 | :heavy_check_mark: | | +| 8.4 | :heavy_check_mark: | | +| 8.5 (beta) | :warning: | PHP 8.5 is currently in beta stage | -## Supported PHP Version +> This table shows the support status of static-php-cli for building corresponding versions, not the PHP official support status for that version. -Currently, static php cli supports PHP versions 8.1 to 8.5, and theoretically supports PHP 8.0 and earlier versions. -Simply select the earlier version when downloading. -However, due to some extensions and special components that have stopped supporting earlier versions of PHP, -static-php-cli will not explicitly support earlier versions. +## PHP Support Versions + +Currently, static-php-cli supports PHP versions 8.2 ~ 8.5, and theoretically supports PHP 8.1 and earlier versions, just select the earlier version when downloading. +However, due to some extensions and special components that have stopped supporting earlier versions of PHP, static-php-cli will not explicitly support earlier versions. We recommend that you compile the latest PHP version possible for a better experience. diff --git a/docs/zh/guide/index.md b/docs/zh/guide/index.md index 318c40b8..8e5727c2 100644 --- a/docs/zh/guide/index.md +++ b/docs/zh/guide/index.md @@ -19,16 +19,30 @@ static-php-cli 是一个用于构建静态编译的 PHP 二进制的工具，目 | Windows | :gear: :computer: | | | FreeBSD | :computer: | :computer: | -其中，Linux 目前仅在 Ubuntu、Debian、Alpine 发行版测试通过，其他发行版未进行测试，不能保证编译成功。 -对于未经过测试的发行版，可以使用 Docker 等方式本地编译，避免环境导致的问题。 +当前支持编译的 PHP 版本： -macOS 下支持 x86_64 和 Arm 两种架构，但在其中一个架构上编译的二进制无法直接在另一个架构上使用。 -Rosetta 2 不能保证 Arm 架构编译的程序可以完全运行在 x86_64 环境下。 +> :warning: 部分支持，对于新的测试版和旧版本可能存在问题。 +> +> :heavy_check_mark: 支持 +> +> :x: 不支持 -Windows 目前只支持 x86_64 架构，不支持 32 位 x86、不支持 arm64 架构。 +| PHP Version | Status | Comment | +|-------------|--------------------|---------------------------------------------------------| +| 7.2 | :x: | | +| 7.3 | :x: | phpmicro 和许多扩展不支持 7.3、7.4 版本 | +| 7.4 | :x: | phpmicro 和许多扩展不支持 7.3、7.4 版本 | +| 8.0 | :warning: | PHP 官方已停止 8.0 的维护，我们不再处理 8.0 相关的 backport 支持 | +| 8.1 | :warning: | PHP 官方仅对 8.1 提供安全更新，在 8.5 发布后我们不再处理 8.1 相关的 backport 支持 | +| 8.2 | :heavy_check_mark: | | +| 8.3 | :heavy_check_mark: | | +| 8.4 | :heavy_check_mark: | | +| 8.5 (beta) | :warning: | PHP 8.5 目前处于 beta 阶段 | + +> 这个表格的支持状态是 static-php-cli 对构建对应版本的支持情况，不是 PHP 官方对该版本的支持情况。 ## PHP 支持版本 -目前，static-php-cli 对 PHP 8.1 ~ 8.5 版本是支持的，对于 PHP 8.0 及更早版本理论上支持，只需下载时选择早期版本即可。 +目前，static-php-cli 对 PHP 8.2 ~ 8.5 版本是支持的，对于 PHP 8.1 及更早版本理论上支持，只需下载时选择早期版本即可。 但由于部分扩展和特殊组件已对早期版本的 PHP 停止了支持，所以 static-php-cli 不会明确支持早期版本。 我们推荐你编译尽可能新的 PHP 版本，以获得更好的体验。