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

@@ -1,13 +1,15 @@
 # These are supported funding model platforms
 
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+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: # Replace with a single Ko-fi 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

@@ -7,6 +7,11 @@
 > 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 it's a extension or dependency update, make sure adding related extensions in `src/global/test-extensions.php`.
-- [ ] If you changed the behavior of static-php-cli, add docs in [static-php/static-php-cli-docs](https://github.com/static-php/static-php-cli-docs) .
-- [ ] If you updated `config/xxxx.json` content, run `bin/spc dev:sort-config xxx`.
+- 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,107 +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.3'
-          - '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-${{ inputs.extensions }}
-
-      # 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 }} --for-extensions=${{ inputs.extensions }} ${{ 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,118 +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.3'
-          - '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 --classmap-authoritative
-
-      # Cache downloaded source
-      - id: cache-download
-        uses: actions/cache@v3
-        with:
-          path: downloads
-          key: php-${{ inputs.version }}-dependencies-${{ inputs.extensions }}
-
-      # 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 }} --for-extensions=${{ inputs.extensions }} ${{ 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
-

.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,14 +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
@@ -21,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:
@@ -36,14 +42,14 @@ 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
+      - 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
@@ -52,62 +58,62 @@ jobs:
       - if: steps.cache-composer-deps.outputs.cache-hit != 'true'
         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-${{ inputs.extensions }}
+          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-alpine-docker download --with-php=${{ inputs.version }} --for-extensions=${{ inputs.extensions }} ${{ 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-alpine-docker 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
-

.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

@@ -3,26 +3,41 @@ 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"
-    runs-on: ubuntu-latest
+    name: "Build SPC Binary for ${{ matrix.operating-system.name }}"
+    runs-on: ${{ matrix.operating-system.os }}
     strategy:
       matrix:
-        php-version:
-          - "8.1"
-        micro-version:
-          - "8.1.26"
         operating-system:
-          - "linux-x86_64"
-          - "macos-x86_64"
-          - "linux-aarch64"
-          - "macos-aarch64"
+          - 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"
@@ -31,12 +46,13 @@ jobs:
         run: echo "SPC_BUILD_DEBUG=--debug" >> $GITHUB_ENV
 
       - name: "Install PHP for official runners"
-        uses: "shivammathur/setup-php@v2"
+        uses: shivammathur/setup-php@v2
         with:
           coverage: none
           tools: composer:v2
-          php-version: "${{ matrix.php-version }}"
+          php-version: "${{ env.PHP_VERSION }}"
           ini-values: memory_limit=-1
+          extensions: curl, openssl, mbstring
 
       - name: "Get Composer Cache Directory"
         id: composer-cache
@@ -44,12 +60,12 @@ jobs:
           echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
 
       - name: "Cache Composer dependencies"
-        uses: "actions/cache@v3"
+        uses: "actions/cache@v4"
         with:
           path: "${{ steps.composer-cache.outputs.dir }}"
-          key: "php-${{ matrix.php-version }}-locked-composer-${{ hashFiles('**/composer.lock') }}"
+          key: "php-${{ env.PHP_VERSION }}-locked-composer-${{ hashFiles('**/composer.lock') }}"
           restore-keys: |
-            php-${{ matrix.php-version }}-locked-composer
+            php-${{ env.PHP_VERSION }}-locked-composer
 
       - name: "Install Locked Dependencies"
         run: "composer install --no-interaction --no-progress"
@@ -57,48 +73,103 @@ jobs:
       - name: "Build PHAR File"
         run: "composer build:phar"
 
-      - name: "Download minimal combination"
+      - name: "Download Minimal Combination"
         run: |
-          curl https://dl.static-php.dev/static-php-cli/minimal/php-${{ matrix.micro-version }}-micro-${{ matrix.operating-system }}.tar.gz -o tmp.tgz
-          tar -zxvf tmp.tgz
+          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: |
-          cat micro.sfx spc.phar > spc
-          chmod +x spc
+          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"
+      - name: "Archive Executable and Validate Binary"
         run: |
-          tar -czf spc-${{ matrix.operating-system }}.tar.gz spc
-          echo "filename=spc-${{ matrix.operating-system }}.tar.gz" >> $GITHUB_ENV
-          echo "OS=${{ matrix.operating-system }}" >> $GITHUB_ENV
-          if [ "${{ matrix.operating-system }}" == "linux-x86_64" ]; then
-            ./spc dev:extensions
+          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: "mkdir dist/ && cp ${{ env.filename }} dist/ && cp spc dist/spc-$OS"
+        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
+      - name: "Upload Binaries to Release"
         uses: softprops/action-gh-release@v1
         if: ${{startsWith(github.ref, 'refs/tags/') }}
         with:
-          files: ${{ env.filename }}
+          files: dist/${{ matrix.operating-system.filename }}
 
-      - name: "Deploy to Self-Hosted Server"
-        if: github.repository == 'crazywhalecc/static-php-cli'
-        uses: easingthemes/ssh-deploy@main
-        env:
-          SSH_PRIVATE_KEY: ${{ secrets.DEPLOY_SERVER_SECRET_KEY }}
-          ARGS: "-rltgoDzvO"
-          SOURCE: "dist/"
-          REMOTE_HOST: ${{ secrets.DEPLOY_SERVER_HOST }}
-          REMOTE_PORT: ${{ secrets.DEPLOY_SERVER_PORT }}
-          REMOTE_USER: ${{ secrets.DEPLOY_SERVER_USER }}
-          TARGET: ${{ secrets.DEPLOY_SERVER_TARGET_SPC_NIGHTLY }}
+      - 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@v3
+        uses: actions/upload-artifact@v4
         with:
-          path: spc
-          name: spc-${{ matrix.operating-system }}
+          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

@@ -1,16 +1,22 @@
 name: Tests
 
 on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'src/globals/test-extensions.php'
   pull_request:
-    branches: [ "main" ]
+    branches: [ "main", "v3" ]
+    types: [ opened, synchronize, reopened ]
+    paths:
+      - 'src/**'
+      - 'config/**'
+      - '.github/workflows/tests.yml'
+      - 'bin/**'
+      - 'composer.json'
+      - 'box.json'
+      - '.php-cs-fixer.php'
 
-permissions:
-  contents: read
+permissions: read-all
+
+env:
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
 jobs:
   php-cs-fixer:
@@ -23,7 +29,7 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.4'
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
           tools: pecl, composer, php-cs-fixer
@@ -41,14 +47,16 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: '8.1'
+          php-version: '8.4'
           extensions: curl, openssl, mbstring
           ini-values: memory_limit=-1
           tools: composer
+        env:
+          phpts: zts
 
       - name: "Cache Composer packages"
         id: composer-cache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: vendor
           key: ${{ runner.os }}-phpstan-${{ hashFiles('**/composer.lock') }}
@@ -68,9 +76,7 @@ jobs:
     strategy:
       matrix:
         include:
-          - php: '8.1'
-          - php: '8.2'
-          - php: '8.3'
+          - php: '8.4'
 
     steps:
       - name: "Checkout"
@@ -86,35 +92,25 @@ jobs:
 
       - name: "Cache Composer packages"
         id: composer-cache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: vendor
           key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
           restore-keys: |
-            ${{ runner.os }}-php-
+            ${{ runner.os }}-php
 
       - name: "Install Dependencies"
         run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
 
       - name: "Run PHPUnit Tests"
-        run: |
-          vendor/bin/phpunit tests/ --no-coverage
+        run: SPC_LIBC=glibc vendor/bin/phpunit tests/ --no-coverage
 
-  build:
-    name: "Build PHP Test (PHP ${{ matrix.php }} ${{ matrix.os }})"
-    runs-on: ${{ matrix.os }}
-    timeout-minutes: 120
-    strategy:
-      matrix:
-        php:
-          - "8.0"
-          - "8.1"
-          - "8.2"
-          - "8.3"
-        os:
-          - ubuntu-latest
-          - macos-latest
-      fail-fast: false
+  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
@@ -122,14 +118,49 @@ jobs:
       - name: "Setup PHP"
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.2
+          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"
+      - name: "Cache composer packages"
         id: composer-cache
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: vendor
           key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}
@@ -138,19 +169,46 @@ jobs:
 
       # Cache downloaded source
       - id: cache-download
-        uses: actions/cache@v3
+        uses: actions/cache@v4
         with:
           path: downloads
-          key: php-${{ matrix.php }}-dependencies
+          key: php-dependencies-${{ matrix.os }}
 
       - name: "Install Dependencies"
-        run: composer update -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+        run: composer update -vvv --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist --no-plugins
 
       - name: "Run Build Tests (doctor)"
-        run: bin/spc doctor --auto-fix
+        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: bin/spc download --for-extensions="$(php src/globals/test-extensions.php extensions)" --with-php=${{ matrix.php }} --debug
+        run: php src/globals/test-extensions.php download_cmd ${{ matrix.os }} ${{ matrix.php }}
 
       - name: "Run Build Tests (build)"
-        run: bin/spc build $(php src/globals/test-extensions.php cmd) --build-cli --build-micro --build-fpm --debug
+        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/update-docs-config.yml

@@ -1,43 +0,0 @@
-name: Update Docs Config
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - 'config/**.json'
-
-jobs:
-  update-docs-config:
-    name: "Update Docs Config"
-    runs-on: ubuntu-latest
-    if: github.repository == 'crazywhalecc/static-php-cli'
-    steps:
-      - name: "Checkout static-php-cli"
-        uses: actions/checkout@v4
-        with:
-          ref: main
-          path: static-php-cli
-
-      - name: "Checkout static-php-cli-docs"
-        uses: actions/checkout@v4
-        with:
-          repository: static-php/static-php-cli-docs
-          ref: master
-          token: ${{ secrets.DOCS_REPO_TOKEN }}
-          path: static-php-cli-docs
-
-      - name: "Set up Git"
-        run: |
-          git config --global user.email "actions@github.com"
-          git config --global user.name "GitHub Actions"
-
-      - name: "Copy Config Files"
-        run: cp -r static-php-cli/config/* static-php-cli-docs/docs/.vitepress/config/
-
-      - name: "Commit and Push Changes"
-        run: |
-          cd static-php-cli-docs
-          git add -A
-          git commit -m "Sync config files from main"
-          git push origin master

.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,33 +1,69 @@
 .idea
-runtime/
-docker/libraries/
-docker/extensions/
-docker/source/
+/runtime/
+/docker/libraries/
+/docker/extensions/
+/docker/source/
 
 # Vendor files
-/vendor/
+/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/**
+
+# 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/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,
@@ -64,7 +65,10 @@ return (new PhpCsFixer\Config())
         'php_unit_test_class_requires_covers' => false,
         'phpdoc_var_without_name' => false,
         'fully_qualified_strict_types' => false,
+        'operator_linebreak' => false,
+        'php_unit_data_provider_method_order' => false,
     ])
     ->setFinder(
-        PhpCsFixer\Finder::create()->in([__DIR__ . '/src', __DIR__ . '/tests/SPC'])
-    );
+        PhpCsFixer\Finder::create()->in([__DIR__ . '/src', __DIR__ . '/tests/StaticPHP'])
+    )
+    ->setParallelConfig(PhpCsFixer\Runner\Parallel\ParallelConfigFactory::detect());

README-en.md

@@ -1,3 +0,0 @@
-# static-php-cli
-
-English README has been moved to [README.md](README.md).

README-zh.md

@@ -1,254 +1,172 @@
-# static-php-cli
+# StaticPHP
 
-Build single static PHP binary, with PHP project together, with popular extensions included.
+[![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)
 
-🌐 **[中文](README-zh.md)** | **[English](README.md)**
+**StaticPHP** 是一个用于构建静态编译可执行文件（包括 PHP、扩展等）的强大工具。
 
-编译纯静态的 PHP Binary 二进制文件，带有各种扩展，让 PHP-cli 应用变得更便携！（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">
+- :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）
 
-同时可以使用 micro 二进制文件，将 PHP 源码和 PHP 二进制构建为一个文件分发！（micro SAPI）
+**单文件独立 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">
 
-> 该 SAPI 源自 [dixyes/phpmicro](https://github.com/dixyes/phpmicro) 的 [Fork 仓库](https://github.com/static-php/phpmicro)。
+**使用 phpmicro 将 PHP 代码与 PHP 解释器结合：**
 
-[![Version](https://img.shields.io/badge/Version-2.0.0-green.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/tests.yml?branch=main&label=Build%20Test&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/tests.yml)
-[![](https://img.shields.io/badge/Extension%20Counter-75+-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">
 
-> 项目名称是 static-php-cli，但其实支持 cli、fpm、micro 和 embed SAPI 😎
+## 快速开始
+
+### 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 编写了基本用法。有关 static-php-cli 所有的功能，请点击这里查看文档：<https://static-php.dev>。
+当前 README 包含基本用法。有关 StaticPHP 的所有功能，
+请访问 <https://static-php.dev>。
 
-## 自托管直接下载
+## 直接下载
 
-如果你不想自行编译 PHP，可以从本项目现有的示例 Action 下载 Artifact，也可以从自托管的服务器下载。
+如果您不想构建或想先测试，可以从 [Actions](https://github.com/static-php/static-php-cli-hosted/actions/workflows/build-php-bulk.yml) 下载示例预编译工件，或从自托管服务器下载。
 
-- [扩展组合 - common](https://dl.static-php.dev/static-php-cli/common/)：common 组合包含了约 [30+](https://dl.static-php.dev/static-php-cli/common/README.txt) 个常用扩展，体积为 22MB 左右。
-- [扩展组合 - bulk](https://dl.static-php.dev/static-php-cli/bulk/)：bulk 组合包含了 [50+](https://dl.static-php.dev/static-php-cli/bulk/README.txt) 个扩展，体积为 70MB 左右。
-- [扩展组合 - minimal](https://dl.static-php.dev/static-php-cli/minimal/)：minimal 组合包含了 [5](https://dl.static-php.dev/static-php-cli/minimal/README.txt) 个扩展，体积为 6MB 左右。
+以下是几个具有不同扩展组合的预编译静态 PHP 二进制文件，
+您可以根据需要直接下载。
 
-## 使用 static-php-cli 构建 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 的预构建二进制文件大小较大。
 
-是的，本项目采用 PHP 编写，编译前需要一个 PHP 环境，比较滑稽。
-但本项目默认可通过自身构建的 micro 和 static-php 二进制运行，其他只需要包含 mbstring、pcntl 扩展和 PHP 版本大于等于 8.1 即可。
+### 在线构建（使用 GitHub Actions）
 
-下面是架构支持情况，:octocat: 代表支持 GitHub Action 构建，:computer: 代表支持本地构建，空 代表暂不支持。
-
-|         | x86_64               | aarch64              |
-|---------|----------------------|----------------------|
-| macOS   | :octocat: :computer: | :computer:           |
-| Linux   | :octocat: :computer: | :octocat: :computer: |
-| Windows |                      |                      |
-| FreeBSD | :computer:           | :computer:           |
-
-> macOS-arm64 因 GitHub 暂未提供 arm runner，如果要构建 arm 二进制，可以使用手动构建。
-
-目前支持编译的 PHP 版本为：`7.3`，`7.4`，`8.0`，`8.1`，`8.2`，`8.3`。
-
-### 支持的扩展情况
-
-请先根据下方扩展列表选择你要编译的扩展。
-
-- [扩展支持列表](https://static-php.dev/zh/guide/extensions.html)
-- [编译命令生成器](https://static-php.dev/zh/guide/cli-generator.html)
-
-> 如果这里没有你需要的扩展，可以提交 Issue。
-
-### 使用 Actions 构建
-
-使用 GitHub Action 可以方便地构建一个静态编译的 PHP，同时可以自行定义要编译的扩展。
+上方直接下载的二进制不能满足需求时，可使用 GitHub Action 可以轻松构建静态编译的 PHP，
+同时自行定义要编译的扩展。
 
 1. Fork 本项目。
-2. 进入项目的 Actions，选择 CI。
-3. 选择 `Run workflow`，填入你要编译的 PHP 版本、目标类型、扩展列表。（扩展列表使用英文逗号分割，例如 `bcmath,curl,mbstring`）
-4. 等待大约一段时间后，进入对应的任务中，获取 `Artifacts`。
+2. 进入项目的 Actions 并选择 `CI`。
+3. 选择 `Run workflow`，填入您要编译的 PHP 版本、目标类型和扩展列表。（扩展用逗号分隔，例如 `bcmath,curl,mbstring`）
+4. 等待一段时间后，进入相应的任务并获取 `Artifacts`。
 
-如果你选择了 `debug`，则会在构建时输出所有日志，包括编译的日志，以供排查错误。
-
-### 手动构建（使用 SPC 二进制）
-
-本项目提供了一个 static-php-cli 的二进制文件，你可以直接下载对应平台的二进制文件，然后使用它来构建静态的 PHP。目前 `spc` 二进制支持的平台有 Linux 和 macOS。
-
-下面是从 GitHub Action 下载的方法：
-
-1. 进入 [GitHub Action](https://github.com/crazywhalecc/static-php-cli/actions/workflows/release-build.yml)。
-2. 选择一个最新的构建任务，进入后选择 `Artifacts`，下载对应平台的二进制文件。
-3. 解压 `.zip` 文件。解压后，为其添加执行权限：`chmod +x ./spc`。
-
-你也可以从自托管的服务器下载二进制文件：[进入](https://dl.static-php.dev/static-php-cli/spc-bin/nightly/)。
-
-### 手动构建（使用源码）
-
-先克隆本项目：
-
-```bash
-git clone https://github.com/crazywhalecc/static-php-cli.git
-```
-
-如果你本机没有安装 PHP，你需要先使用包管理（例如 brew、apt、yum、apk 等）安装 php。
-
-你也可以通过 `bin/setup-runtime` 命令下载静态编译好的 php-cli 和 Composer。下载的 php 和 Composer 将保存为 `bin/php` 和 `bin/composer`。
-
-```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
-
-# 初始化本项目
-cd static-php-cli
-composer update
-chmod +x bin/spc
-```
-
-### 使用 static-php-cli 命令行程序
-
-下面是使用 static-php-cli 编译静态 php 和 micro 的基础用法：
-
-> 如果你使用的是打包好的 `spc` 二进制，你需要将下列命令的 `bin/spc` 替换为 `./spc`。
-
-```bash
-# 检查环境依赖，并根据提示的命令安装缺失的编译工具
-./bin/spc doctor
-# 拉取所有依赖库
-./bin/spc fetch --all
-# 只拉取编译指定扩展需要的所有依赖
-./bin/spc download --for-extensions=openssl,pcntl,mbstring,pdo_sqlite
-# 构建包含 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
-```
-
-你也可以使用参数 `--with-php=x.y` 来指定下载的 PHP 版本，目前支持 7.3 ~ 8.3：
-
-```bash
-# 优先考虑使用 >= 8.0 的 PHP 版本，因为 phpmicro 不支持在 PHP7 中构建
-./bin/spc download --with-php=8.2 --all
-```
-
-其中，目前支持构建 cli，micro，fpm 三种静态二进制，使用以下参数的一个或多个来指定编译的 SAPI：
-
-- `--build-cli`：构建 cli 二进制
-- `--build-micro`：构建 phpmicro 自执行二进制
-- `--build-fpm`：构建 fpm
-- `--build-embed`：构建 embed（libphp）
-- `--build-all`：构建所有
-
-如果出现了任何错误，可以使用 `--debug` 参数来展示完整的输出日志，以供排查错误：
-
-```bash
-./bin/spc build openssl,pcntl,mbstring --debug --build-all
-./bin/spc fetch --all --debug
-```
-
-此外，默认编译的 PHP 为 NTS 版本。如需编译线程安全版本（ZTS），只需添加参数 `--enable-zts` 即可。
-
-```bash
-./bin/spc build openssl,pcntl --build-all --enable-zts
-```
-
-同时，你也可以使用参数 `--no-strip` 来关闭裁剪，关闭裁剪后可以使用 gdb 等工具调试，但这样会让静态二进制体积变大。
-
-## 不同 SAPI 的使用
-
-### 使用 cli
-
-> php-cli 是一个静态的二进制文件，类似 Go、Rust 语言编译后的单个可移植的二进制文件。
-
-采用参数 `--build-cli` 或`--build-all` 参数时，最后编译结果会输出一个 `./php` 的二进制文件，此文件可分发、可直接使用。
-该文件编译后会存放在 `buildroot/bin/` 目录中，名称为 `php`，拷贝出来即可。
-
-```bash
-cd buildroot/bin/
-./php -v                # 检查版本
-./php -m                # 检查编译的扩展
-./php your_code.php     # 运行代码
-./php your_project.phar # 运行打包为 phar 单文件的项目
-```
-
-### 使用 micro
-
-> phpmicro 是一个提供自执行二进制 PHP 的项目，本项目依赖 phpmicro 进行编译自执行二进制。详见 [dixyes/phpmicro](https://github.com/dixyes/phpmicro)。
-
-采用项目参数 `--build-micro` 或 `--build-all` 时，最后编译结果会输出一个 `./micro.sfx` 的文件，此文件需要配合你的 PHP 源码使用。
-该文件编译后会存放在 `buildroot/bin/` 目录中，拷贝出来即可。
-
-使用时应准备好你的项目源码文件，可以是单个 PHP 文件，也可以是 Phar 文件。
-
-```bash
-echo "<?php echo 'Hello world' . PHP_EOL;" > code.php
-cat micro.sfx code.php > single-app && chmod +x single-app
-./single-app
-```
-
-如果打包 PHAR 文件，仅需把 code.php 更换为 phar 文件路径即可。
-你可以使用 [box-project/box](https://github.com/box-project/box) 将你的 CLI 项目打包为 Phar，
-然后将它与 phpmicro 结合，生成独立可执行的二进制文件。
-
-```bash
-# 使用 static-php-cli 生成的 micro.sfx 结合，也可以直接使用 cat 命令结合它们
-bin/spc micro:combine my-app.phar
-cat buildroot/bin/micro.sfx my-app.phar > my-app && chmod +x my-app
-
-# 使用 micro:combine 结合可以将 INI 选项注入到二进制中
-bin/spc micro:combine my-app.phar -I "memory_limit=4G" -I "disable_functions=system" --output my-app-2
-```
-
-> 有些情况下的 phar 文件或 PHP 项目可能无法在 micro 环境下运行。
-
-### 使用 fpm
-
-采用项目参数 `--build-fpm` 或 `--build-all` 时，最后编译结果会输出一个 `./php-fpm` 的文件。
-该文件存放在 `buildroot/bin/` 目录，拷贝出来即可使用。
-
-在正常的 Linux 发行版和 macOS 系统中，安装 php-fpm 后包管理会自动生成默认的 fpm 配置文件。
-因为 php-fpm 必须指定配置文件才可启动，本项目编译的 php-fpm 不会带任何配置文件，所以需自行编写 `php-fpm.conf` 和 `pool.conf` 配置文件。
-
-指定 `php-fpm.conf` 可以使用命令参数 `-y`，例如：`./php-fpm -y php-fpm.conf`。
-
-### 使用 embed
-
-采用项目参数 `--build-embed` 或 `--build-all` 时，最后编译结果会输出一个 `libphp.a`、`php-config` 以及一系列头文件，存放在 `buildroot/`，你可以在你的其他代码中引入它们。
-
-如果你知道 [embed SAPI](https://github.com/php/php-src/tree/master/sapi/embed)，你应该知道如何使用它。对于有可能编译用到引入其他库的问题，你可以使用 `buildroot/bin/php-config` 来获取编译时的配置。
-
-另外，有关如何使用此功能的高级示例，请查看[如何使用它构建 FrankenPHP 的静态版本](https://github.com/dunglas/frankenphp/blob/main/docs/static.md)。
+如果您启用 `debug`，构建时将输出所有日志，包括编译日志，以便故障排除。
 
 ## 贡献
 
-如果缺少你需要的扩展，可发起 Issue。如果你对本项目较熟悉，也欢迎为本项目发起 Pull Request。
+如果您需要的扩展缺失，可以创建 issue。
+如果您熟悉本项目，也欢迎发起 pull request。
 
-另外，添加新扩展的贡献方式，可以参考下方 `进阶`。
+如果您想贡献文档，请直接编辑 `docs/` 目录。
 
-如果你想贡献文档内容，请到项目仓库 [static-php/static-php-cli-docs](https://github.com/static-php/static-php-cli-docs) 贡献。
+现在有一个 [static-php](https://github.com/static-php) 组织，用于存储与项目相关的仓库。
 
 ## 赞助本项目
 
-你可以在 [我的个人赞助页](https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md) 支持我和我的项目。
+您可以从 [GitHub Sponsor](https://github.com/crazywhalecc) 赞助我或我的项目。您捐赠的一部分将用于维护 **static-php.dev** 服务器。
 
-## 开源协议
+**特别感谢以下赞助商**：
 
-本项目依据旧版本惯例采用 MIT License 开源，部分扩展的集成编译命令参考或修改自以下项目：
+<a href="https://beyondco.de/"><img src="/docs/public/images/beyondcode-seeklogo.png" width="300" alt="Beyond Code Logo" /></a>
 
-- [dixyes/lwmbs](https://github.com/dixyes/lwmbs)（木兰宽松许可证）
-- [swoole/swoole-cli](https://github.com/swoole/swoole-cli)（Apache 2.0 LICENSE、SWOOLE-CLI LICENSE）
+<a href="https://nativephp.com/"><img src="/docs/public/images/nativephp-logo.svg" width="300" alt="NativePHP Logo" /></a>
 
-因本项目的特殊性，使用项目编译过程中会使用很多其他开源项目，例如 curl、protobuf 等，它们都有各自的开源协议。
-请在编译完成后，使用命令 `bin/spc dump-license` 导出项目使用项目的开源协议，并遵守对应项目的 LICENSE。
+## 开源许可证
 
-## 进阶
+本项目本身基于 MIT 许可证，
+一些新添加的扩展和依赖可能来自其他项目，
+这些代码文件的头部也会给出额外的许可证和作者说明。
 
-本项目重构分支为模块化编写。如果你对本项目感兴趣，想加入开发，可以参照文档的 [贡献指南](https://static-php.dev) 贡献代码或文档。
+这些是类似的项目：
+
+- [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,80 +1,128 @@
-# static-php-cli
+# StaticPHP
 
-Build single static PHP binary, with PHP project together, with popular extensions included.
+[![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)
 
-🌐 **[中文](README-zh.md)** | **[English](README.md)**
+**StaticPHP** is a powerful tool designed for building portable executables including PHP, extensions, and more.
 
-> 2.0 Release is coming soon, windows support will be added in v2.1.
+## Features
 
-The project name is static-php-cli, but it actually supports cli, fpm, micro and embed SAPI 😎
+- :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%)
 
-Compile a purely static php-cli binary file with various extensions to make PHP applications more portable! (cli SAPI)
+**Single-file standalone php-cli:**
 
-<img width="600" alt="2023-05-02 15 53 13" src="https://user-images.githubusercontent.com/20330940/235610282-23e58d68-bd35-4092-8465-171cff2d5ba8.png">
+<img width="700" alt="out1" src="https://github.com/crazywhalecc/static-php-cli/assets/20330940/01a2e60f-13b0-4242-a645-f7afa4936396">
 
-You can also use the micro binary file to combine php binary and php source code into one for distribution! (micro SAPI)
+**Combine PHP code with PHP interpreter using phpmicro:**
 
-<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="out2" src="https://github.com/crazywhalecc/static-php-cli/assets/20330940/46b7128d-fb72-4169-957e-48564c3ff3e2">
 
-> This SAPI feature is from the [Fork](https://github.com/static-php/phpmicro) of [dixyes/phpmicro](https://github.com/dixyes/phpmicro).
+## Quickstart
 
-[![Version](https://img.shields.io/badge/Version-2.0.0-green.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/tests.yml?branch=main&label=Build%20Test&style=flat-square)](https://github.com/crazywhalecc/static-php-cli/actions/workflows/tests.yml)
-[![](https://img.shields.io/badge/Extension%20Counter-75+-yellow.svg?style=flat-square)]([https://static-php.dev/](https://static-php.dev/en/guide/extensions.html))
-[![](https://img.shields.io/github/search/crazywhalecc/static-php-cli/TODO?label=TODO%20Counter&style=flat-square)]()
+### 1. Download spc binary
+
+```bash
+# 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
+```
+
+For macOS and Linux, add execute permission first:
+
+```bash
+chmod +x ./spc
+```
+
+### 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
+./spc craft
+
+# Output full console log
+./spc craft --debug
+```
+
+### 3. Static PHP usage
+
+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
+```
 
 ## Documentation
 
-The current README contains basic usage. For all the features of static-php-cli,
+The current README contains basic usage. For all the features of StaticPHP,
 see <https://static-php.dev> .
 
 ## Direct Download
 
-If you don't want to compile yourself, you can download example pre-compiled artifact from [Actions](https://github.com/static-php/static-php-cli-hosted/actions/workflows/build-php-common.yml), or from self-hosted server.
+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.
 
 Below are several precompiled static-php binaries with different extension combinations,
 which can be downloaded directly according to your needs.
 
-- [Extension-Combination - common](https://dl.static-php.dev/static-php-cli/common/): `common` contains about [30+](https://dl.static-php.dev/static-php-cli/common/README.txt) commonly used extensions, and the size is about 22MB.
-- [Extension-Combination - bulk](https://dl.static-php.dev/static-php-cli/bulk/): `bulk` contains [50+](https://dl.static-php.dev/static-php-cli/bulk/README.txt) extensions and is about 70MB in size.
-- [Extension-Combination - minimal](https://dl.static-php.dev/static-php-cli/minimal/): `minimal` contains [5](https://dl.static-php.dev/static-php-cli/minimal/README.txt) extensions and is about 6MB in size.
+| 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 |
 
-## Use static-php-cli to build 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.
 
-### Compilation Requirements
+### Build Online (using GitHub Actions)
 
-Yes, this project is written in PHP, pretty funny.
-But static-php-cli runtime only requires an environment above PHP 8.1 and `mbstring`, `pcntl` extension.
-
-Here is the architecture support status, where :octocat: represents support for GitHub Action builds,
-:computer: represents support for local manual builds, and blank represents not currently supported.
-
-|         | x86_64               | aarch64              |
-|---------|----------------------|----------------------|
-| macOS   | :octocat: :computer: | :computer:           |
-| Linux   | :octocat: :computer: | :octocat: :computer: |
-| Windows |                      |                      |
-| FreeBSD | :computer:           | :computer:           |
-
-> 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.3`, `7.4`, `8.0`, `8.1`, `8.2`, `8.3`.
-
-### Supported Extensions
-
-Please first select the extension you want to compile based on the extension list below.
-
-- [Supported Extension List](https://static-php.dev/en/guide/extensions.html)
-- [Command Generator](https://static-php.dev/en/guide/cli-generator.html)
-
-> If an extension you need is missing, you can submit an issue.
-
-Here is the current planned roadmap for extension support: [#152](https://github.com/crazywhalecc/static-php-cli/issues/152) .
-
-### GitHub Actions Build
-
-Use GitHub Action to easily build a statically compiled PHP,
+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.
 
 1. Fork me.
@@ -84,192 +132,24 @@ and at the same time define the extensions to be compiled by yourself.
 
 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 (using SPC binary)
-
-This project provides a binary file of static-php-cli.
-You can directly download the binary file of the corresponding platform and then use it to build static PHP.
-Currently, the platforms supported by `spc` binary are Linux and macOS.
-
-Here's how to download from GitHub Actions:
-
-1. Enter [GitHub Actions](https://github.com/crazywhalecc/static-php-cli/actions/workflows/release-build.yml) or [self-hosted nightly builds](https://dl.static-php.dev/static-php-cli/spc-bin/nightly/).
-2. If you download from GHA, select the latest build task, select `Artifacts`, and download the binary file of the corresponding platform.
-3. If you download from GHA, unzip the `.zip` file. After decompressing, add execution permissions to it: `chmod +x ./spc`.
-4. If you download from self-hosted server, download `spc-$os-$arch` file and just use it (don't forget `chmod +x`).
-
-> SPC single-file binary is built by phpmicro and box, and it doesn't need to install PHP. Just treat `spc` as a standalone executable.
-
-### Manual build (using source code)
-
-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 use package management to install PHP (such as brew, apt, yum, apk etc.).
-
-And you can also download single-file php binary and composer using command `bin/setup-runtime`.
-The PHP runtime for static-php-cli itself will be downloaded at `bin/php`, and composer is at `bin/composer`.
-
-```bash
-cd static-php-cli
-chmod +x bin/setup-runtime
-# It will download php-cli from self-hosted server and composer from getcomposer.org
-./bin/setup-runtime
-
-# Use this php runtime to run static-php-cli compiler
-./bin/php bin/spc
-
-# Use composer
-./bin/php bin/composer
-
-# Initialize this project
-cd static-php-cli
-composer update
-chmod +x bin/spc
-```
-
-### Use static-php-cli
-
-Basic usage for building php and micro with some extensions:
-
-> If you are using the packaged `spc` binary, you need to replace `bin/spc` with `./spc` in the following commands.
-
-```bash
-# Check system tool dependencies, fix them if possible
-./bin/spc doctor
-# fetch all libraries
-./bin/spc download --all
-# only fetch necessary sources by needed extensions
-./bin/spc download --for-extensions=openssl,pcntl,mbstring,pdo_sqlite
-# 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.3:
-
-```bash
-# Using PHP >= 8.0 is recommended, because PHP7 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-embed`: build embed (libphp)
-- `--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
-```
-
-In addition, we build NTS (non-thread-safe) by default. If you are going to build ZTS version, just add `--enable-zts` option.
-
-```bash
-./bin/spc build openssl,pcntl --build-all --enable-zts
-```
-
-Adding option `--no-strip` can produce binaries with debug symbols, in order to debug (using gdb). Disabling strip will increase the size of static binary.
-
-## Different SAPI Usage
-
-### Use cli
-
-> 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)
-```
-
-### Use micro
-
-> phpmicro is a SelF-extracted eXecutable SAPI module,
-> provided by [phpmicro](https://github.com/dixyes/phpmicro) project.
-> But this project is using a [fork](https://github.com/static-php/phpmicro) of phpmicro, because we need to add some features to it.
-> 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 you package a PHAR file, just replace `code.php` with the phar file path.
-You can use [box-project/box](https://github.com/box-project/box) to package your CLI project as Phar,
-It is then combined with phpmicro to produce a standalone executable binary.
-
-```bash
-# Use the micro.sfx generated by static-php-cli to combine,
-bin/spc micro:combine my-app.phar
-# or you can directly use the cat command to combine them.
-cat buildroot/bin/micro.sfx my-app.phar > my-app && chmod +x my-app
-
-# Use micro:combine combination to inject INI options into the binary.
-bin/spc micro:combine my-app.phar -I "memory_limit=4G" -I "disable_functions=system" --output my-app-2
-```
-
-> In some cases, PHAR files may not run in a micro environment. Overall, micro is not production ready.
-
-### Use fpm
-
-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 common 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`.
-
-### Use embed
-
-When using the project parameters `--build-embed` or `--build-all`,
-the final compilation result will output a `libphp.a`, `php-config` and a series of header files,
-stored in `buildroot/`. You can introduce them in your other projects.
-
-If you know [embed SAPI](https://github.com/php/php-src/tree/master/sapi/embed), you should know how to use it.
-You may require the introduction of other libraries during compilation,
-you can use `buildroot/bin/php-config` to obtain the compile-time configuration.
-
-For an advanced example of how to use this feature, take a look at [how to use it to build a static version of FrankenPHP](https://github.com/dunglas/frankenphp/blob/main/docs/static.md).
-
 ## Contribution
 
 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.
 
-If you want to contribute documentation, please go to [static-php/static-php-cli-docs](https://github.com/static-php/static-php-cli-docs).
+If you want to contribute documentation, please just edit in `docs/`.
 
 Now there is a [static-php](https://github.com/static-php) organization, which is used to store the repo related to the project.
 
 ## Sponsor this project
 
-You can sponsor my project on [this page](https://github.com/crazywhalecc/crazywhalecc/blob/master/FUNDING.md).
+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.
+
+**Special thanks to sponsors below**:
+
+<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>
 
 ## Open-Source License
 
@@ -282,10 +162,12 @@ These are similar projects:
 - [dixyes/lwmbs](https://github.com/dixyes/lwmbs)
 - [swoole/swoole-cli](https://github.com/swoole/swoole-cli)
 
+The project uses some code from [dixyes/lwmbs](https://github.com/dixyes/lwmbs), such as windows static build target and libiconv support.
+lwmbs is licensed under the [Mulan PSL 2](http://license.coscl.org.cn/MulanPSL2).
+
 Due to the special nature of this project,
 many other open source projects such as curl and protobuf will be used during the project compilation process,
 and they all have their own open source licenses.
 
 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

@@ -25,7 +25,7 @@ __DIR__=$(cd "$(dirname "$0")" && pwd)
 __PROJECT__=$(cd "${__DIR__}"/../ && pwd)
 
 # set download dir
-__PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.2.13-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+__PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.4.12-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
 __COMPOSER_URL__="https://getcomposer.org/download/latest-stable/composer.phar"
 
 # use china mirror
@@ -45,7 +45,7 @@ done
 
 case "$mirror" in
 china)
-  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.2.13-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
+  __PHP_RUNTIME_URL__="https://dl.static-php.dev/static-php-cli/bulk/php-8.4.12-cli-${__OS_FIXED__}-${__ARCH__}.tar.gz"
   __COMPOSER_URL__="https://mirrors.tencent.com/composer/composer.phar"
   ;;
 
@@ -61,7 +61,7 @@ test -f "${__PROJECT__}"/downloads/runtime.tar.gz || { echo "Downloading $__PHP_
 test -f "${__DIR__}"/php || { tar -xf "${__PROJECT__}"/downloads/runtime.tar.gz -C "${__DIR__}"/ ; }
 chmod +x "${__DIR__}"/php
 # download composer
-test -f "${__DIR__}"/composer || curl -#fSL -o "${__DIR__}"/composer "$__COMPOSER_URL__"
+test -f "${__DIR__}"/composer || { echo "Downloading Composer from $__COMPOSER_URL__" && curl -#fSL -o "${__DIR__}"/composer "$__COMPOSER_URL__" ; }
 chmod +x "${__DIR__}"/composer
 # sanity check for php and composer
 "${__DIR__}"/php -v >/dev/null || { echo "Failed to run php" && exit 1; }

bin/setup-runtime.ps1

@@ -28,7 +28,7 @@ function RemoveFromPath {
     $currentPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
 
     if ($currentPath -like "*$pathToRemove*") {
-        $newPath = $currentPath -replace [regex]::Escape($pathToRemove), ''
+        $newPath = $currentPath -replace [regex]::Escape(';' + $pathToRemove), ''
         [System.Environment]::SetEnvironmentVariable('Path', $newPath, 'User')
         Write-Host "Removed Path '$pathToRemove'"
     } else {
@@ -51,10 +51,11 @@ if ($action -eq 'add-path') {
 }
 
 # get php 8.1 specific version
-$API = (Invoke-WebRequest -Uri "https://www.php.net/releases/index.php?json&version=8.1") | ConvertFrom-Json
 
 # php windows download
-$PHPRuntimeUrl = "https://windows.php.net/downloads/releases/php-" + $API.version + "-Win32-vs16-x64.zip"
+$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
@@ -92,7 +93,7 @@ if (-not(Test-Path "runtime\composer.phar"))
 # create runtime\composer.ps1
 $ComposerContent = '
 $WorkingDir = (Split-Path -Parent $MyInvocation.MyCommand.Definition)
-Start-Process ($WorkingDir + "\php.exe") ($WorkingDir + "\composer.phar " + $args) -NoNewWindow -Wait
+& ($WorkingDir + "\php.exe") (Join-Path $WorkingDir "\composer.phar") @args
 '
 $ComposerContent | Set-Content -Path 'runtime\composer.ps1' -Encoding UTF8
 

bin/spc

@@ -1,8 +1,9 @@
 #!/usr/bin/env php
 <?php
 
-use SPC\ConsoleApplication;
-use SPC\exception\ExceptionHandler;
+use StaticPHP\ConsoleApplication;
+use StaticPHP\Exception\ExceptionHandler;
+use StaticPHP\Exception\SPCException;
 
 if (file_exists(dirname(__DIR__) . '/vendor/autoload.php')) {
     // Current: ./bin (git/project mode)
@@ -12,13 +13,16 @@ if (file_exists(dirname(__DIR__) . '/vendor/autoload.php')) {
     require_once dirname(__DIR__, 3) . '/autoload.php';
 }
 
-// 防止 Micro 打包状态下不支持中文的显示（虽然这个项目目前好像没输出过中文？）
-if (PHP_OS_FAMILY === 'Windows' && Phar::running()) {
-    exec('CHCP 65001');
+// Print deprecation notice on PHP < 8.4, use red and highlight background
+if (PHP_VERSION_ID < 80400) {
+    echo "\e[43mDeprecation Notice: PHP < 8.4 is deprecated, please upgrade your PHP version.\e[0m\n";
 }
 
 try {
     (new ConsoleApplication())->run();
-} catch (Exception $e) {
-    ExceptionHandler::getInstance()->handle($e);
+} catch (SPCException $e) {
+    exit(ExceptionHandler::handleSPCException($e));
+} catch (\Throwable $e) {
+    exit(ExceptionHandler::handleDefaultException($e));
 }
+

bin/spc-alpine-docker

@@ -1,11 +1,14 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
+
+set -e
 
 # This file is using docker to run commands
+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
@@ -21,27 +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
-    # shellcheck disable=SC2039
-    echo -e "\e[033m* Using different arch needs to setup qemu-static for docker !\e[0m"
-    $DOCKER_EXECUTABLE run --rm --privileged multiarch/qemu-user-static:register --reset > /dev/null
+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"
@@ -50,12 +74,13 @@ 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 ..."
-    $DOCKER_EXECUTABLE build -t cwcc-spc-$SPC_USE_ARCH -f- . <<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; \
+    apk upgrade -a; \
     apk add --no-cache \
         autoconf \
         automake \
@@ -78,26 +103,33 @@ RUN apk update; \
         linux-headers \
         m4 \
         make \
-        php82 \
-        php82-common \
-        php82-pcntl \
-        php82-phar \
-        php82-posix \
-        php82-sodium \
-        php82-tokenizer \
-        php82-dom \
-        php82-xml \
-        php82-xmlwriter \
-        composer \
         pkgconfig \
+        re2c \
         wget \
-        xz
+        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
 COPY ./composer.* /app/
 ADD ./bin /app/bin
-RUN composer install --no-dev --classmap-authoritative
+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
+
+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
 
@@ -108,6 +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
 # shellcheck disable=SC2068
-$DOCKER_EXECUTABLE run --rm $INTERACT -e SPC_FIX_DEPLOY_ROOT="$(pwd)" -v "$(pwd)"/config:/app/config -v "$(pwd)"/src:/app/src -v "$(pwd)"/buildroot:/app/buildroot -v "$(pwd)"/source:/app/source -v "$(pwd)"/downloads:/app/downloads cwcc-spc-$SPC_USE_ARCH bin/spc $@
+# 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

@@ -1,4 +1,4 @@
-$PHP_Exec = "runtime\php.exe"
+$PHP_Exec = ".\runtime\php.exe"
 
 if (-not(Test-Path $PHP_Exec)) {
     $PHP_Exec = Get-Command php.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Definition
@@ -8,5 +8,5 @@ if (-not(Test-Path $PHP_Exec)) {
     }
 }
 
-$phpArgs = "bin\spc " + $args
-Start-Process $PHP_Exec -ArgumentList $phpArgs -NoNewWindow -Wait
+& "$PHP_Exec" ("bin/spc") @args
+exit $LASTEXITCODE

box.json

@@ -1,19 +1,23 @@
 {
-  "alias": "spc-php.phar",
-  "banner": false,
-  "blacklist": [
-    ".github"
-  ],
-  "directories": [
-    "config",
-    "src",
-    "vendor/psr",
-    "vendor/laravel/prompts",
-    "vendor/illuminate",
-    "vendor/symfony",
-    "vendor/zhamao"
-  ],
-  "git-commit-short": "git_commit_short",
-  "metadata": "ConsoleApplication::VERSION",
-  "output": "spc.phar"
+    "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,24 +9,29 @@
         }
     ],
     "require": {
-        "php": ">= 8.1",
+        "php": ">=8.4",
         "ext-mbstring": "*",
-        "laravel/prompts": "^0.1.12",
+        "ext-zlib": "*",
+        "laravel/prompts": "~0.1",
+        "php-di/php-di": "^7.1",
         "symfony/console": "^5.4 || ^6 || ^7",
-        "zhamao/logger": "^1.0"
+        "symfony/process": "^7.2",
+        "symfony/yaml": "^7.2",
+        "zhamao/logger": "^1.1.4"
     },
     "require-dev": {
-        "captainhook/captainhook": "^5.10",
-        "captainhook/plugin-composer": "^5.3",
-        "friendsofphp/php-cs-fixer": "^3.25",
-        "humbug/box": "^4.3",
-        "nunomaduro/collision": "^7.8",
-        "phpstan/phpstan": "^1.10",
-        "phpunit/phpunit": "^10.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",
@@ -35,7 +40,7 @@
     },
     "autoload-dev": {
         "psr-4": {
-            "SPC\\Tests\\": "tests/SPC"
+            "Tests\\StaticPHP\\": "tests/StaticPHP"
         }
     },
     "bin": [
@@ -44,15 +49,24 @@
     "scripts": {
         "analyse": "phpstan analyse --memory-limit 300M",
         "cs-fix": "php-cs-fixer fix",
+        "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/lib.json

@@ -1,10 +1,58 @@
 {
+    "lib-base": {
+        "type": "root"
+    },
+    "php": {
+        "type": "root",
+        "source": "php-src",
+        "lib-depends": [
+            "lib-base",
+            "micro",
+            "frankenphp"
+        ],
+        "lib-depends-macos": [
+            "lib-base",
+            "micro",
+            "libxml2",
+            "frankenphp"
+        ],
+        "lib-suggests-linux": [
+            "libacl",
+            "brotli",
+            "watcher"
+        ],
+        "lib-suggests-macos": [
+            "brotli",
+            "watcher"
+        ]
+    },
+    "frankenphp": {
+        "source": "frankenphp",
+        "type": "target"
+    },
+    "micro": {
+        "type": "target",
+        "source": "micro"
+    },
+    "pkg-config": {
+        "type": "package",
+        "source": "pkg-config",
+        "bin-unix": [
+            "pkg-config"
+        ]
+    },
+    "attr": {
+        "source": "attr",
+        "static-libs-unix": [
+            "libattr.a"
+        ]
+    },
     "brotli": {
         "source": "brotli",
-        "static-libs-unix": [
-            "libbrotlidec.a",
-            "libbrotlienc.a",
-            "libbrotlicommon.a"
+        "pkg-configs": [
+            "libbrotlicommon",
+            "libbrotlidec",
+            "libbrotlienc"
         ],
         "static-libs-windows": [
             "brotlicommon.lib",
@@ -21,10 +69,8 @@
             "libbz2.a"
         ],
         "static-libs-windows": [
-            [
-                "libbz2.lib",
-                "libbz2_a.lib"
-            ]
+            "libbz2.lib",
+            "libbz2_a.lib"
         ],
         "headers": [
             "bzlib.h"
@@ -36,7 +82,7 @@
             "libcurl.a"
         ],
         "static-libs-windows": [
-            "libcurl.lib"
+            "libcurl_a.lib"
         ],
         "headers": [
             "curl"
@@ -45,21 +91,26 @@
             "openssl",
             "zlib"
         ],
-        "lib-suggests": [
-            "libssh2",
-            "brotli",
-            "nghttp2",
-            "zstd"
-        ],
-        "lib-suggests-windows": [
+        "lib-depends-windows": [
             "zlib",
+            "libssh2",
+            "nghttp2"
+        ],
+        "lib-suggests-unix": [
             "libssh2",
             "brotli",
             "nghttp2",
+            "nghttp3",
+            "ngtcp2",
             "zstd",
-            "openssl",
+            "libcares",
+            "ldap",
             "idn2",
-            "psl"
+            "krb5"
+        ],
+        "lib-suggests-windows": [
+            "brotli",
+            "zstd"
         ],
         "frameworks": [
             "CoreFoundation",
@@ -67,11 +118,23 @@
             "SystemConfiguration"
         ]
     },
+    "fastlz": {
+        "source": "fastlz",
+        "static-libs-unix": [
+            "libfastlz.a"
+        ],
+        "headers": [
+            "fastlz/fastlz.h"
+        ]
+    },
     "freetype": {
         "source": "freetype",
         "static-libs-unix": [
             "libfreetype.a"
         ],
+        "static-libs-windows": [
+            "libfreetype_a.lib"
+        ],
         "headers-unix": [
             "freetype2/freetype/freetype.h",
             "freetype2/ft2build.h"
@@ -80,9 +143,23 @@
             "zlib"
         ],
         "lib-suggests": [
-            "libpng",
-            "bzip2",
-            "brotli"
+            "libpng"
+        ]
+    },
+    "gettext": {
+        "source": "gettext",
+        "static-libs-unix": [
+            "libintl.a"
+        ],
+        "lib-depends": [
+            "libiconv"
+        ],
+        "lib-suggests": [
+            "ncurses",
+            "libxml2"
+        ],
+        "frameworks": [
+            "CoreFoundation"
         ]
     },
     "glfw": {
@@ -109,34 +186,94 @@
             "gmp.h"
         ]
     },
+    "gmssl": {
+        "source": "gmssl",
+        "static-libs-unix": [
+            "libgmssl.a"
+        ],
+        "static-libs-windows": [
+            "gmssl.lib"
+        ],
+        "frameworks": [
+            "Security"
+        ]
+    },
+    "grpc": {
+        "source": "grpc",
+        "pkg-configs": [
+            "grpc"
+        ],
+        "lib-depends": [
+            "zlib",
+            "openssl",
+            "libcares"
+        ],
+        "cpp-library": true,
+        "frameworks": [
+            "CoreFoundation"
+        ]
+    },
     "icu": {
         "source": "icu",
         "cpp-library": true,
-        "static-libs-unix": [
-            "libicui18n.a",
-            "libicuio.a",
-            "libicuuc.a",
-            "libicudata.a"
+        "pkg-configs": [
+            "icu-uc",
+            "icu-i18n",
+            "icu-io"
+        ]
+    },
+    "icu-static-win": {
+        "source": "icu-static-win",
+        "static-libs-windows": [
+            "icudt.lib",
+            "icuin.lib",
+            "icuio.lib",
+            "icuuc.lib"
+        ],
+        "headers-windows": [
+            "unicode"
+        ]
+    },
+    "idn2": {
+        "source": "libidn2",
+        "pkg-configs": [
+            "libidn2"
+        ],
+        "headers": [
+            "idn2.h"
+        ],
+        "lib-suggests-unix": [
+            "libiconv",
+            "gettext",
+            "libunistring"
+        ],
+        "lib-depends-macos": [
+            "libiconv",
+            "gettext"
         ]
     },
     "imagemagick": {
         "source": "imagemagick",
-        "static-libs-unix": [
-            "libMagick++-7.Q16HDRI.a",
-            "libMagickWand-7.Q16HDRI.a",
-            "libMagickCore-7.Q16HDRI.a"
+        "cpp-library": true,
+        "pkg-configs": [
+            "Magick++-7.Q16HDRI",
+            "MagickCore-7.Q16HDRI",
+            "MagickWand-7.Q16HDRI"
         ],
         "lib-depends": [
             "zlib",
-            "libpng",
             "libjpeg",
+            "libjxl",
+            "libpng",
             "libwebp",
-            "freetype"
+            "freetype",
+            "libtiff",
+            "libheif",
+            "bzip2"
         ],
         "lib-suggests": [
             "zstd",
             "xz",
-            "bzip2",
             "libzip",
             "libxml2"
         ]
@@ -150,11 +287,43 @@
             "openssl"
         ]
     },
+    "jbig": {
+        "source": "jbig",
+        "static-libs-unix": [
+            "libjbig.a",
+            "libjbig85.a"
+        ],
+        "headers": [
+            "jbig.h",
+            "jbig85.h",
+            "jbig_ar.h"
+        ]
+    },
+    "krb5": {
+        "source": "krb5",
+        "pkg-configs": [
+            "krb5-gssapi"
+        ],
+        "headers": [
+            "krb5.h",
+            "gssapi/gssapi.h"
+        ],
+        "lib-depends": [
+            "openssl"
+        ],
+        "lib-suggests": [
+            "ldap",
+            "libedit"
+        ],
+        "frameworks": [
+            "Kerberos"
+        ]
+    },
     "ldap": {
         "source": "ldap",
-        "static-libs-unix": [
-            "liblber.a",
-            "libldap.a"
+        "pkg-configs": [
+            "ldap",
+            "lber"
         ],
         "lib-depends": [
             "openssl",
@@ -163,16 +332,57 @@
             "libsodium"
         ]
     },
+    "lerc": {
+        "source": "lerc",
+        "static-libs-unix": [
+            "libLerc.a"
+        ],
+        "cpp-library": true
+    },
+    "libacl": {
+        "source": "libacl",
+        "static-libs-unix": [
+            "libacl.a"
+        ],
+        "lib-depends": [
+            "attr"
+        ]
+    },
+    "libaom": {
+        "source": "libaom",
+        "static-libs-unix": [
+            "libaom.a"
+        ],
+        "static-libs-windows": [
+            "aom.lib"
+        ],
+        "cpp-library": true
+    },
     "libargon2": {
         "source": "libargon2",
         "static-libs-unix": [
             "libargon2.a"
+        ],
+        "lib-suggests": [
+            "libsodium"
         ]
     },
     "libavif": {
         "source": "libavif",
         "static-libs-unix": [
             "libavif.a"
+        ],
+        "static-libs-windows": [
+            "avif.lib"
+        ],
+        "lib-depends": [
+            "libaom"
+        ],
+        "lib-suggests": [
+            "libwebp",
+            "libjpeg",
+            "libxml2",
+            "libpng"
         ]
     },
     "libcares": {
@@ -183,8 +393,23 @@
         "headers-unix": [
             "ares.h",
             "ares_dns.h",
-            "ares_nameser.h",
-            "ares_rules.h"
+            "ares_nameser.h"
+        ]
+    },
+    "libde265": {
+        "source": "libde265",
+        "static-libs-unix": [
+            "libde265.a"
+        ],
+        "cpp-library": true
+    },
+    "libedit": {
+        "source": "libedit",
+        "static-libs-unix": [
+            "libedit.a"
+        ],
+        "lib-depends": [
+            "ncurses"
         ]
     },
     "libevent": {
@@ -217,6 +442,30 @@
             "ffitarget.h"
         ]
     },
+    "libffi-win": {
+        "source": "libffi-win",
+        "static-libs-windows": [
+            "libffi.lib"
+        ],
+        "headers-windows": [
+            "ffi.h",
+            "ffitarget.h",
+            "fficonfig.h"
+        ]
+    },
+    "libheif": {
+        "source": "libheif",
+        "static-libs-unix": [
+            "libheif.a"
+        ],
+        "lib-depends": [
+            "libde265",
+            "libwebp",
+            "libaom",
+            "zlib",
+            "brotli"
+        ]
+    },
     "libiconv": {
         "source": "libiconv",
         "static-libs-unix": [
@@ -229,11 +478,39 @@
             "localcharset.h"
         ]
     },
+    "libiconv-win": {
+        "source": "libiconv-win",
+        "static-libs-windows": [
+            "libiconv.lib",
+            "libiconv_a.lib"
+        ]
+    },
     "libjpeg": {
         "source": "libjpeg",
         "static-libs-unix": [
             "libjpeg.a",
             "libturbojpeg.a"
+        ],
+        "static-libs-windows": [
+            "libjpeg_a.lib"
+        ],
+        "lib-depends": [
+            "zlib"
+        ]
+    },
+    "libjxl": {
+        "source": "libjxl",
+        "pkg-configs": [
+            "libjxl",
+            "libjxl_cms",
+            "libjxl_threads",
+            "libhwy"
+        ],
+        "lib-depends": [
+            "brotli",
+            "libjpeg",
+            "libpng",
+            "libwebp"
         ]
     },
     "liblz4": {
@@ -242,11 +519,24 @@
             "liblz4.a"
         ]
     },
+    "libmaxminddb": {
+        "source": "libmaxminddb",
+        "static-libs-unix": [
+            "libmaxminddb.a"
+        ],
+        "headers": [
+            "maxminddb.h",
+            "maxminddb_config.h"
+        ]
+    },
     "libmemcached": {
         "source": "libmemcached",
+        "cpp-library": true,
         "static-libs-unix": [
             "libmemcached.a",
-            "libmemcachedutil.a"
+            "libmemcachedprotocol.a",
+            "libmemcachedutil.a",
+            "libhashkit.a"
         ]
     },
     "libpng": {
@@ -255,7 +545,8 @@
             "libpng16.a"
         ],
         "static-libs-windows": [
-            "libpng16_static.lib"
+            "libpng16_static.lib",
+            "libpng_a.lib"
         ],
         "headers-unix": [
             "png.h",
@@ -270,10 +561,40 @@
             "zlib"
         ]
     },
+    "librabbitmq": {
+        "source": "librabbitmq",
+        "static-libs-unix": [
+            "librabbitmq.a"
+        ],
+        "static-libs-windows": [
+            "rabbitmq.4.lib"
+        ],
+        "lib-depends": [
+            "openssl"
+        ]
+    },
+    "librdkafka": {
+        "source": "librdkafka",
+        "pkg-configs": [
+            "rdkafka++-static",
+            "rdkafka-static"
+        ],
+        "cpp-library": true,
+        "lib-suggests": [
+            "curl",
+            "liblz4",
+            "openssl",
+            "zlib",
+            "zstd"
+        ]
+    },
     "libsodium": {
         "source": "libsodium",
         "static-libs-unix": [
             "libsodium.a"
+        ],
+        "static-libs-windows": [
+            "libsodium.lib"
         ]
     },
     "libssh2": {
@@ -291,9 +612,57 @@
         ],
         "lib-depends": [
             "openssl"
+        ]
+    },
+    "libtiff": {
+        "source": "libtiff",
+        "static-libs-unix": [
+            "libtiff.a"
         ],
-        "lib-suggests": [
-            "zlib"
+        "lib-depends": [
+            "zlib",
+            "libjpeg"
+        ],
+        "lib-suggests-unix": [
+            "lerc",
+            "libwebp",
+            "jbig",
+            "xz",
+            "zstd"
+        ]
+    },
+    "libunistring": {
+        "source": "libunistring",
+        "static-libs-unix": [
+            "libunistring.a"
+        ],
+        "headers": [
+            "unistr.h",
+            "unistring/"
+        ]
+    },
+    "liburing": {
+        "source": "liburing",
+        "pkg-configs": [
+            "liburing",
+            "liburing-ffi"
+        ],
+        "static-libs-linux": [
+            "liburing.a",
+            "liburing-ffi.a"
+        ],
+        "headers-linux": [
+            "liburing/",
+            "liburing.h"
+        ]
+    },
+    "libuuid": {
+        "source": "libuuid",
+        "static-libs-unix": [
+            "libuuid.a"
+        ],
+        "headers": [
+            "uuid/uuid.h"
         ]
     },
     "libuv": {
@@ -304,34 +673,43 @@
     },
     "libwebp": {
         "source": "libwebp",
-        "static-libs-unix": [
-            "libwebp.a",
-            "libwebpdecoder.a",
-            "libwebpdemux.a",
-            "libwebpmux.a",
-            "libsharpyuv.a"
+        "pkg-configs": [
+            "libwebp",
+            "libwebpdecoder",
+            "libwebpdemux",
+            "libwebpmux",
+            "libsharpyuv"
+        ],
+        "static-libs-windows": [
+            "libwebp.lib",
+            "libwebpdecoder.lib",
+            "libwebpdemux.lib",
+            "libsharpyuv.lib"
         ]
     },
     "libxml2": {
         "source": "libxml2",
-        "static-libs-unix": [
-            "libxml2.a"
+        "pkg-configs": [
+            "libxml-2.0"
         ],
         "static-libs-windows": [
-            [
-                "libxml2s.lib",
-                "libxml2_a.lib"
-            ]
+            "libxml2s.lib",
+            "libxml2_a.lib"
         ],
         "headers": [
             "libxml2"
         ],
-        "lib-depends": [
+        "lib-depends-unix": [
             "libiconv"
         ],
-        "lib-suggests": [
+        "lib-suggests-unix": [
             "xz",
-            "icu",
+            "zlib"
+        ],
+        "lib-depends-windows": [
+            "libiconv-win"
+        ],
+        "lib-suggests-windows": [
             "zlib"
         ]
     },
@@ -363,23 +741,36 @@
             "libzip.a"
         ],
         "static-libs-windows": [
-            [
-                "zip.lib",
-                "libzip_a.lib"
-            ]
+            "zip.lib",
+            "libzip_a.lib"
         ],
         "headers": [
             "zip.h",
             "zipconf.h"
         ],
-        "lib-depends": [
+        "lib-depends-unix": [
             "zlib"
         ],
-        "lib-suggests": [
+        "lib-suggests-unix": [
             "bzip2",
             "xz",
             "zstd",
             "openssl"
+        ],
+        "lib-depends-windows": [
+            "zlib",
+            "bzip2",
+            "xz"
+        ],
+        "lib-suggests-windows": [
+            "zstd",
+            "openssl"
+        ]
+    },
+    "mimalloc": {
+        "source": "mimalloc",
+        "static-libs-unix": [
+            "libmimalloc.a"
         ]
     },
     "ncurses": {
@@ -388,6 +779,17 @@
             "libncurses.a"
         ]
     },
+    "net-snmp": {
+        "source": "net-snmp",
+        "pkg-configs": [
+            "netsnmp",
+            "netsnmp-agent"
+        ],
+        "lib-depends": [
+            "openssl",
+            "zlib"
+        ]
+    },
     "nghttp2": {
         "source": "nghttp2",
         "static-libs-unix": [
@@ -404,7 +806,45 @@
             "openssl"
         ],
         "lib-suggests": [
-            "libxml2"
+            "libxml2",
+            "nghttp3",
+            "ngtcp2"
+        ]
+    },
+    "nghttp3": {
+        "source": "nghttp3",
+        "static-libs-unix": [
+            "libnghttp3.a"
+        ],
+        "static-libs-windows": [
+            "nghttp3.lib"
+        ],
+        "headers": [
+            "nghttp3"
+        ],
+        "lib-depends": [
+            "openssl"
+        ]
+    },
+    "ngtcp2": {
+        "source": "ngtcp2",
+        "static-libs-unix": [
+            "libngtcp2.a",
+            "libngtcp2_crypto_ossl.a"
+        ],
+        "static-libs-windows": [
+            "ngtcp2.lib",
+            "ngtcp2_crypto_ossl.lib"
+        ],
+        "headers": [
+            "ngtcp2"
+        ],
+        "lib-depends": [
+            "openssl"
+        ],
+        "lib-suggests": [
+            "nghttp3",
+            "brotli"
         ]
     },
     "onig": {
@@ -413,10 +853,8 @@
             "libonig.a"
         ],
         "static-libs-windows": [
-            [
-                "onig.lib",
-                "onig_a.lib"
-            ]
+            "onig.lib",
+            "onig_a.lib"
         ],
         "headers": [
             "oniggnu.h",
@@ -425,6 +863,9 @@
     },
     "openssl": {
         "source": "openssl",
+        "pkg-configs": [
+            "openssl"
+        ],
         "static-libs-unix": [
             "libssl.a",
             "libcrypto.a"
@@ -440,22 +881,17 @@
             "zlib"
         ]
     },
-    "pkg-config": {
-        "source": "pkg-config"
-    },
     "postgresql": {
         "source": "postgresql",
-        "static-libs-unix": [
-            "libpq.a",
-            "libpgport.a",
-            "libpgcommon.a"
+        "pkg-configs": [
+            "libpq"
         ],
         "lib-depends": [
             "libiconv",
             "libxml2",
             "openssl",
             "zlib",
-            "readline"
+            "libedit"
         ],
         "lib-suggests": [
             "icu",
@@ -464,6 +900,38 @@
             "zstd"
         ]
     },
+    "postgresql-win": {
+        "source": "postgresql-win",
+        "static-libs": [
+            "libpq.lib",
+            "libpgport.lib",
+            "libpgcommon.lib"
+        ]
+    },
+    "pthreads4w": {
+        "source": "pthreads4w",
+        "static-libs-windows": [
+            "libpthreadVC3.lib"
+        ]
+    },
+    "qdbm": {
+        "source": "qdbm",
+        "static-libs-unix": [
+            "libqdbm.a"
+        ],
+        "static-libs-windows": [
+            "qdbm_a.lib"
+        ],
+        "headers-windows": [
+            "depot.h"
+        ]
+    },
+    "re2c": {
+        "source": "re2c",
+        "bin-unix": [
+            "re2c"
+        ]
+    },
     "readline": {
         "source": "readline",
         "static-libs-unix": [
@@ -475,6 +943,7 @@
     },
     "snappy": {
         "source": "snappy",
+        "cpp-library": true,
         "static-libs-unix": [
             "libsnappy.a"
         ],
@@ -493,7 +962,10 @@
         "static-libs-unix": [
             "libsqlite3.a"
         ],
-        "headers-unix": [
+        "static-libs-windows": [
+            "libsqlite3_a.lib"
+        ],
+        "headers": [
             "sqlite3.h",
             "sqlite3ext.h"
         ]
@@ -506,6 +978,11 @@
     },
     "unixodbc": {
         "source": "unixodbc",
+        "pkg-configs": [
+            "odbc",
+            "odbccr",
+            "odbcinst"
+        ],
         "static-libs-unix": [
             "libodbc.a",
             "libodbccr.a",
@@ -515,16 +992,24 @@
             "libiconv"
         ]
     },
+    "watcher": {
+        "source": "watcher",
+        "cpp-library": true,
+        "static-libs-unix": [
+            "libwatcher-c.a"
+        ],
+        "headers": [
+            "wtr/watcher-c.h"
+        ]
+    },
     "xz": {
         "source": "xz",
         "static-libs-unix": [
             "liblzma.a"
         ],
         "static-libs-windows": [
-            [
-                "liblzma.lib",
-                "liblzma_a.lib"
-            ]
+            "lzma.lib",
+            "liblzma_a.lib"
         ],
         "headers-unix": [
             "lzma"
@@ -533,12 +1018,15 @@
             "lzma",
             "lzma.h"
         ],
-        "lib-depends": [
+        "lib-depends-unix": [
             "libiconv"
         ]
     },
     "zlib": {
         "source": "zlib",
+        "pkg-configs": [
+            "zlib"
+        ],
         "static-libs-unix": [
             "libz.a"
         ],
@@ -552,6 +1040,9 @@
     },
     "zstd": {
         "source": "zstd",
+        "pkg-configs": [
+            "libzstd"
+        ],
         "static-libs-unix": [
             "libzstd.a"
         ],

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