Merge branch 'OpenMage:main' into main

.ddev/commands/web/phpcs

@@ -4,4 +4,4 @@
 ## Usage: phpcs
 ## Example: ddev phpcs <path-to-files>
 
-php vendor/bin/phpcs -s -p --report=full,summary "$@"
+php vendor/bin/phpcs -s -p --standard=.phpcs.dist.xml --cache=.phpcs.result.cache --report=full,summary "$@"

.ddev/commands/web/phpmd

@@ -4,4 +4,4 @@
 ## Usage: phpmd
 ## Example: ddev phpmd <path-to-files>
 
-php vendor/bin/phpmd "$@" text .phpmd.dist.xml
+php vendor/bin/phpmd "$@" text .phpmd.dist.xml --color --cache --baseline-file .phpmd.dist.baseline.xml

.ddev/commands/web/phpmd-no-baseline

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+## Description: run PHPMD
+## Usage: phpmd-no-baseline
+## Example: ddev phpmd-no-baseline <path-to-files>
+
+php vendor/bin/phpmd "$@" text .phpmd.dist.xml

.ddev/commands/web/phpunit

@@ -4,4 +4,4 @@
 ## Usage: phpunit
 ## Example: ddev phpunit
 
-php vendor/bin/phpunit --no-coverage "$@" --testdox
+php vendor/bin/phpunit --configuration .phpunit.dist.xml --no-coverage "$@" --testdox

.ddev/commands/web/phpunit-coverage

@@ -5,5 +5,5 @@
 ## Example: ddev phpunit-coverage
 
 enable_xdebug
-XDEBUG_MODE=coverage php vendor/bin/phpunit "$@" --testdox
+XDEBUG_MODE=coverage php vendor/bin/phpunit --configuration .phpunit.dist.xml --testdox "$@"
 disable_xdebug

.ddev/commands/web/phpunit-coverage-local

@@ -5,5 +5,5 @@
 ## Example: ddev phpunit-coverage-local
 
 enable_xdebug
-XDEBUG_MODE=coverage php vendor/bin/phpunit --coverage-html build/coverage "$@" --testdox
+XDEBUG_MODE=coverage php vendor/bin/phpunit --configuration .phpunit.dist.xml --coverage-html build/coverage --testdox "$@"
 disable_xdebug

.ddev/commands/web/rector

@@ -4,4 +4,4 @@
 ## Usage: rector
 ## Example: ddev rector <path-to-files>
 
-php vendor/bin/rector process "$@"
+php vendor/bin/rector process --config .rector.php "$@"

.gitattributes

@@ -3,6 +3,7 @@
 /.github export-ignore
 /dev export-ignore
 /docs export-ignore
+/docs_includes export-ignore
 /tests export-ignore
 
 /.all-contributorsrc export-ignore
@@ -14,10 +15,11 @@
 /.phpcs.ecg.xml.dist export-ignore
 /.phpcs.php.xml.dist export-ignore
 /.phpcs.xml.dist export-ignore
+/.phpmd.dist.baseline.xml export-ignore
 /.phpmd.dist.xml export-ignore
 /.phpstan.dist.baseline.neon export-ignore
 /.phpstan.dist.neon export-ignore
-/rector.php export-ignore
+/.rector.php export-ignore
 
 /README.md export-ignore
 
@@ -35,4 +37,4 @@
 *.sql text eol=lf
 *.svg text eol=lf
 *.txt text eol=lf
-*.phtml text eol=lf
+*.phtml text eol=lf

.github/labeler.yml

@@ -884,18 +884,24 @@
       .github/workflows/php-cs-fixer.yml
     ]
 
