minor #49122 Add cache contracts template annotations (jack-worman)

This PR was merged into the 6.3 branch.

Discussion
----------

Add cache contracts template annotations

| Q             | A
| ------------- | ---
| Branch?       | 6.3
| Bug fix?      | no
| New feature?  | no
| Deprecations? | no
| Tickets       |
| License       | MIT
| Doc PR        |

Add template annotations so static analysis tool can better understand the code.

Commits
-------

2460efeb1a Add cache contracts template annotations

Author: nicolas-grekas

Cache/CacheInterface.php

@@ -29,14 +29,18 @@ interface CacheInterface
      * requested key, that could be used e.g. for expiration control. It could also
      * be an ItemInterface instance when its additional features are needed.
      *
-     * @param string                     $key       The key of the item to retrieve from the cache
-     * @param callable|CallbackInterface $callback  Should return the computed value for the given key/item
-     * @param float|null                 $beta      A float that, as it grows, controls the likeliness of triggering
-     *                                              early expiration. 0 disables it, INF forces immediate expiration.
-     *                                              The default (or providing null) is implementation dependent but should
-     *                                              typically be 1.0, which should provide optimal stampede protection.
-     *                                              See https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
-     * @param array                      &$metadata The metadata of the cached item {@see ItemInterface::getMetadata()}
+     * @template T
+     *
+     * @param string $key The key of the item to retrieve from the cache
+     * @param (callable(CacheItemInterface,bool):T)|(callable(ItemInterface,bool):T)|CallbackInterface<T> $callback
+     * @param float|null $beta      A float that, as it grows, controls the likeliness of triggering
+     *                              early expiration. 0 disables it, INF forces immediate expiration.
+     *                              The default (or providing null) is implementation dependent but should
+     *                              typically be 1.0, which should provide optimal stampede protection.
+     *                              See https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
+     * @param array      &$metadata The metadata of the cached item {@see ItemInterface::getMetadata()}
+     *
+     * @return T
      *
      * @throws InvalidArgumentException When $key is not valid or when $beta is negative
      */

Cache/CallbackInterface.php

@@ -17,14 +17,16 @@
  * Computes and returns the cached value of an item.
  *
  * @author Nicolas Grekas <[email protected]>
+ *
+ * @template T
  */
 interface CallbackInterface
 {
     /**
      * @param CacheItemInterface|ItemInterface $item  The item to compute the value for
      * @param bool                             &$save Should be set to false when the value should not be saved in the pool
      *
-     * @return mixed The computed value for the passed item
+     * @return T The computed value for the passed item
      */
     public function __invoke(CacheItemInterface $item, bool &$save): mixed;
 }