From 21422a91d25ff2b6ef08cf7a91e9cd4b32fa7a5d Mon Sep 17 00:00:00 2001
From: Kayw <weikaiii@sina.cn>
Date: Thu, 13 Mar 2025 09:52:41 +0800
Subject: [PATCH] Enhance PHPDoc for Manager classes with `@param-closure-this`

---
 src/Illuminate/Cache/CacheManager.php              |  3 +++
 src/Illuminate/Log/LogManager.php                  |  3 +++
 src/Illuminate/Redis/RedisManager.php              |  3 +++
 src/Illuminate/Support/MultipleInstanceManager.php |  3 +++
 types/Managers/CacheManager.php                    | 13 +++++++++++++
 types/Managers/ConcurrencyManager.php              | 13 +++++++++++++
 types/Managers/LogManager.php                      | 13 +++++++++++++
 types/Managers/RedisManager.php                    | 13 +++++++++++++
 8 files changed, 64 insertions(+)
 create mode 100644 types/Managers/CacheManager.php
 create mode 100644 types/Managers/ConcurrencyManager.php
 create mode 100644 types/Managers/LogManager.php
 create mode 100644 types/Managers/RedisManager.php

diff --git a/src/Illuminate/Cache/CacheManager.php b/src/Illuminate/Cache/CacheManager.php
index 6f15b122b2a4..a17405c2ab42 100755
--- a/src/Illuminate/Cache/CacheManager.php
+++ b/src/Illuminate/Cache/CacheManager.php
@@ -419,6 +419,9 @@ public function purge($name = null)
      *
      * @param  string  $driver
      * @param  \Closure  $callback
+     *
+     * @param-closure-this  $this  $callback
+     *
      * @return $this
      */
     public function extend($driver, Closure $callback)
diff --git a/src/Illuminate/Log/LogManager.php b/src/Illuminate/Log/LogManager.php
index 840cdd65dd5e..d8f48c06b44f 100644
--- a/src/Illuminate/Log/LogManager.php
+++ b/src/Illuminate/Log/LogManager.php
@@ -587,6 +587,9 @@ public function setDefaultDriver($name)
      *
      * @param  string  $driver
      * @param  \Closure  $callback
+     *
+     * @param-closure-this  $this  $callback
+     *
      * @return $this
      */
     public function extend($driver, Closure $callback)
diff --git a/src/Illuminate/Redis/RedisManager.php b/src/Illuminate/Redis/RedisManager.php
index f1c7d4e917c3..4c4f3b876623 100644
--- a/src/Illuminate/Redis/RedisManager.php
+++ b/src/Illuminate/Redis/RedisManager.php
@@ -255,6 +255,9 @@ public function purge($name = null)
      *
      * @param  string  $driver
      * @param  \Closure  $callback
+     *
+     * @param-closure-this  $this  $callback
+     *
      * @return $this
      */
     public function extend($driver, Closure $callback)
diff --git a/src/Illuminate/Support/MultipleInstanceManager.php b/src/Illuminate/Support/MultipleInstanceManager.php
index 05a8c23b4135..5706bde1e234 100644
--- a/src/Illuminate/Support/MultipleInstanceManager.php
+++ b/src/Illuminate/Support/MultipleInstanceManager.php
@@ -192,6 +192,9 @@ public function purge($name = null)
      *
      * @param  string  $name
      * @param  \Closure  $callback
+     *
+     * @param-closure-this  $this  $callback
+     *
      * @return $this
      */
     public function extend($name, Closure $callback)
diff --git a/types/Managers/CacheManager.php b/types/Managers/CacheManager.php
new file mode 100644
index 000000000000..47521e110349
--- /dev/null
+++ b/types/Managers/CacheManager.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Cache\CacheManager;
+
+use function PHPStan\Testing\assertType;
+
+$cacheManager = resolve(CacheManager::class);
+
+$cacheManager->extend('redis', function (): void {
+    assertType('Illuminate\Cache\CacheManager', $this);
+});
diff --git a/types/Managers/ConcurrencyManager.php b/types/Managers/ConcurrencyManager.php
new file mode 100644
index 000000000000..d745b77ca0f7
--- /dev/null
+++ b/types/Managers/ConcurrencyManager.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Concurrency\ConcurrencyManager;
+
+use function PHPStan\Testing\assertType;
+
+$concurrencyManager = resolve(ConcurrencyManager::class);
+
+$concurrencyManager->extend('custom', function (): void {
+    assertType('Illuminate\Concurrency\ConcurrencyManager', $this);
+});
diff --git a/types/Managers/LogManager.php b/types/Managers/LogManager.php
new file mode 100644
index 000000000000..45da40dfa3dc
--- /dev/null
+++ b/types/Managers/LogManager.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Log\LogManager;
+
+use function PHPStan\Testing\assertType;
+
+$logManager = resolve(LogManager::class);
+
+$logManager->extend('emergency', function (): void {
+    assertType('Illuminate\Log\LogManager', $this);
+});
diff --git a/types/Managers/RedisManager.php b/types/Managers/RedisManager.php
new file mode 100644
index 000000000000..8b38200762c0
--- /dev/null
+++ b/types/Managers/RedisManager.php
@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Redis\RedisManager;
+
+use function PHPStan\Testing\assertType;
+
+$redisManager = resolve(RedisManager::class);
+
+$redisManager->extend('custom', function (): void {
+    assertType('Illuminate\Redis\RedisManager', $this);
+});