Switch static-php-cli to support PHP 8.3 and 8.4 only (#615)

crazywhalecc · web-flow · commit 29ea46bd179a · 2025-03-07T18:06:32.000+08:00
* Update spc self to PHP 8.4 only

* Update workflows

* Fix test-extensions, adjust docs order

* Fix cs-fix and phpunit

* Add PHP_CS_FIXER_IGNORE_ENV

* Add compatibility for PHP 8.3

* Change version description in README, adjust composer.json PHP version limit

* Switch PHP to 8.4 in spc-alpine-docker

* Add deprecation notice
diff --git a/.github/workflows/build-unix.yml b/.github/workflows/build-unix.yml
@@ -129,7 +129,7 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: ${{ inputs.php-version }}
+          php-version: 8.4
           tools: pecl, composer
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
diff --git a/.github/workflows/build-windows-x86_64.yml b/.github/workflows/build-windows-x86_64.yml
@@ -6,7 +6,7 @@ on:
       version:
         required: true
         description: php version to compile
-        default: '8.2'
+        default: '8.4'
         type: choice
         options:
           - '8.4'
diff --git a/.github/workflows/ext-matrix-tests.yml b/.github/workflows/ext-matrix-tests.yml
@@ -113,7 +113,7 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          php-version: 8.4
           tools: pecl, composer
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
diff --git a/.github/workflows/release-build.yml b/.github/workflows/release-build.yml
@@ -9,8 +9,8 @@ on:
   workflow_dispatch:
 
 env:
-  PHP_VERSION: 8.2
-  MICRO_VERSION: 8.2.18
+  PHP_VERSION: 8.4
+  MICRO_VERSION: 8.4.4
 
 jobs:
   build-release-artifacts:
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
@@ -34,13 +34,13 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.4'
           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
+        run: PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix --dry-run --diff --ansi
 
   phpstan:
     runs-on: ubuntu-latest
@@ -52,7 +52,7 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.4'
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
           tools: composer
@@ -79,9 +79,6 @@ jobs:
     strategy:
       matrix:
         include:
-          - php: '8.1'
-          - php: '8.2'
-          - php: '8.3'
           - php: '8.4'
 
     steps:
@@ -125,7 +122,7 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          php-version: 8.4
 
       - name: Define
         id: gendef
@@ -153,7 +150,7 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          php-version: 8.4
           tools: pecl, composer
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
diff --git a/.gitignore b/.gitignore
@@ -32,6 +32,7 @@ packlib_files.txt
 !/bin/spc*
 !/bin/setup-runtime*
 !/bin/spc-alpine-docker
+!/bin/php-cs-fixer-wrapper
 
 # exclude windows build tools
 /php-sdk-binary-tools/
diff --git a/.php-cs-fixer.php b/.php-cs-fixer.php
@@ -64,6 +64,8 @@
         'php_unit_test_class_requires_covers' => false,
         'phpdoc_var_without_name' => false,
         'fully_qualified_strict_types' => false,
+        'operator_linebreak' => false,
+        'php_unit_data_provider_method_order' => false,
     ])
     ->setFinder(
         PhpCsFixer\Finder::create()->in([__DIR__ . '/src', __DIR__ . '/tests/SPC'])
diff --git a/README-zh.md b/README-zh.md
@@ -58,7 +58,7 @@ static-php-cli（简称 `spc`）有许多特性：
 
 ### 编译环境需求
 
-- PHP >= 8.1（这是 spc 自身需要的版本，不是支持的构建版本）
+- PHP >= 8.4（这是 spc 自身需要的版本，不是支持的构建版本）
 - 扩展：`mbstring,tokenizer,phar`
 - 系统安装了 `curl` 和 `git`
 
@@ -180,6 +180,9 @@ bin/spc --version
 # 检查环境依赖，并根据尝试自动安装缺失的编译工具
 ./bin/spc doctor --auto-fix
 
+# 输出目标项目依赖的扩展列表
+./bin/spc dump-extensions /path/to/your/project --format=text
+
 # 拉取所有依赖库
 ./bin/spc download --all
 # 只拉取编译指定扩展需要的所有依赖（推荐）
diff --git a/README.md b/README.md
@@ -67,7 +67,7 @@ which can be downloaded directly according to your needs.
 You can say I made a PHP builder written in PHP, pretty funny.
 But static-php-cli runtime only requires an environment above PHP 8.1 and extensions mentioned below.
 
-- PHP >= 8.1 (This is the version required by spc itself, not the build version)
+- PHP >= 8.4 (This is the version required by spc itself, not the build version)
 - Extension: `mbstring,tokenizer,phar`
 - Supported OS with `curl` and `git` installed
 
@@ -195,7 +195,7 @@ Basic usage for building php with some extensions:
 # fetch all libraries
 ./bin/spc download --all
 # dump a list of extensions required by your project
-./bin/spc dump-extensions
+./bin/spc dump-extensions /path/to/your/project --format=text
 # only fetch necessary sources by needed extensions (recommended)
 ./bin/spc download --for-extensions="openssl,pcntl,mbstring,pdo_sqlite"
 # download pre-built libraries first (save time for compiling dependencies)
diff --git a/bin/php-cs-fixer-wrapper b/bin/php-cs-fixer-wrapper
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+# get parent dir, and run the php-cs-fixer
+PHP_CS_FIXER_IGNORE_ENV=1 "$(dirname "$0")/../vendor/bin/php-cs-fixer" "$@"
diff --git a/bin/setup-runtime b/bin/setup-runtime
@@ -25,7 +25,7 @@ __DIR__=$(cd "$(dirname "$0")" && pwd)
 __PROJECT__=$(cd "${__DIR__}"/../ && pwd)
 
 # set download dir
-__PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.2.13-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+__PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.4.4-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
 __COMPOSER_URL__="https://getcomposer.org/download/latest-stable/composer.phar"
 
 # use china mirror
@@ -45,7 +45,7 @@ done
 
 case "$mirror" in
 china)