+'phpmd':
+  - changed-files:
+    - any-glob-to-any-file: [
+      .phpmd*,
+      .github/workflows/phpmd.yml
+    ]
+
 'phpstan':
   - changed-files:
     - any-glob-to-any-file: [
       .phpstan*,
-      phpstan*,
       .github/workflows/phpstan.yml
     ]
 
 'phpunit':
   - changed-files:
     - any-glob-to-any-file: [
-      phpunit*,
+      .phpunit*,
       tests/*,
       .github/workflows/phpunit.yml
     ]
@@ -910,6 +916,6 @@
 'rector':
   - changed-files:
       - any-glob-to-any-file: [
-        rector.php,
+        .rector.php,
         .github/workflows/rector.yml
       ]

.github/workflows/check-files.yml

@@ -27,6 +27,9 @@ on:
       php-cs-fixer:
         description: "Count changed PHP-CS-Fixer files"
         value: ${{ jobs.check.outputs.php-cs-fixer }}
+      phpmd:
+        description: "Count changed PHPMD files"
+        value: ${{ jobs.check.outputs.phpmd }}
       phpstan:
         description: "Count changed PHPStan files"
         value: ${{ jobs.check.outputs.phpstan }}
@@ -52,6 +55,7 @@ jobs:
       workflow: ${{ steps.changes-workflow.outputs.workflow }}
       phpcs: ${{ steps.changes-phpcs.outputs.phpcs }}
       php-cs-fixer: ${{ steps.changes-php-cs-fixer.outputs.php-cs-fixer }}
+      phpmd: ${{ steps.changes-phpstan.outputs.phpmd }}
       phpstan: ${{ steps.changes-phpstan.outputs.phpstan }}
       phpunit-test: ${{ steps.changes-phpunit-test.outputs.phpunit-test }}
       phpunit: ${{ steps.changes-phpunit.outputs.phpunit }}
@@ -87,8 +91,9 @@ jobs:
             .github/workflows/**
             **phpcs**
             **php-cs-fixer**
+            **phpmd**
             **phpstan**
-            rector.php
+            .rector.php
             tests/
             phpunit*
 
@@ -158,6 +163,14 @@ jobs:
           echo "$count PHP-CS-Fixer file(s) changed"
           echo "php-cs-fixer=$count" >> $GITHUB_OUTPUT
 
+      - name: Check if PHPMD files changed
+        id: changes-phpmd
+        if: steps.changed-files-specific.outputs.any_modified == 'true'
+        run: |
+          count="$(grep -oE "**phpmd**" <<< "${{ steps.changed-files-specific.outputs.all_modified_files }}" | wc -l)"
+          echo "$count PHPMD file(s) changed"
+          echo "phpmd=$count" >> $GITHUB_OUTPUT
+
       - name: Check if PHPStan files changed
         id: changes-phpstan
         if: steps.changed-files-specific.outputs.any_modified == 'true'
@@ -178,6 +191,6 @@ jobs:
         id: changes-phpunit
         if: steps.changed-files-specific.outputs.any_modified == 'true'
         run: |
-          count="$(grep -oE "phpunit*" <<< "${{ steps.changed-files-specific.outputs.all_modified_files }}" | wc -l)"
+          count="$(grep -oE "**phpunit**" <<< "${{ steps.changed-files-specific.outputs.all_modified_files }}" | wc -l)"
           echo "$count PHPUnit file(s) changed"
           echo "phpunit=$count" >> $GITHUB_OUTPUT

.github/workflows/docs.yml

@@ -0,0 +1,39 @@
+name: MkDocs
+
+on:
+  workflow_call:
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+  push:
+    branches:
+      - main
+      - documentation
+    paths:
+      - 'docs/**.md'
+      - 'docs/**.html'
+      - 'docs/**.yml'
+      - 'docs_includes/**.md'
+      - 'mkdocs.yml'
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v4
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
+
+      - uses: actions/cache@v3
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache
+          restore-keys: |
+            mkdocs-material-
+      - run: pip3 install mkdocs mkdocs-material mkdocs-minify-plugin mkdocs-redirects
+
+      - name: Publish docs
+        run: mkdocs gh-deploy --force

.github/workflows/phpcs.yml

@@ -14,11 +14,11 @@ jobs:
       matrix:
         rules:
           - label: Default
-            path: .phpcs.xml.dist
+            path: .phpcs.dist.xml
           - label: Ecg
-            path: .phpcs.ecg.xml.dist
+            path: .phpcs.dist.ecg.xml
           - label: PhpCompatibility
-            path: .phpcs.php.xml.dist
+            path: .phpcs.dist.php.xml
 
     steps:
       - name: Setup PHP
@@ -44,4 +44,4 @@ jobs:
         run: composer install --prefer-dist --no-progress --ignore-platform-req=ext-*
 
       - name: PHPCodeSniffer
-        run: php vendor/bin/phpcs -s --report=full --standard=${{ matrix.rules.path }}
+        run: php vendor/bin/phpcs -s -p --report=full --standard=${{ matrix.rules.path }}

.github/workflows/phpmd.yml

@@ -0,0 +1,32 @@
+name: PHPMD
+
+on:
+  workflow_call:
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+jobs:
+  phpcs:
+    name: Mess Detector
+    runs-on: [ubuntu-latest]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Get composer cache directory
+        id: composer-cache
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+      - name: Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ steps.composer-cache.outputs.dir }}
+          key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+          restore-keys: ${{ runner.os }}-composer-
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress --ignore-platform-req=ext-*
+
+      - name: PHPMD
+        run: php vendor/bin/phpmd app/code/core/Mage/ github .phpmd.dist.xml --baseline-file .phpmd.dist.baseline.xml

.github/workflows/phpstan.yml

@@ -37,19 +37,19 @@ jobs:
         run: composer install --prefer-dist --no-progress --ignore-platform-req=ext-*
 
       - name: Restore result cache
-        uses: actions/cache/restore@v3
+        uses: actions/cache/restore@v4
         with:
           path: .phpstan.cache
-          key: "phpstan-result-cache-${{ github.run_id }}"
+          key: phpstan-result-cache-${{ matrix.php-versions }}-${{ github.run_id }}
           restore-keys: |
             phpstan-result-cache-
 
       - name: PHPStan Static Analysis
         run: XDEBUG_MODE=off php vendor/bin/phpstan.phar analyze
 
       - name: Save result cache
-        uses: actions/cache/save@v3
+        uses: actions/cache/save@v4
         if: always()
         with:
           path: .phpstan.cache
-          key: "phpstan-result-cache-${{ github.run_id }}"
+          key: phpstan-result-cache-${{ matrix.php-versions }}-${{ github.run_id }}

.github/workflows/phpunit.yml

@@ -87,7 +87,7 @@ jobs:
           --skip_url_validation 'yes'
 
       - name: Run phpUnit
-        run: php -f vendor/bin/phpunit
+        run: php vendor/bin/phpunit --configuration .phpunit.dist.xml
 
       - name: Publish Unit Test Results
         uses: EnricoMi/publish-unit-test-result-action@v2

.github/workflows/rector.yml

@@ -34,4 +34,4 @@ jobs:
         run: composer install --prefer-dist --no-progress --ignore-platform-req=ext-*
 
       - name: Rector
-        run: php vendor/bin/rector process --dry-run
+        run: php vendor/bin/rector process --config .rector.php --dry-run

.github/workflows/release.yml

@@ -13,7 +13,7 @@ jobs:
         php-versions: ['7.4']
     steps:
     - name: Checkout repository
-      uses: actions/checkout@master
+      uses: actions/checkout@4
 
     - name: Get composer cache directory
       id: composer-cache

.github/workflows/workflow.yml

@@ -11,11 +11,11 @@ on:
       - '**.js'
       - '**.xml'
       - '.php-cs-fixer.dist.php'
-      - '.phpcs.xml.dist'
-      - '.phpcs.ecg.xml.dist'
-      - '.phpcs.php.xml.dist'
-      - 'phpstan.dist.neon'
-      - 'phpstan.dist.baseline.neon'
+      - '.phpcs.dist.xml'
+      - '.phpcs.dist.ecg.xml'
+      - '.phpcs.dist.php.xml'
+      - '.phpstan.dist.neon'
+      - '.phpstan.dist.baseline.neon'
 
   pull_request:
     paths:
@@ -27,11 +27,11 @@ on:
       - '**.js'
       - '**.xml'
       - '.php-cs-fixer.dist.php'
-      - '.phpcs.xml.dist'
-      - '.phpcs.ecg.xml.dist'
-      - '.phpcs.php.xml.dist'
-      - 'phpstan.dist.neon'
-      - 'phpstan.dist.baseline.neon'
+      - '.phpcs.dist.xml'
+      - '.phpcs.dist.ecg.xml'
+      - '.phpcs.dist.php.xml'
+      - '.phpstan.dist.neon'
+      - '.phpstan.dist.baseline.neon'
 
 jobs:
   debug:
@@ -84,6 +84,16 @@ jobs:
       needs.check.outputs.workflow > 0
     uses: ./.github/workflows/php-cs-fixer.yml
 
+  phpmd:
+    name: PHPMD
+    needs: [check, composer]
+    if: |
+      needs.check.outputs.php > 0 ||
+      needs.check.outputs.phpmd > 0 ||
+      needs.check.outputs.composer > 0 ||
+      needs.check.outputs.workflow > 0
+    uses: ./.github/workflows/phpmd.yml
+
   phpstan:
     name: PHPStan
     needs: [check, composer]

.gitignore

@@ -60,8 +60,15 @@
 .php-cs-fixer*
 !.php-cs-fixer.dist.*
 
+# PHPCS cache
+.phpcs.result.cache
 .phpcs*.xml
-!.phpcs*.xml.dist
+!.phpcs.dist*.xml
+!.phpcs.xml
+phpcs.xml
+
+# PHPMD cache
+.phpmd.result-cache.php
 
 # PhpStan
 .phpstan.cache
@@ -75,7 +82,7 @@ tests/coverage
 tests/logging
 .phpunit.result.cache
 phpunit.xml
-!phpunit.xml.dist
+!.phpunit.dist.xml
 
 # build
 /build
@@ -84,6 +91,9 @@ phpunit.xml
 /shell/update-copyright.php
 /shell/translations.php
 
+# generated by mkdocs serve
+/site
+
 # DDEV
 .ddev/config.yaml
 .ddev/.sampleData