ctrl-c.yml

name: Ctrl+C signal delivery (macOS + Linux)

# Reproduction CI for YanGusik/laravel-spawn#8: first Ctrl+C did not stop
# the dev server on macOS. Builds php-src (true-async) + ext/async +
# http_server with ccache, then runs tests/ctrl-c/run.sh — SIGINT/SIGTERM
# delivered to the process group (terminal-style) and to the PID directly,
# with pcntl-interaction and open-connection cases.
#
# Bugs found by this harness (03-pcntl-after hang, 04-pcntl-before SEGV,
# identical on macOS and Linux) are fixed by the #109 pair: php-src
# 109-zend-sigaction-hook (zend_sigaction delegates to the reactor) +
# php-async fix-signal-pcntl-clobber — all scenarios are expected green.

on:
  workflow_dispatch:
  pull_request:
    paths:
      - 'tests/ctrl-c/**'
      - '.github/workflows/ctrl-c.yml'

env:
  # TODO: back to `true-async` / `main` after the #109 sigaction-hook pair merges
  # (php-src 109-zend-sigaction-hook + php-async fix-signal-pcntl-clobber).
  PHP_SRC_BRANCH: 109-zend-sigaction-hook
  PHP_ASYNC_BRANCH: fix-signal-pcntl-clobber
  CCACHE_DIR: /tmp/ccache

