ci.yml

name: CI

on:
  push:
    branches:
      - master
      - develop
      - stage
  pull_request:
  workflow_dispatch:
  schedule:
    # Weekly run to catch breakage from new PHP / dependency releases.
    - cron: '0 6 * * 1'

permissions:
  contents: read

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

jobs:
  tests:
    name: PHP ${{ matrix.php }}${{ matrix.deps == 'lowest' && ' (lowest deps)' || '' }}
    runs-on: ubuntu-latest

    strategy:
      fail-fast: false
      matrix:
        php: ['8.1', '8.2', '8.3', '8.4', '8.5']
        deps: ['highest']
        include:
          # Also verify the project still works against its minimum dependencies.
          - php: '8.1'
            deps: 'lowest'

    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: ${{ matrix.php }}
          extensions: soap, curl, libxml, openssl, mbstring
          coverage: xdebug
          ini-values: error_reporting=E_ALL, display_errors=On

      - name: Validate composer.json
        run: composer validate --strict

      - name: Install dependencies
        run: >
          composer update --no-interaction --no-progress --prefer-dist
          ${{ matrix.deps == 'lowest' && '--prefer-lowest --prefer-stable' || '--prefer-stable' }}

      - name: Lint (php syntax)
        run: composer lint

      - name: Coding standards (PSR-2)
        run: composer check-style

      - name: Static analysis (PHPStan)
        run: composer stan

      - name: Tests (hermetic + TLS)
        run: vendor/bin/phpunit --coverage-clover=coverage.xml --colors=never

      - name: Upload coverage to Codecov
        if: matrix.php == '8.3' && matrix.deps == 'highest'
        uses: codecov/codecov-action@v7
        with:
          files: coverage.xml
          fail_ci_if_error: false
        env:
          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}