ci: run PHP test only if something related changed

.github/changes-filters.yml

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
+# SPDX-License-Identifier: MIT
+backend:
+  - '.github/workflows/**'
+  - 'appinfo/**'
+  - 'lib/**'
+  - 'templates/**'
+  - 'tests/php/**'
+  - 'vendor/**'
+  - 'vendor-bin/**'
+  - 'composer/**'
+  - 'composer.json'
+  - 'composer.lock'
+  - 'phpunit.integration.xml'
+  - 'phpunit.unit'
+  - '.php-cs-fixer.dist.php'
+  - 'psalm.xml'

.github/workflows/lint-php-cs.yml

@@ -18,8 +18,29 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  changes:
+    runs-on: ubuntu-latest-low
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      backend: ${{ steps.changes.outputs.backend }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 1
+          sparse-checkout: .github/changes-filters.yml
+          sparse-checkout-cone-mode: false
+      - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
+        id: changes
+        continue-on-error: true
+        with:
+          filters: .github/changes-filters.yml
+
   lint:
     runs-on: ubuntu-latest
+    needs: changes
+    if: needs.changes.outputs.backend != 'false'
 
     name: php-cs
 
@@ -50,3 +71,17 @@ jobs:
 
       - name: Lint
         run: composer run cs:check || ( echo 'Please run `composer run cs:fix` to format your code' && exit 1 )
+
+  summary:
+    permissions:
+      contents: none
+    runs-on: ubuntu-latest-low
+    needs: lint
+
+    if: always()
+
+    name: php-cs-lint-summary
+
+    steps:
+      - name: Summary status
+        run: if ${{ needs.lint.result != 'success' && needs.lint.result != 'skipped' }}; then exit 1; fi

.github/workflows/lint-php.yml

@@ -18,8 +18,29 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  changes:
+    runs-on: ubuntu-latest-low
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      backend: ${{ steps.changes.outputs.backend }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 1
+          sparse-checkout: .github/changes-filters.yml
+          sparse-checkout-cone-mode: false
+      - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
+        id: changes
+        continue-on-error: true
+        with:
+          filters: .github/changes-filters.yml
+
   matrix:
     runs-on: ubuntu-latest-low
+    needs: changes
+    if: needs.changes.outputs.backend != 'false'
     outputs:
       php-min: ${{ steps.versions.outputs.php-min }}
       php-max: ${{ steps.versions.outputs.php-max }}

.github/workflows/php-test.yml

@@ -4,8 +4,29 @@ name: PHP Tests
 on: pull_request
 
 jobs:
+  changes:
+    runs-on: ubuntu-latest-low
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      backend: ${{ steps.changes.outputs.backend }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 1
+          sparse-checkout: .github/changes-filters.yml
+          sparse-checkout-cone-mode: false
+      - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
+        id: changes
+        continue-on-error: true
+        with:
+          filters: .github/changes-filters.yml
+
   unit-tests:
     runs-on: ubuntu-latest
+    needs: changes
+    if: needs.changes.outputs.backend != 'false'
     strategy:
       matrix:
         php-versions: [ '8.3', '8.4', '8.5' ]
@@ -55,6 +76,8 @@ jobs:
 
   integration-tests:
     runs-on: ubuntu-latest
+    needs: changes
+    if: needs.changes.outputs.backend != 'false'
     strategy:
       matrix:
         php-versions: [ '8.3', '8.4', '8.5' ]
@@ -96,7 +119,7 @@ jobs:
         run: composer run test:integration
 
   summary:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-low
     needs:
       - unit-tests
       - integration-tests

.github/workflows/psalm-matrix.yml

@@ -18,8 +18,29 @@ permissions:
   contents: read
 
 jobs:
+  changes:
+    runs-on: ubuntu-latest-low
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      backend: ${{ steps.changes.outputs.backend }}
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
+        with:
+          fetch-depth: 1
+          sparse-checkout: .github/changes-filters.yml
+          sparse-checkout-cone-mode: false
+      - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
+        id: changes
+        continue-on-error: true
+        with:
+          filters: .github/changes-filters.yml
+
   matrix:
     runs-on: ubuntu-latest-low
+    needs: changes
+    if: needs.changes.outputs.backend != 'false'
     outputs:
       ocp-matrix: ${{ steps.versions.outputs.ocp-matrix }}
     steps:
@@ -86,4 +107,4 @@ jobs:
 
     steps:
       - name: Summary status
-        run: if ${{ needs.static-analysis.result != 'success' }}; then exit 1; fi
+        run: if ${{ needs.static-analysis.result != 'success' && needs.static-analysis.result != 'skipped' }}; then exit 1; fi