Build static macOS PHP CLI binaries

.github/workflows/build-php-cli-binaries.yml

@@ -0,0 +1,190 @@
+name: Build PHP CLI Binaries
+
+on:
+  workflow_dispatch:
+    inputs:
+      php_version:
+        description: PHP patch version to build
+        required: true
+        default: 8.4.20
+      spc_ref:
+        description: static-php-cli ref
+        required: true
+        default: 2.8.5
+      prefer_pre_built:
+        description: Prefer pre-built static-php-cli libraries
+        required: true
+        type: boolean
+        default: true
+      debug:
+        description: Enable static-php-cli debug logs
+        required: true
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+env:
+  GITHUB_TOKEN: ${{ github.token }}
+
+jobs:
+  build:
+    name: Build ${{ matrix.target }}
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 240
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - target: macos-aarch64
+            runner: macos-15
+            artifact_platform: macos
+            artifact_arch: aarch64
+            archive_extension: tar.gz
+            binary_name: php
+            extensions: &macos_php_extensions apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,ftp,gd,gettext,iconv,igbinary,imagick,intl,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,readline,redis,session,shmop,simplexml,sockets,sodium,sqlite3,ssh2,tokenizer,xml,xmlreader,xmlwriter,xsl,yaml,zip,zlib
+          - target: macos-x86_64
+            runner: macos-15-intel
+            artifact_platform: macos
+            artifact_arch: x86_64
+            archive_extension: tar.gz
+            binary_name: php
+            extensions: *macos_php_extensions
+          - target: windows-x86_64
+            runner: windows-latest
+            artifact_platform: windows
+            artifact_arch: x86_64
+            archive_extension: zip
+            binary_name: php.exe
+            # static-php-cli 2.8.5 has Windows builders for intl and sodium, but not gettext/libxslt.
+            extensions: apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,ftp,gd,iconv,igbinary,intl,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pdo,pdo_mysql,pdo_sqlite,phar,redis,session,shmop,simplexml,sockets,sodium,sqlite3,ssh2,tokenizer,xml,xmlreader,xmlwriter,yaml,zip,zlib
+    env:
+      PHP_VERSION: ${{ github.event_name == 'workflow_dispatch' && inputs.php_version || '8.4.20' }}
+      SPC_REF: ${{ github.event_name == 'workflow_dispatch' && inputs.spc_ref || '2.8.5' }}
+      PHP_CLI_EXTENSIONS: ${{ matrix.extensions }}
+      PHP_CLI_ARTIFACT_PLATFORM: ${{ matrix.artifact_platform }}
+      PHP_CLI_ARTIFACT_ARCH: ${{ matrix.artifact_arch }}
+      PHP_CLI_ARCHIVE_EXTENSION: ${{ matrix.archive_extension }}
+      PHP_CLI_BINARY_NAME: ${{ matrix.binary_name }}
+      PREFER_PRE_BUILT: ${{ github.event_name != 'workflow_dispatch' || inputs.prefer_pre_built }}
+      SPC_DEBUG: ${{ github.event_name == 'workflow_dispatch' && inputs.debug || false }}
+
+    steps:
+      - name: Checkout Studio
+        uses: actions/checkout@v6
+
+      - name: Checkout static-php-cli
+        uses: actions/checkout@v6
+        with:
+          repository: crazywhalecc/static-php-cli
+          ref: ${{ env.SPC_REF }}
+          path: .cache/static-php-cli
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          coverage: none
+          tools: composer:v2
+          php-version: 8.4
+          ini-values: memory_limit=-1
+          extensions: curl, openssl, mbstring
+        env:
+          phpts: nts
+
+      - name: Install static-php-cli dependencies
+        working-directory: .cache/static-php-cli
+        run: composer install --no-dev --no-interaction --prefer-dist --classmap-authoritative
+
+      - name: Build PHP CLI on macOS
+        if: runner.os == 'macOS'
+        working-directory: .cache/static-php-cli
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          download_args=(--with-php="$PHP_VERSION" --for-extensions="$PHP_CLI_EXTENSIONS" --ignore-cache-sources=php-src)
+          build_args=("$PHP_CLI_EXTENSIONS" --build-cli)
+
+          if [ "$PREFER_PRE_BUILT" = "true" ]; then
+            download_args+=(--prefer-pre-built)
+          fi
+
+          if [ "$SPC_DEBUG" = "true" ]; then
+            download_args+=(--debug)
+            build_args+=(--debug)
+          fi
+
+          php bin/spc doctor --auto-fix
+          php bin/spc download "${download_args[@]}"
+          php bin/spc build "${build_args[@]}"
+
+      - name: Build PHP CLI on Windows
+        if: runner.os == 'Windows'
+        working-directory: .cache/static-php-cli
+        shell: pwsh
+        run: |
+          $downloadArgs = @(
+            "--with-php=$env:PHP_VERSION",
+            "--for-extensions=$env:PHP_CLI_EXTENSIONS",
+            "--ignore-cache-sources=php-src"
+          )
+          $buildArgs = @( $env:PHP_CLI_EXTENSIONS, "--build-cli" )
+
+          if ( $env:PREFER_PRE_BUILT -eq "true" ) {
+            $downloadArgs += "--prefer-pre-built"
+          }
+
+          if ( $env:SPC_DEBUG -eq "true" ) {
+            $downloadArgs += "--debug"
+            $buildArgs += "--debug"
+          }
+
+          php bin/spc doctor --auto-fix
+          php bin/spc download @downloadArgs
+          php bin/spc build @buildArgs
+
+      - name: Package macOS artifact
+        if: runner.os == 'macOS'
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          out_dir="$GITHUB_WORKSPACE/out/php-binaries"
+          artifact="php-${PHP_VERSION}-cli-${PHP_CLI_ARTIFACT_PLATFORM}-${PHP_CLI_ARTIFACT_ARCH}.${PHP_CLI_ARCHIVE_EXTENSION}"
+
+          mkdir -p "$out_dir"
+          cp "$GITHUB_WORKSPACE/.cache/static-php-cli/buildroot/bin/$PHP_CLI_BINARY_NAME" "$RUNNER_TEMP/php"
+          chmod +x "$RUNNER_TEMP/php"
+          xattr -cr "$RUNNER_TEMP/php"
+          tar -czf "$out_dir/$artifact" -C "$RUNNER_TEMP" php
+          shasum -a 256 "$out_dir/$artifact" | awk '{print $1}' > "$out_dir/$artifact.sha256"
+
+      - name: Package Windows artifact
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $outDir = Join-Path $env:GITHUB_WORKSPACE 'out/php-binaries'
+          $artifact = "php-$env:PHP_VERSION-cli-$env:PHP_CLI_ARTIFACT_PLATFORM-$env:PHP_CLI_ARTIFACT_ARCH.$env:PHP_CLI_ARCHIVE_EXTENSION"
+          $source = Join-Path $env:GITHUB_WORKSPACE ".cache/static-php-cli/buildroot/bin/$env:PHP_CLI_BINARY_NAME"
+          $dest = Join-Path $env:RUNNER_TEMP $env:PHP_CLI_BINARY_NAME
+          $archive = Join-Path $outDir $artifact
+
+          New-Item -ItemType Directory -Force $outDir | Out-Null
+          Copy-Item -Force $source $dest
+          Compress-Archive -Force -Path $dest -DestinationPath $archive
+          (Get-FileHash $archive -Algorithm SHA256).Hash.ToLower() | Set-Content -NoNewline "$archive.sha256"
+
+      - name: Upload PHP CLI artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: php-${{ env.PHP_VERSION }}-cli-${{ matrix.target }}
+          path: out/php-binaries/*
+
+      - name: Upload static-php-cli logs
+        if: ${{ failure() }}
+        uses: actions/upload-artifact@v4
+        with:
+          name: spc-logs-${{ matrix.target }}
+          path: .cache/static-php-cli/log/*.log
+          if-no-files-found: ignore

docs/design-docs/native-php-binaries.md

@@ -0,0 +1,28 @@
+# Native PHP Binaries
+
+Use the manual `Build PHP CLI Binaries` GitHub Actions workflow to build Studio
+PHP CLI artifacts. The workflow checks out `crazywhalecc/static-php-cli`, pins
+the requested SPC ref, passes Studio's extension list directly to `spc download`
+and `spc build`, then uploads archives with `.sha256` sidecars.
+
+The manual workflow currently builds:
+
+- `php-8.4.20-cli-macos-aarch64.tar.gz`
+- `php-8.4.20-cli-macos-x86_64.tar.gz`
+- `php-8.4.20-cli-windows-x86_64.zip`
+
+Windows ARM64 Studio builds use the Windows x64 PHP binary under Windows 11
+emulation. Native Windows ARM64 PHP binaries are not built.
+
+The `.sha256` sidecars are used to verify downloaded artifacts. When these
+artifacts are published to the Apps CDN, copy those checksums into
+`tools/common/lib/php-binary-metadata.ts`.
+Before publishing macOS artifacts, sign and notarize the `php` binary with the
+existing Studio Developer ID setup.
+
+Regular Studio app builds upload to the Apps CDN through `fastlane/Fastfile`:
+`upload_file_to_apps_cdn` wraps `upload_build_to_apps_cdn` from
+`fastlane-plugin-wpmreleasetoolkit`. That path requires `WPCOM_API_TOKEN`, the
+Studio Apps CDN site ID, build metadata, and a file path. CDN upload for PHP
+binary artifacts should be added separately after the manual GitHub Actions
+builds are proven.