Add PHP SDK coverage for Apache Iggy

The PHP extension client needs to build independently from the root Rust workspace while still testing against the in-tree Rust SDK. This adds the PHP binding package, Dockerized integration test path, and CI detection so PHP-only changes exercise the right checks.

Constraint: Foreign SDK crates are kept outside the root workspace like the existing Python and C++ SDKs
Constraint: PHP extension builds require php-config, cargo-php, and libclang in containerized CI
Rejected: Leave PHP tests manual only | PHP-only PRs would not run SDK-specific validation
Confidence: medium
Scope-risk: moderate
Directive: Keep foreign/php excluded from the root Cargo workspace unless the extension build is intentionally made workspace-compatible
Tested: cargo fmt --manifest-path foreign/php/Cargo.toml --check; composer validate --working-dir foreign/php --strict; PHP syntax lint for tests; cargo metadata --manifest-path foreign/php/Cargo.toml; docker compose config; docker compose build php-tests; PHP integration smoke against apache/iggy:latest with 23 passed, 3 skipped, 0 failed
Not-tested: Full docker compose test with source-built Iggy server after php-tests image build

Author: countradooku

.github/config/components.yml

@@ -200,6 +200,15 @@ components:
       - "foreign/python/**"
     tasks: ["lint", "test", "build"]
 
+  sdk-php:
+    depends_on:
+      - "rust-sdk" # PHP SDK wraps the Rust SDK
+      - "rust-server" # For integration tests
+      - "ci-infrastructure" # CI changes trigger full regression
+    paths:
+      - "foreign/php/**"
+    tasks: ["build", "test"]
+
   sdk-node:
     depends_on:
       - "rust-sdk" # Node SDK depends on core SDK

.github/workflows/_detect.yml

@@ -26,6 +26,9 @@ on:
       python_matrix:
         description: "Matrix for Python SDK"
         value: ${{ jobs.detect.outputs.python_matrix }}
+      php_matrix:
+        description: "Matrix for PHP SDK"
+        value: ${{ jobs.detect.outputs.php_matrix }}
       node_matrix:
         description: "Matrix for Node SDK"
         value: ${{ jobs.detect.outputs.node_matrix }}
@@ -57,6 +60,7 @@ jobs:
     outputs:
       rust_matrix: ${{ steps.mk.outputs.rust_matrix }}
       python_matrix: ${{ steps.mk.outputs.python_matrix }}
+      php_matrix: ${{ steps.mk.outputs.php_matrix }}
       node_matrix: ${{ steps.mk.outputs.node_matrix }}
       go_matrix: ${{ steps.mk.outputs.go_matrix }}
       java_matrix: ${{ steps.mk.outputs.java_matrix }}
@@ -227,7 +231,7 @@ jobs:
               console.log(`Total files changed: ${files.length}`);
             }
 
-            const groups = { rust:[], python:[], node:[], go:[], java:[], csharp:[], cpp:[], bdd:[], examples:[], other:[] };
+            const groups = { rust:[], python:[], php:[], node:[], go:[], java:[], csharp:[], cpp:[], bdd:[], examples:[], other:[] };
 
             // Process affected components and generate tasks
             console.log('');
@@ -250,6 +254,7 @@ jobs:
 
               if (name === 'rust') groups.rust.push(...entries);
               else if (name === 'sdk-python') groups.python.push(...entries);
+              else if (name === 'sdk-php') groups.php.push(...entries);
               else if (name === 'sdk-node') groups.node.push(...entries);
               else if (name === 'sdk-go') groups.go.push(...entries);
               else if (name === 'sdk-java') groups.java.push(...entries);
@@ -296,6 +301,7 @@ jobs:
               // Clear existing groups to avoid duplicates - we'll run everything anyway
               groups.rust = [];
               groups.python = [];
+              groups.php = [];
               groups.node = [];
               groups.go = [];
               groups.java = [];
@@ -310,6 +316,7 @@ jobs:
                 const entries = cfg.tasks.map(task => ({ component: name, task }));
                 if (name === 'rust') groups.rust.push(...entries);
                 else if (name === 'sdk-python') groups.python.push(...entries);
