ttt

# Conflicts:
#	config/env.ini

.editorconfig

@@ -0,0 +1,16 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+indent_size = 2
+
+[*.{yml,yaml,vue,ts}]
+indent_size = 2

.github/FUNDING.yml

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

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,17 @@
+---
+name: Bug report
+about: Build PHP or library failed, download failed, doesn't seem to work...
+title: ''
+labels: bug
+body:
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: |
+        Please tell us what you do, what you get and what you expected.
+        Provide with some step-by-step instructions to reproduce the issue.
+        If possible, attach a screenshot or log files in ./log directory.
+    validations:
+      required: true
+---

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,8 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: new feature
+assignees: crazywhalecc
+
+---

.github/ISSUE_TEMPLATE/something-want-to-know.md

@@ -0,0 +1,10 @@
+---
+name: Something want to know
+about: Describe your question about static-php, we will reply ASAP
+title: ''
+labels: question
+assignees: ''
+
+---
+
+

.github/pull_request_template.md

@@ -0,0 +1,17 @@
+## What does this PR do?
+
+
+
+## Checklist before merging
+
+> If your PR involves the changes mentioned below and completed the action, please tick the corresponding option.
+> If a modification is not involved, please skip it directly.
+
+- If you modified `*.php` or `*.json`, run them locally to ensure your changes are valid:
+  - [ ] `composer cs-fix`
+  - [ ] `composer analyse`
+  - [ ] `composer test`
+  - [ ] `bin/spc dev:sort-config`
+- If it's an extension or dependency update, please ensure the following:
+  - [ ] Add your test combination to `src/globals/test-extensions.php`.
+  - [ ] If adding new or fixing bugs, add commit message containing `extension test` or `test extensions` to trigger full test suite.

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

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

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

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

.github/workflows/build-unix.yml

@@ -0,0 +1,335 @@
+name: "CI on Unix"
+
+on:
+  workflow_dispatch:
+    inputs:
+      os:
+        required: true
+        description: Build target OS
+        default: 'linux-x86_64'
+        type: choice
+        options:
+          - 'linux-x86_64'
+          - 'linux-aarch64'
+          - 'linux-x86_64-glibc'
+          - 'linux-aarch64-glibc'
+          - 'macos-x86_64'
+          - 'macos-aarch64'
+      php-version:
+        required: true
+        description: PHP version to compile
+        default: '8.4'
+        type: choice
+        options:
+          - '8.4'
+          - '8.3'
+          - '8.2'
+          - '8.1'
+      extensions:
+        description: Extensions to build (comma separated)
+        required: true
+        type: string
+      shared-extensions:
+        description: Shared extensions to build (optional, comma separated)
+        type: string
+      extra-libs:
+        description: Extra libraries to build (optional, comma separated)
+        type: string
+      build-cli:
+        description: Build cli binary
+        default: true
+        type: boolean
+      build-micro:
+        description: Build phpmicro binary
+        type: boolean
+      build-fpm:
+        description: Build fpm binary
+        type: boolean
+      build-frankenphp:
+        description: Build frankenphp binary (requires ZTS)
+        type: boolean
+        default: false
+      enable-zts:
+        description: Enable ZTS
+        type: boolean
+        default: false
+      prefer-pre-built:
+        description: Prefer pre-built binaries (reduce build time)
+        type: boolean
+        default: true
+      with-suggested-libs:
+        description: Build with suggested libs
+        type: boolean
+        default: true
+      debug:
+        description: Show full build logs
+        type: boolean
+      no-strip:
+        description: Keep debug symbols for debugging
+        type: boolean
+        default: false
+  workflow_call:
+    inputs:
+      os:
+        required: true
+        description: Build target OS
+        default: 'linux-x86_64'
+        type: string
+      php-version:
+        required: true
+        description: PHP version to compile
+        default: '8.4'
+        type: string
+      extensions:
+        description: Extensions to build (comma separated)
+        required: true
+        type: string
+      shared-extensions:
+        description: Shared extensions to build (optional, comma separated)
+        type: string
+      extra-libs:
+        description: Extra libraries to build (optional, comma separated)
+        type: string
+      build-cli:
+        description: Build cli binary
+        default: true
+        type: boolean
+      build-micro:
+        description: Build phpmicro binary
+        type: boolean
+      build-fpm:
+        description: Build fpm binary
+        type: boolean
+      build-frankenphp:
+        description: Build frankenphp binary (requires ZTS)
+        type: boolean
+        default: false
+      enable-zts:
+        description: Enable ZTS
+        type: boolean
+        default: false
+      prefer-pre-built:
+        description: Prefer pre-built binaries (reduce build time)
+        type: boolean
+        default: true
+      with-suggested-libs:
+        description: Include suggested libs
+        type: boolean
+        default: false
+      debug:
+        description: Show full build logs
+        type: boolean
+      no-strip:
+        description: Keep debug symbols for debugging
+        type: boolean
+        default: false
+
+env:
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+jobs:
+  define-build:
+    name: "Define Build Scripts"
+    runs-on: ubuntu-latest
+    outputs:
+      run: ${{ steps.gendef.outputs.run }}
+      download: ${{ steps.gendef.outputs.download }}
+      build: ${{ steps.gendef.outputs.build }}
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Define"
+        id: gendef
+        run: |
+          case "${{ inputs.os }}" in
+            linux-x86_64)
+              DOWN_CMD="./bin/spc-alpine-docker download"
+              BUILD_CMD="./bin/spc-alpine-docker build"
+              RUNS_ON="ubuntu-latest"
+              ;;
+            linux-aarch64)
+              DOWN_CMD="./bin/spc-alpine-docker download"
+              BUILD_CMD="./bin/spc-alpine-docker build"
+              RUNS_ON="ubuntu-24.04-arm"
+              ;;
+            linux-x86_64-glibc)
+              DOWN_CMD="./bin/spc-gnu-docker download"
+              BUILD_CMD="./bin/spc-gnu-docker build"
+              RUNS_ON="ubuntu-22.04"
+              ;;
+            linux-aarch64-glibc)
+              DOWN_CMD="./bin/spc-gnu-docker download"
+              BUILD_CMD="./bin/spc-gnu-docker build"
+              RUNS_ON="ubuntu-22.04-arm"
+              ;;
+            macos-x86_64)
+              DOWN_CMD="composer update --no-dev --classmap-authoritative && ./bin/spc doctor --auto-fix && ./bin/spc download"
+              BUILD_CMD="./bin/spc build"
+              RUNS_ON="macos-15-intel"
+              ;;
+            macos-aarch64)
+              DOWN_CMD="composer update --no-dev --classmap-authoritative && ./bin/spc doctor --auto-fix && ./bin/spc download"
+              BUILD_CMD="./bin/spc build"
+              RUNS_ON="macos-15"
+              ;;
+          esac
+          STATIC_EXTS="${{ inputs.extensions }}"
+          SHARED_EXTS="${{ inputs['shared-extensions'] }}"
+          BUILD_FRANKENPHP="${{ inputs['build-frankenphp'] }}"
+          ENABLE_ZTS="${{ inputs['enable-zts'] }}"
+          ALL_EXTS="$STATIC_EXTS"
+          if [ -n "$SHARED_EXTS" ]; then
+            ALL_EXTS="$ALL_EXTS,$SHARED_EXTS"
+          fi
+          DOWN_CMD="$DOWN_CMD --with-php=${{ inputs.php-version }} --for-extensions=$ALL_EXTS --ignore-cache-sources=php-src"
+          BUILD_CMD="$BUILD_CMD $STATIC_EXTS"
+          if [ -n "$SHARED_EXTS" ]; then
+            BUILD_CMD="$BUILD_CMD --build-shared=$SHARED_EXTS"
+          fi
+          if [ -n "${{ inputs.extra-libs }}" ]; then
+            DOWN_CMD="$DOWN_CMD --for-libs=${{ inputs.extra-libs }}"
+            BUILD_CMD="$BUILD_CMD --with-libs=${{ inputs.extra-libs }}"
+          fi
+          if [ ${{ inputs.debug }} == true ]; then
+            DOWN_CMD="$DOWN_CMD --debug"
+            BUILD_CMD="$BUILD_CMD --debug"
+          fi
+          if [ ${{ inputs.prefer-pre-built }} == true ]; then
+              DOWN_CMD="$DOWN_CMD --prefer-pre-built"
+          fi
+          if [ ${{ inputs.with-suggested-libs }} == true ]; then
+              BUILD_CMD="$BUILD_CMD --with-suggested-libs"
+          fi
+          if [ ${{ inputs.build-cli }} == true ]; then
+              BUILD_CMD="$BUILD_CMD --build-cli"
+          fi
+          if [ ${{ inputs.build-micro }} == true ]; then
+              BUILD_CMD="$BUILD_CMD --build-micro"
+          fi
+          if [ ${{ inputs.build-fpm }} == true ]; then
+              BUILD_CMD="$BUILD_CMD --build-fpm"
+          fi
+          if [ "$BUILD_FRANKENPHP" = "true" ]; then
+              BUILD_CMD="$BUILD_CMD --build-frankenphp"
+          fi
+          if [ "$ENABLE_ZTS" = "true" ]; then
+              BUILD_CMD="$BUILD_CMD --enable-zts"
+          fi
+          echo 'download='"$DOWN_CMD" >> "$GITHUB_OUTPUT"
+          echo 'build='"$BUILD_CMD" >> "$GITHUB_OUTPUT"
+          echo 'run='"$RUNS_ON" >> "$GITHUB_OUTPUT"
+  build:
+    name: "Build ${{ inputs.version }} on ${{ inputs.os }}"
+    runs-on: ${{ needs.define-build.outputs.run }}
+    needs: define-build
+    timeout-minutes: 240
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Setup PHP"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.4
+          tools: pecl, composer
+          extensions: curl, openssl, mbstring
+          ini-values: memory_limit=-1
+        env:
+          phpts: nts
+
+      - if: ${{ inputs['build-frankenphp'] == true }}
+        name: "Install go-xcaddy for FrankenPHP"
+        run: |
+          case "${{ inputs.os }}" in
+            linux-x86_64|linux-aarch64)
+              ./bin/spc-alpine-docker install-pkg go-xcaddy
+              ;;
+            linux-x86_64-glibc|linux-aarch64-glibc)
+              ./bin/spc-gnu-docker install-pkg go-xcaddy
+              ;;
+            macos-x86_64|macos-aarch64)
+              composer update --no-dev --classmap-authoritative
+              ./bin/spc doctor --auto-fix
+              ./bin/spc install-pkg go-xcaddy
+              ;;
+            *)
+              echo "Unsupported OS for go-xcaddy install: ${{ inputs.os }}"
+              exit 1
+              ;;
+          esac
+
+      # Cache downloaded source
+      - id: cache-download
+        uses: actions/cache@v4
+        with:
+          path: downloads
+          key: php-dependencies-${{ inputs.os }}
+      - name: "Download sources"
+        run: ${{ needs.define-build.outputs.download }}
+      - name: "Build PHP"
+        run: ${{ needs.define-build.outputs.build }}
+#      - name: Setup tmate session
+#        if: ${{ failure() }}
+#        uses: mxschmitt/action-tmate@v3
+
+      # Upload debug logs
+      - if: ${{ inputs.debug && failure() }}
+        name: "Upload build logs on failure"
+        uses: actions/upload-artifact@v4
+        with:
+          name: spc-logs-${{ inputs.php-version }}-${{ inputs.os }}
+          path: log/*.log
+
+      # Upload cli executable
+      - if: ${{ inputs.build-cli == true }}
+        name: "Upload PHP cli SAPI"
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-cli-${{ inputs.php-version }}-${{ inputs.os }}
+          path: buildroot/bin/php
+
+      # Upload micro self-extracted executable
+      - if: ${{ inputs.build-micro == true }}
+        name: "Upload PHP micro SAPI"
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-micro-${{ inputs.php-version }}-${{ inputs.os }}
+          path: buildroot/bin/micro.sfx
+
+      # Upload fpm executable
+      - if: ${{ inputs.build-fpm == true }}
+        name: "Upload PHP fpm SAPI"
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-fpm-${{ inputs.php-version }}-${{ inputs.os }}
+          path: buildroot/bin/php-fpm
+
+      # Upload frankenphp executable
+      - if: ${{ inputs['build-frankenphp'] == true }}
+        name: "Upload FrankenPHP SAPI"
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-frankenphp-${{ inputs.php-version }}-${{ inputs.os }}
+          path: buildroot/bin/frankenphp
+
+      # Upload extensions metadata
+      - if: ${{ inputs['shared-extensions'] != '' }}
+        name: "Upload shared extensions"
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-shared-ext-${{ inputs.php-version }}-${{ inputs.os }}
+          path: |
+            buildroot/modules/*.so
+      - uses: actions/upload-artifact@v4
+        name: "Upload License Files"
+        with:
+          name: license-files-${{ inputs.php-version }}-${{ inputs.os }}
+          path: buildroot/license/
+      - uses: actions/upload-artifact@v4
+        name: "Upload Build Metadata"
+        with:
+          name: build-meta-${{ inputs.php-version }}-${{ inputs.os }}
+          path: |
+            buildroot/build-extensions.json
+            buildroot/build-libraries.json

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

@@ -1,4 +1,4 @@
-name: CI on x86_64 linux
+name: CI on x86_64 Windows
 
 on:
   workflow_dispatch:
@@ -6,13 +6,14 @@ on:
       version:
         required: true
         description: php version to compile
-        default: '8.2'
+        default: '8.4'
         type: choice
         options:
+          - '8.4'
+          - '8.3'
           - '8.2'
           - '8.1'
           - '8.0'
-          - '7.4'
       build-cli:
         description: build cli binary
         default: true
@@ -20,14 +21,20 @@ on:
       build-micro:
         description: build phpmicro binary
         type: boolean
-      build-fpm:
-        description: build fpm binary
-        type: boolean
       extensions:
         description: extensions to compile (comma separated)
         required: true
         type: string
+      prefer-pre-built:
+        description: prefer pre-built binaries (reduce build time)
+        type: boolean
+        default: true
+      with-suggested-libs:
+        description: Build with suggested libs
+        type: boolean
+        default: true
       debug:
+        description: enable debug logs
         type: boolean
 
 env:
@@ -35,88 +42,78 @@ env:
 
 jobs:
   build:
-    name: build ${{ inputs.version }} on Linux x86_64
-    runs-on: ubuntu-latest
+    name: build ${{ inputs.version }} on Windows x86_64
+    runs-on: windows-latest
     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
+      - uses: actions/checkout@v4
 
       # Cache composer dependencies
       - id: cache-composer-deps
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         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
+        run: composer update --no-dev --classmap-authoritative
+
+      - name: Generate hashed key for download cache
+        shell: bash
+        run: |
+          INPUT_HASH=$(echo "${{ runner.os }}-${{ inputs.version }}-${{ inputs.extensions }}" | sha256sum | awk '{print $1}')
+          echo "INPUT_HASH=${INPUT_HASH}" >> "$GITHUB_ENV"
 
       # Cache downloaded source
       - id: cache-download
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: downloads
-          key: php-${{ inputs.version }}-dependencies
+          key: php-${{ env.INPUT_HASH }}
 
       # With or without debug
       - if: inputs.debug == true
-        run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
+        run: echo "SPC_BUILD_DEBUG=--debug" >> $env:GITHUB_ENV
+      - if: inputs.prefer-pre-built == true
+        run: echo "SPC_PRE_BUILT=--prefer-pre-built" >> $env:GITHUB_ENV
 
       # With target select: cli, micro or both
       - if: ${{ inputs.build-cli == true }}
-        run: echo "SPC_BUILD_CLI=--build-cli" >> $GITHUB_ENV
+        run: echo "SPC_BUILD_CLI=--build-cli" >> $env:GITHUB_ENV
       - if: ${{ inputs.build-micro == true }}
-        run: echo "SPC_BUILD_MICRO=--build-micro" >> $GITHUB_ENV
-      - if: ${{ inputs.build-fpm == true }}
-        run: echo "SPC_BUILD_FPM=--build-fpm" >> $GITHUB_ENV
+        run: echo "SPC_BUILD_MICRO=--build-micro" >> $env:GITHUB_ENV
+
+      - run: ./bin/spc doctor
 
       # 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: ./bin/spc download --with-php="${{ inputs.version }}" --for-extensions="${{ inputs.extensions }}" ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_PRE_BUILT }}
 
       # 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 build "${{ inputs.extensions }}" ${{ env.SPC_BUILD_DEBUG }} ${{ env.SPC_BUILD_CLI }} ${{ env.SPC_BUILD_MICRO }} ${{ env.SPC_BUILD_FPM }}
 
       # Upload cli executable
       - if: ${{ inputs.build-cli == true }}
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: php-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
-          path: buildroot/bin/php
+          name: php-${{ inputs.version }}
+          path: buildroot/bin/php.exe
 
       # Upload micro self-extracted executable
       - if: ${{ inputs.build-micro == true }}
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
-          name: micro-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
+          name: micro-${{ inputs.version }}
           path: buildroot/bin/micro.sfx
 
-      # Upload fpm executable
-      - if: ${{ inputs.build-fpm == true }}
-        uses: actions/upload-artifact@v3
-        with:
-          name: php-fpm-${{ inputs.version }}-${{ env.SPC_BUILD_OS }}
-          path: buildroot/bin/php-fpm
-
       # Upload extensions metadata
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: license-files
           path: buildroot/license/
-      - uses: actions/upload-artifact@v3
+      - uses: actions/upload-artifact@v4
         with:
           name: build-meta
           path: |
             buildroot/build-extensions.json
             buildroot/build-libraries.json
-
-      # Upload downloaded files
-      - uses: actions/upload-artifact@v3
-        with:
-          name: download-files
-          path: downloads/

.github/workflows/ext-matrix-tests.yml

@@ -0,0 +1,139 @@
+name: "Extension Matrix Tests"
+
+on:
+  workflow_dispatch:
+  push:
+
+jobs:
+  test:
+    name: "${{ matrix.extension }} (PHP ${{ matrix.php-version }} on ${{ matrix.operating-system }})"
+    runs-on: ${{ matrix.operating-system }}
+    if: contains(github.event.head_commit.message, 'extension test') || contains(github.event.head_commit.message, 'test extensions')
+    strategy:
+      fail-fast: false
+      matrix:
+        extension:
+          - amqp
+          - apcu
+          - bcmath
+          - bz2
+          - calendar
+          - ctype
+          - curl
+          - dba
+          - dom
+          - ds
+          - event
+          - exif
+          - filter
+          - fileinfo
+          - ftp
+          - gd
+          - gettext
+          - gmp
+          - iconv
+          - igbinary
+          - imagick
+          - imap
+          - intl
+          - ldap
+          - mbstring,mbregex
+          - memcache
+          - mysqli,mysqlnd,pdo_mysql
+          - opcache
+          - openssl
+          - pcntl
+          - password-argon2
+          - pcntl
+          - pdo
+          - pgsql,pdo_pgsql
+          - phar
+          - posix
+          - rar
+          - protobuf
+          - readline
+          - redis
+          - session
+          - shmop
+          - simdjson
+          - simplexml,xml
+          - snappy
+          - soap
+          - sockets
+          - sodium
+          - sqlite3,pdo_sqlite
+          - sqlsrv
+          - ssh2
+          - swoole
+          - swoole,swoole-hook-pgsql,swoole-hook-mysql,swoole-hook-sqlite,swoole-hook-odbc
+          - swow
+          - sysvmsg,sysvsem,sysvshm
+          - tidy
+          - tokenizer
+          - uuid
+          - uv
+          - xhprof
+          - xlswriter
+          - xmlwriter,xmlreader
+          - xsl
+          - yac
+          - yaml
+          - zip
+          - zlib
+          - zstd
+        php-version:
+          - "8.4"
+        operating-system:
+          - "ubuntu-latest"
+          #- "macos-15-intel"
+          #- "debian-arm64-self-hosted"
+          - "macos-15"
+
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+
+      - name: OS type
+        id: os-type
+        run: |
+          OS=""
+          if [ "${{ matrix.operating-system }}" = "ubuntu-latest" ]; then
+              OS="linux-x86_64"
+          elif [ "${{ matrix.operating-system }}" = "macos-15-intel" ]; then
+              OS="macos-x86_64"
+          elif [ "${{ matrix.operating-system }}" = "debian-arm64-self-hosted" ]; then
+              OS="linux-aarch64"
+          elif [ "${{ matrix.operating-system }}" = "macos-15" ]; then
+              OS="macos-aarch64"
+          fi
+          echo "OS=$OS" >> $GITHUB_ENV
+
+      - name: "Setup PHP"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.4
+          tools: pecl, composer
+          extensions: curl, openssl, mbstring
+          ini-values: memory_limit=-1
+        env:
+          phpts: nts
+
+      - name: "Install Dependencies"
+        run: composer update -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+      - id: cache-download
+        uses: actions/cache@v4
+        with:
+          path: downloads
+          key: php-${{ matrix.php-version }}-dependencies-for-tests
+
+      # If there's no dependencies cache, fetch sources
+      - name: "Download sources"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ./bin/spc download --with-php=${{ matrix.php-version }} --for-extensions=${{ matrix.extension }} --debug --ignore-cache-sources=php-src
+
+      - name: "Build library: ${{ matrix.library }}"
+        run: |
+          SPC_USE_SUDO=yes ./bin/spc doctor --auto-fix
+          ./bin/spc build --build-cli --build-micro --build-fpm ${{ matrix.extension }} --debug --with-suggested-libs --with-suggested-exts

.github/workflows/release-build.yml

@@ -0,0 +1,175 @@
+name: Build SPC Binary
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+    paths:
+      - '.github/workflows/release-build.yml'
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+env:
+  PHP_VERSION: 8.4
+  MICRO_VERSION: 8.4.11
+
+jobs:
+  build-release-artifacts:
+    name: "Build SPC Binary for ${{ matrix.operating-system.name }}"
+    runs-on: ${{ matrix.operating-system.os }}
+    strategy:
+      matrix:
+        operating-system:
+          - name: "linux-x86_64"
+            os: "ubuntu-latest"
+            filename: "spc-linux-x86_64.tar.gz"
+          - name: "macos-x86_64"
+            os: "macos-15-intel"
+            filename: "spc-macos-x86_64.tar.gz"
+          - name: "linux-aarch64"
+            os: "ubuntu-latest"
+            filename: "spc-linux-aarch64.tar.gz"
+          - name: "macos-aarch64"
+            os: "macos-14"
+            filename: "spc-macos-aarch64.tar.gz"
+          - name: "windows-x64"
+            os: "ubuntu-latest"
+            filename: "spc-windows-x64.exe"
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v4"
+
+      - if: inputs.debug == true
+        run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
+
+      - name: "Install PHP for official runners"
+        uses: shivammathur/setup-php@v2
+        with:
+          coverage: none
+          tools: composer:v2
+          php-version: "${{ env.PHP_VERSION }}"
+          ini-values: memory_limit=-1
+          extensions: curl, openssl, mbstring
+
+      - name: "Get Composer Cache Directory"
+        id: composer-cache
+        run: |
+          echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: "Cache Composer dependencies"
+        uses: "actions/cache@v4"
+        with:
+          path: "${{ steps.composer-cache.outputs.dir }}"
+          key: "php-${{ env.PHP_VERSION }}-locked-composer-${{ hashFiles('**/composer.lock') }}"
+          restore-keys: |
+            php-${{ env.PHP_VERSION }}-locked-composer
+
+      - name: "Install Locked Dependencies"
+        run: "composer install --no-interaction --no-progress"
+
+      - name: "Build PHAR File"
+        run: "composer build:phar"
+
+      - name: "Download Minimal Combination"
+        run: |
+          if [ "${{ matrix.operating-system.name }}" = "windows-x64" ]; then
+            curl -fsSL https://dl.static-php.dev/static-php-cli/windows/spc-min/php-${{ env.MICRO_VERSION }}-micro-win.zip -o tmp.zip
+            unzip tmp.zip
+          else
+            curl -fsSL https://dl.static-php.dev/static-php-cli/minimal/php-${{ env.MICRO_VERSION }}-micro-${{ matrix.operating-system.name }}.tar.gz -o tmp.tgz
+            tar -zxvf tmp.tgz
+          fi
+
+      - name: "Generate Executable"
+        run: |
+          bin/spc micro:combine spc.phar -M micro.sfx -O spc -I "memory_limit=2G"
+          if [ "${{ matrix.operating-system.name }}" = "windows-x64" ]; then
+            mv spc spc.exe
+          else
+            chmod +x spc
+          fi
+          if [ "${{ matrix.operating-system.name }}" = "macos-aarch64" ] || [ "${{ matrix.operating-system.name }}" = "macos-x86_64" ]; then
+             sudo xattr -cr ./spc
+          fi
+
+      - name: "Archive Executable and Validate Binary"
+        run: |
+          if [ "${{ matrix.operating-system.name }}" != "windows-x64" ]; then
+            tar -czf ${{ matrix.operating-system.filename }} spc
+            # validate spc binary
+            if [ "${{ matrix.operating-system.name }}" == "linux-x86_64" ]; then
+              ./spc dev:extensions
+            fi
+          fi
+
+      - name: "Copy file"
+        run: |
+          if [ "${{ matrix.operating-system.name }}" != "windows-x64" ]; then
+            mkdir dist/ && cp ${{ matrix.operating-system.filename }} dist/ && cp spc dist/spc-${{ matrix.operating-system.name }}
+          else
+            mkdir dist/ && cp spc.exe dist/${{ matrix.operating-system.filename }}
+            echo "SUFFIX=.exe" >> $GITHUB_ENV
+          fi
+
+      - name: "Upload Binaries to Release"
+        uses: softprops/action-gh-release@v1
+        if: ${{startsWith(github.ref, 'refs/tags/') }}
+        with:
+          files: dist/${{ matrix.operating-system.filename }}
+
+      - name: "Deploy to self-hosted OSS"
+        # only run this step if the repository is static-php-cli and the branch is main
+        if: github.repository == 'crazywhalecc/static-php-cli' && github.ref == 'refs/heads/main'
+        uses: static-php/upload-s3-action@v1.0.0
+        with:
+          aws_key_id: ${{ secrets.AWS_KEY_ID }}
+          aws_secret_access_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws_bucket: ${{ secrets.AWS_BUCKET }}
+          source_dir: "dist/"
+          destination_dir: static-php-cli/spc-bin/nightly/
+          endpoint: ${{ secrets.AWS_ENDPOINT }}
+
+      - name: "Upload Artifact"
+        uses: actions/upload-artifact@v4
+        with:
+          path: spc${{ env.SUFFIX }}
+          name: spc-${{ matrix.operating-system.name }}${{ env.SUFFIX }}
+  test-spc:
+    name: "Test SPC Binary for ${{ matrix.operating-system.name }}"
+    runs-on: ${{ matrix.operating-system.os }}
+    needs: [build-release-artifacts]
+    strategy:
+      matrix:
+        operating-system:
+          - name: "linux-x86_64"
+            os: "ubuntu-latest"
+          - name: "macos-x86_64"
+            os: "macos-15-intel"
+          - name: "linux-aarch64"
+            os: "ubuntu-24.04-arm"
+          - name: "macos-aarch64"
+            os: "macos-15"
+          - name: "windows-x64"
+            os: "windows-latest"
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Download Artifact"
+        uses: actions/download-artifact@v4
+        env:
+          SUFFIX: ${{ matrix.operating-system.name == 'windows-x64' && '.exe' || '' }}
+        with:
+          name: spc-${{ matrix.operating-system.name }}${{ env.SUFFIX }}
+
+      - name: "Chmod"
+        if: matrix.operating-system.name != 'windows-x64'
+        run: chmod +x spc
+
+      - name: "Run SPC Tests"
+        env:
+          SUFFIX: ${{ matrix.operating-system.name == 'windows-x64' && '.exe' || '' }}
+        run: ./spc${{ env.SUFFIX }} dev:extensions

