Migrate from PHPStan to Mago for static code analysis

CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com), and this project adheres to [Semantic Versioning](https://semver.org).
 
+## [Unreleased]
+### Added
+* *Nothing*
+
+### Changed
+* Migrate from PHPStan to Mago for static code analysis.
+
+### Deprecated
+* *Nothing*
+
+### Removed
+* *Nothing*
+
+### Fixed
+* *Nothing*
+
+
 ## [9.0.1] - 2026-06-14
 ### Added
 * *Nothing*

composer.json

@@ -42,11 +42,9 @@
         "laminas/laminas-stratigility": "^4.3",
         "mezzio/mezzio-problem-details": "^1.19",
         "pagerfanta/core": "^3.8",
-        "phpstan/phpstan": "^2.1",
-        "phpstan/phpstan-phpunit": "^2.0",
         "phpunit/phpunit": "^13.0",
         "psr/simple-cache": "^3.0",
-        "shlinkio/shlink-mago-config": "^1.0",
+        "shlinkio/shlink-mago-config": "^1.1",
         "symfony/string": "^8.0",
         "symfony/var-dumper": "^8.0"
     },
@@ -71,7 +69,7 @@
     "scripts": {
         "ci": [
             "@cs",
-            "@stan",
+            "@analyze",
             "@test:ci"
         ],
         "lint": "mago lint",
@@ -80,7 +78,8 @@
         "format:check": "mago format --check",
         "cs": ["@lint", "@format:check"],
         "cs:fix": ["@lint:fix", "@format"],
-        "stan": "phpstan analyse",
+        "analyze": "mago analyze",
+        "stan": "@analyze",
         "test": "phpunit --order-by=random --testdox --testdox-summary",
         "test:ci": "XDEBUG_MODE=coverage composer test -- --coverage-clover=build/clover.xml",
         "test:pretty": "XDEBUG_MODE=coverage composer test -- --coverage-html=build/coverage-html"
@@ -89,7 +88,7 @@
         "ci": "<fg=blue;options=bold>Alias for \"cs\", \"stan\" and \"test:ci\"</>",
         "cs": "<fg=blue;options=bold>Checks coding styles</>",
         "cs:fix": "<fg=blue;options=bold>Fixes coding styles, when possible</>",
-        "stan": "<fg=blue;options=bold>Inspects code with phpstan</>",
+        "analyze": "<fg=blue;options=bold>Inspects code with Mago analyze</>",
         "test": "<fg=blue;options=bold>Runs unit tests with no coverage reports</>",
         "test:ci": "<fg=blue;options=bold>Runs unit tests generating coverage reports and logs</>",
         "test:pretty": "<fg=blue;options=bold>Runs unit tests generating coverage reports in html</>"

functions/functions.php

@@ -27,7 +27,8 @@ function buildDateRange(Chronos|null $startDate, Chronos|null $endDate): DateRan
  */
 function parseOrderBy(string $orderBy): array
 {
-    return array_pad(explode('-', $orderBy), 2, null); // @phpstan-ignore-line
+    // @mago-expect analysis:invalid-return-statement
+    return array_pad(explode('-', $orderBy), 2, null);
 }
 
 /**