From bd716144fbbb26562226f908c5c329508d6929ec Mon Sep 17 00:00:00 2001
From: Felix Yeung <19355619+imfelixyeung@users.noreply.github.com>
Date: Fri, 28 Aug 2026 17:31:04 +0100
Subject: [PATCH] feat: add PHPStan stubs for cache and plugin manager classes

---
 .../public/cache/classes/application_cache.stub   |  6 ++++++
 phpstan/stubs/public/cache/classes/cache.stub     | 15 +++++++++++++++
 .../public/cache/classes/loader_interface.stub    |  6 ++++++
 .../classes/loader_with_locking_interface.stub    |  6 ++++++
 .../stubs/public/cache/classes/request_cache.stub |  6 ++++++
 .../stubs/public/cache/classes/session_cache.stub |  6 ++++++
 .../stubs/public/lib/classes/plugin_manager.stub  | 12 ++++++++++++
 .../stubs/public/lib/classes/plugininfo/base.stub |  6 ++++++
 8 files changed, 63 insertions(+)
 create mode 100644 phpstan/stubs/public/cache/classes/application_cache.stub
 create mode 100644 phpstan/stubs/public/cache/classes/cache.stub
 create mode 100644 phpstan/stubs/public/cache/classes/loader_interface.stub
 create mode 100644 phpstan/stubs/public/cache/classes/loader_with_locking_interface.stub
 create mode 100644 phpstan/stubs/public/cache/classes/request_cache.stub
 create mode 100644 phpstan/stubs/public/cache/classes/session_cache.stub
 create mode 100644 phpstan/stubs/public/lib/classes/plugin_manager.stub
 create mode 100644 phpstan/stubs/public/lib/classes/plugininfo/base.stub

diff --git a/phpstan/stubs/public/cache/classes/application_cache.stub b/phpstan/stubs/public/cache/classes/application_cache.stub
new file mode 100644
index 00000000..239448ac
--- /dev/null
+++ b/phpstan/stubs/public/cache/classes/application_cache.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace core_cache;
+
+class application_cache extends cache implements loader_with_locking_interface {
+}
diff --git a/phpstan/stubs/public/cache/classes/cache.stub b/phpstan/stubs/public/cache/classes/cache.stub
new file mode 100644
index 00000000..bb8ad241
--- /dev/null
+++ b/phpstan/stubs/public/cache/classes/cache.stub
@@ -0,0 +1,15 @@
+<?php
+
+namespace core_cache;
+
+class cache implements loader_interface {
+    /**
+     * @param string $component
+     * @param string $area
+     * @param array<mixed> $identifiers
+     * @param string $unused
+     * @return application_cache|session_cache|request_cache
+     */
+    public static function make($component, $area, array $identifiers = [], $unused = null) {
+    }
+}
diff --git a/phpstan/stubs/public/cache/classes/loader_interface.stub b/phpstan/stubs/public/cache/classes/loader_interface.stub
new file mode 100644
index 00000000..87a4051a
--- /dev/null
+++ b/phpstan/stubs/public/cache/classes/loader_interface.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace core_cache;
+
+interface loader_interface {
+}
diff --git a/phpstan/stubs/public/cache/classes/loader_with_locking_interface.stub b/phpstan/stubs/public/cache/classes/loader_with_locking_interface.stub
new file mode 100644
index 00000000..d298f5c7
--- /dev/null
+++ b/phpstan/stubs/public/cache/classes/loader_with_locking_interface.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace core_cache;
+
+interface loader_with_locking_interface {
+}
diff --git a/phpstan/stubs/public/cache/classes/request_cache.stub b/phpstan/stubs/public/cache/classes/request_cache.stub
new file mode 100644
index 00000000..427001f6
--- /dev/null
+++ b/phpstan/stubs/public/cache/classes/request_cache.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace core_cache;
+
+class request_cache extends cache {
+}
diff --git a/phpstan/stubs/public/cache/classes/session_cache.stub b/phpstan/stubs/public/cache/classes/session_cache.stub
new file mode 100644
index 00000000..c62e714f
--- /dev/null
+++ b/phpstan/stubs/public/cache/classes/session_cache.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace core_cache;
+
+class session_cache extends cache {
+}
diff --git a/phpstan/stubs/public/lib/classes/plugin_manager.stub b/phpstan/stubs/public/lib/classes/plugin_manager.stub
new file mode 100644
index 00000000..8300c459
--- /dev/null
+++ b/phpstan/stubs/public/lib/classes/plugin_manager.stub
@@ -0,0 +1,12 @@
+<?php
+
+namespace core;
+
+class plugin_manager {
+    /**
+     * @param string $type
+     * @return class-string<\core\plugininfo\base>
+     */
+    public static function resolve_plugininfo_class($type) {
+    }
+}
diff --git a/phpstan/stubs/public/lib/classes/plugininfo/base.stub b/phpstan/stubs/public/lib/classes/plugininfo/base.stub
new file mode 100644
index 00000000..89b5adec
--- /dev/null
+++ b/phpstan/stubs/public/lib/classes/plugininfo/base.stub
@@ -0,0 +1,6 @@
+<?php
+
+namespace core\plugininfo;
+
+abstract class base {
+}