-  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.2.13-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.4.4-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
   __COMPOSER_URL__="https://mirrors.tencent.com/composer/composer.phar"
   ;;
 
@@ -61,7 +61,7 @@ test -f "${__PROJECT__}"/downloads/runtime.tar.gz || { echo "Downloading $__PHP_
 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__"
+test -f "${__DIR__}"/composer || { echo "Downloading Composer from $__COMPOSER_URL__" && 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; }
diff --git a/bin/setup-runtime.ps1 b/bin/setup-runtime.ps1
@@ -51,7 +51,7 @@ if ($action -eq 'add-path') {
 }
 
 # get php 8.1 specific version
-$API = (Invoke-WebRequest -Uri "https://www.php.net/releases/index.php?json&version=8.3") | ConvertFrom-Json
+$API = (Invoke-WebRequest -Uri "https://www.php.net/releases/index.php?json&version=8.4") | ConvertFrom-Json
 
 # php windows download
 $PHPRuntimeUrl = "https://windows.php.net/downloads/releases/php-" + $API.version + "-nts-Win32-vs16-x64.zip"
diff --git a/bin/spc b/bin/spc
@@ -17,6 +17,11 @@ if (PHP_OS_FAMILY === 'Windows' && Phar::running()) {
     exec('CHCP 65001');
 }
 
+// Print deprecation notice on PHP < 8.4, use red and highlight background
+if (PHP_VERSION_ID < 80400) {
+    echo "\e[43mDeprecation Notice: PHP < 8.4 is deprecated, please upgrade your PHP version.\e[0m\n";
+}
+
 try {
     (new ConsoleApplication())->run();
 } catch (Exception $e) {
diff --git a/bin/spc-alpine-docker b/bin/spc-alpine-docker
@@ -50,9 +50,9 @@ else
 fi
 
 # Detect docker env is setup
-if ! $DOCKER_EXECUTABLE images | grep -q cwcc-spc-$SPC_USE_ARCH; then
+if ! $DOCKER_EXECUTABLE images | grep -q cwcc-spc-$SPC_USE_ARCH-v2; then
     echo "Docker container does not exist. Building docker image ..."
-    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH -f- . <<EOF
+    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH-v2 -f- . <<EOF
 FROM $ALPINE_FROM
 $SPC_USE_MIRROR
 RUN apk update; \
@@ -79,21 +79,16 @@ RUN apk update; \
         linux-headers \
         m4 \
         make \
-        php82 \
-        php82-common \
-        php82-pcntl \
-        php82-phar \
-        php82-posix \
-        php82-sodium \
-        php82-tokenizer \
-        php82-dom \
-        php82-xml \
-        php82-xmlwriter \
-        composer \
         pkgconfig \
         wget \
         xz
 
+RUN curl -#fSL https://dl.static-php.dev/static-php-cli/bulk/php-8.4.4-cli-linux-\$(uname -m).tar.gz | tar -xz -C /usr/local/bin && \
+    chmod +x /usr/local/bin/php
+
+RUN curl -#fSL https://getcomposer.org/download/latest-stable/composer.phar -o /usr/local/bin/composer && \
+    chmod +x /usr/local/bin/composer
+
 WORKDIR /app
 ADD ./src /app/src
 COPY ./composer.* /app/
@@ -124,4 +119,4 @@ MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/pkgroot:/app/pkgroot"
 # shellcheck disable=SC2068
 # shellcheck disable=SC2086
 # shellcheck disable=SC2090
-$DOCKER_EXECUTABLE run --rm $INTERACT -e SPC_FIX_DEPLOY_ROOT="$(pwd)" $MOUNT_LIST cwcc-spc-$SPC_USE_ARCH bin/spc $@
+$DOCKER_EXECUTABLE run --rm $INTERACT -e SPC_FIX_DEPLOY_ROOT="$(pwd)" $MOUNT_LIST cwcc-spc-$SPC_USE_ARCH-v2 bin/spc $@
diff --git a/composer.json b/composer.json
@@ -9,7 +9,7 @@
         }
     ],
     "require": {
-        "php": ">= 8.1",
+        "php": ">= 8.3",
         "ext-mbstring": "*",
         "ext-zlib": "*",
         "laravel/prompts": "^0.1.12",
@@ -19,7 +19,7 @@
     "require-dev": {
         "captainhook/captainhook-phar": "^5.23",
         "captainhook/hook-installer": "^1.0",
-        "friendsofphp/php-cs-fixer": "^3.25",
+        "friendsofphp/php-cs-fixer": "^3.60",
         "humbug/box": "^4.5.0 || ^4.6.0",
         "nunomaduro/collision": "^7.8",
         "phpstan/phpstan": "^1.10",
@@ -44,7 +44,7 @@
     ],
     "scripts": {
         "analyse": "phpstan analyse --memory-limit 300M",
-        "cs-fix": "php-cs-fixer fix",
+        "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 php-cs-fixer fix",
         "test": "vendor/bin/phpunit tests/ --no-coverage",
         "build:phar": "vendor/bin/box compile"
     },
diff --git a/composer.lock b/composer.lock
diff --git a/docs/en/guide/manual-build.md b/docs/en/guide/manual-build.md
diff --git a/docs/zh/guide/manual-build.md b/docs/zh/guide/manual-build.md
diff --git a/src/SPC/ConsoleApplication.php b/src/SPC/ConsoleApplication.php
diff --git a/src/globals/test-extensions.php b/src/globals/test-extensions.php
diff --git a/tests/SPC/builder/linux/SystemUtilTest.php b/tests/SPC/builder/linux/SystemUtilTest.php
diff --git a/tests/SPC/builder/macos/SystemUtilTest.php b/tests/SPC/builder/macos/SystemUtilTest.php