.github/workflows/tests.yml

@@ -0,0 +1,214 @@
+name: Tests
+
+on:
+  pull_request:
+    branches: [ "main", "v3" ]
+    types: [ opened, synchronize, reopened ]
+    paths:
+      - 'src/**'
+      - 'config/**'
+      - '.github/workflows/tests.yml'
+      - 'bin/**'
+      - 'composer.json'
+      - 'box.json'
+      - '.php-cs-fixer.php'
+
+permissions: read-all
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+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.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
+
+  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.4'
+          extensions: curl, openssl, mbstring
+          ini-values: memory_limit=-1
+          tools: composer
+        env:
+          phpts: zts
+
+      - name: "Cache Composer packages"
+        id: composer-cache
+        uses: actions/cache@v4
+        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.4'
+
+    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@v4
+        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: SPC_LIBC=glibc vendor/bin/phpunit tests/ --no-coverage
+
+  define-matrix:
+    name: "Define Matrix"
+    runs-on: ubuntu-latest
+    outputs:
+      php: ${{ steps.gendef.outputs.php }}
+      os: ${{ steps.gendef.outputs.os }}
+    steps:
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Setup PHP"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.4
+          extensions: curl, openssl, mbstring
+
+      - name: Define
+        id: gendef
+        run: |
+          PHP_VERSIONS=$(php src/globals/test-extensions.php php)
+          OS_VERSIONS=$(php src/globals/test-extensions.php os)
+          echo 'php='"$PHP_VERSIONS" >> "$GITHUB_OUTPUT"
+          echo 'os='"$OS_VERSIONS" >> "$GITHUB_OUTPUT"
+
+
+  build:
+    name: "Build PHP Test (PHP ${{ matrix.php }} ${{ matrix.os }})"
+    runs-on: ${{ matrix.os }}
+    needs: [define-matrix, php-cs-fixer, phpstan, phpunit]
+    timeout-minutes: 120
+    strategy:
+      matrix:
+        php: ${{ fromJSON(needs.define-matrix.outputs.php) }}
+        os: ${{ fromJSON(needs.define-matrix.outputs.os) }}
+      fail-fast: false
+    steps:
+      - name: "Update runner packages"
+        if: ${{ startsWith(matrix.os, 'ubuntu-') }}
+        run: sudo apt-get update && sudo apt-get install -y ca-certificates
+
+      - name: "Checkout"
+        uses: actions/checkout@v4
+
+      - name: "Setup PHP"
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: 8.4
+          tools: pecl, composer
+          extensions: curl, openssl, mbstring
+          ini-values: memory_limit=-1
+        env:
+          phpts: nts
+
+      - name: "Cache composer packages"
+        id: composer-cache
+        uses: actions/cache@v4
+        with:
+          path: vendor
+          key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-php-
+
+      # Cache downloaded source
+      - id: cache-download
+        uses: actions/cache@v4
+        with:
+          path: downloads
+          key: php-dependencies-${{ matrix.os }}
+
+      - name: "Install Dependencies"
+        run: composer update -vvv --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist --no-plugins
+
+      - name: "Run Build Tests (doctor)"
+        run: php src/globals/test-extensions.php doctor_cmd ${{ matrix.os }} ${{ matrix.php }}
+
+      - name: "Prepare UPX for Windows"
+        if: ${{ startsWith(matrix.os, 'windows-') }}
+        run: |
+          php src/globals/test-extensions.php install_upx_cmd ${{ matrix.os }} ${{ matrix.php }}
+          echo "UPX_CMD=$(php src/globals/test-extensions.php upx)" >> $env:GITHUB_ENV
+
+      - name: "Prepare UPX for Linux"
+        if: ${{ startsWith(matrix.os, 'ubuntu-') }}
+        run: |
+          php src/globals/test-extensions.php install_upx_cmd ${{ matrix.os }} ${{ matrix.php }}
+          echo "UPX_CMD=$(php src/globals/test-extensions.php upx)" >> $GITHUB_ENV
+
+      - name: "Run Build Tests (download)"
+        run: php src/globals/test-extensions.php download_cmd ${{ matrix.os }} ${{ matrix.php }}
+
+      - name: "Run Build Tests (build)"
+        run: php src/globals/test-extensions.php build_cmd ${{ matrix.os }} ${{ matrix.php }}
+
+      - name: "Run Build Tests (build - embed for non-windows)"
+        if: ${{ !startsWith(matrix.os, 'windows-') }}
+        run: php src/globals/test-extensions.php build_embed_cmd ${{ matrix.os }} ${{ matrix.php }}
+
+      - name: "Upload logs"
+        if: ${{ always() && hashFiles('log/**') != '' }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-logs-${{ matrix.os }}-${{ matrix.php }}
+          path: log
+
+#      - name: Setup tmate session
+#        if: ${{ failure() }}
+#        uses: mxschmitt/action-tmate@v3

.github/workflows/vitepress-deploy.yml

@@ -0,0 +1,71 @@
+name: Docs Auto Deploy
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'config/**.json'
+      - 'docs/**'
+      - 'package.json'
+      - 'yarn.lock'
+      - '.github/workflows/vitepress-deploy.yml'
+
+jobs:
+  build:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    if: github.repository == 'crazywhalecc/static-php-cli'
+    steps:
+      - name: Checkout master
+        uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v3
+        with:
+          cache: yarn
+
+      - run: yarn install --frozen-lockfile
+
+      - name: "Copy Config Files"
+        run: |
+          mkdir -p docs/.vitepress/config
+          cp -r config/* docs/.vitepress/config/
+
+      - name: "Install PHP for official runners"
+        uses: shivammathur/setup-php@v2
+        with:
+          coverage: none
+          tools: composer:v2
+          php-version: 8.4
+          ini-values: memory_limit=-1
+          extensions: curl, openssl, mbstring
+
+      - name: "Get Composer Cache Directory"
+        id: composer-cache
+        run: |
+          echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: "Cache Composer dependencies"
+        uses: "actions/cache@v4"
+        with:
+          path: "${{ steps.composer-cache.outputs.dir }}"
+          key: "php-8.2-locked-composer-${{ hashFiles('**/composer.lock') }}"
+          restore-keys: |
+            php-8.2-locked-composer
+
+      - name: "Install Locked Dependencies"
+        run: "composer install --no-interaction --no-progress"
+
+      - name: "Generate Extension Support List"
+        run: |
+          bin/spc dev:gen-ext-docs > docs/extensions.md
+          bin/spc dev:gen-ext-dep-docs > docs/deps-map-ext.md
+          bin/spc dev:gen-lib-dep-docs > docs/deps-map-lib.md
+
+      - name: Build
+        run: yarn docs:build
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/.vitepress/dist

.gitignore

@@ -1,27 +1,69 @@
 .idea
-runtime/
-docker/libraries/
-docker/extensions/
-docker/source/
+/runtime/
+/docker/libraries/
+/docker/extensions/
+/docker/source/
 
-# Composer file
-composer.lock
-/vendor/
+# Vendor files
+/vendor/**
 
 # default source extract directory
-/source/
+/source/**
+
+# built by shared embed tests
+/locale/
 
 # default source download directory
-/downloads/
+/downloads/**
 
 # default source build root directory
-/buildroot/
+/buildroot/**
 
-# php cs fixer cache file
+# default package root directory
+/pkgroot/**
+
+# Windows PHP SDK binary tools
+/php-sdk-binary-tools/**
+
+# default pack:lib and release directory
+/dist/**
+packlib_files.txt
+
+# tools cache files
 .php-cs-fixer.cache
+.phpunit.result.cache
+
+# doctor cache fallback (when ~/.cache/spc/ is not writable)
+.spc-doctor.lock
 
 # exclude self-runtime
 /bin/*
-!/bin/spc
-!/bin/setup-runtime
-!/bin/spc-alpine-docker
+!/bin/spc*
+!/bin/setup-runtime*
+!/bin/docker-entrypoint.sh
+
+# exclude windows build tools
+/php-sdk-binary-tools/
+
+# default test directory
+/tests/var/
+
+# VitePress
+/node_modules/
+/docs/.vitepress/dist/
+/docs/.vitepress/cache/
+package-lock.json
+pnpm-lock.yaml
+
+# craft
+craft.yml
+
+# SPC logs
+log/
+
+# spc.phar
+spc.phar
+spc.exe
+
+# dumped files from StaticPHP v3
+/dump-*.json

.php-cs-fixer.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 return (new PhpCsFixer\Config())
     ->setRiskyAllowed(true)
+    ->setUnsupportedPhpVersionAllowed(true)
     ->setRules([
         '@PSR12' => true,
         '@Symfony' => true,
@@ -63,7 +64,11 @@ return (new PhpCsFixer\Config())
         'phpdoc_summary' => false,
         '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')
-    );
+        PhpCsFixer\Finder::create()->in([__DIR__ . '/src', __DIR__ . '/tests/StaticPHP'])
+    )
+    ->setParallelConfig(PhpCsFixer\Runner\Parallel\ParallelConfigFactory::detect());

README-en.md

@@ -1,231 +0,0 @@
-# static-php-cli
-
-Compile A Statically Linked PHP With Swoole and other Extensions.
-
-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">
-
-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">
-
-> 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)]()
-[![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/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.
-
-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.
-
-|         | x86_64    | aarch64   |
-|---------|-----------|-----------|
-| macOS   | CI, Local | Local     |
-| Linux   | CI, Local | CI, Local |
-| Windows |           |           |
-
-> 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`.
-
-## Usage
-
-Please first select the extension you want to compile based on the extension list below.
-
-### Direct Download
-
-If you don't compile yourself, you can download pre-compiled artifact from Actions, or from self-hosted server: [Here](https://dl.zhamao.xin/static-php-cli/)
-
-> self-hosted server contains extensions: `bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,xml,mbstring,mbregex,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,session,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip`
-
-### Supported Extensions
-
-[Supported Extension List](/ext-support.md)
-
-> If there is no extension you need here, you can submit an issue.
-
-### GitHub Actions Build
-
-Use GitHub Action to easily build a statically compiled PHP and phpmicro, 
-and at the same time define the extensions to be compiled by yourself.
-
-1. Fork me.
-2. Go to the Actions of the project and select `CI`.
-3. Select `Run workflow`, fill in the PHP version you want to compile, the target type, and the list of extensions. (extensions comma separated, e.g. `bcmath,curl,mbstring`)
-4. After waiting for about a period of time, enter the corresponding task and get `Artifacts`.
-
-If you enable `debug`, all logs will be output at build time, including compiled logs, for troubleshooting.
-
-- When using ubuntu-latest, it will build linux-x86_64 binary.
-- When using macos-latest, it will build macOS-x86_64 binary.
-
-### Manual Build
-
-Clone repo first:
-
-```bash
-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.
-
-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
-./bin/setup-runtime
-
-# Use this php runtime to run static-php-cli compiler
-./bin/php bin/spc
-
-# Use composer
-./bin/php bin/composer
-```
-
-Basic usage for building php and micro with some extensions:
-
-```bash
-cd static-php-cli
-composer update
-chmod +x bin/spc
-# Check system tool dependencies, fix them automatically (only support macOS) (TODO: Linux distro support)
-./bin/spc doctor
-# fetch all libraries
-./bin/spc fetch --all
-# with bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl extension, build both CLI and phpmicro SAPI
-./bin/spc build bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl --build-cli --build-micro
-```
-
-You can also use the parameter `--with-php=x.y` to specify the downloaded PHP version, currently supports 7.4 ~ 8.2:
-
-```bash
-# Using PHP >= 8.0 is recommended, because 7.4 cannot use phpmicro
-./bin/spc fetch --with-php=8.2 --all
-```
-
-Now we support `cli`, `micro`, `fpm`, you can use one or more of the following parameters to specify the compiled SAPI:
-
-- `--build-cli`: build static cli executable
-- `--build-micro`: build static phpmicro self-extracted executable
-- `--build-fpm`: build static fpm binary
-- `--build-all`: build all
-
-If anything goes wrong, use `--debug` option to display full terminal output:
-
-```bash
-./bin/spc build openssl,pcntl,mbstring --debug --build-all
-./bin/spc fetch --all --debug
-```
-
-### php-cli Usage
-
-> php-cli is a single static binary, you can use it like normal php installed on your system.
-
-When using the parameter `--build-cli` or `--build-all`, 
-the final compilation result will output a binary file named `./php`, 
-which can be distributed and used directly. 
-This file will be located in the directory `buildroot/bin/`, copy it out for use.
-
-```bash
-cd buildroot/bin/
-./php -v                # check version
-./php -m                # check extensions
-./php your_code.php     # run your php code
-./php your_project.phar # run your phar (project archive)
-```
-
-### micro.sfx Usage
-
-> 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.
-
-When using the parameter `--build-all` or `--build-micro`, 
-the final compilation result will output a file named `./micro.sfx`, 
-which needs to be used with your PHP source code like `code.php`. 
-This file will be located in the path `buildroot/bin/micro.sfx`, simply copy it out for use.
-
-Prepare your project source code, which can be a single PHP file or a Phar file, for use.
-
-```bash
-echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
-cat micro.sfx code.php > single-app && chmod +x single-app
-./single-app
-
-# If packing a PHAR file, replace code.php with the Phar file path.
-```
-
-> In some cases, PHAR files may not run in a micro environment.
-
-### php-fpm Usage
-
-When using the parameter `--build-all` or `--build-fpm`,
-the final compilation result will output a file named `./php-fpm`,
-This file will be located in the path `buildroot/bin/`, simply copy it out for use.
-
-In normal Linux distributions and macOS systems, the package manager will automatically generate a default fpm configuration file after installing php-fpm.
-Because php-fpm must specify a configuration file before running, the php-fpm compiled by this project will not have any configuration files, so you need to write `php-fpm.conf` and `pool.conf` configuration files yourself.
-
-Specifying `php-fpm.conf` can use the command parameter `-y`, for example: `./php-fpm -y php-fpm.conf`.
-
-## 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. 
-If the extension you need is missing, you can create an issue. 
-If you are familiar with this project, you are also welcome to initiate a pull request.
-
-The basic principles for contributing are as follows:
-
-- This project uses php-cs-fixer and phpstan as code formatting tools. Before contributing, please run `composer analyze` and `composer cs-fix` on the updated code.
-- If other open source libraries are involved, the corresponding licenses should be provided. 
-    Also, configuration files should be sorted using the command `sort-config` after modification.
-    For more information about sorting commands, see the documentation.
-- Naming conventions should be followed, such as using the extension name registered in PHP for the extension name itself, 
-    and external library names should follow the project's own naming conventions. For internal logic functions, class names, variables, etc., 
-    camelCase and underscore formats should be followed, and mixing within the same module is prohibited.
-- When compiling external libraries and creating patches, compatibility with different operating systems should be considered.
-
-## Open-Source License
-
-This project is based on the tradition of using the MIT License for old versions, 
-while the new version references source code from some other projects:
-
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs) (Mulun Permissive License)
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli) (Apache 2.0 LICENSE+SWOOLE-CLI LICENSE)
-
-Due to the special nature of this project, 
-many other open source projects such as curl and protobuf will be used during the project compilation process, 
-and they all have their own open source licenses.
-
-Please use the `dump-license`(TODO) command to export the open source licenses used in the project after compilation, 
-and comply with the corresponding project's LICENSE.
-
-## Advanced
-
-This project is pure open source project, and some modules are separated for developing.
-
-This section will be improved after refactor version released.

README-zh.md

@@ -0,0 +1,172 @@
+# StaticPHP
+
+[![English readme](https://img.shields.io/badge/README-English%20%F0%9F%87%AC%F0%9F%87%A7-moccasin?style=flat-square)](README.md)
+[![Chinese readme](https://img.shields.io/badge/README-%E4%B8%AD%E6%96%87%20%F0%9F%87%A8%F0%9F%87%B3-moccasin?style=flat-square)](README-zh.md)
+[![Releases](https://img.shields.io/packagist/v/crazywhalecc/static-php-cli?include_prereleases&label=Release&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/releases)
+[![CI](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/tests.yml?branch=main&label=Build%20Test&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/tests.yml)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](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：**
+
+<img width="700" alt="out1" src="https://github.com/crazywhalecc/static-php-cli/assets/20330940/01a2e60f-13b0-4242-a645-f7afa4936396">
+
+**使用 phpmicro 将 PHP 代码与 PHP 解释器结合：**
+
+<img width="700" alt="out2" src="https://github.com/crazywhalecc/static-php-cli/assets/20330940/46b7128d-fb72-4169-957e-48564c3ff3e2">
+
+## 快速开始
+
+### 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 '<?php echo "Hello world!\n";' > a.php
+./spc micro:combine a.php -O my-app
+./my-app
+
+# php-fpm
+buildroot/bin/php-fpm -v
+```
+
+## 文档
+
+当前 README 包含基本用法。有关 StaticPHP 的所有功能，
+请访问 <https://static-php.dev>。
+
+## 直接下载
+
+如果您不想构建或想先测试，可以从 [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** 服务器。
+
+**特别感谢以下赞助商**：
+
+<a href="https://beyondco.de/"><img src="/docs/public/images/beyondcode-seeklogo.png" width="300" alt="Beyond Code Logo" /></a>
+
+<a href="https://nativephp.com/"><img src="/docs/public/images/nativephp-logo.svg" width="300" alt="NativePHP Logo" /></a>
+
+## 开源许可证
+
+本项目本身基于 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。

README.md

@@ -1,211 +1,173 @@
-# static-php-cli
+# StaticPHP
 
-Compile A Statically Linked PHP With Swoole and other Extensions. 
+[![Chinese readme](https://img.shields.io/badge/README-%E4%B8%AD%E6%96%87%20%F0%9F%87%A8%F0%9F%87%B3-moccasin?style=flat-square)](README-zh.md)
+[![English readme](https://img.shields.io/badge/README-English%20%F0%9F%87%AC%F0%9F%87%A7-moccasin?style=flat-square)](README.md)
+[![Releases](https://img.shields.io/packagist/v/crazywhalecc/static-php-cli?include_prereleases&label=Release&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/releases)
+[![CI](https://img.shields.io/github/actions/workflow/status/crazywhalecc/static-php-cli/tests.yml?branch=main&label=Build%20Test&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/tests.yml)
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://github.com/crazywhalecc/static-php-cli/blob/main/LICENSE)
 
-If you are using English, see [English README](README-en.md).
+**StaticPHP** is a powerful tool designed for building portable executables including PHP, extensions, and more.
 
-编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！（cli SAPI）
+## Features
 
-<img width="600" alt="截屏2023-05-02 15 53 13" src="https://user-images.githubusercontent.com/20330940/235610282-23e58d68-bd35-4092-8465-171cff2d5ba8.png">
+- :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)
+- :pill: Automatic build environment checker with auto-fix capabilities
+- :zap: `Linux`, `macOS`, `FreeBSD`, `Windows` support
+- :wrench: Configurable source code patching
+- :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)
+- :floppy_disk: UPX compression support (reduces binary size by 30-50%)
 
-同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！（由 [dixyes/phpmicro](https://github.com/dixyes/phpmicro) 提供支持）（micro SAPI）
+**Single-file standalone php-cli:**
 
-<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="700" alt="out1" src="https://github.com/crazywhalecc/static-php-cli/assets/20330940/01a2e60f-13b0-4242-a645-f7afa4936396">
 
-> 此分支为重构的新版，如果你在找纯 Bash 编写的旧版本，请到 [bash-version 分支](https://github.com/crazywhalecc/static-php-cli/tree/bash-version)。
+**Combine PHP code with PHP interpreter using phpmicro:**
 
-[![Version](https://img.shields.io/badge/Version-2.0--rc1-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/github/search/crazywhalecc/static-php-cli/TODO?label=TODO%20Counter&style=flat-square)]()
+<img width="700" alt="out2" src="https://github.com/crazywhalecc/static-php-cli/assets/20330940/46b7128d-fb72-4169-957e-48564c3ff3e2">
 
-## 编译环境需求
+## Quickstart
 
-是的，本项目采用 PHP 编写，编译前需要一个 PHP 环境，比较滑稽。
-但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 tokenizer 扩展和 PHP 版本大于等于 8.0 即可。
-
-下面是架构支持情况，`CI` 代表支持 GitHub Action 构建，`Local` 代表支持本地构建，空 代表暂不支持。
-
-|         | x86_64    | aarch64   |
-|---------|-----------|-----------|
-| macOS   | CI, Local | Local     |
-| Linux   | CI, Local | CI, Local |
-| Windows |           |           |
-
-> macOS-arm64 因 GitHub 暂未提供 arm runner，如果要构建 arm 二进制，可以使用手动构建。
-
-目前支持编译的 PHP 版本为：`7.4`，`8.0`，`8.1`，`8.2`。
-
-## 使用
-
-请先根据下方扩展列表选择你要编译的扩展。
-
-### 自托管直接下载
-
-如果你不想自行编译，可以从本项目现有的 Action 下载 Artifact，也可以从自托管的服务器下载：[进入](https://dl.zhamao.xin/static-php-cli/)
-
-> 自托管的服务器默认包含的扩展有：`bcmath,bz2,calendar,ctype,curl,dom,exif,fileinfo,filter,ftp,gd,gmp,iconv,xml,mbstring,mbregex,mysqlnd,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,redis,session,simplexml,soap,sockets,sqlite3,tokenizer,xmlwriter,xmlreader,zlib,zip`
-
-### 支持的扩展情况
-
-[扩展支持列表](/ext-support.md)
-
-> 如果这里没有你需要的扩展，可以提交 Issue。
-
-### 使用 Actions 构建
-
-使用 GitHub Action 可以方便地构建一个静态编译的 PHP 和 phpmicro，同时可以自行定义要编译的扩展。
-
-1. Fork 本项目。
-2. 进入项目的 Actions，选择 CI。
-3. 选择 `Run workflow`，填入你要编译的 PHP 版本、目标类型、扩展列表。（扩展列表使用英文逗号分割，例如 `bcmath,curl,mbstring`）
-4. 等待大约一段时间后，进入对应的任务中，获取 `Artifacts`。
-
-如果你选择了 `debug`，则会在构建时输出所有日志，包括编译的日志，以供排查错误。
-
-### 手动构建
-
-先克隆本项目：
+### 1. Download spc binary
 
 ```bash
-git clone https://github.com/crazywhalecc/static-php-cli.git
+# For Linux x86_64
+curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/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
+# 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 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
 ```
 
-如果你本机没有安装 PHP，你可以通过命令下载静态编译好的 php-cli 和 Composer。
-
-下载的 php 和 Composer 将保存为 `bin/php` 和 `bin/composer`。
+For macOS and Linux, add execute permission first:
 
 ```bash
-cd static-php-cli
-chmod +x bin/setup-runtime
-./bin/setup-runtime
-
-# 使用独立的 php 运行 static-php-cli
-./bin/php bin/spc
-
-# 使用 composer
-./bin/php bin/composer
+chmod +x ./spc
 ```
 
-下面是使用 static-php-cli 编译静态 php 和 micro 的基础用法：
+### 2. Build Static PHP
+
+First, create a `craft.yml` file and specify which extensions you want to include from [extension list](https://static-php.dev/en/guide/extensions.html) or [command generator](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.4
+# 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
+```
+
+Run command:
 
 ```bash
-# 克隆本项目
-cd static-php-cli
-composer update
-chmod +x bin/spc
-# 检查环境依赖，并根据提示的命令安装缺失的编译工具（目前仅支持 macOS，Linux 后续会支持）
-./bin/spc doctor
-# 拉取所有依赖库
-./bin/spc fetch --all
-# 构建包含 bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl 扩展的 php-cli 和 micro.sfx
-./bin/spc build "bcmath,openssl,tokenizer,sqlite3,pdo_sqlite,ftp,curl" --build-cli --build-micro
+./spc craft
+
+# Output full console log
+./spc craft --debug
 ```
 
-你也可以使用参数 `--with-php=x.y` 来指定下载的 PHP 版本，目前支持 7.4 ~ 8.2：
+### 3. Static PHP usage
 
-```bash
-# 优先考虑使用 >= 8.0 的 PHP 版本
-./bin/spc fetch --with-php=8.2 --all
+Now you can copy binaries built by StaticPHP to another machine and run with no dependencies:
+
+```
+# php-cli
+buildroot/bin/php -v
+
+# phpmicro
+echo '<?php echo "Hello world!\n";' > a.php
+./spc micro:combine a.php -O my-app
+./my-app
+
+# php-fpm
+buildroot/bin/php-fpm -v
 ```
 
-其中，目前支持构建 cli，micro，fpm 三种静态二进制，使用以下参数的一个或多个来指定编译的 SAPI：
+## Documentation
 
-- `--build-cli`：构建 cli 二进制
-- `--build-micro`：构建 phpmicro 自执行二进制
-- `--build-fpm`：构建 fpm
-- `--build-all`：构建所有
+The current README contains basic usage. For all the features of StaticPHP,
+see <https://static-php.dev> .
 
-如果出现了任何错误，可以使用 `--debug` 参数来展示完整的输出日志，以供排查错误：
+## Direct Download
 
-```bash
-./bin/spc build openssl,pcntl,mbstring --debug --build-all
-./bin/spc fetch --all --debug
-```
+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.
 
-### 使用 php-cli
+Below are several precompiled static-php binaries with different extension combinations,
+which can be downloaded directly according to your needs.
 
-> php-cli 是一个静态的二进制文件，类似 Go、Rust 语言编译后的单个可移植的二进制文件。
+| 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 |
 
-采用参数 `--build-cli` 或`--build-all` 参数时，最后编译结果会输出一个 `./php` 的二进制文件，此文件可分发、可直接使用。
-该文件编译后会存放在 `buildroot/bin/` 目录中，名称为 `php`，拷贝出来即可。
+> 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.
 
-```bash
-cd buildroot/bin/
-./php -v                # 检查版本
-./php -m                # 检查编译的扩展
-./php your_code.php     # 运行代码
-./php your_project.phar # 运行打包为 phar 单文件的项目
-```
+### Build Online (using GitHub Actions)
 
-### 使用 micro.sfx
+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.
 
-> phpmicro 是一个提供自执行二进制 PHP 的项目，本项目依赖 phpmicro 进行编译自执行二进制。详见 [dixyes/phpmicro](https://github.com/dixyes/phpmicro)。
+1. Fork me.
+2. Go to the Actions of the project and select `CI`.
+3. Select `Run workflow`, fill in the PHP version you want to compile, the target type, and the list of extensions. (extensions comma separated, e.g. `bcmath,curl,mbstring`)
+4. After waiting for about a period of time, enter the corresponding task and get `Artifacts`.
 
-采用项目参数 `--build-micro` 或 `--build-all` 时，最后编译结果会输出一个 `./micro.sfx` 的文件，此文件需要配合你的 PHP 源码使用。
-该文件编译后会存放在 `buildroot/bin/` 目录中，拷贝出来即可。
+If you enable `debug`, all logs will be output at build time, including compiled logs, for troubleshooting.
 
-使用时应准备好你的项目源码文件，可以是单个 PHP 文件，也可以是 Phar 文件。
+## Contribution
 
-```bash
-echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
-cat micro.sfx code.php > single-app && chmod +x single-app
-./single-app
+If the extension you need is missing, you can create an issue.
+If you are familiar with this project, you are also welcome to initiate a pull request.
 
-# 如果打包 PHAR 文件，仅需把 code.php 更换为 phar 文件路径即可
-```
+If you want to contribute documentation, please just edit in `docs/`.
 
-> 有些情况下的 phar 文件可能无法在 micro 环境下运行。
+Now there is a [static-php](https://github.com/static-php) organization, which is used to store the repo related to the project.
 
-### 使用 php-fpm
+## Sponsor this project
 
-采用项目参数 `--build-fpm` 或 `--build-all` 时，最后编译结果会输出一个 `./php-fpm` 的文件。
-该文件存放在 `buildroot/bin/` 目录，拷贝出来即可使用。
+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.
 
-在正常的 Linux 发行版和 macOS 系统中，安装 php-fpm 后包管理会自动生成默认的 fpm 配置文件。
-因为 php-fpm 必须指定配置文件才可启动，本项目编译的 php-fpm 不会带任何配置文件，所以需自行编写 `php-fpm.conf` 和 `pool.conf` 配置文件。
+**Special thanks to sponsors below**:
 
-指定 `php-fpm.conf` 可以使用命令参数 `-y`，例如：`./php-fpm -y php-fpm.conf`。
+<a href="https://beyondco.de/"><img src="/docs/public/images/beyondcode-seeklogo.png" width="300" alt="Beyond Code Logo" /></a>
 
-## 项目支持情况
+<a href="https://nativephp.com/"><img src="/docs/public/images/nativephp-logo.svg" width="300" alt="NativePHP Logo" /></a>
 
-- [X] 基础结构编写（采用 `symfony/console`）
-- [X] 错误处理
-- [X] macOS 支持
-- [ ] Windows 支持
-- [X] Linux 支持
-- [X] PHP 7.4 支持
-- [X] fpm 支持
+## Open-Source License
 
-更多功能和特性正在陆续支持中，详见：https://github.com/crazywhalecc/static-php-cli/issues/32
+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:
 
-目前支持的扩展较少，如果缺少你需要的扩展，可发起 Issue。如果你对本项目较熟悉，也欢迎为本项目发起 Pull Request。
+- [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).
 
-- 项目采用了 php-cs-fixer、phpstan 作为代码规范工具，贡献前请对更新的代码执行 `composer analyze` 和 `composer cs-fix`。
-- 涉及到其他开源库的部分应提供对应库的协议，同时对配置文件在修改后采用命令 `sort-config` 排序。有关排序的命令，见文档。
-- 应遵循命名规范，例如扩展名称应采取 PHP 内注册的扩展名本身，外部库名应遵循项目本身的名称，内部逻辑的函数、类名、变量等应遵循驼峰、下划线等格式，禁止同一模块混用。
-- 涉及编译外部库的命令和 Patch 时应注意兼容不同操作系统。
+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.
 
-另外，添加新扩展的贡献方式，可以参考下方 `进阶`。
-
-## 开源协议
-
-本项目依据旧版本惯例采用 MIT License 开源，自身的部分代码引用或修改自以下项目：
-
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)（木兰宽松许可证）
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)（Apache 2.0 LICENSE、SWOOLE-CLI LICENSE）
-
-因本项目的特殊性，使用项目编译过程中会使用很多其他开源项目，例如 curl、protobuf 等，它们都有各自的开源协议。
-请在编译完成后，使用命令 `dump-license`(TODO) 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
-
-## 进阶
-
-本项目重构分支为模块化编写。
-
-TODO：这部分将在基础功能完成后编写完成。
+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.

TODO.md

@@ -0,0 +1,57 @@
+# v3 TODO List
+
+Tracking items identified during the v2 → v3 migration audit.
+
+---
+
+## Commands
+
+- [ ] Implement `craft` command (drives full build from `craft.yml`; should be easier with v3 vendor/registry mode)
+- [ ] Migrate `micro:combine` command (combine `micro.sfx` with PHP code + INI injection)
+- [ ] Implement `dump-extensions` command (extract required extensions from `composer.json` / `composer.lock`)
+- [ ] Design and implement v3 dev toolchain commands (WIP — needs design decision):
+  - [ ] `dev:extensions` / equivalent listing command
+  - [ ] `dev:php-version`, `dev:ext-version`, `dev:lib-version`
+  - [ ] Doc generation commands (`dev:gen-ext-docs`, `dev:gen-ext-dep-docs`, `dev:gen-lib-dep-docs`) — pending v3 doc design
+
+---
+
+## Source Patches (SourcePatcher → Artifact migration)
+
+The following v2 `SourcePatcher` hooks are not yet migrated to v3 `src/Package/Artifact/` classes:
+
+- [ ] Migrate `patchSQLSRVWin32` — removes `/sdl` compile flag to prevent Zend build failure on Windows
+- [ ] Migrate `patchSQLSRVPhp85` — fixes `pdo_sqlsrv` directory layout for PHP 8.5
+- [ ] Migrate `patchYamlWin32` — patches `config.w32` `_a.lib` detection logic for the `yaml` extension
+- [ ] Migrate `patchImagickWith84` — applies PHP 8.4 compatibility patch for `imagick` based on version detection
+
+---
+
+## Extension Package Classes (Unix)
+
+Extensions that had non-trivial v2 build logic and are missing a v3 `src/Package/Extension/` class:
+
+- [x] `gettext` — macOS: fix `config.m4` bracket syntax for cross-version compatibility + append frameworks to linker flags (critical for macOS linking; this is a Unix-side gap, not Windows-only)
+
+---
+
+## Windows Extensions (Early Stage)
+
+Windows extension support is still in early stage. The following extensions had Windows-specific configure args or patches in v2 and are pending v3 Windows implementation:
+
+- [ ] `amqp` — Windows configure args
+- [ ] `com_dotnet` — Windows-only extension
+- [ ] `dom` — remove `dllmain.c` from `config.w32`
+- [ ] `ev` — fix `PHP_EV_SHARED` in `config.w32`
+- [ ] `gmssl` — add `CHECK_LIB("gmssl.lib")` to `config.w32`
+- [ ] `intl` — fix `PHP_INTL_SHARED` in `config.w32`
+- [ ] `lz4` — Windows configure args
+- [ ] `mbregex` — Windows configure args
+- [ ] `sqlsrv` / `pdo_sqlsrv` — complex conditional build logic (independent `sqlsrv` without `pdo_sqlsrv`)
+- [ ] `xml` — remove `dllmain.c` from `config.w32`; handles `soap`, `xmlreader`, `xmlwriter`, `simplexml`
+
+---
+
+## Documentation
+
+- [ ] Write v3 user documentation (currently zero v3 docs)

bin/docker-entrypoint.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -e
+TARGET_DIR="/app/pkgroot/$(uname -m)-linux"
+BACKUP_DIR="/app/pkgroot-private"
+# copy private pkgroot to pkgroot if pkgroot is empty
+if [ ! -d "$TARGET_DIR" ] || [ -z "$(ls -A "$TARGET_DIR")" ]; then
+    echo "* Copying private pkgroot to pkgroot ..."
+    rm -rf "$TARGET_DIR"
+    cp -r "$BACKUP_DIR" "$TARGET_DIR"
+fi
+exec "$@"

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.static-php.dev/static-php-cli/bulk/php-8.4.12-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
 __COMPOSER_URL__="https://getcomposer.org/download/latest-stable/composer.phar"
 
 # use china mirror
@@ -35,7 +35,6 @@ while [ $# -gt 0 ]; do
   case "$1" in
   --mirror)
     mirror="$2"
-    shift
     ;;
   --*)
     echo "Illegal option $1"
@@ -46,23 +45,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"
-  __COMPOSER_URL__="https://mirrors.aliyun.com/composer/composer.phar"
+  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.4.12-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+  __COMPOSER_URL__="https://mirrors.tencent.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 || { 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; }
-${__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/setup-runtime.ps1

@@ -0,0 +1,116 @@
+param (
+    [string] ${action}
+)
+
+function AddToPath {
+    param (
+        [string]$pathToAdd
+    )
+
+    $currentPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
+
+    if ($currentPath -notlike "*$pathToAdd*") {
+        $newPath = $currentPath + ";$pathToAdd"
+        [System.Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
+        Write-Host "Added '$pathToAdd' to Path."
+        Write-Host "To remove path, use: " -NoNewline
+        Write-Host "bin/setup-runtime remove-path" -ForegroundColor Cyan
+    } else {
+        Write-Host "Path already exists."
+    }
+}
+
+function RemoveFromPath {
+    param (
+        [string]$pathToRemove
+    )
+
+    $currentPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
+
+    if ($currentPath -like "*$pathToRemove*") {
+        $newPath = $currentPath -replace [regex]::Escape(';' + $pathToRemove), ''
+        [System.Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
+        Write-Host "Removed Path '$pathToRemove'"
+    } else {
+        Write-Host "Path '$pathToRemove' not in Path"
+    }
+}
+
+# working dir
+$WorkingDir = (Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Definition))
+
+if ($action -eq 'add-path') {
+    AddToPath ($WorkingDir + '\runtime')
+    exit 0
+} elseif ($action -eq 'remove-path') {
+    RemoveFromPath ($WorkingDir + '\runtime')
+    exit 0
+} elseif (-not($action -eq '')) {
+    Write-Host ("Invalid action: " + $action) -ForegroundColor Red
+    exit 1
+}
+
+# get php 8.1 specific version
+
+# php windows download
+$PHPRuntimeUrl = "https://windows.php.net/downloads/releases/archives/php-8.4.4-nts-Win32-vs17-x64.zip"
+Write-Host "Downloading PHP from: " -NoNewline
+Write-Host $PHPRuntimeUrl -ForegroundColor Cyan
+$ComposerUrl = "https://getcomposer.org/download/latest-stable/composer.phar"
+
+# create dir
+New-Item -Path "downloads" -ItemType Directory -Force | Out-Null
+
+# download php
+if (-not(Test-Path "downloads\php.zip"))
+{
+    Write-Host "Downloading PHP ..."
+    Invoke-WebRequest $PHPRuntimeUrl -OutFile "downloads\php.zip"
+}
+
+# extract php
+New-Item -Path "runtime" -ItemType Directory -Force | Out-Null
+Write-Host "Extracting php.zip ..."
+Expand-Archive -Path "downloads/php.zip" -DestinationPath "runtime" -Force
+# make php.ini
+Move-Item -Path "runtime\php.ini-production" -Destination "runtime\php.ini" -Force
+$OriginINI = Get-Content -Path "runtime\php.ini" -Raw
+$OriginINI = $OriginINI -replace ';extension=openssl', 'extension=openssl'
+$OriginINI = $OriginINI -replace ';extension=curl', 'extension=curl'
+$OriginINI = $OriginINI -replace ';extension=mbstring', 'extension=mbstring'
+$OriginINI = $OriginINI -replace ';extension=sodium', 'extension=sodium'
+$OriginINI = $OriginINI -replace ';extension_dir = "./"', ('extension_dir = "' + (Split-Path -Parent $MyInvocation.MyCommand.Definition) + '\..\runtime\ext"')
+$OriginINI | Set-Content -Path "runtime\php.ini"
+
+# download composer
+if (-not(Test-Path "runtime\composer.phar"))
+{
+    Write-Host "Downloading composer ..."
+    Invoke-WebRequest $ComposerUrl -OutFile "downloads\composer.phar"
+    Move-Item -Path "downloads\composer.phar" -Destination "runtime\composer.phar" -Force
+}
+
+# create runtime\composer.ps1
+$ComposerContent = '
+$WorkingDir = (Split-Path -Parent $MyInvocation.MyCommand.Definition)
+& ($WorkingDir + "\php.exe") (Join-Path $WorkingDir "\composer.phar") @args
+'
+$ComposerContent | Set-Content -Path 'runtime\composer.ps1' -Encoding UTF8
+
+Write-Host "Successfully downloaded PHP and Composer !" -ForegroundColor Green
+Write-Host "Use static-php-cli: " -NoNewline
+Write-Host "bin/spc" -ForegroundColor Cyan
+Write-Host "Use php:            " -NoNewline
+Write-Host "runtime/php" -ForegroundColor Cyan
+Write-Host "Use composer:       " -NoNewline
+Write-Host "runtime/composer" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "Don't forget installing composer dependencies '" -NoNewline
+Write-Host "runtime/composer install" -ForegroundColor Cyan -NoNewline
+Write-Host "' before using static-php-cli !"
+Write-Host ""
+Write-Host "If you want to use this PHP for quality tools (like phpstan, php-cs-fixer) or other project,"
+Write-Host "or use PHP, Composer as system executable,"
+Write-Host "use '" -NoNewline
+Write-Host "bin/setup-runtime add-path" -ForegroundColor Cyan -NoNewline
+Write-Host "' to add runtime dir in Path."

bin/spc

@@ -1,16 +1,28 @@
 #!/usr/bin/env php
 <?php
 
-require_once __DIR__ . '/../vendor/autoload.php';
+use StaticPHP\ConsoleApplication;
+use StaticPHP\Exception\ExceptionHandler;
+use StaticPHP\Exception\SPCException;
 
-// 防止 Micro 打包状态下不支持中文的显示（虽然这个项目目前好像没输出过中文？）
-if (PHP_OS_FAMILY === 'Windows' && Phar::running()) {
-    exec('CHCP 65001');
+if (file_exists(dirname(__DIR__) . '/vendor/autoload.php')) {
+    // Current: ./bin (git/project mode)
+    require_once dirname(__DIR__) . '/vendor/autoload.php';
+} else {
+    // Current: ./vendor/crazywhalecc/static-php-cli/bin (composer library mode)
+    require_once dirname(__DIR__, 3) . '/autoload.php';
+}
+
+// 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 \SPC\ConsoleApplication())->run();
-} catch (Exception $e) {
-    \SPC\exception\ExceptionHandler::getInstance()->handle($e);
+    (new ConsoleApplication())->run();
+} catch (SPCException $e) {
+    exit(ExceptionHandler::handleSPCException($e));
+} catch (\Throwable $e) {
+    exit(ExceptionHandler::handleDefaultException($e));
 }
+

bin/spc-alpine-docker

@@ -1,19 +1,22 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
+
+set -e
 
 # This file is using docker to run commands
-
-self_dir=$(cd "$(dirname "$0")";pwd)
+SPC_DOCKER_VERSION=v7
 
 # Detect docker can run
 if ! which docker >/dev/null; then
-  echo "Docker is not installed, please install docker first !"
-  exit 1
+    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
@@ -21,26 +24,48 @@ if [ $(id -u) -ne 0 ]; then
     fi
 fi
 
-
-
-# to check if qemu-docker run
-if [ "$SPC_USE_ARCH" = "" ]; then
-    SPC_USE_ARCH=x86_64
+# Convert uname to gnu arch
+CURRENT_ARCH=$(uname -m)
+if [ "$CURRENT_ARCH" = "arm64" ]; then
+    CURRENT_ARCH=aarch64
 fi
+if [ -z "$SPC_USE_ARCH" ]; then
+    SPC_USE_ARCH=$CURRENT_ARCH
+fi
+# parse SPC_USE_ARCH
 case $SPC_USE_ARCH in
-x86_64)
-    ALPINE_FROM=alpine:edge
+x86_64|amd64)
+    SPC_USE_ARCH=x86_64
+    if [ "$CURRENT_ARCH" != "x86_64" ]; then
+        PLATFORM_ARG="--platform linux/amd64"
+        ALPINE_FROM=multiarch/alpine:x86_64-edge
+    fi
     ;;
-aarch64)
-    ALPINE_FROM=multiarch/alpine:aarch64-edge
-    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
+aarch64|arm64)
+    SPC_USE_ARCH=aarch64
+    if [ "$CURRENT_ARCH" != "aarch64" ]; then
+        PLATFORM_ARG="--platform linux/arm64"
+        ALPINE_FROM=multiarch/alpine:aarch64-edge
+    fi
     ;;
 *)
     echo "Current arch is not supported to run in docker: $SPC_USE_ARCH"
     exit 1
     ;;
 esac
+# if ALPINE_FROM is not set, use alpine:3.21
+if [ -z "$ALPINE_FROM" ]; then
+    ALPINE_FROM=alpine:3.21
+fi
+if [ "$SPC_USE_ARCH" != "$CURRENT_ARCH" ]; then
+    echo "* Using different arch needs to setup qemu-static for docker !"
+    ALPINE_FROM=multiarch/alpine:$SPC_USE_ARCH-edge
+    if [ "$(uname -s)" = "Linux" ]; then
+        $DOCKER_EXECUTABLE run --rm --privileged multiarch/qemu-user-static:register --reset > /dev/null
+    fi
+else
+    ALPINE_FROM=alpine:3.21
+fi
 
 if [ "$SPC_USE_MIRROR" = "yes" ]; then
     SPC_USE_MIRROR="RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories"
@@ -49,26 +74,63 @@ 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-$SPC_DOCKER_VERSION; then
     echo "Docker container does not exist. Building docker image ..."
-    ALPINE_DOCKERFILE=$(cat << EOF
+    $DOCKER_EXECUTABLE build $PLATFORM_ARG -t cwcc-spc-$SPC_USE_ARCH-$SPC_DOCKER_VERSION -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 upgrade -a; \
+    apk add --no-cache \
+        autoconf \
+        automake \
+        gettext \
+        bash \
+        binutils \
+        bison \
+        build-base \
+        cmake \
+        curl \
+        file \
+        flex \
+        g++ \
+        gcc \
+        git \
+        jq \
+        libgcc \
+        libtool \
+        libstdc++ \
+        linux-headers \
+        m4 \
+        make \
+        pkgconfig \
+        re2c \
+        wget \
+        xz \
+        gettext-dev \
+        binutils-gold
+
+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
-ADD ./composer.json /app/composer.json
+COPY ./composer.* /app/
 ADD ./bin /app/bin
-RUN composer update --no-dev
-EOF
-)
-    echo "$ALPINE_DOCKERFILE" > $(pwd)/Dockerfile
+RUN composer install --no-dev
+ADD ./config /app/config
+ADD ./spc.registry.json /app/spc.registry.json
+RUN bin/spc doctor --auto-fix
+RUN bin/spc install-pkg upx
 
-    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH .
-    rm $(pwd)/Dockerfile
+RUN mv /app/pkgroot/\$(uname -m)-linux /app/pkgroot-private
+ADD bin/docker-entrypoint.sh /bin/docker-entrypoint.sh
+RUN chmod +x /bin/docker-entrypoint.sh
+ENTRYPOINT ["/bin/docker-entrypoint.sh"]
+EOF
 fi
 
 # Check if in ci (local terminal can execute with -it)
@@ -78,5 +140,89 @@ else
     INTERACT=''
 fi
 
+# Mounting volumes
+MOUNT_LIST=""
+# shellcheck disable=SC2089
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/config:/app/config"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/src:/app/src"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/buildroot:/app/buildroot"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/source:/app/source"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/dist:/app/dist"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/downloads:/app/downloads"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/pkgroot:/app/pkgroot"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/log:/app/log"
+if [ -f "$(pwd)/craft.yml" ]; then
+    MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/craft.yml:/app/craft.yml"
+fi
+
+# Environment variable passthrough
+ENV_LIST=""
+ENV_LIST="$ENV_LIST -e SPC_FIX_DEPLOY_ROOT="$(pwd)""
+if [ ! -z "$GITHUB_TOKEN" ]; then
+    ENV_LIST="$ENV_LIST -e GITHUB_TOKEN=$GITHUB_TOKEN"
+fi
+
+# Intercept and rewrite --with-frankenphp-app option, and mount host path to /app/app
+FRANKENPHP_APP_PATH=""
+NEW_ARGS=()
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --with-frankenphp-app=*)
+            FRANKENPHP_APP_PATH="${1#*=}"
+            NEW_ARGS+=("--with-frankenphp-app=/app/app")
+            shift
+            ;;
+        --with-frankenphp-app)
+            if [ -n "${2:-}" ]; then
+                FRANKENPHP_APP_PATH="$2"
+                NEW_ARGS+=("--with-frankenphp-app=/app/app")
+                shift 2
+            else
+                NEW_ARGS+=("$1")
+                shift
+            fi
+            ;;
+        *)
+            NEW_ARGS+=("$1")
+            shift
+            ;;
+    esac
+done
+
+# Normalize the path and add mount if provided
+if [ -n "$FRANKENPHP_APP_PATH" ]; then
+    # expand ~ to $HOME
+    if [ "${FRANKENPHP_APP_PATH#~}" != "$FRANKENPHP_APP_PATH" ]; then
+        FRANKENPHP_APP_PATH="$HOME${FRANKENPHP_APP_PATH#~}"
+    fi
+    # make absolute if relative
+    case "$FRANKENPHP_APP_PATH" in
+        /*) ABS_APP_PATH="$FRANKENPHP_APP_PATH" ;;
+        *) ABS_APP_PATH="$(pwd)/$FRANKENPHP_APP_PATH" ;;
+    esac
+    MOUNT_LIST="$MOUNT_LIST -v $ABS_APP_PATH:/app/app"
+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
+# shellcheck disable=SC2086
+# shellcheck disable=SC2090
+if [ "$SPC_DOCKER_DEBUG" = "yes" ]; then
+    echo "* Debug mode enabled, run docker in interactive mode."
+    echo "* You can use 'exit' to exit the docker container."
+    echo "* You can use 'bin/spc' like normal builds."
+    echo "*"
+    echo "*    Mounted directories:"
+    echo "*    ./config:    $(pwd)/config"
+    echo "*    ./src:       $(pwd)/src"
+    echo "*    ./buildroot: $(pwd)/buildroot"
+    echo "*    ./source:    $(pwd)/source"
+    echo "*    ./dist:      $(pwd)/dist"
+    echo "*    ./downloads: $(pwd)/downloads"
+    echo "*    ./pkgroot:   $(pwd)/pkgroot"
+    echo "*"
+    set -ex
+    $DOCKER_EXECUTABLE run $PLATFORM_ARG --rm $INTERACT $ENV_LIST $MOUNT_LIST cwcc-spc-$SPC_USE_ARCH-$SPC_DOCKER_VERSION /bin/bash
+else
+    $DOCKER_EXECUTABLE run $PLATFORM_ARG --rm $INTERACT $ENV_LIST $MOUNT_LIST cwcc-spc-$SPC_USE_ARCH-$SPC_DOCKER_VERSION bin/spc "${NEW_ARGS[@]}"
+fi

bin/spc-debug

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+
+# This script runs the 'spc' command with Xdebug enabled for debugging purposes.
+php -d xdebug.mode=debug -d xdebug.client_host=127.0.0.1 -d xdebug.client_port=9003 -d xdebug.start_with_request=yes "$(dirname "$0")/../bin/spc" "$@"

bin/spc-debug.ps1

@@ -0,0 +1,12 @@
+$PHP_Exec = ".\runtime\php.exe"
+
+if (-not(Test-Path $PHP_Exec)) {
+    $PHP_Exec = Get-Command php.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Definition
+    if (-not $PHP_Exec) {
+        Write-Host "Error: PHP not found, you need to install PHP on your system or use 'bin/setup-runtime'." -ForegroundColor Red
+        exit 1
+    }
+}
+
+& "$PHP_Exec" -d xdebug.mode=debug -d xdebug.client_host=127.0.0.1 -d xdebug.client_port=9003 -d xdebug.start_with_request=yes ("bin/spc") @args
+exit $LASTEXITCODE

bin/spc-gnu-docker

@@ -0,0 +1,236 @@
+#!/usr/bin/env bash
+
+set -e
+
+# This file is using docker to run commands
+SPC_DOCKER_VERSION=v6
+
+# 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" ] && [ "$SPC_DOCKER_DEBUG" != "yes" ]; then
+            echo "Docker command requires sudo"
+            # shellcheck disable=SC2039
+            echo -n 'To use sudo to run docker, run "export SPC_USE_SUDO=yes" and run command again'
+            exit 1
+        fi
+        DOCKER_EXECUTABLE="sudo docker"
+    fi
+fi
+
+# Convert uname to gnu arch
+CURRENT_ARCH=$(uname -m)
+if [ "$CURRENT_ARCH" = "arm64" ]; then
+    CURRENT_ARCH=aarch64
+fi
+if [ -z "$SPC_USE_ARCH" ]; then
+    SPC_USE_ARCH=$CURRENT_ARCH
+fi
+# parse SPC_USE_ARCH
+case $SPC_USE_ARCH in
+x86_64|amd64)
+    SPC_USE_ARCH=x86_64
+    SPC_USE_ARCH_DOCKER=amd64
+    if [ "$CURRENT_ARCH" != "x86_64" ]; then
+        PLATFORM_ARG="--platform linux/amd64"
+    fi
+    ;;
+aarch64|arm64)
+    SPC_USE_ARCH=aarch64
+    SPC_USE_ARCH_DOCKER=arm64
+    if [ "$CURRENT_ARCH" != "aarch64" ]; then
+        PLATFORM_ARG="--platform linux/arm64"
+    fi
+    ;;
+*)
+    echo "Current arch is not supported to run in docker: $SPC_USE_ARCH"
+    exit 1
+    ;;
+esac
+# detect if we need to use qemu-static
+if [ "$SPC_USE_ARCH" != "$CURRENT_ARCH" ]; then
+    if [ "$(uname -s)" = "Linux" ]; then
+        echo "* Using different arch needs to setup qemu-static for docker !"
+        $DOCKER_EXECUTABLE run --rm --privileged multiarch/qemu-user-static --reset -p yes > /dev/null
+    fi
+fi
+
+# Detect docker env is setup
+if ! $DOCKER_EXECUTABLE images | grep -q cwcc-spc-gnu-$SPC_USE_ARCH-$SPC_DOCKER_VERSION; then
+    echo "Docker container does not exist. Building docker image ..."
+    $DOCKER_EXECUTABLE buildx build $PLATFORM_ARG -t cwcc-spc-gnu-$SPC_USE_ARCH-$SPC_DOCKER_VERSION -f- . <<EOF
+FROM centos:7
+RUN sed -i 's/mirror.centos.org/vault.centos.org/g' /etc/yum.repos.d/*.repo && \
+    sed -i 's/^#.*baseurl=http/baseurl=http/g' /etc/yum.repos.d/*.repo && \
+    sed -i 's/^mirrorlist=http/#mirrorlist=http/g' /etc/yum.repos.d/*.repo
+RUN yum clean all && \
+    yum makecache && \
+    yum update -y && \
+    localedef -c -i en_US -f UTF-8 en_US.UTF-8
+
+RUN yum install -y centos-release-scl
+
+RUN if [ "$SPC_USE_ARCH" = "aarch64" ]; then \
+        sed -i 's|mirror.centos.org/centos|vault.centos.org/altarch|g' /etc/yum.repos.d/CentOS-SCLo-scl-rh.repo ; \
+        sed -i 's|mirror.centos.org/centos|vault.centos.org/altarch|g' /etc/yum.repos.d/CentOS-SCLo-scl.repo ; \
+    else \
+        sed -i 's/mirror.centos.org/vault.centos.org/g' /etc/yum.repos.d/*.repo ; \
+    fi
+RUN sed -i 's/^#.*baseurl=http/baseurl=http/g' /etc/yum.repos.d/*.repo && \
+    sed -i 's/^mirrorlist=http/#mirrorlist=http/g' /etc/yum.repos.d/*.repo && \
+    sed -i 's|http://|https://|g' /etc/yum.repos.d/*.repo
+
+RUN yum update -y && \
+    yum install -y devtoolset-10-gcc-* devtoolset-10-libatomic-devel
+RUN echo "source scl_source enable devtoolset-10" >> /etc/bashrc
+RUN source /etc/bashrc
+RUN yum install -y which
+
+RUN curl -o cmake.tgz -#fSL https://github.com/Kitware/CMake/releases/download/v3.31.4/cmake-3.31.4-linux-$SPC_USE_ARCH.tar.gz && \
+    mkdir /cmake && \
+    tar -xzf cmake.tgz -C /cmake --strip-components 1
+
+WORKDIR /app
+COPY ./composer.* /app/
+ADD ./bin/setup-runtime /app/bin/setup-runtime
+ADD ./bin/spc /app/bin/spc
+RUN /app/bin/setup-runtime
+ADD ./src /app/src
+RUN /app/bin/php /app/bin/composer install --no-dev
+ENV SPC_LIBC=glibc
+ENV PATH="/app/bin:/cmake/bin:/opt/rh/devtoolset-10/root/usr/bin:\$PATH"
+
+ADD ./config /app/config
+RUN CC=gcc bin/spc doctor --auto-fix --debug
+RUN bin/spc install-pkg upx
+RUN if [ -f /app/buildroot/bin/re2c ]; then \
+        cp /app/buildroot/bin/re2c /usr/local/bin/re2c ;\
+    fi
+
+RUN curl -o make.tgz -fsSL https://ftp.gnu.org/gnu/make/make-4.4.tar.gz && \
+    tar -zxvf make.tgz && \
+    cd make-4.4 && \
+    ./configure && \
+    make && \
+    make install && \
+    ln -sf /usr/local/bin/make /usr/bin/make
+
+RUN curl -o automake.tgz -fsSL https://ftp.gnu.org/gnu/automake/automake-1.17.tar.xz && \
+    tar -xvf automake.tgz && \
+    cd automake-1.17 && \
+    ./configure && \
+    make && \
+    make install && \
+    ln -sf /usr/local/bin/automake /usr/bin/automake
+
+RUN mv /app/pkgroot/\$(uname -m)-linux /app/pkgroot-private
+ADD bin/docker-entrypoint.sh /bin/docker-entrypoint.sh
+RUN chmod +x /bin/docker-entrypoint.sh
+ENTRYPOINT ["/bin/docker-entrypoint.sh"]
+EOF
+fi
+
+# Check if in ci (local terminal can execute with -it)
+if [ -t 0 ]; then
+    INTERACT=-it
+else
+    INTERACT=''
+fi
+
+# Mounting volumes
+MOUNT_LIST=""
+# shellcheck disable=SC2089
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/config:/app/config"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/src:/app/src"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/buildroot:/app/buildroot"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/source:/app/source"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/dist:/app/dist"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/downloads:/app/downloads"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/pkgroot:/app/pkgroot"
+MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/log:/app/log"
+if [ -f "$(pwd)/craft.yml" ]; then
+    MOUNT_LIST="$MOUNT_LIST -v ""$(pwd)""/craft.yml:/app/craft.yml"
+fi
+
+# Apply env in temp env file
+echo 'SPC_DEFAULT_C_FLAGS=-fPIC' > /tmp/spc-gnu-docker.env
+echo 'SPC_LIBC=glibc' >> /tmp/spc-gnu-docker.env
+
+# Environment variable passthrough
+ENV_LIST=""
+ENV_LIST="$ENV_LIST -e SPC_FIX_DEPLOY_ROOT="$(pwd)""
+if [ ! -z "$GITHUB_TOKEN" ]; then
+    ENV_LIST="$ENV_LIST -e GITHUB_TOKEN=$GITHUB_TOKEN"
+fi
+
+# Intercept and rewrite --with-frankenphp-app option, and mount host path to /app/app
+FRANKENPHP_APP_PATH=""
+NEW_ARGS=()
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --with-frankenphp-app=*)
+            FRANKENPHP_APP_PATH="${1#*=}"
+            NEW_ARGS+=("--with-frankenphp-app=/app/app")
+            shift
+            ;;
+        --with-frankenphp-app)
+            if [ -n "${2:-}" ]; then
+                FRANKENPHP_APP_PATH="$2"
+                NEW_ARGS+=("--with-frankenphp-app=/app/app")
+                shift 2
+            else
+                NEW_ARGS+=("$1")
+                shift
+            fi
+            ;;
+        *)
+            NEW_ARGS+=("$1")
+            shift
+            ;;
+    esac
+done
+
+# Normalize the path and add mount if provided
+if [ -n "$FRANKENPHP_APP_PATH" ]; then
+    # expand ~ to $HOME
+    if [ "${FRANKENPHP_APP_PATH#~}" != "$FRANKENPHP_APP_PATH" ]; then
+        FRANKENPHP_APP_PATH="$HOME${FRANKENPHP_APP_PATH#~}"
+    fi
+    # make absolute if relative
+    case "$FRANKENPHP_APP_PATH" in
+        /*) ABS_APP_PATH="$FRANKENPHP_APP_PATH" ;;
+        *) ABS_APP_PATH="$(pwd)/$FRANKENPHP_APP_PATH" ;;
+    esac
+    MOUNT_LIST="$MOUNT_LIST -v $ABS_APP_PATH:/app/app"
+fi
+
+# Run docker
+# shellcheck disable=SC2068
+# shellcheck disable=SC2086
+# shellcheck disable=SC2090
+
+if [ "$SPC_DOCKER_DEBUG" = "yes" ]; then
+    echo "* Debug mode enabled, run docker in interactive mode."
+    echo "* You can use 'exit' to exit the docker container."
+    echo "* You can use 'bin/spc' like normal builds."
+    echo "*"
+    echo "*    Mounted directories:"
+    echo "*    ./config:    $(pwd)/config"
+    echo "*    ./src:       $(pwd)/src"
+    echo "*    ./buildroot: $(pwd)/buildroot"
+    echo "*    ./source:    $(pwd)/source"
+    echo "*    ./dist:      $(pwd)/dist"
+    echo "*    ./downloads: $(pwd)/downloads"
+    echo "*    ./pkgroot:   $(pwd)/pkgroot"
+    echo "*"
+    set -ex
+    $DOCKER_EXECUTABLE run $PLATFORM_ARG --privileged --rm -it $INTERACT $ENV_LIST --env-file /tmp/spc-gnu-docker.env $MOUNT_LIST cwcc-spc-gnu-$SPC_USE_ARCH-$SPC_DOCKER_VERSION /bin/bash
+else
+    $DOCKER_EXECUTABLE run $PLATFORM_ARG --rm $INTERACT $ENV_LIST --env-file /tmp/spc-gnu-docker.env $MOUNT_LIST cwcc-spc-gnu-$SPC_USE_ARCH-$SPC_DOCKER_VERSION bin/spc "${NEW_ARGS[@]}"
+fi

bin/spc.ps1

@@ -0,0 +1,12 @@
+$PHP_Exec = ".\runtime\php.exe"
+
+if (-not(Test-Path $PHP_Exec)) {
+    $PHP_Exec = Get-Command php.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Definition
+    if (-not $PHP_Exec) {
+        Write-Host "Error: PHP not found, you need to install PHP on your system or use 'bin/setup-runtime'." -ForegroundColor Red
+        exit 1
+    }
+}
+
+& "$PHP_Exec" ("bin/spc") @args
+exit $LASTEXITCODE

box.json

@@ -0,0 +1,23 @@
+{
+    "alias": "spc-php.phar",
+    "banner": false,
+    "blacklist": [
+        ".github"
+    ],
+    "compression": "GZ",
+    "check-requirements": false,
+    "directories": [
+        "config",
+        "src",
+        "vendor/psr",
+        "vendor/laravel/prompts",
+        "vendor/symfony",
+        "vendor/php-di",
+        "vendor/zhamao"
+    ],
+    "files": [
+        "spc.registry.yml"
+    ],
+    "git-commit-short": "git_commit_short",
+    "output": "spc.phar"
+}

captainhook.json

@@ -3,7 +3,7 @@
         "enabled": true,
         "actions": [
             {
-                "action": "composer analyse"
+                "action": "php vendor/bin/phpstan analyse --memory-limit 300M"
             }
         ]
     },
@@ -11,13 +11,22 @@
         "enabled": true,
         "actions": [
             {
-                "action": "composer cs-fix -- --config=.php-cs-fixer.php --dry-run --diff {$STAGED_FILES|of-type:php}",
+                "action": "php vendor/bin/php-cs-fixer fix --config=.php-cs-fixer.php --dry-run --diff {$STAGED_FILES|of-type:php} --sequential",
                 "conditions": [
                     {
                         "exec": "\\CaptainHook\\App\\Hook\\Condition\\FileStaged\\OfType",
                         "args": ["php"]
                     }
                 ]
+            },
+            {
+                "action": "bin/spc dev:lint-config --check",
+                "conditions": [
+                    {
+                        "exec": "\\CaptainHook\\App\\Hook\\Condition\\FileStaged\\InDirectory",
+                        "args": ["config"]
+                    }
+                ]
             }
         ]
     },

composer.json

@@ -9,44 +9,64 @@
         }
     ],
     "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.4",
+        "ext-mbstring": "*",
+        "ext-zlib": "*",
+        "laravel/prompts": "~0.1",
+        "php-di/php-di": "^7.1",
+        "symfony/console": "^5.4 || ^6 || ^7",
+        "symfony/process": "^7.2",
+        "symfony/yaml": "^7.2",
+        "zhamao/logger": "^1.1.4"
     },
     "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/captainhook-phar": "^5.23",
+        "captainhook/hook-installer": "^1.0",
+        "friendsofphp/php-cs-fixer": "^3.60",
+        "humbug/box": "^4.5.0 || ^4.6.0",
+        "phpstan/phpstan": "^2.1",
+        "phpunit/phpunit": "^10.3 || ^9.5"
     },
     "autoload": {
         "psr-4": {
-            "SPC\\": "src/SPC"
+            "SPC\\": "src/SPC",
+            "StaticPHP\\": "src/StaticPHP",
+            "Package\\": "src/Package"
         },
         "files": [
             "src/globals/defines.php",
             "src/globals/functions.php"
         ]
     },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\StaticPHP\\": "tests/StaticPHP"
+        }
+    },
     "bin": [
         "bin/spc"
     ],
     "scripts": {
         "analyse": "phpstan analyse --memory-limit 300M",
         "cs-fix": "php-cs-fixer fix",
-        "test": "bin/phpunit --no-coverage"
+        "lint-config": "bin/spc dev:lint-config",
+        "test": "vendor/bin/phpunit tests/ --no-coverage",
+        "build:phar": "vendor/bin/box compile"
     },
     "config": {
         "allow-plugins": {
             "phpstan/extension-installer": true,
-            "captainhook/plugin-composer": true
+            "captainhook/hook-installer": true,
+            "captainhook/plugin-composer": true,
+            "captainhook/captainhook-phar": true
         },
         "optimize-autoloader": true,
         "sort-packages": true
-    }
+    },
+    "funding": [
+        {
+            "type": "other",
+            "url": "https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md"
+        }
+    ]
 }

config/artifact/glfw.yml

@@ -0,0 +1,9 @@
+glfw:
+  metadata:
+    license-files:
+      - LICENSE
+    license: MIT
+  source:
+    type: git
+    url: 'https://github.com/mario-deluna/php-glfw'
+    rev: master

config/artifact/musl-wrapper.yml

@@ -0,0 +1,2 @@
+musl-wrapper:
+  source: 'https://musl.libc.org/releases/musl-1.2.5.tar.gz'

config/artifact/ncurses.yml

@@ -0,0 +1,9 @@
+ncurses:
+  binary: hosted
+  metadata:
+    license-files:
+      - COPYING
+  source:
+    type: filelist
+    url: 'https://ftp.gnu.org/pub/gnu/ncurses/'
+    regex: '/href="(?<file>ncurses-(?<version>[^"]+)\.tar\.gz)"/'

config/artifact/php-src.yml

@@ -0,0 +1,11 @@
+php-src:
+  metadata:
+    license-files:
+      - LICENSE
+    license: PHP-3.01
+  source:
+    type: php-release
+    domain: 'https://www.php.net'
+  source-mirror:
+    type: php-release
+    domain: 'https://phpmirror.static-php.dev'

config/env.ini

@@ -0,0 +1,167 @@
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+; static-php-cli (spc) env configuration
+;
+; This file is used to set default env vars for static-php-cli build.
+; As dynamic build process, some of these vars can be overwritten by CLI options.
+; And you can also overwrite these vars by setting them in your shell environment.
+; The value should be changed only if you know what you are doing. Otherwise, please leave them as default.
+;
+; We need to use some pre-defined internal env vars, like `BUILD_ROOT_PATH`, `DOWNLOAD_PATH`, etc.
+; Please note that these vars cannot be defined in this file, they should only be defined before static-php-cli running.
+;
+; Here's a list of env vars, these variables will be defined if not defined:
+;
+;   BUILD_ROOT_PATH:    the root path of the build process. (default: `$(pwd)/buildroot`)
+;   BUILD_INCLUDE_PATH: the path of the include files. (default: `$BUILD_ROOT_PATH/include`)
+;   BUILD_LIB_PATH:     the path of the lib files. (default: `$BUILD_ROOT_PATH/lib`)
+;   BUILD_BIN_PATH:     the path of the bin files. (default: `$BUILD_ROOT_PATH/bin`)
+;   BUILD_MODULES_PATH: the path of the php modules (shared extensions) files. (default: `$BUILD_ROOT_PATH/modules`)
+;   PKG_ROOT_PATH:      the root path of the package files. (default: `$(pwd)/pkgroot/$GNU_ARCH-{darwin|linux|windows}`)
+;   SOURCE_PATH:        the path of the source files. (default: `$(pwd)/source`)
+;   DOWNLOAD_PATH:      the path of the download files. (default: `$(pwd)/downloads`)
+;   PATH:               (*nix only) static-php-cli will add `$BUILD_BIN_PATH` to PATH.
+;   PKG_CONFIG_PATH:    (*nix only) static-php-cli will set `$BUILD_LIB_PATH/pkgconfig` to PKG_CONFIG_PATH.
+;
+; Here's a list of env vars, these variables is defined in SPC and cannot be changed anywhere:
+;
+;   SPC_VERSION:            the version of static-php-cli.
+;   WORKING_DIR:            the working directory of the build process. (default: `$(pwd)`)
+;   ROOT_DIR:               the root directory of static-php-cli. (default: `/path/to/static-php-cli`, when running in phar or micro mode: `phar://path/to/spc.phar`)
+;   CPU_COUNT:              the count of the CPU cores. (default: `$(nproc)`)
+;   SPC_ARCH:               the arch of the current system, for some libraries needed `--host=XXX` args. (default: `$(uname -m)`, e.g. `x86_64`, `aarch64`, `arm64`)
+;   GNU_ARCH:               the GNU arch of the current system. (default: `$(uname -m)`, e.g. `x86_64`, `aarch64`)
+;   MAC_ARCH:               the MAC arch of the current system. (default: `$(uname -m)`, e.g. `x86_64`, `arm64`)
+;   PKG_CONFIG:             (*nix only) static-php-cli will set `$BUILD_BIN_PATH/pkg-config` to PKG_CONFIG.
+;   SPC_DEFAULT_CC:         (*nix only) the default compiler for selected toolchain.
+;   SPC_DEFAULT_CXX:        (*nix only) the default c++ compiler selected toolchain.
+;   SPC_DEFAULT_AR:         (*nix only) the default archiver for selected toolchain.
+;   SPC_DEFAULT_LD:         (*nix only) the default linker for selected toolchain.
+;   SPC_EXTRA_PHP_VARS:     (linux only) the extra vars for building php, used in `configure` and `make` command.
+
+[global]
+; Build concurrency for make -jN, default is CPU_COUNT, this value are used in every libs.
+SPC_CONCURRENCY=${CPU_COUNT}
+; Ignore PHP version check before building some extensions
+SPC_SKIP_PHP_VERSION_CHECK="no"
+; Ignore some check item for bin/spc doctor command, comma separated (e.g. SPC_SKIP_DOCTOR_CHECK_ITEMS="if homebrew has installed")
+SPC_SKIP_DOCTOR_CHECK_ITEMS=""
+; extra modules that xcaddy will include in the FrankenPHP build
+SPC_CMD_VAR_FRANKENPHP_XCADDY_MODULES="--with github.com/dunglas/mercure/caddy --with github.com/dunglas/vulcain/caddy --with github.com/dunglas/caddy-cbrotli"
+; The display message for php version output (PHP >= 8.4 available)
+PHP_BUILD_PROVIDER="StaticPHP ${SPC_VERSION}"
+; Whether to enable log file (if you are using vendor mode)
+SPC_ENABLE_LOG_FILE="yes"
+; The LOG DIR for spc logs
+SPC_LOGS_DIR="${WORKING_DIR}/log"
+; Preserve old logs when running new builds
+SPC_PRESERVE_LOGS="no"
+
+; EXTENSION_DIR where the built php will look for extension when a .ini instructs to load them
+; only useful for builds targeting not pure-static linking
+; default paths
+; Ubuntu/Debian: /usr/lib/php/{PHP_VERSION}/
+; RHEL: /usr/lib64/php/modules
+; Alpine: /usr/lib/php{PHP_VERSION}/modules
+; where {PHP_VERSION} is 84 for php 8.4
+; EXTENSION_DIR=
+
+[windows]
+; build target: win7-static
+SPC_TARGET=native-windows
+; php-sdk-binary-tools path
+PHP_SDK_PATH="${WORKING_DIR}\php-sdk-binary-tools"
+; upx executable path
+UPX_EXEC="${PKG_ROOT_PATH}\bin\upx.exe"
+; phpmicro patches, for more info, see: https://github.com/easysoft/phpmicro/tree/master/patches
+SPC_MICRO_PATCHES=static_extensions_win32,cli_checks,disable_huge_page,vcruntime140,win32,zend_stream,cli_static,win32_api
+
+[linux]
+; Linux can use different build toolchains.
+; - musl (default, when SPC_LIBC=musl): used for general linux distros, can build `musl` (statically linked) only.
+; - zig (will become default): usable on all Linux distros, can build `-musl`, `arch-linux-musl -dynamic` and `arch-linux-gnu` targets. Can specify version such as `x86_64-linux-gnu.2.17`.
+; - musl-native: used for alpine linux, can build `musl` and `musl -dynamic` target.
+; - gnu-native: used for general linux distros, can build gnu target for the installed glibc version only.
+
+; option to specify the target, superceded by SPC_TARGET if set
+; SPC_LIBC=musl
+; uncomment to link libc dynamically on musl
+; SPC_MUSL_DYNAMIC=true
+
+; Recommended: specify your target here. Zig toolchain will be used.
+; examples:
+; `native-native-gnu`           - links against glibc, current OS version
+; `native-native-gnu.2.17`      - links against glibc, version 2.17
+; `native-native`               - links against system libc dynamically
+; `native-native-musl`          - links against musl libc statically
+; `native-native-musl -dynamic` - links against musl libc dynamically
+SPC_TARGET=native-native-musl
+
+; compiler environments (default value is defined by selected toolchain)
+CC=${SPC_DEFAULT_CC}
+CXX=${SPC_DEFAULT_CXX}
+AR=${SPC_DEFAULT_AR}
+LD=${SPC_DEFAULT_LD}
+; default compiler flags, used in CMake toolchain file, openssl and pkg-config build
+SPC_DEFAULT_C_FLAGS="-fPIC -Os"
+SPC_DEFAULT_CXX_FLAGS="-fPIC -Os"
+SPC_DEFAULT_LD_FLAGS=""
+; upx executable path
+UPX_EXEC=${PKG_ROOT_PATH}/bin/upx
+; phpmicro patches, for more info, see: https://github.com/easysoft/phpmicro/tree/master/patches
+SPC_MICRO_PATCHES=cli_checks,disable_huge_page
+
+; *** default build command for building php ***
+; buildconf command
+SPC_CMD_PREFIX_PHP_BUILDCONF="./buildconf --force"
+; configure command
+SPC_CMD_PREFIX_PHP_CONFIGURE="./configure --prefix= --with-valgrind=no --disable-shared --enable-static --disable-all --disable-phpdbg --with-pic"
+
+; *** default build vars for building php ***
+; embed type for php, static (libphp.a) or shared (libphp.so)
+SPC_CMD_VAR_PHP_EMBED_TYPE="static"
+; EXTRA_CFLAGS for `configure` and `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS="-g -fstack-protector-strong -fno-ident -fPIE ${SPC_DEFAULT_C_FLAGS}"
+; EXTRA_CXXFLAGS for `configure` and `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_CXXFLAGS="-g -fstack-protector-strong -fno-ident -fPIE ${SPC_DEFAULT_CXX_FLAGS}"
+; EXTRA_LDFLAGS for `make` php, can use -release to set a soname for libphp.so
+SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS=""
+
+; optional, path to openssl conf. This affects where openssl will look for the default CA.
+; default on Debian/Alpine: /etc/ssl, default on RHEL: /etc/pki/tls
+OPENSSLDIR=""
+
+[macos]
+; build target: macho or macho (possibly we could support macho-universal in the future)
+; Currently we do not support universal and cross-compilation for macOS.
+SPC_TARGET=native-macos
+; Whether to use brew version of llvm or system version (valid options: 'system', 'brew', default: 'system')
+SPC_USE_LLVM=system
+; compiler environments (default value is defined by selected toolchain)
+CC=${SPC_DEFAULT_CC}
+CXX=${SPC_DEFAULT_CXX}
+AR=${SPC_DEFAULT_AR}
+LD=${SPC_DEFAULT_LD}
+; default compiler flags, used in CMake toolchain file, openssl and pkg-config build
+SPC_DEFAULT_C_FLAGS="--target=${MAC_ARCH}-apple-darwin -Os"
+SPC_DEFAULT_CXX_FLAGS="--target=${MAC_ARCH}-apple-darwin -Os"
+SPC_DEFAULT_LD_FLAGS=""
+; phpmicro patches, for more info, see: https://github.com/easysoft/phpmicro/tree/master/patches
+SPC_MICRO_PATCHES=cli_checks,macos_iconv
+
+; *** default build command for building php ***
+; buildconf command
+SPC_CMD_PREFIX_PHP_BUILDCONF="./buildconf --force"
+; configure command
+SPC_CMD_PREFIX_PHP_CONFIGURE="./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-phpdbg"
+
+; *** default build vars for building php ***
+; embed type for php, static (libphp.a) or shared (libphp.dylib)
+SPC_CMD_VAR_PHP_EMBED_TYPE="static"
+; EXTRA_CFLAGS for `configure` and `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_CFLAGS="-g -fstack-protector-strong -fpic -fpie -Werror=unknown-warning-option ${SPC_DEFAULT_C_FLAGS}"
+; EXTRA_CXXFLAGS for `configure` and `make` php
+SPC_CMD_VAR_PHP_MAKE_EXTRA_CXXFLAGS="-g -fstack-protector-strong -fno-ident -fpie -Werror=unknown-warning-option ${SPC_DEFAULT_CXX_FLAGS}"
+; EXTRA_LDFLAGS for `make` php, can use -release to set a soname for libphp.dylib
+SPC_CMD_VAR_PHP_MAKE_EXTRA_LDFLAGS=""
+; minimum compatible macOS version (LLVM vars, availability not guaranteed)
+MACOSX_DEPLOYMENT_TARGET=12.0

config/pkg.lib.json

@@ -0,0 +1,992 @@
+{
+    "attr": {
+        "artifact": "attr",
+        "license": {
+            "type": "file",
+            "path": "doc/COPYING.LGPL"
+        },
+        "type": "library"
+    },
+    "brotli": {
+        "artifact": "brotli",
+        "headers": [
+            "brotli"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "libbrotlicommon",
+            "libbrotlidec",
+            "libbrotlienc"
+        ],
+        "type": "library"
+    },
+    "bzip2": {
+        "artifact": "bzip2",
+        "headers": [
+            "bzlib.h"
+        ],
+        "license": {
+            "type": "text",
+            "text": "This program, \"bzip2\", the associated library \"libbzip2\", and all documentation, are copyright (C) 1996-2010 Julian R Seward. All rights reserved. \n\nRedistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:\n\n    1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.\n    2. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.\n    3. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.\n    4. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission.\n\nTHIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n\nJulian Seward, jseward@bzip.org bzip2/libbzip2 version 1.0.6 of 6 September 2010\n\nPATENTS: To the best of my knowledge, bzip2 and libbzip2 do not use any patented algorithms. However, I do not have the resources to carry out a patent search. Therefore I cannot give any guarantee of the above statement."
+        },
+        "type": "library"
+    },
+    "curl": {
+        "artifact": "curl",
+        "depends": [
+            "openssl",
+            "zlib"
+        ],
+        "depends@windows": [
+            "zlib",
+            "libssh2",
+            "nghttp2"
+        ],
+        "frameworks": [
+            "CoreFoundation",
+            "CoreServices",
+            "SystemConfiguration"
+        ],
+        "headers": [
+            "curl"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "suggests": [
+            "libssh2",
+            "brotli",
+            "nghttp2",
+            "nghttp3",
+            "ngtcp2",
+            "zstd",
+            "libcares",
+            "ldap"
+        ],
+        "suggests@windows": [
+            "brotli",
+            "zstd"
+        ],
+        "type": "library"
+    },
+    "fastlz": {
+        "artifact": "fastlz",
+        "headers": [
+            "fastlz/fastlz.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE.MIT"
+        },
+        "type": "library"
+    },
+    "freetype": {
+        "artifact": "freetype",
+        "depends": [
+            "zlib"
+        ],
+        "headers": [
+            "freetype2/freetype/freetype.h",
+            "freetype2/ft2build.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE.TXT"
+        },
+        "suggests": [
+            "libpng",
+            "bzip2",
+            "brotli"
+        ],
+        "type": "library"
+    },
+    "gettext": {
+        "artifact": "gettext",
+        "depends": [
+            "libiconv"
+        ],
+        "frameworks": [
+            "CoreFoundation"
+        ],
+        "license": {
+            "type": "file",
+            "path": "gettext-runtime/intl/COPYING.LIB"
+        },
+        "suggests": [
+            "ncurses",
+            "libxml2"
+        ],
+        "type": "library"
+    },
+    "glfw": {
+        "artifact": "ext-glfw",
+        "frameworks": [
+            "CoreVideo",
+            "OpenGL",
+            "Cocoa",
+            "IOKit"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "gmp": {
+        "artifact": "gmp",
+        "headers": [
+            "gmp.h"
+        ],
+        "license": {
+            "type": "text",
+            "text": "Since version 6, GMP is distributed under the dual licenses, GNU LGPL v3 and GNU GPL v2. These licenses make the library free to use, share, and improve, and allow you to pass on the result. The GNU licenses give freedoms, but also set firm restrictions on the use with non-free programs."
+        },
+        "type": "library"
+    },
+    "gmssl": {
+        "artifact": "gmssl",
+        "frameworks": [
+            "Security"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "grpc": {
+        "artifact": "grpc",
+        "depends": [
+            "zlib",
+            "openssl",
+            "libcares"
+        ],
+        "frameworks": [
+            "CoreFoundation"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "grpc"
+        ],
+        "type": "library"
+    },
+    "icu": {
+        "artifact": "icu",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "icu-uc",
+            "icu-i18n",
+            "icu-io"
+        ],
+        "type": "library"
+    },
+    "icu-static-win": {
+        "artifact": "icu-static-win",
+        "headers@windows": [
+            "unicode"
+        ],
+        "license": {
+            "type": "text",
+            "text": "none"
+        },
+        "type": "library"
+    },
+    "imagemagick": {
+        "artifact": "imagemagick",
+        "depends": [
+            "zlib",
+            "libjpeg",
+            "libjxl",
+            "libpng",
+            "libwebp",
+            "freetype",
+            "libtiff",
+            "libheif",
+            "bzip2"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "Magick++-7.Q16HDRI",
+            "MagickCore-7.Q16HDRI",
+            "MagickWand-7.Q16HDRI"
+        ],
+        "suggests": [
+            "zstd",
+            "xz",
+            "libzip",
+            "libxml2"
+        ],
+        "type": "library"
+    },
+    "imap": {
+        "artifact": "imap",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "suggests": [
+            "openssl"
+        ],
+        "type": "library"
+    },
+    "jbig": {
+        "artifact": "jbig",
+        "headers": [
+            "jbig.h",
+            "jbig85.h",
+            "jbig_ar.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "ldap": {
+        "artifact": "ldap",
+        "depends": [
+            "openssl",
+            "zlib",
+            "gmp",
+            "libsodium"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "ldap",
+            "lber"
+        ],
+        "type": "library"
+    },
+    "lerc": {
+        "artifact": "lerc",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libacl": {
+        "artifact": "libacl",
+        "depends": [
+            "attr"
+        ],
+        "license": {
+            "type": "file",
+            "path": "doc/COPYING.LGPL"
+        },
+        "type": "library"
+    },
+    "libaom": {
+        "artifact": "libaom",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libargon2": {
+        "artifact": "libargon2",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libavif": {
+        "artifact": "libavif",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libcares": {
+        "artifact": "libcares",
+        "headers": [
+            "ares.h",
+            "ares_dns.h",
+            "ares_nameser.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE.md"
+        },
+        "type": "library"
+    },
+    "libde265": {
+        "artifact": "libde265",
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "libedit": {
+        "artifact": "libedit",
+        "depends": [
+            "ncurses"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "libevent": {
+        "artifact": "libevent",
+        "depends": [
+            "openssl"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libffi": {
+        "artifact": "libffi",
+        "headers": [
+            "ffi.h",
+            "ffitarget.h"
+        ],
+        "headers@windows": [
+            "ffi.h",
+            "fficonfig.h",
+            "ffitarget.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libffi-win": {
+        "artifact": "libffi-win",
+        "headers@windows": [
+            "ffi.h",
+            "ffitarget.h",
+            "fficonfig.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libheif": {
+        "artifact": "libheif",
+        "depends": [
+            "libde265",
+            "libwebp",
+            "libaom",
+            "zlib",
+            "brotli"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "libiconv": {
+        "artifact": "libiconv",
+        "headers": [
+            "iconv.h",
+            "libcharset.h",
+            "localcharset.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING.LIB"
+        },
+        "type": "library"
+    },
+    "libiconv-win": {
+        "artifact": "libiconv-win",
+        "license": {
+            "type": "file",
+            "path": "source/COPYING"
+        },
+        "type": "library"
+    },
+    "libjpeg": {
+        "artifact": "libjpeg",
+        "license": {
+            "type": "file",
+            "path": "LICENSE.md"
+        },
+        "suggests@windows": [
+            "zlib"
+        ],
+        "type": "library"
+    },
+    "libjxl": {
+        "artifact": "libjxl",
+        "depends": [
+            "brotli",
+            "libjpeg",
+            "libpng",
+            "libwebp"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "libjxl",
+            "libjxl_cms",
+            "libjxl_threads",
+            "libhwy"
+        ],
+        "type": "library"
+    },
+    "liblz4": {
+        "artifact": "liblz4",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libmemcached": {
+        "artifact": "libmemcached",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libpng": {
+        "artifact": "libpng",
+        "depends": [
+            "zlib"
+        ],
+        "headers": [
+            "png.h",
+            "pngconf.h",
+            "pnglibconf.h"
+        ],
+        "headers@windows": [
+            "png.h",
+            "pngconf.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "librabbitmq": {
+        "artifact": "librabbitmq",
+        "depends": [
+            "openssl"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "librdkafka": {
+        "artifact": "librdkafka",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "pkg-configs": [
+            "rdkafka++-static",
+            "rdkafka-static"
+        ],
+        "suggests": [
+            "curl",
+            "liblz4",
+            "openssl",
+            "zlib",
+            "zstd"
+        ],
+        "type": "library"
+    },
+    "libsodium": {
+        "artifact": "libsodium",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "libssh2": {
+        "artifact": "libssh2",
+        "depends": [
+            "openssl"
+        ],
+        "headers": [
+            "libssh2.h",
+            "libssh2_publickey.h",
+            "libssh2_sftp.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "libtiff": {
+        "artifact": "libtiff",
+        "depends": [
+            "zlib",
+            "libjpeg"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE.md"
+        },
+        "suggests": [
+            "lerc",
+            "libwebp",
+            "jbig",
+            "xz",
+            "zstd"
+        ],
+        "type": "library"
+    },
+    "liburing": {
+        "artifact": "liburing",
+        "headers@linux": [
+            "liburing/",
+            "liburing.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "pkg-configs": [
+            "liburing",
+            "liburing-ffi"
+        ],
+        "type": "library"
+    },
+    "libuuid": {
+        "artifact": "libuuid",
+        "headers": [
+            "uuid/uuid.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "libuv": {
+        "artifact": "libuv",
+        "license": [
+            {
+                "type": "file",
+                "path": "LICENSE"
+            },
+            {
+                "type": "file",
+                "path": "LICENSE-extra"
+            }
+        ],
+        "type": "library"
+    },
+    "libwebp": {
+        "artifact": "libwebp",
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "pkg-configs": [
+            "libwebp",
+            "libwebpdecoder",
+            "libwebpdemux",
+            "libwebpmux",
+            "libsharpyuv"
+        ],
+        "type": "library"
+    },
+    "libxml2": {
+        "artifact": "libxml2",
+        "depends": [
+            "libiconv"
+        ],
+        "depends@windows": [
+            "libiconv-win"
+        ],
+        "headers": [
+            "libxml2"
+        ],
+        "license": {
+            "type": "file",
+            "path": "Copyright"
+        },
+        "pkg-configs": [
+            "libxml-2.0"
+        ],
+        "suggests": [
+            "xz",
+            "zlib"
+        ],
+        "suggests@windows": [
+            "zlib"
+        ],
+        "type": "library"
+    },
+    "libxslt": {
+        "artifact": "libxslt",
+        "depends": [
+            "libxml2"
+        ],
+        "license": {
+            "type": "file",
+            "path": "Copyright"
+        },
+        "type": "library"
+    },
+    "libyaml": {
+        "artifact": "libyaml",
+        "headers": [
+            "yaml.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "License"
+        },
+        "type": "library"
+    },
+    "libzip": {
+        "artifact": "libzip",
+        "depends": [
+            "zlib"
+        ],
+        "depends@windows": [
+            "zlib",
+            "bzip2",
+            "xz"
+        ],
+        "headers": [
+            "zip.h",
+            "zipconf.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "suggests": [
+            "bzip2",
+            "xz",
+            "zstd",
+            "openssl"
+        ],
+        "suggests@windows": [
+            "zstd",
+            "openssl"
+        ],
+        "type": "library"
+    },
+    "mimalloc": {
+        "artifact": "mimalloc",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "ncurses": {
+        "artifact": "ncurses",
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "static-libs@unix": [
+            "libncurses.a"
+        ],
+        "type": "library"
+    },
+    "net-snmp": {
+        "artifact": "net-snmp",
+        "depends": [
+            "openssl",
+            "zlib"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "pkg-configs": [
+            "netsnmp",
+            "netsnmp-agent"
+        ],
+        "type": "library"
+    },
+    "nghttp2": {
+        "artifact": "nghttp2",
+        "depends": [
+            "zlib",
+            "openssl"
+        ],
+        "headers": [
+            "nghttp2"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "suggests": [
+            "libxml2",
+            "nghttp3",
+            "ngtcp2"
+        ],
+        "type": "library"
+    },
+    "nghttp3": {
+        "artifact": "nghttp3",
+        "depends": [
+            "openssl"
+        ],
+        "headers": [
+            "nghttp3"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "ngtcp2": {
+        "artifact": "ngtcp2",
+        "depends": [
+            "openssl"
+        ],
+        "headers": [
+            "ngtcp2"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "suggests": [
+            "nghttp3",
+            "brotli"
+        ],
+        "type": "library"
+    },
+    "onig": {
+        "artifact": "onig",
+        "headers": [
+            "oniggnu.h",
+            "oniguruma.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "openssl": {
+        "artifact": "openssl",
+        "depends": [
+            "zlib"
+        ],
+        "headers": [
+            "openssl"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE.txt"
+        },
+        "type": "library"
+    },
+    "postgresql": {
+        "artifact": "postgresql",
+        "depends": [
+            "libiconv",
+            "libxml2",
+            "openssl",
+            "zlib",
+            "libedit"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYRIGHT"
+        },
+        "pkg-configs": [
+            "libpq"
+        ],
+        "suggests": [
+            "icu",
+            "libxslt",
+            "ldap",
+            "zstd"
+        ],
+        "type": "library"
+    },
+    "postgresql-win": {
+        "artifact": "postgresql-win",
+        "license": {
+            "type": "text",
+            "text": "PostgreSQL Database Management System\n(also known as Postgres, formerly as Postgres95)\n\nPortions Copyright (c) 1996-2025, The PostgreSQL Global Development Group\n\nPortions Copyright (c) 1994, The Regents of the University of California\n\nPermission to use, copy, modify, and distribute this software and its\ndocumentation for any purpose, without fee, and without a written\nagreement is hereby granted, provided that the above copyright notice\nand this paragraph and the following two paragraphs appear in all\ncopies.\n\nIN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY\nFOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,\nINCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS\nDOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF\nTHE POSSIBILITY OF SUCH DAMAGE.\n\nTHE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,\nINCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY\nAND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS\nON AN \"AS IS\" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS\nTO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS."
+        },
+        "type": "library"
+    },
+    "pthreads4w": {
+        "artifact": "pthreads4w",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "qdbm": {
+        "artifact": "qdbm",
+        "headers@windows": [
+            "depot.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "re2c": {
+        "artifact": "re2c",
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    },
+    "readline": {
+        "artifact": "readline",
+        "depends": [
+            "ncurses"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "snappy": {
+        "artifact": "snappy",
+        "depends": [
+            "zlib"
+        ],
+        "headers": [
+            "snappy.h",
+            "snappy-c.h",
+            "snappy-sinksource.h",
+            "snappy-stubs-public.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "sqlite": {
+        "artifact": "sqlite",
+        "headers": [
+            "sqlite3.h",
+            "sqlite3ext.h"
+        ],
+        "license": {
+            "type": "text",
+            "text": "The author disclaims copyright to this source code.  In place of\na legal notice, here is a blessing:\n\n  *   May you do good and not evil.\n  *   May you find forgiveness for yourself and forgive others.\n  *   May you share freely, never taking more than you give."
+        },
+        "type": "library"
+    },
+    "tidy": {
+        "artifact": "tidy",
+        "license": {
+            "type": "file",
+            "path": "README/LICENSE.md"
+        },
+        "type": "library"
+    },
+    "unixodbc": {
+        "artifact": "unixodbc",
+        "depends": [
+            "libiconv"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "watcher": {
+        "artifact": "watcher",
+        "headers": [
+            "wtr/watcher-c.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "license"
+        },
+        "type": "library"
+    },
+    "xz": {
+        "artifact": "xz",
+        "depends": [
+            "libiconv"
+        ],
+        "headers": [
+            "lzma"
+        ],
+        "headers@windows": [
+            "lzma",
+            "lzma.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "COPYING"
+        },
+        "type": "library"
+    },
+    "zlib": {
+        "artifact": "zlib",
+        "headers": [
+            "zlib.h",
+            "zconf.h"
+        ],
+        "license": {
+            "type": "text",
+            "text": "(C) 1995-2022 Jean-loup Gailly and Mark Adler\n\nThis software is provided 'as-is', without any express or implied\nwarranty.  In no event will the authors be held liable for any damages\narising from the use of this software.\n\nPermission is granted to anyone to use this software for any purpose,\nincluding commercial applications, and to alter it and redistribute it\nfreely, subject to the following restrictions:\n\n1. The origin of this software must not be misrepresented; you must not\n claim that you wrote the original software. If you use this software\n in a product, an acknowledgment in the product documentation would be\n appreciated but is not required.\n2. Altered source versions must be plainly marked as such, and must not be\n misrepresented as being the original software.\n3. This notice may not be removed or altered from any source distribution.\n\nJean-loup Gailly        Mark Adler\njloup@gzip.org          madler@alumni.caltech.edu"
+        },
+        "type": "library"
+    },
+    "zstd": {
+        "artifact": "zstd",
+        "headers": [
+            "zdict.h",
+            "zstd.h",
+            "zstd_errors.h"
+        ],
+        "headers@windows": [
+            "zstd.h",
+            "zstd_errors.h"
+        ],
+        "license": {
+            "type": "file",
+            "path": "LICENSE"
+        },
+        "type": "library"
+    }
+}

config/pkg/ext/builtin-extensions.yml

@@ -0,0 +1,348 @@
+ext-bcmath:
+  type: php-extension
+ext-bz2:
+  type: php-extension
+  depends:
+    - bzip2
+  php-extension:
+    arg-type@unix: with-path
+    arg-type@windows: with
+ext-calendar:
+  type: php-extension
+ext-ctype:
+  type: php-extension
+ext-curl:
+  type: php-extension
+  depends:
+    - curl
+  depends@windows:
+    - curl
+    - ext-zlib
+    - ext-openssl
+  php-extension:
+    arg-type: with
+ext-dba:
+  type: php-extension
+  suggests:
+    - qdbm
+  php-extension:
+    arg-type: custom
+ext-dom:
+  type: php-extension
+  depends:
+    - libxml2
+    - ext-xml
+  php-extension:
+    arg-type: '--enable-dom@shared_suffix@ --with-libxml=@build_root_path@'
+    arg-type@windows: with
+ext-exif:
+  type: php-extension
+ext-ffi:
+  type: php-extension
+  depends@unix:
+    - libffi
+  php-extension:
+    arg-type@unix: '--with-ffi=@shared_suffix@ --enable-zend-signals'
+    arg-type@windows: with
+ext-fileinfo:
+  type: php-extension
+ext-filter:
+  type: php-extension
+ext-ftp:
+  type: php-extension
+  suggests:
+    - ext-openssl
+ext-gd:
+  type: php-extension
+  depends:
+    - zlib
+    - libpng
+    - ext-zlib
+  suggests:
+    - libavif
+    - libwebp
+    - libjpeg
+    - freetype
+  php-extension:
+    arg-type: custom
+ext-gettext:
+  type: php-extension
+  depends:
+    - gettext
+  php-extension:
+    arg-type: with-path
+ext-gmp:
+  type: php-extension
+  depends:
+    - gmp
+  php-extension:
+    arg-type: with-path
+ext-iconv:
+  type: php-extension
+  depends@unix:
+    - libiconv
+  php-extension:
+    arg-type@unix: with-path
+    arg-type@windows: with
+ext-intl:
+  type: php-extension
+  depends@unix:
+    - icu
+ext-ldap:
+  type: php-extension
+  depends:
+    - ldap
+  suggests:
+    - gmp
+    - libsodium
+    - ext-openssl
+  php-extension:
+    arg-type: with-path
+ext-libxml:
+  type: php-extension
+  depends:
+    - ext-xml
+  php-extension:
+    build-with-php: true
+    build-shared: false
+    arg-type: none
+ext-mbregex:
+  type: php-extension
+  depends:
+    - onig
+    - ext-mbstring
+  php-extension:
+    arg-type: custom
+    build-shared: false
+    build-static: true
+    display-name: mbstring
+ext-mbstring:
+  type: php-extension
+  php-extension:
+    arg-type: custom
+ext-mysqli:
+  type: php-extension
+  depends:
+    - ext-mysqlnd
+  php-extension:
+    arg-type: with
+    build-with-php: true
+ext-mysqlnd:
+  type: php-extension
+  depends:
+    - zlib
+  php-extension:
+    arg-type@unix: enable
+    arg-type@windows: with
+    build-with-php: true
+ext-odbc:
+  type: php-extension
+  depends@unix:
+    - unixodbc
+  php-extension:
+    arg-type@unix: '--with-unixODBC@shared_path_suffix@'
+ext-opcache:
+  type: php-extension
+  php-extension:
+    arg-type@unix: custom
+    arg-type@windows: enable
+    zend-extension: true
+    display-name: 'Zend Opcache'
+ext-openssl:
+  type: php-extension
+  depends:
+    - openssl
+    - zlib
+    - ext-zlib
+  php-extension:
+    arg-type: custom
+    arg-type@windows: with
+    build-with-php: true
+ext-password-argon2:
+  type: php-extension
+  depends:
+    - libargon2
+    - ext-openssl
+  php-extension:
+    arg-type: custom
+    display-name: ''
+ext-pcntl:
+  type: php-extension
+ext-pdo:
+  type: php-extension
+ext-pdo_mysql:
+  type: php-extension
+  depends:
+    - ext-pdo
+    - ext-mysqlnd
+  php-extension:
+    arg-type: with
+ext-pdo_odbc:
+  type: php-extension
+  depends:
+    - ext-pdo
+    - ext-odbc
+  depends@unix:
+    - unixodbc
+    - ext-pdo
+    - ext-odbc
+  php-extension:
+    arg-type: custom
+ext-pdo_pgsql:
+  type: php-extension
+  depends@unix:
+    - ext-pdo
+    - ext-pgsql
+    - postgresql
+  php-extension:
+    arg-type@unix: with-path
+    arg-type@windows: '--with-pdo-pgsql=yes'
+ext-pdo_sqlite:
+  type: php-extension
+  depends:
+    - ext-pdo
+    - ext-sqlite3
+    - sqlite
+  php-extension:
+    arg-type: with
+ext-pgsql:
+  type: php-extension
+  depends@unix:
+    - postgresql
+  php-extension:
+    arg-type: custom
+ext-phar:
+  type: php-extension
+  depends:
+    - zlib
+ext-posix:
+  type: php-extension
+ext-readline:
+  type: php-extension
+  depends:
+    - libedit
+  php-extension:
+    support:
+      Windows: wip
+      BSD: wip
+    arg-type: '--with-libedit --without-readline'
+    build-shared: false
+    build-static: true
+ext-session:
+  type: php-extension
+ext-shmop:
+  type: php-extension
+  php-extension:
+    build-with-php: true
+ext-simplexml:
+  type: php-extension
+  depends:
+    - ext-xml
+  php-extension:
+    arg-type@unix: '--enable-simplexml@shared_suffix@ --with-libxml=@build_root_path@'
+    arg-type@windows: with
+    build-with-php: true
+ext-snmp:
+  type: php-extension
+  depends:
+    - net-snmp
+  php-extension:
+    arg-type: with
+ext-soap:
+  type: php-extension
+  depends:
+    - ext-xml
+    - ext-session
+  php-extension:
+    arg-type@unix: '--enable-soap@shared_suffix@ --with-libxml=@build_root_path@'
+    arg-type@windows: with
+    build-with-php: true
+ext-sockets:
+  type: php-extension
+ext-sodium:
+  type: php-extension
+  depends:
+    - libsodium
+  php-extension:
+    arg-type: with
+ext-sqlite3:
+  type: php-extension
+  depends:
+    - sqlite
+  php-extension:
+    arg-type@unix: with-path
+    arg-type@windows: with
+    build-with-php: true
+ext-sysvmsg:
+  type: php-extension
+  php-extension:
+    support:
+      Windows: 'no'
+      BSD: wip
+ext-sysvsem:
+  type: php-extension
+  php-extension:
+    support:
+      Windows: 'no'
+      BSD: wip
+ext-sysvshm:
+  type: php-extension
+  php-extension:
+    support:
+      BSD: wip
+ext-tidy:
+  type: php-extension
+  depends:
+    - tidy
+  php-extension:
+    support:
+      Windows: wip
+      BSD: wip
+    arg-type: with-path
+ext-tokenizer:
+  type: php-extension
+  php-extension:
+    build-with-php: true
+ext-xml:
+  type: php-extension
+  depends:
+    - libxml2
+  depends@windows:
+    - libxml2
+    - ext-iconv
+  php-extension:
+    arg-type: '--enable-xml@shared_suffix@ --with-libxml=@build_root_path@'
+    arg-type@windows: with
+    build-with-php: true
+ext-xmlreader:
+  type: php-extension
+  depends:
+    - libxml2
+  php-extension:
+    arg-type: '--enable-xmlreader@shared_suffix@ --with-libxml=@build_root_path@'
+    build-with-php: true
+ext-xmlwriter:
+  type: php-extension
+  depends:
+    - libxml2
+  php-extension:
+    arg-type: '--enable-xmlwriter@shared_suffix@ --with-libxml=@build_root_path@'
+    build-with-php: true
+ext-xsl:
+  type: php-extension
+  depends:
+    - libxslt
+    - ext-xml
+    - ext-dom
+  php-extension:
+    arg-type: with-path
+    build-with-php: true
+ext-zlib:
+  type: php-extension
+  depends:
+    - zlib
+  php-extension:
+    arg-type: custom
+    arg-type@windows: enable
+    build-with-php: true
+    build-shared: false

config/pkg/ext/ext-amqp.yml

@@ -0,0 +1,17 @@
+ext-amqp:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: amqp
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - librabbitmq
+  depends@windows:
+    - librabbitmq
+    - ext-openssl
+  php-extension:
+    arg-type: '--with-amqp@shared_suffix@ --with-librabbitmq-dir=@build_root_path@'
+    arg-type@windows: '--with-amqp'

config/pkg/ext/ext-apcu.yml

@@ -0,0 +1,9 @@
+ext-apcu:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: APCu
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01

config/pkg/ext/ext-ast.yml

@@ -0,0 +1,9 @@
+ext-ast:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: ast
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-3-Clause

config/pkg/ext/ext-brotli.yml

@@ -0,0 +1,13 @@
+ext-brotli:
+  type: php-extension
+  artifact:
+    source:
+      type: git
+      extract: php-src/ext/brotli
+      rev: master
+      url: 'https://github.com/kjdev/php-ext-brotli'
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends:
+    - brotli

config/pkg/ext/ext-dio.yml

@@ -0,0 +1,9 @@
+ext-dio:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: dio
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01

config/pkg/ext/ext-ds.yml

@@ -0,0 +1,9 @@
+ext-ds:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: ds
+    metadata:
+      license-files: [LICENSE]
+      license: MIT

config/pkg/ext/ext-ev.yml

@@ -0,0 +1,13 @@
+ext-ev:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: ev
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - ext-sockets
+  php-extension:
+    arg-type@windows: with

config/pkg/ext/ext-event.yml

@@ -0,0 +1,19 @@
+ext-event:
+  type: php-extension
+  artifact:
+    source:
+      type: url
+      url: 'https://bitbucket.org/osmanov/pecl-event/get/3.1.4.tar.gz'
+      extract: php-src/ext/event
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - libevent
+    - ext-openssl
+  suggests:
+    - ext-sockets
+  php-extension:
+    support:
+      Windows: wip
+    arg-type: custom

config/pkg/ext/ext-excimer.yml

@@ -0,0 +1,9 @@
+ext-excimer:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: excimer
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01

config/pkg/ext/ext-glfw.yml

@@ -0,0 +1,7 @@
+ext-glfw:
+  type: php-extension
+  artifact: glfw
+  depends:
+    - glfw
+  php-extension:
+    arg-type@unix: '--enable-glfw --with-glfw-dir=@build_root_path@'

config/pkg/ext/ext-gmssl.yml

@@ -0,0 +1,12 @@
+ext-gmssl:
+  type: php-extension
+  artifact:
+    source:
+      type: ghtar
+      repo: gmssl/GmSSL-PHP
+      extract: php-src/ext/gmssl
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - gmssl

config/pkg/ext/ext-grpc.yml

@@ -0,0 +1,14 @@
+ext-grpc:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: grpc
+    metadata:
+      license-files: [LICENSE]
+      license: Apache-2.0
+  depends:
+    - grpc
+  lang: cpp
+  php-extension:
+    arg-type@unix: enable-path

config/pkg/ext/ext-igbinary.yml

@@ -0,0 +1,12 @@
+ext-igbinary:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: igbinary
+    metadata:
+      license-files: [COPYING]
+      license: BSD-3-Clause
+  suggests:
+    - ext-session
+    - ext-apcu

config/pkg/ext/ext-imagick.yml

@@ -0,0 +1,13 @@
+ext-imagick:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: imagick
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - imagemagick
+  php-extension:
+    arg-type: custom

config/pkg/ext/ext-imap.yml

@@ -0,0 +1,15 @@
+ext-imap:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: imap
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - imap
+  suggests:
+    - ext-openssl
+  php-extension:
+    arg-type: custom

config/pkg/ext/ext-inotify.yml

@@ -0,0 +1,9 @@
+ext-inotify:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: inotify
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01

config/pkg/ext/ext-lz4.yml

@@ -0,0 +1,15 @@
+ext-lz4:
+  type: php-extension
+  artifact:
+    source:
+      type: ghtagtar
+      repo: kjdev/php-ext-lz4
+      extract: php-src/ext/lz4
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends:
+    - liblz4
+  php-extension:
+    arg-type@unix: '--enable-lz4=@shared_suffix@ --with-lz4-includedir=@build_root_path@'
+    arg-type@windows: '--enable-lz4'

config/pkg/ext/ext-maxminddb.yml

@@ -0,0 +1,13 @@
+ext-maxminddb:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: maxminddb
+    metadata:
+      license-files: [LICENSE]
+      license: Apache-2.0
+  depends:
+    - libmaxminddb
+  php-extension:
+    arg-type: with

config/pkg/ext/ext-memcache.yml

@@ -0,0 +1,14 @@
+ext-memcache:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: memcache
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.0
+  depends:
+    - ext-zlib
+    - ext-session
+  php-extension:
+    arg-type: '--enable-memcache@shared_suffix@ --with-zlib-dir=@build_root_path@'

config/pkg/ext/ext-memcached.yml

@@ -0,0 +1,23 @@
+ext-memcached:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: memcached
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - libmemcached
+  depends@unix:
+    - libmemcached
+    - fastlz
+    - ext-session
+    - ext-zlib
+  suggests:
+    - zstd
+    - ext-igbinary
+    - ext-msgpack
+    - ext-session
+  php-extension:
+    arg-type: '--enable-memcached@shared_suffix@ --with-zlib-dir=@build_root_path@'

config/pkg/ext/ext-mongodb.yml

@@ -0,0 +1,21 @@
+ext-mongodb:
+  type: php-extension
+  artifact:
+    source:
+      type: ghrel
+      repo: mongodb/mongo-php-driver
+      match: mongodb.+\.tgz
+      extract: php-src/ext/mongodb
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  suggests:
+    - icu
+    - openssl
+    - zstd
+    - zlib
+  frameworks:
+    - CoreFoundation
+    - Security
+  php-extension:
+    arg-type: custom

config/pkg/ext/ext-msgpack.yml

@@ -0,0 +1,14 @@
+ext-msgpack:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: msgpack
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-3-Clause
+  depends:
+    - ext-session
+  php-extension:
+    arg-type@unix: with
+    arg-type@windows: enable

config/pkg/ext/ext-mysqlnd_ed25519.yml

@@ -0,0 +1,18 @@
+ext-mysqlnd_ed25519:
+  type: php-extension
+  artifact:
+    source:
+      type: pie
+      repo: mariadb/mysqlnd_ed25519
+      extract: php-src/ext/mysqlnd_ed25519
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-3-Clause
+  depends:
+    - ext-mysqlnd
+    - libsodium
+  suggests:
+    - openssl
+  php-extension:
+    arg-type: '--with-mysqlnd_ed25519=@shared_suffix@'
+    build-static: false

config/pkg/ext/ext-mysqlnd_parsec.yml

@@ -0,0 +1,17 @@
+ext-mysqlnd_parsec:
+  type: php-extension
+  artifact:
+    source:
+      type: pie
+      repo: mariadb/mysqlnd_parsec
+      extract: php-src/ext/mysqlnd_parsec
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-3-Clause
+  depends:
+    - ext-mysqlnd
+    - libsodium
+    - openssl
+  php-extension:
+    arg-type: '--enable-mysqlnd_parsec'
+    build-static: false

config/pkg/ext/ext-opentelemetry.yml

@@ -0,0 +1,9 @@
+ext-opentelemetry:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: opentelemetry
+    metadata:
+      license-files: [LICENSE]
+      license: Apache-2.0

config/pkg/ext/ext-parallel.yml

@@ -0,0 +1,9 @@
+ext-parallel:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: parallel
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01

config/pkg/ext/ext-pcov.yml

@@ -0,0 +1,12 @@
+ext-pcov:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: pcov
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  php-extension:
+    build-static: false
+    build-shared: true

config/pkg/ext/ext-pdo_sqlsrv.yml

@@ -0,0 +1,14 @@
+ext-pdo_sqlsrv:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: pdo_sqlsrv
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends:
+    - ext-pdo
+    - ext-sqlsrv
+  php-extension:
+    arg-type: with

config/pkg/ext/ext-protobuf.yml

@@ -0,0 +1,9 @@
+ext-protobuf:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: protobuf
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-3-Clause

config/pkg/ext/ext-rar.yml

@@ -0,0 +1,12 @@
+ext-rar:
+  type: php-extension
+  artifact:
+    source:
+      type: git
+      url: 'https://github.com/static-php/php-rar.git'
+      rev: issue-php82
+      extract: php-src/ext/rar
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  lang: cpp

config/pkg/ext/ext-rdkafka.yml

@@ -0,0 +1,15 @@
+ext-rdkafka:
+  type: php-extension
+  artifact:
+    source:
+      type: ghtar
+      repo: arnaud-lb/php-rdkafka
+      extract: php-src/ext/rdkafka
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends:
+    - librdkafka
+  lang: cpp
+  php-extension:
+    arg-type: custom

config/pkg/ext/ext-redis.yml

@@ -0,0 +1,21 @@
+ext-redis:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: redis
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  suggests:
+    - ext-session
+    - ext-igbinary
+    - ext-msgpack
+  suggests@unix:
+    - ext-session
+    - ext-igbinary
+    - ext-msgpack
+    - zstd
+    - liblz4
+  php-extension:
+    arg-type: custom

config/pkg/ext/ext-simdjson.yml

@@ -0,0 +1,10 @@
+ext-simdjson:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: simdjson
+    metadata:
+      license-files: [LICENSE]
+      license: Apache-2.0
+  lang: cpp

config/pkg/ext/ext-snappy.yml

@@ -0,0 +1,18 @@
+ext-snappy:
+  type: php-extension
+  artifact:
+    source:
+      type: git
+      url: 'https://github.com/kjdev/php-ext-snappy'
+      rev: master
+      extract: php-src/ext/snappy
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - snappy
+  suggests:
+    - ext-apcu
+  lang: cpp
+  php-extension:
+    arg-type@unix: '--enable-snappy --with-snappy-includedir=@build_root_path@'

config/pkg/ext/ext-spx.yml

@@ -0,0 +1,14 @@
+ext-spx:
+  type: php-extension
+  artifact:
+    source:
+      type: pie
+      repo: noisebynorthwest/php-spx
+      extract: php-src/ext/spx
+    metadata:
+      license-files: [LICENSE]
+      license: GPL-3.0-or-later
+  depends:
+    - ext-zlib
+  php-extension:
+    arg-type: '--enable-SPX@shared_suffix@'

config/pkg/ext/ext-sqlsrv.yml

@@ -0,0 +1,15 @@
+ext-sqlsrv:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: sqlsrv
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends@linux:
+    - unixodbc
+    - ext-pcntl
+  depends@macos:
+    - unixodbc
+  lang: cpp

config/pkg/ext/ext-ssh2.yml

@@ -0,0 +1,15 @@
+ext-ssh2:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: ssh2
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - libssh2
+    - ext-openssl
+    - ext-zlib
+  php-extension:
+    arg-type: with-path

config/pkg/ext/ext-swoole.yml

@@ -0,0 +1,72 @@
+ext-swoole:
+  type: php-extension
+  artifact:
+    source:
+      type: ghtar
+      repo: swoole/swoole-src
+      extract: php-src/ext/swoole
+      match: v6\.+
+      prefer-stable: true
+    metadata:
+      license-files: [LICENSE]
+      license: Apache-2.0
+  depends:
+    - libcares
+    - brotli
+    - nghttp2
+    - zlib
+    - ext-openssl
+    - ext-curl
+  suggests:
+    - zstd
+    - ext-sockets
+    - ext-swoole-hook-pgsql
+    - ext-swoole-hook-mysql
+    - ext-swoole-hook-sqlite
+    - ext-swoole-hook-odbc
+  suggests@linux:
+    - zstd
+    - liburing
+    - ext-sockets
+    - ext-swoole-hook-pgsql
+    - ext-swoole-hook-mysql
+    - ext-swoole-hook-sqlite
+    - ext-swoole-hook-odbc
+  lang: cpp
+  php-extension:
+    arg-type: custom
+ext-swoole-hook-mysql:
+  type: php-extension
+  depends:
+    - ext-mysqlnd
+    - ext-pdo
+    - ext-pdo_mysql
+  suggests:
+    - ext-mysqli
+  php-extension:
+    arg-type: none
+    display-name: swoole
+ext-swoole-hook-odbc:
+  type: php-extension
+  depends:
+    - ext-pdo
+    - unixodbc
+  php-extension:
+    arg-type: none
+    display-name: swoole
+ext-swoole-hook-pgsql:
+  type: php-extension
+  depends:
+    - ext-pgsql
+    - ext-pdo
+  php-extension:
+    arg-type: none
+    display-name: swoole
+ext-swoole-hook-sqlite:
+  type: php-extension
+  depends:
+    - ext-sqlite3
+    - ext-pdo
+  php-extension:
+    arg-type: none
+    display-name: swoole

config/pkg/ext/ext-swow.yml

@@ -0,0 +1,18 @@
+ext-swow:
+  type: php-extension
+  artifact:
+    source:
+      extract: php-src/ext/swow-src
+      type: ghtar
+      repo: swow/swow
+      prefer-stable: true
+    metadata:
+      license: Apache-2.0
+      license-files: [LICENSE]
+  suggests:
+    - openssl
+    - curl
+    - ext-openssl
+    - ext-curl
+  php-extension:
+    arg-type: custom

config/pkg/ext/ext-trader.yml

@@ -0,0 +1,14 @@
+ext-trader:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: trader
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-2-Clause
+  php-extension:
+    support:
+      BSD: wip
+      Windows: wip
+    arg-type: enable

config/pkg/ext/ext-uuid.yml

@@ -0,0 +1,16 @@
+ext-uuid:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: uuid
+    metadata:
+      license-files: [LICENSE]
+      license: LGPL-2.1-only
+  depends:
+    - libuuid
+  php-extension:
+    support:
+      Windows: wip
+      BSD: wip
+    arg-type: with-path

config/pkg/ext/ext-uv.yml

@@ -0,0 +1,18 @@
+ext-uv:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: uv
+      prefer-stable: false
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - libuv
+    - ext-sockets
+  php-extension:
+    support:
+      Windows: wip
+      BSD: wip
+    arg-type: with-path

config/pkg/ext/ext-xdebug.yml

@@ -0,0 +1,14 @@
+ext-xdebug:
+  type: php-extension
+  artifact:
+    source:
+      type: pie
+      repo: xdebug/xdebug
+    metadata:
+      license-files: [LICENSE]
+      license: Xdebug-1.03
+  php-extension:
+    zend-extension: true
+    build-static: false
+    build-shared: true
+    build-with-php: false

config/pkg/ext/ext-xhprof.yml

@@ -0,0 +1,18 @@
+ext-xhprof:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: xhprof
+      extract: php-src/ext/xhprof-src
+    metadata:
+      license-files: [LICENSE]
+      license: Apache-2.0
+  depends:
+    - ext-ctype
+  php-extension:
+    support:
+      Windows: wip
+      BSD: wip
+    arg-type: enable
+    build-with-php: true

config/pkg/ext/ext-xlswriter.yml

@@ -0,0 +1,18 @@
+ext-xlswriter:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: xlswriter
+    metadata:
+      license-files: [LICENSE]
+      license: BSD-2-Clause
+  depends:
+    - ext-zlib
+    - ext-zip
+  suggests:
+    - openssl
+  php-extension:
+    support:
+      BSD: wip
+    arg-type: custom

config/pkg/ext/ext-xz.yml

@@ -0,0 +1,15 @@
+ext-xz:
+  type: php-extension
+  artifact:
+    source:
+      type: git
+      url: 'https://github.com/codemasher/php-ext-xz'
+      rev: main
+      extract: php-src/ext/xz
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends:
+    - xz
+  php-extension:
+    arg-type: with-path

config/pkg/ext/ext-yac.yml

@@ -0,0 +1,14 @@
+ext-yac:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: yac
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends@unix:
+    - fastlz
+    - ext-igbinary
+  php-extension:
+    arg-type@unix: '--enable-yac@shared_suffix@ --enable-igbinary --enable-json --with-system-fastlz'

config/pkg/ext/ext-yaml.yml

@@ -0,0 +1,16 @@
+ext-yaml:
+  type: php-extension
+  artifact:
+    source:
+      type: git
+      url: 'https://github.com/php/pecl-file_formats-yaml'
+      rev: php7
+      extract: php-src/ext/yaml
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends:
+    - libyaml
+  php-extension:
+    arg-type@unix: with-path
+    arg-type@windows: with

config/pkg/ext/ext-zip.yml

@@ -0,0 +1,17 @@
+ext-zip:
+  type: php-extension
+  artifact:
+    source:
+      type: pecl
+      name: zip
+      extract: ext-zip
+    metadata:
+      license-files: [LICENSE]
+      license: PHP-3.01
+  depends@unix:
+    - libzip
+  php-extension:
+    support:
+      BSD: wip
+    arg-type: custom
+    arg-type@windows: enable

config/pkg/ext/ext-zstd.yml

@@ -0,0 +1,15 @@
+ext-zstd:
+  type: php-extension
+  artifact:
+    source:
+      type: git
+      url: 'https://github.com/kjdev/php-ext-zstd'
+      rev: master
+      extract: php-src/ext/zstd
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  depends:
+    - zstd
+  php-extension:
+    arg-type: '--enable-zstd --with-libzstd=@build_root_path@'

config/pkg/lib/attr.yml

@@ -0,0 +1,10 @@
+attr:
+  type: library
+  artifact:
+    source: 'https://download.savannah.nongnu.org/releases/attr/attr-2.5.2.tar.gz'
+    source-mirror: 'https://mirror.souseiseki.middlendian.com/nongnu/attr/attr-2.5.2.tar.gz'
+    metadata:
+      license-files: [doc/COPYING.LGPL]
+      license: LGPL-2.1-or-later
+  static-libs@unix:
+    - libattr.a

config/pkg/lib/brotli.yml

@@ -0,0 +1,21 @@
+brotli:
+  type: library
+  artifact:
+    source:
+      type: ghtagtar
+      repo: google/brotli
+      match: 'v1\.\d.*'
+    binary: hosted
+    metadata:
+      license-files: [LICENSE]
+      license: MIT
+  headers:
+    - brotli
+  pkg-configs:
+    - libbrotlicommon
+    - libbrotlidec
+    - libbrotlienc
+  static-libs@windows:
+    - brotlicommon.lib
+    - brotlidec.lib
+    - brotlienc.lib

config/pkg/lib/bzip2.yml

@@ -0,0 +1,21 @@
+bzip2:
+  type: library
+  artifact:
+    source:
+      type: url
+      url: 'https://dl.static-php.dev/static-php-cli/deps/bzip2/bzip2-1.0.8.tar.gz'
+    source-mirror:
+      type: filelist
+      url: 'https://sourceware.org/pub/bzip2/'
+      regex: '/href="(?<file>bzip2-(?<version>[^"]+)\.tar\.gz)"/'
+    binary: hosted
+    metadata:
+      license-files: ['@/bzip2.txt']
+      license: bzip2-1.0.6
+  headers:
+    - bzlib.h
+  static-libs@unix:
+    - libbz2.a
+  static-libs@windows:
+    - libbz2.lib
+    - libbz2_a.lib

config/pkg/lib/fastlz.yml

@@ -0,0 +1,14 @@
+fastlz:
+  type: library
+  artifact:
+    source:
+      type: git
+      url: 'https://github.com/ariya/FastLZ.git'
+      rev: master
+    metadata:
+      license-files: [LICENSE.MIT]
+      license: MIT
+  headers:
+    - fastlz.h
+  static-libs@unix:
+    - libfastlz.a

config/pkg/lib/freetype.yml

@@ -0,0 +1,23 @@
+freetype:
+  type: library
+  artifact:
+    source:
+      type: ghtagtar
+      repo: freetype/freetype
+      match: VER-2-\d+-\d+
+    metadata:
+      license-files: [LICENSE.TXT]
+      license: FTL
+  depends:
+    - zlib
+  suggests:
+    - libpng
+    - bzip2
+    - brotli
+  headers@unix:
+    - freetype2/freetype/freetype.h
+    - freetype2/ft2build.h
+  static-libs@unix:
+    - libfreetype.a
+  static-libs@windows:
+    - libfreetype_a.lib

config/pkg/lib/gettext.yml

@@ -0,0 +1,19 @@
+gettext:
+  type: library
+  artifact:
+    source:
+      type: filelist
+      url: 'https://ftp.gnu.org/pub/gnu/gettext/'
+      regex: '/href="(?<file>gettext-(?<version>[^"]+)\.tar\.xz)"/'
+    metadata:
+      license-files: [gettext-runtime/intl/COPYING.LIB]
+      license: LGPL-2.1-or-later
+  depends:
+    - libiconv
+  suggests:
+    - ncurses
+    - libxml2
+  frameworks:
+    - CoreFoundation
+  static-libs@unix:
+    - libintl.a