From 21f5ce33855a307b87d235dca991fdeccf50b3d8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Viktor=20Sz=C3=A9pe?= <viktor@szepe.net>
Date: Wed, 18 Sep 2024 06:57:20 +0000
Subject: [PATCH] Add wp-compat PHPStan extension Resolves #1535

---
 composer.json     |  3 +-
 composer.lock     | 78 ++++++++++++++++++++++++++++++++++++++++++++++-
 phpstan.neon.dist |  3 ++
 3 files changed, 82 insertions(+), 2 deletions(-)

diff --git a/composer.json b/composer.json
index 28f6548a01..92ca5950f0 100644
--- a/composer.json
+++ b/composer.json
@@ -32,7 +32,8 @@
     "wp-phpunit/wp-phpunit": "^6.5",
     "yoast/phpunit-polyfills": "^2.0",
     "phpstan/php-8-stubs": "^0.3.84",
-    "phpstan/phpstan-strict-rules": "^1.6"
+    "phpstan/phpstan-strict-rules": "^1.6",
+    "johnbillion/wp-compat": "^0.2.1"
   },
   "config": {
     "allow-plugins": {
diff --git a/composer.lock b/composer.lock
index 1cc8367bd4..29a9a94674 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "d718357823681410d46135323910524f",
+    "content-hash": "b607a922148ff7d8c9e5e163e59ccc9d",
     "packages": [],
     "packages-dev": [
         {
@@ -155,6 +155,82 @@
             ],
             "time": "2022-12-30T00:15:36+00:00"
         },
+        {
+            "name": "johnbillion/wp-compat",
+            "version": "0.2.1",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/johnbillion/wp-compat.git",
+                "reference": "580cc09bdadd0922bd9de5d4e02fcc39c2ad342c"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/johnbillion/wp-compat/zipball/580cc09bdadd0922bd9de5d4e02fcc39c2ad342c",
+                "reference": "580cc09bdadd0922bd9de5d4e02fcc39c2ad342c",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">= 7.4",
+                "phpstan/phpstan": "^1.12"
+            },
+            "require-dev": {
+                "dealerdirect/phpcodesniffer-composer-installer": "^0.7.0",
+                "johnbillion/plugin-infrastructure": "dev-trunk",
+                "nikic/php-parser": "^5.1",
+                "php-stubs/wordpress-stubs": "^6.6",
+                "phpstan/phpstan-deprecation-rules": "1.2.0",
+                "phpstan/phpstan-phpunit": "1.3.15",
+                "phpstan/phpstan-strict-rules": "1.6.0",
+                "phpunit/phpunit": "^9.0",
+                "roots/wordpress-core-installer": "1.100.0",
+                "roots/wordpress-full": "dev-main",
+                "wp-coding-standards/wpcs": "3.1.0"
+            },
+            "suggest": {
+                "phpstan/phpstan-deprecation-rules": "PHPStan rules for detecting usage of deprecated symbols",
+                "szepeviktor/phpstan-wordpress": "WordPress extensions for PHPStan"
+            },
+            "type": "phpstan-extension",
+            "extra": {
+                "wordpress-install-dir": "vendor/wordpress/wordpress",
+                "phpstan": {
+                    "includes": [
+                        "extension.neon"
+                    ]
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "WPCompat\\PHPStan\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "John Blackbourn",
+                    "homepage": "https://johnblackbourn.com/"
+                }
+            ],
+            "description": "PHPStan extension to help verify that your PHP code is compatible with a given version of WordPress",
+            "keywords": [
+                "PHPStan",
+                "wordpress"
+            ],
+            "support": {
+                "issues": "https://github.com/johnbillion/wp-compat/issues",
+                "source": "https://github.com/johnbillion/wp-compat"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/sponsors/johnbillion",
+                    "type": "github"
+                }
+            ],
+            "time": "2024-09-09T23:34:34+00:00"
+        },
         {
             "name": "myclabs/deep-copy",
             "version": "1.12.0",
diff --git a/phpstan.neon.dist b/phpstan.neon.dist
index c66cc423a5..e47ad06411 100644
--- a/phpstan.neon.dist
+++ b/phpstan.neon.dist
@@ -1,7 +1,10 @@
 includes:
 	- phar://phpstan.phar/conf/bleedingEdge.neon
+	- vendor/johnbillion/wp-compat/extension.neon
 parameters:
 	level: 8
+	WPCompat:
+		requiresAtLeast: '6.5'
 	treatPhpDocTypesAsCertain: false
 	paths:
 		- plugins