fix: Require @template-implements or @implements for `IteratorIte…

…mTypeSniff`, remove `@template-extends`

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to `phpcs-type-sniff` will be documented in this file.
 
 Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
 
+## 81.6.4 - 2024-05-24
+### Changed
+- Require `@template-implements` or `@implements` for `IteratorItemTypeSniff`, remove `@template-extends`
+
 ## 81.6.3 - 2024-05-24
 ### Fixed
 - Parse implemented interfaces using token instead of reflection, to avoid FatalError. Used in IteratorItemTypeSniff

src/Sniffs/CodeElement/IteratorItemTypeSniff.php

@@ -56,13 +56,13 @@ public function process(File $file, CodeElementInterface $element, CodeElementIn
 
         if ($element->getDocBlock()->getTagsByName('template-implements')) {
             return;
-        } elseif ($element->getDocBlock()->getTagsByName('template-extends')) {
+        } elseif ($element->getDocBlock()->getTagsByName('implements')) {
             return;
         } else {
             $originId = $this->addViolationId ? $element->getFqcn() : null;
             SniffHelper::addViolation(
                 $file,
-                'Classes which implement IteratorAggregate must have "@template-implements IteratorAggregate<?>"'
+                'Classes which implement IteratorAggregate must have "@implements IteratorAggregate<?>" or "@template-implements ..."'
                 . ' doc tag with a specified item type or template type',
                 $element->getLine(),
                 static::CODE,

tests/Sniffs/CompositeCodeElementSniffTest.php

@@ -574,7 +574,7 @@ public static function dataProcess(): array
             ],
             __DIR__ . '/fixtures/TestIterator0.php',
             [
-                '009 Classes which implement IteratorAggregate must have "@template-implements IteratorAggregate<?>" doc tag with a specified item type or template type'
+                '009 Classes which implement IteratorAggregate must have "@implements IteratorAggregate<?>" or "@template-implements ..." doc tag with a specified item type or template type'
             ],
         ];