Add reusable GitHub Actions workflows for PHP linting and unit testing

Author: JolienTrog

.github/workflows/php.yml

@@ -0,0 +1,58 @@
+# This file defines a reusable GitHub Actions workflow for PHP projects.
+# It runs linting and unit tests across multiple PHP versions, only running tests if a test directory exists.
+
+name: Jobs
+
+on:
+  workflow_call:
+    inputs:
+      php-version:
+        required: false
+        type: string
+        default: '["8.2", "8.3", "8.4"]'
+
+
+jobs:
+
+  phplint:
+    name: Lint
+    strategy:
+      matrix:
+        php: ${{ fromJson(inputs.php-version) }}
+    uses: icinga/github-actions/.github/workflows/phplint.yml@main
+    with:
+      php-version: ${{ matrix.php }}
+    secrets: inherit
+
+
+  test-exists:
+    runs-on: ubuntu-latest
+    name: test-exists
+    outputs:
+      has-tests: ${{ steps.check.outputs.exists }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Check directory
+        id: check
+        run: |
+          if [ -d "test" ]; then
+            echo "Test directory exists"
+            echo "exists=true" >> $GITHUB_OUTPUT
+          else
+          echo "Test directory does not exist"
+            echo "exists=false" >> $GITHUB_OUTPUT
+          fi
+
+  phpunit:
+    name: Unit Test
+    needs: test-exists
+    if: needs.test-exists.outputs.has-tests == 'true'
+    strategy:
+      matrix:
+        php: ${{ fromJson(inputs.php-version) }}
+    uses: icinga/github-actions/.github/workflows/phpstan.yml
+    with:
+      php-version: ${{ matrix.php }}
+    secrets: inherit

.github/workflows/phplint.yml

@@ -0,0 +1,66 @@
+name: Lint
+
+on:
+  workflow_call:
+    inputs:
+      php-version:
+        type: string
+        required: true
+
+jobs:
+  static-analysis:
+    name: Static analysis for version ${{ inputs.php-version }}
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: '1'
+
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ inputs.php-version }}
+          tools: parallel-lint, phpcs
+
+      - name: Set up dependencies
+        run: |
+          git clone --depth 1 https://github.com/Icinga/icingaweb2.git vendor/icingaweb2
+          git clone --depth 1 -b snapshot/nightly https://github.com/Icinga/icinga-php-library.git vendor/icinga-php-library
+          git clone --depth 1 -b snapshot/nightly https://github.com/Icinga/icinga-php-thirdparty.git vendor/icinga-php-thirdparty
+
+      - name: Install composer
+        if: hashFiles('composer.json') != ''
+        run: |
+          if [ -f composer.json ]; then
+            composer install --no-progress --prefer-dist
+          fi
+
+      - name: Lint
+        run: parallel-lint --exclude vendor .
+
+      - name: Create phpcs.xml
+        if: hashFiles('phpcs.xml') == ''
+        run: |
+          cat <<'EOF' >phpcs.xml
+          <?xml version="1.0"?>
+          <ruleset name="PSR12">
+              <!-- Test all PHP files except those in vendor/ -->
+              <file>./</file>
+              <arg name="extensions" value="php"/>
+              <exclude-pattern>vendor/*</exclude-pattern>
+          
+              <arg name="report-width" value="auto"/>
+              <arg name="report-full"/>
+              <arg name="report-gitblame"/>
+              <arg name="report-summary"/>
+              <arg name="encoding" value="UTF-8"/>
+          
+              <rule ref="PSR12"/>
+          </ruleset>
+          EOF
+
+      - name: Check Code Style
+        run: |
+          phpcs -wps --colors

.github/workflows/phpunit.yml

@@ -0,0 +1,39 @@
+name: PHP Unit Tests
+
+on:
+  workflow_call:
+    inputs:
+      php-version:
+        type: string
+        required: true
+
+jobs:
+    test:
+      name: Unit tests with php ${{ inputs.php-version }}
+      runs-on: ubuntu-latest
+
+      steps:
+        - name: Checkout code base
+          uses: actions/checkout@v4
+
+        - name: Setup PHP
+          uses: shivammathur/setup-php@v2
+          with:
+            php-version: ${{ inputs.php-version }}
+            tools: phpunit
+
+        - name: Set up Icinga Web
+          run: |
+            git clone --depth 1 https://github.com/Icinga/icingaweb2.git _icingaweb2
+            ln -s `pwd` _icingaweb2/modules/icingadb
+
+        - name: Set up Libraries
+          run: |
+            mkdir _libraries
+            git clone --depth 1 -b snapshot/nightly https://github.com/Icinga/icinga-php-library.git _libraries/ipl
+            git clone --depth 1 -b snapshot/nightly https://github.com/Icinga/icinga-php-thirdparty.git _libraries/vendor
+
+        - name: PHPUnit
+          env:
+            ICINGAWEB_LIBDIR: _libraries
+          run: phpunit --bootstrap _icingaweb2/test/php/bootstrap.php