Always use FQCN in docblocks. (#40779)

lucasmichot · web-flow · commit 770ff2c08b20 · 2022-02-03T10:06:04.000+01:00
diff --git a/src/Illuminate/Cache/CacheManager.php b/src/Illuminate/Cache/CacheManager.php
@@ -254,7 +254,7 @@ protected function createDynamodbDriver(array $config)
     /**
      * Create new DynamoDb Client instance.
      *
-     * @return DynamoDbClient
+     * @return \Aws\DynamoDb\DynamoDbClient
      */
     protected function newDynamodbClient(array $config)
     {
diff --git a/src/Illuminate/Cache/DynamoDbStore.php b/src/Illuminate/Cache/DynamoDbStore.php
@@ -529,7 +529,7 @@ public function setPrefix($prefix)
     /**
      * Get the DynamoDb Client instance.
      *
-     * @return DynamoDbClient
+     * @return \Aws\DynamoDb\DynamoDbClient
      */
     public function getClient()
     {
diff --git a/src/Illuminate/Collections/LazyCollection.php b/src/Illuminate/Collections/LazyCollection.php
@@ -797,7 +797,7 @@ public function mergeRecursive($items)
      *
      * @template TCombineValue
      *
-     * @param  IteratorAggregate<array-key, TCombineValue>|array<array-key, TCombineValue>|(callable(): \Generator<array-key, TCombineValue>)  $values
+     * @param  \IteratorAggregate<array-key, TCombineValue>|array<array-key, TCombineValue>|(callable(): \Generator<array-key, TCombineValue>)  $values
      * @return static<TKey, TCombineValue>
      */
     public function combine($values)
@@ -1587,7 +1587,7 @@ public function count(): int
      * @template TIteratorKey of array-key
      * @template TIteratorValue
      *
-     * @param  IteratorAggregate<TIteratorKey, TIteratorValue>|array<TIteratorKey, TIteratorValue>|(callable(): \Generator<TIteratorKey, TIteratorValue>)  $source
+     * @param  \IteratorAggregate<TIteratorKey, TIteratorValue>|array<TIteratorKey, TIteratorValue>|(callable(): \Generator<TIteratorKey, TIteratorValue>)  $source
      * @return \Traversable<TIteratorKey, TIteratorValue>
      */
     protected function makeIterator($source)
diff --git a/src/Illuminate/Database/Eloquent/Concerns/HidesAttributes.php b/src/Illuminate/Database/Eloquent/Concerns/HidesAttributes.php
@@ -2,8 +2,6 @@
 
 namespace Illuminate\Database\Eloquent\Concerns;
 
-use Closure;
-
 trait HidesAttributes
 {
     /**
@@ -88,7 +86,7 @@ public function makeVisible($attributes)
     /**
      * Make the given, typically hidden, attributes visible if the given truth test passes.
      *
-     * @param  bool|Closure  $condition
+     * @param  bool|\Closure  $condition
      * @param  array|string|null  $attributes
      * @return $this
      */
@@ -115,7 +113,7 @@ public function makeHidden($attributes)
     /**
      * Make the given, typically visible, attributes hidden if the given truth test passes.
      *
-     * @param  bool|Closure  $condition
+     * @param  bool|\Closure  $condition
      * @param  array|string|null  $attributes
      * @return $this
      */
diff --git a/src/Illuminate/Database/Eloquent/Model.php b/src/Illuminate/Database/Eloquent/Model.php
@@ -1948,7 +1948,7 @@ protected function resolveChildRouteBindingQuery($childType, $value, $field)
     /**
      * Retrieve the model for a bound value.
      *
-     * @param  \Illuminate\Database\Eloquent\Model|Illuminate\Database\Eloquent\Relations\Relation  $query
+     * @param  \Illuminate\Database\Eloquent\Model|\Illuminate\Database\Eloquent\Relations\Relation  $query
      * @param  mixed  $value
      * @param  string|null  $field
      * @return \Illuminate\Database\Eloquent\Relations\Relation
diff --git a/src/Illuminate/Database/Eloquent/Relations/Concerns/CanBeOneOfMany.php b/src/Illuminate/Database/Eloquent/Relations/Concerns/CanBeOneOfMany.php
@@ -60,7 +60,7 @@ abstract public function addOneOfManyJoinSubQueryConstraints(JoinClause $join);
      * Indicate that the relation is a single result of a larger one-to-many relationship.
      *
      * @param  string|array|null  $column
-     * @param  string|Closure|null  $aggregate
+     * @param  string|\Closure|null  $aggregate
      * @param  string|null  $relation
      * @return $this
      *
diff --git a/src/Illuminate/Filesystem/AwsS3V3Adapter.php b/src/Illuminate/Filesystem/AwsS3V3Adapter.php
@@ -11,7 +11,7 @@ class AwsS3V3Adapter extends FilesystemAdapter
     /**
      * The AWS S3 client.
      *
-     * @var S3Client
+     * @var \Aws\S3\S3Client
      */
     protected $client;
 
diff --git a/src/Illuminate/Log/Logger.php b/src/Illuminate/Log/Logger.php
@@ -49,7 +49,7 @@ public function __construct(LoggerInterface $logger, Dispatcher $dispatcher = nu
     /**
      * Log an emergency message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -61,7 +61,7 @@ public function emergency($message, array $context = []): void
     /**
      * Log an alert message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -73,7 +73,7 @@ public function alert($message, array $context = []): void
     /**
      * Log a critical message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -85,7 +85,7 @@ public function critical($message, array $context = []): void
     /**
      * Log an error message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -97,7 +97,7 @@ public function error($message, array $context = []): void
     /**
      * Log a warning message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -109,7 +109,7 @@ public function warning($message, array $context = []): void
     /**
      * Log a notice to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -121,7 +121,7 @@ public function notice($message, array $context = []): void
     /**
      * Log an informational message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -133,7 +133,7 @@ public function info($message, array $context = []): void
     /**
      * Log a debug message to the logs.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -146,7 +146,7 @@ public function debug($message, array $context = []): void
      * Log a message to the logs.
      *
      * @param  string  $level
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -159,7 +159,7 @@ public function log($level, $message, array $context = []): void
      * Dynamically pass log calls into the writer.
      *
      * @param  string  $level
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -172,7 +172,7 @@ public function write($level, $message, array $context = []): void
      * Write a message to the log.
      *
      * @param  string  $level
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @param  array  $context
      * @return void
      */
@@ -249,7 +249,7 @@ protected function fireLogEvent($level, $message, array $context = [])
     /**
      * Format the parameters for the logger.
      *
-     * @param  Arrayable|Jsonable|\Stringable|array|string  $message
+     * @param  \Illuminate\Contracts\Support\Arrayable|\Illuminate\Contracts\Support\Jsonable|\Illuminate\Support\Stringable|array|string  $message
      * @return string
      */
     protected function formatMessage($message)
diff --git a/tests/Integration/Database/EloquentModelCustomCastingTest.php b/tests/Integration/Database/EloquentModelCustomCastingTest.php
@@ -156,7 +156,7 @@ class AddressCast implements CastsAttributes
      * @param  string  $key
      * @param  mixed  $value
      * @param  array  $attributes
-     * @return AddressModel
+     * @return \Illuminate\Tests\Integration\Database\AddressModel
      */
     public function get($model, $key, $value, $attributes)
     {
diff --git a/tests/Integration/Http/Fixtures/PostResourceWithAnonymousResourceCollectionWithPaginationInformation.php b/tests/Integration/Http/Fixtures/PostResourceWithAnonymousResourceCollectionWithPaginationInformation.php
@@ -15,7 +15,7 @@ public function toArray($request)
      * Create a new anonymous resource collection.
      *
      * @param  mixed  $resource
-     * @return AnonymousResourceCollectionWithPaginationInformation
+     * @return \Illuminate\Tests\Integration\Http\Fixtures\AnonymousResourceCollectionWithPaginationInformation
      */
     public static function collection($resource)
     {
diff --git a/tests/Integration/Migration/MigratorTest.php b/tests/Integration/Migration/MigratorTest.php
@@ -4,14 +4,13 @@
 
 use Illuminate\Support\Facades\DB;
 use Mockery;
-use Mockery\Mock;
 use Orchestra\Testbench\TestCase;
 use Symfony\Component\Console\Output\OutputInterface;
 
 class MigratorTest extends TestCase
 {
     /**
-     * @var Mock
+     * @var \Mockery\Mock
      */
     private $output;
 
diff --git a/tests/Queue/QueueBeanstalkdQueueTest.php b/tests/Queue/QueueBeanstalkdQueueTest.php
@@ -14,12 +14,12 @@
 class QueueBeanstalkdQueueTest extends TestCase
 {
     /**
-     * @var BeanstalkdQueue
+     * @var \Illuminate\Queue\BeanstalkdQueue
      */
     private $queue;
 
     /**
-     * @var Container|m\LegacyMockInterface|m\MockInterface
+     * @var \Illuminate\Container\Container|\Mockery\LegacyMockInterface|\Mockery\MockInterface
      */
     private $container;
 

Original file line number	Diff line number	Diff line change
`@@ -254,7 +254,7 @@ protected function createDynamodbDriver(array $config)`
`254`	`254`	`/**`
`255`	`255`	`* Create new DynamoDb Client instance.`
`256`	`256`	`*`
`257`		`- * @return DynamoDbClient`
	`257`	`+ * @return \Aws\DynamoDb\DynamoDbClient`
`258`	`258`	`*/`
`259`	`259`	`protected function newDynamodbClient(array $config)`
`260`	`260`	`{`
Original file line number	Diff line number	Diff line change
`@@ -529,7 +529,7 @@ public function setPrefix($prefix)`
`529`	`529`	`/**`
`530`	`530`	`* Get the DynamoDb Client instance.`
`531`	`531`	`*`
`532`		`- * @return DynamoDbClient`
	`532`	`+ * @return \Aws\DynamoDb\DynamoDbClient`
`533`	`533`	`*/`
`534`	`534`	`public function getClient()`
`535`	`535`	`{`
Original file line number	Diff line number	Diff line change
`@@ -797,7 +797,7 @@ public function mergeRecursive($items)`
`797`	`797`	`*`
`798`	`798`	`* @template TCombineValue`
`799`	`799`	`*`
`800`		`- * @param IteratorAggregate<array-key, TCombineValue>\|array<array-key, TCombineValue>\|(callable(): \Generator<array-key, TCombineValue>) $values`
	`800`	`+ * @param \IteratorAggregate<array-key, TCombineValue>\|array<array-key, TCombineValue>\|(callable(): \Generator<array-key, TCombineValue>) $values`
`801`	`801`	`* @return static<TKey, TCombineValue>`
`802`	`802`	`*/`
`803`	`803`	`public function combine($values)`
`@@ -1587,7 +1587,7 @@ public function count(): int`
`1587`	`1587`	`* @template TIteratorKey of array-key`
`1588`	`1588`	`* @template TIteratorValue`
`1589`	`1589`	`*`
`1590`		`- * @param IteratorAggregate<TIteratorKey, TIteratorValue>\|array<TIteratorKey, TIteratorValue>\|(callable(): \Generator<TIteratorKey, TIteratorValue>) $source`
	`1590`	`+ * @param \IteratorAggregate<TIteratorKey, TIteratorValue>\|array<TIteratorKey, TIteratorValue>\|(callable(): \Generator<TIteratorKey, TIteratorValue>) $source`
`1591`	`1591`	`* @return \Traversable<TIteratorKey, TIteratorValue>`
`1592`	`1592`	`*/`
`1593`	`1593`	`protected function makeIterator($source)`
Original file line number	Diff line number	Diff line change
`@@ -1948,7 +1948,7 @@ protected function resolveChildRouteBindingQuery($childType, $value, $field)`
`1948`	`1948`	`/**`
`1949`	`1949`	`* Retrieve the model for a bound value.`
`1950`	`1950`	`*`
`1951`		`- * @param \Illuminate\Database\Eloquent\Model\|Illuminate\Database\Eloquent\Relations\Relation $query`
	`1951`	`+ * @param \Illuminate\Database\Eloquent\Model\|\Illuminate\Database\Eloquent\Relations\Relation $query`
`1952`	`1952`	`* @param mixed $value`
`1953`	`1953`	`* @param string\|null $field`
`1954`	`1954`	`* @return \Illuminate\Database\Eloquent\Relations\Relation`
Original file line number	Diff line number	Diff line change
`@@ -60,7 +60,7 @@ abstract public function addOneOfManyJoinSubQueryConstraints(JoinClause $join);`
`60`	`60`	`* Indicate that the relation is a single result of a larger one-to-many relationship.`
`61`	`61`	`*`
`62`	`62`	`* @param string\|array\|null $column`
`63`		`- * @param string\|Closure\|null $aggregate`
	`63`	`+ * @param string\|\Closure\|null $aggregate`
`64`	`64`	`* @param string\|null $relation`
`65`	`65`	`* @return $this`
`66`	`66`	`*`
Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@ class AwsS3V3Adapter extends FilesystemAdapter`
`11`	`11`	`/**`
`12`	`12`	`* The AWS S3 client.`
`13`	`13`	`*`
`14`		`- * @var S3Client`
	`14`	`+ * @var \Aws\S3\S3Client`
`15`	`15`	`*/`
`16`	`16`	`protected $client;`
`17`	`17`
Original file line number	Diff line number	Diff line change
`@@ -156,7 +156,7 @@ class AddressCast implements CastsAttributes`
`156`	`156`	`* @param string $key`
`157`	`157`	`* @param mixed $value`
`158`	`158`	`* @param array $attributes`
`159`		`- * @return AddressModel`
	`159`	`+ * @return \Illuminate\Tests\Integration\Database\AddressModel`
`160`	`160`	`*/`
`161`	`161`	`public function get($model, $key, $value, $attributes)`
`162`	`162`	`{`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@ public function toArray($request)`
`15`	`15`	`* Create a new anonymous resource collection.`
`16`	`16`	`*`
`17`	`17`	`* @param mixed $resource`
`18`		`- * @return AnonymousResourceCollectionWithPaginationInformation`
	`18`	`+ * @return \Illuminate\Tests\Integration\Http\Fixtures\AnonymousResourceCollectionWithPaginationInformation`
`19`	`19`	`*/`
`20`	`20`	`public static function collection($resource)`
`21`	`21`	`{`