jobs:
  # --------------------------------------------------------------------
  # macOS — the platform the issue was reported on.
  # --------------------------------------------------------------------
  ctrl-c-macos:
    name: "CTRLC_MACOS_ARM64"
    runs-on: macos-14
    timeout-minutes: 60

    steps:
      - name: Checkout http_server
        uses: actions/checkout@v5
        with:
          path: http-server

      - name: Clone php-src (true-async) + ext/async
        run: |
          git clone --depth=1 --branch="$PHP_SRC_BRANCH" \
            https://github.com/true-async/php-src php-src
          git clone --depth=1 --branch="$PHP_ASYNC_BRANCH" \
            https://github.com/true-async/php-async php-src/ext/async

      - name: Resolve source SHAs for ccache key
        id: shas
        run: |
          echo "php_src=$(git -C php-src rev-parse --short HEAD)" >> "$GITHUB_OUTPUT"
          echo "php_async=$(git -C php-src/ext/async rev-parse --short HEAD)" >> "$GITHUB_OUTPUT"

      - name: Restore ccache
        uses: actions/cache@v5
        with:
          path: /tmp/ccache
          key: ctrlc-ccache-macos14-${{ steps.shas.outputs.php_src }}-${{ steps.shas.outputs.php_async }}
          restore-keys: |
            ctrlc-ccache-macos14-

      - name: Install build dependencies (Homebrew)
        run: |
          set -x
          brew update >/dev/null
          formula_installer="$(brew --repo)"/Library/Homebrew/formula_installer.rb
          code=" keg.link\(verbose: verbose\?"
          sudo sed -Ei '' "s/$code.*/$code, overwrite: true\)/" "$formula_installer"

          brew reinstall autoconf libsodium icu4c curl openssl@3
          brew install bison re2c nghttp2 libuv libxml2 libiconv ccache

      - name: Configure PHP base
        working-directory: php-src
        run: |
          set -x
          BREW_OPT="$(brew --prefix)/opt"
          export PATH="$BREW_OPT/bison/bin:$PATH"
          export PKG_CONFIG_PATH="$BREW_OPT/openssl@3/lib/pkgconfig:$BREW_OPT/curl/lib/pkgconfig:$BREW_OPT/libxml2/lib/pkgconfig:$BREW_OPT/icu4c/lib/pkgconfig:$BREW_OPT/libuv/lib/pkgconfig:$BREW_OPT/nghttp2/lib/pkgconfig:${PKG_CONFIG_PATH:-}"
          sed -i -e 's/Requires.private:.*//g' "$BREW_OPT/curl/lib/pkgconfig/libcurl.pc"

          ./buildconf --force
          ./configure \
            CC="ccache clang" \
            --prefix=/usr/local \
            --disable-all \
            --without-pear \
            --enable-async \
            --enable-pdo \
            --with-pdo-mysql=mysqlnd \
            --with-pdo-sqlite \
            --enable-sockets \
            --enable-posix \
            --enable-pcntl \
            --enable-opcache \
            --with-openssl \
            --with-config-file-path=/etc \
            --with-config-file-scan-dir=/etc/php.d \
            --disable-debug \
            --enable-zts

      - name: Build & install PHP base
        working-directory: php-src
        run: |
          export PATH="$(brew --prefix)/opt/bison/bin:$PATH"
          make -j"$(sysctl -n hw.logicalcpu)" >/dev/null
          sudo make install
          sudo mkdir -p /etc/php.d
          echo "opcache.enable_cli=1" | sudo tee /etc/php.d/opcache.ini
          ccache -s || true

      - name: phpize + build http_server
        working-directory: http-server
        run: |
          set -x
          BREW_OPT="$(brew --prefix)/opt"
          export PKG_CONFIG_PATH="$BREW_OPT/openssl@3/lib/pkgconfig:$BREW_OPT/nghttp2/lib/pkgconfig:$BREW_OPT/libuv/lib/pkgconfig:${PKG_CONFIG_PATH:-}"
          /usr/local/bin/phpize
          ./configure \
            CC="ccache clang" \
            --with-php-config=/usr/local/bin/php-config \
            --enable-http-server \
            --enable-http2 \
            --disable-http3 \
            --with-openssl \
            --with-nghttp2="$BREW_OPT/nghttp2"
          make -j"$(sysctl -n hw.logicalcpu)"
          sudo make install
          echo "extension=true_async_server.so" | sudo tee /etc/php.d/true_async_server.ini
          ccache -s || true

      - name: Show PHP info
        run: |
          /usr/local/bin/php -v
          /usr/local/bin/php -m | grep -iE 'async|pcntl|sockets|server' || true
          /usr/local/bin/php -i | grep -i 'zend signal' || true

      - name: Run Ctrl+C harness
        working-directory: http-server
        run: bash tests/ctrl-c/run.sh /usr/local/bin/php

  # --------------------------------------------------------------------
  # Linux baseline — same harness on the platform where the issue was
  # reported as "not reproducible". Uses distro packages (libuv 1.48
  # satisfies the >= 1.45 floor) instead of the source-built stack.
  # --------------------------------------------------------------------
  ctrl-c-linux:
    name: "CTRLC_LINUX_X64"
    runs-on: ubuntu-24.04
    timeout-minutes: 60

    steps:
      - name: Checkout http_server
        uses: actions/checkout@v5
        with:
          path: http-server

      - name: Clone php-src (true-async) + ext/async
        run: |
          git clone --depth=1 --branch="$PHP_SRC_BRANCH" \
            https://github.com/true-async/php-src php-src
          git clone --depth=1 --branch="$PHP_ASYNC_BRANCH" \
            https://github.com/true-async/php-async php-src/ext/async

      - name: Resolve source SHAs for ccache key
        id: shas
        run: |
          echo "php_src=$(git -C php-src rev-parse --short HEAD)" >> "$GITHUB_OUTPUT"
          echo "php_async=$(git -C php-src/ext/async rev-parse --short HEAD)" >> "$GITHUB_OUTPUT"

      - name: Restore ccache
        uses: actions/cache@v5
        with:
          path: /tmp/ccache
          key: ctrlc-ccache-ubuntu24-${{ steps.shas.outputs.php_src }}-${{ steps.shas.outputs.php_async }}
          restore-keys: |
            ctrlc-ccache-ubuntu24-

      - name: Install build dependencies (apt)
        run: |
          set -eux
          sudo apt-get update -y
          sudo apt-get install -y --no-install-recommends \
            autoconf bison build-essential re2c pkg-config ccache \
            libxml2-dev libssl-dev libsqlite3-dev \
            libuv1-dev libnghttp2-dev

      - name: Configure & build PHP base
        working-directory: php-src
        run: |
          set -eux
          ./buildconf --force
          ./configure \
            CC="ccache gcc" \
            --prefix=/usr/local \
            --disable-all \
            --without-pear \
            --enable-async \
            --enable-pdo \
            --with-pdo-sqlite \
            --enable-sockets \
            --enable-posix \
            --enable-pcntl \
            --enable-opcache \
            --with-openssl \
            --with-config-file-path=/etc \
            --with-config-file-scan-dir=/etc/php.d \
            --disable-debug \
            --enable-zts
          make -j"$(nproc)" >/dev/null
          sudo make install
          sudo mkdir -p /etc/php.d
          echo "opcache.enable_cli=1" | sudo tee /etc/php.d/opcache.ini
          ccache -s || true

      - name: phpize + build http_server
        working-directory: http-server
        run: |
          set -eux
          /usr/local/bin/phpize
          ./configure \
            CC="ccache gcc" \
            --with-php-config=/usr/local/bin/php-config \
            --enable-http-server \
            --enable-http2 \
            --disable-http3 \
            --with-openssl \
            --with-nghttp2=/usr
          make -j"$(nproc)"
          sudo make install
          echo "extension=true_async_server.so" | sudo tee /etc/php.d/true_async_server.ini
          ccache -s || true

      - name: Show PHP info
        run: |
          /usr/local/bin/php -v
          /usr/local/bin/php -m | grep -iE 'async|pcntl|sockets|server' || true
          /usr/local/bin/php -i | grep -i 'zend signal' || true

      - name: Run Ctrl+C harness
        working-directory: http-server
        run: bash tests/ctrl-c/run.sh /usr/local/bin/php