+                else if (name === 'sdk-php') groups.php.push(...entries);
                 else if (name === 'sdk-node') groups.node.push(...entries);
                 else if (name === 'sdk-go') groups.go.push(...entries);
                 else if (name === 'sdk-java') groups.java.push(...entries);
@@ -346,6 +353,7 @@ jobs:
             const jobSummary = [
               { name: 'Rust', tasks: groups.rust },
               { name: 'Python SDK', tasks: groups.python },
+              { name: 'PHP SDK', tasks: groups.php },
               { name: 'Node SDK', tasks: groups.node },
               { name: 'Go SDK', tasks: groups.go },
               { name: 'Java SDK', tasks: groups.java },
@@ -378,6 +386,7 @@ jobs:
 
             setOutput('rust_matrix', JSON.stringify(matrix(groups.rust)));
             setOutput('python_matrix', JSON.stringify(matrix(groups.python)));
+            setOutput('php_matrix', JSON.stringify(matrix(groups.php)));
             setOutput('node_matrix', JSON.stringify(matrix(groups.node)));
             setOutput('go_matrix', JSON.stringify(matrix(groups.go)));
             setOutput('java_matrix', JSON.stringify(matrix(groups.java)));

.github/workflows/_test.yml

@@ -97,6 +97,23 @@ jobs:
           verbose: true
           override_pr: ${{ github.event.pull_request.number }}
 
+      # PHP SDK
+      - name: Set up Docker Buildx for PHP
+        if: inputs.component == 'sdk-php'
+        uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0
+
+      - name: Run PHP SDK task
+        if: inputs.component == 'sdk-php'
+        run: |
+          if [ "${{ inputs.task }}" = "build" ]; then
+            docker compose -f foreign/php/docker-compose.test.yml build php-tests
+          elif [ "${{ inputs.task }}" = "test" ]; then
+            docker compose -f foreign/php/docker-compose.test.yml up --build --abort-on-container-exit --exit-code-from php-tests
+          else
+            echo "Unknown PHP SDK task: ${{ inputs.task }}"
+            exit 1
+          fi
+
       # Node SDK
       - name: Run Node SDK task
         if: inputs.component == 'sdk-node'

.github/workflows/pre-merge.yml

@@ -78,6 +78,19 @@ jobs:
     secrets:
       CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
+  # PHP SDK
+  test-php:
+    name: PHP • ${{ matrix.task }}
+    needs: detect
+    if: ${{ fromJson(needs.detect.outputs.php_matrix).include[0].component != 'noop' }}
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJson(needs.detect.outputs.php_matrix) }}
+    uses: ./.github/workflows/_test.yml
+    with:
+      component: ${{ matrix.component }}
+      task: ${{ matrix.task }}
+
   # Node SDK
   test-node:
     name: Node • ${{ matrix.task }}
@@ -194,7 +207,7 @@ jobs:
   status:
     name: CI Status
     runs-on: ubuntu-latest
-    needs: [common, detect, test-rust, test-python, test-node, test-go, test-java, test-csharp, test-cpp, test-bdd, test-examples, test-other]
+    needs: [common, detect, test-rust, test-python, test-php, test-node, test-go, test-java, test-csharp, test-cpp, test-bdd, test-examples, test-other]
     if: always()
     steps:
       - name: Get job execution times

Cargo.toml

@@ -61,7 +61,7 @@ members = [
     "core/tools",
     "examples/rust",
 ]
-exclude = ["foreign/cpp", "foreign/python"]
+exclude = ["foreign/cpp", "foreign/php", "foreign/python"]
 resolver = "2"
 
 [workspace.dependencies]

foreign/php/.cargo/config.toml

@@ -0,0 +1,5 @@
+[target.aarch64-apple-darwin]
+rustflags = ["-C", "link-arg=-Wl,-undefined,dynamic_lookup"]
+
+[target.x86_64-apple-darwin]
+rustflags = ["-C", "link-arg=-Wl,-undefined,dynamic_lookup"]

foreign/php/.gitignore

@@ -0,0 +1,4 @@
+/target
+.omx/
+/vendor
+/test-results