ci: add musl build step

Author: ptondereau

.github/workflows/build.yml

@@ -91,6 +91,7 @@ jobs:
         rust: [stable, nightly]
         clang: ["15", "17"]
         phpts: [ts, nts]
+        target: [gnu, musl]
         exclude:
           # ext-php-rs requires nightly Rust when on Windows.
           - os: windows-latest
@@ -101,11 +102,26 @@ jobs:
             clang: "15"
           - os: windows-latest
             clang: "15"
+          # musl only supported on Linux with stable Rust
+          - os: windows-latest
+            target: musl
+          - os: macos-latest
+            target: musl
+          - target: musl
+            rust: nightly
+          # Skip PHP 8.0 for musl (EOL)
+          - target: musl
+            php: "8.0"
     env:
       CARGO_TERM_COLOR: always
     steps:
       - name: Checkout code
         uses: actions/checkout@v5
+      - name: Install musl toolchain
+        if: matrix.target == 'musl'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y musl-tools musl-dev
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
@@ -118,6 +134,9 @@ jobs:
         with:
           toolchain: ${{ matrix.rust }}
           components: rustfmt, clippy
+      - name: Add musl target
+        if: matrix.target == 'musl'
+        run: rustup target add x86_64-unknown-linux-musl
       - run: rustup show
       - name: Cache cargo dependencies
         uses: Swatinem/rust-cache@v2
@@ -162,13 +181,15 @@ jobs:
       - name: Build
         env:
           EXT_PHP_RS_TEST: ""
-        run: cargo build --release --features closure,anyhow,runtime --workspace
+          RUSTFLAGS: ${{ matrix.target == 'musl' && '-C target-feature=-crt-static' || '' }}
+        run: cargo build --release --features closure,anyhow,runtime --workspace ${{ matrix.target == 'musl' && '--target x86_64-unknown-linux-musl' || '' }}
       # Test
       - name: Test inline examples
         # Macos fails on unstable rust. We skip the inline examples test for now.
         if: "!(contains(matrix.os, 'macos') && matrix.rust == 'nightly')"
-        run: cargo test --release --workspace --features closure,anyhow,runtime --no-fail-fast
-
+        env:
+          RUSTFLAGS: ${{ matrix.target == 'musl' && '-C target-feature=-crt-static' || '' }}
+        run: cargo test --release --workspace --features closure,anyhow,runtime --no-fail-fast ${{ matrix.target == 'musl' && '--target x86_64-unknown-linux-musl' || '' }}
   test-embed:
     name: Test with embed
     runs-on: ubuntu-latest

README.md

@@ -126,6 +126,22 @@ best resource at the moment. This can be viewed at [docs.rs].
     1.57 at the time of writing.
 - Clang 5.0 or later.
 
+### Alpine Linux (musl) Requirements
+
+Building for Alpine Linux (musl libc) is supported on stable Rust with the following
+requirements:
+
+- Install musl toolchain: `sudo apt-get install musl-tools musl-dev`
+- Add musl target: `rustup target add x86_64-unknown-linux-musl`
+- Build with dynamic linking flag:
+  ```bash
+  RUSTFLAGS="-C target-feature=-crt-static" \
+    cargo build --target x86_64-unknown-linux-musl
+  ```
+
+**Note**: Building for musl requires dynamic CRT linking (`-crt-static` flag) to produce
+the `cdylib` output required for PHP extensions.
+
 ### Windows Requirements
 
 - Extensions can only be compiled for PHP installations sourced from

crates/cli/build.rs

@@ -5,4 +5,18 @@
 
 fn main() {
     println!("cargo:rustc-link-arg-bins=-rdynamic");
+
+    // On musl targets, allow undefined symbols for PHP runtime functions
+    // sigsetjmp and PHP symbols will be resolved when the binary runs with PHP loaded
+    #[cfg(target_env = "musl")]
+    {
+        println!("cargo:rustc-link-arg-bins=-Wl,--unresolved-symbols=ignore-all");
+    }
+
+    // On macOS, use dynamic lookup for undefined symbols
+    // This allows PHP symbols to be resolved at runtime
+    #[cfg(target_os = "macos")]
+    {
+        println!("cargo:rustc-link-arg-bins=-Wl,-undefined,dynamic_lookup");
+    }
 }

tests/build.rs

@@ -0,0 +1,8 @@
+fn main() {
+    // On macOS, allow undefined symbols for PHP extensions
+    // PHP symbols will be resolved at runtime when the extension is loaded by PHP
+    #[cfg(target_os = "macos")]
+    {
+        println!("cargo:rustc-link-arg=-Wl,-undefined,dynamic_lookup");
+    }
+}