[DI] deprecates tag !tagged in favor of !tagged_iterator

UPGRADE-4.4.md

@@ -24,6 +24,27 @@ DependencyInjection
      my_service:
        factory: ['@factory_service', method]
    ```
+ * Deprecated `tagged` in favor of `tagged_iterator`
+
+   Before:
+   ```yaml
+   services:
+       App\Handler:
+           tags: ['app.handler']
+   
+       App\HandlerCollection:
+           arguments: [!tagged app.handler]
+   ```
+
+   After:
+   ```yaml
+   services:
+       App\Handler:
+       tags: ['app.handler']
+    
+   App\HandlerCollection:
+       arguments: [!tagged_iterator app.handler]
+   ```
 
 MonologBridge
 --------------

UPGRADE-5.0.md

@@ -84,6 +84,27 @@ DependencyInjection
      my_service:
        factory: ['@factory_service', method]
    ```
+ * Removed `tagged` in favor of `tagged_iterator`
+
+   Before:
+   ```yaml
+   services:
+       App\Handler:
+            tags: ['app.handler']
+
+        App\HandlerCollection:
+            arguments: [!tagged app.handler]
+   ```
+
+   After:
+   ```yaml
+   services:
+       App\Handler:
+           tags: ['app.handler']
+ 
+       App\HandlerCollection:
+           arguments: [!tagged_iterator app.handler]
+   ```
 
 DoctrineBridge
 --------------

src/Symfony/Bundle/FrameworkBundle/Resources/config/messenger.xml

@@ -61,7 +61,7 @@
 
         <!-- transports -->
         <service id="messenger.transport_factory" class="Symfony\Component\Messenger\Transport\TransportFactory">
-            <argument type="tagged" tag="messenger.transport_factory" />
+            <argument type="tagged_iterator" tag="messenger.transport_factory" />
         </service>
 
         <service id="messenger.transport.amqp.factory" class="Symfony\Component\Messenger\Transport\AmqpExt\AmqpTransportFactory">

src/Symfony/Bundle/FrameworkBundle/Resources/config/services.xml

@@ -70,13 +70,13 @@
         <service id="Symfony\Component\HttpFoundation\UrlHelper" alias="url_helper" />
 
         <service id="cache_warmer" class="Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerAggregate" public="true">
-            <argument type="tagged" tag="kernel.cache_warmer" />
+            <argument type="tagged_iterator" tag="kernel.cache_warmer" />
             <argument>%kernel.debug%</argument>
             <argument>%kernel.cache_dir%/%kernel.container_class%Deprecations.log</argument>
         </service>
 
         <service id="cache_clearer" class="Symfony\Component\HttpKernel\CacheClearer\ChainCacheClearer" public="true">
-            <argument type="tagged" tag="kernel.cache_clearer" />
+            <argument type="tagged_iterator" tag="kernel.cache_clearer" />
         </service>
 
         <service id="kernel" synthetic="true" public="true" />
@@ -99,7 +99,7 @@
         </service>
 
         <service id="config_cache_factory" class="Symfony\Component\Config\ResourceCheckerConfigCacheFactory">
-            <argument type="tagged" tag="config_cache.resource_checker" />
+            <argument type="tagged_iterator" tag="config_cache.resource_checker" />
         </service>
 
         <service id="dependency_injection.config.container_parameters_resource_checker" class="Symfony\Component\DependencyInjection\Config\ContainerParametersResourceChecker">

src/Symfony/Bundle/FrameworkBundle/composer.json

@@ -20,7 +20,7 @@
         "ext-xml": "*",
         "symfony/cache": "^4.3|^5.0",
         "symfony/config": "^4.2|^5.0",
-        "symfony/dependency-injection": "^4.3|^5.0",
+        "symfony/dependency-injection": "^4.4|^5.0",
         "symfony/http-foundation": "^4.3|^5.0",
         "symfony/http-kernel": "^4.3|^5.0",
         "symfony/polyfill-mbstring": "~1.0",

src/Symfony/Component/DependencyInjection/CHANGELOG.md

@@ -5,6 +5,7 @@ CHANGELOG
 -----
 
  * deprecated support for short factories and short configurators in Yaml
+ * deprecated `tagged` in favor of `tagged_iterator`
 
 4.3.0
 -----

src/Symfony/Component/DependencyInjection/Dumper/XmlDumper.php

@@ -287,7 +287,7 @@ class XmlDumper extends Dumper
                 $element->setAttribute('type', 'collection');
                 $this->convertParameters($value, $type, $element, 'key');
             } elseif ($value instanceof TaggedIteratorArgument || ($value instanceof ServiceLocatorArgument && $tag = $value->getTaggedIteratorArgument())) {
-                $element->setAttribute('type', $value instanceof TaggedIteratorArgument ? 'tagged' : 'tagged_locator');
+                $element->setAttribute('type', $value instanceof TaggedIteratorArgument ? 'tagged_iterator' : 'tagged_locator');
                 $element->setAttribute('tag', $tag->getTag());
 
                 if (null !== $tag->getIndexAttribute()) {

src/Symfony/Component/DependencyInjection/Dumper/YamlDumper.php

@@ -248,7 +248,7 @@ class YamlDumper extends Dumper
                     }
                 }
 
-                return new TaggedValue($value instanceof TaggedIteratorArgument ? 'tagged' : 'tagged_locator', $content);
+                return new TaggedValue($value instanceof TaggedIteratorArgument ? 'tagged_iterator' : 'tagged_locator', $content);
             }
 
             if ($value instanceof IteratorArgument) {

src/Symfony/Component/DependencyInjection/Loader/Configurator/ContainerConfigurator.php

@@ -115,8 +115,20 @@ function iterator(array $values): IteratorArgument
 
 /**
  * Creates a lazy iterator by tag name.
+ *
+ * @deprecated since Symfony 4.4, to be removed in 5.0, use "tagged_iterator" instead.
  */
 function tagged(string $tag, string $indexAttribute = null, string $defaultIndexMethod = null): TaggedIteratorArgument
+{
+    @trigger_error(__NAMESPACE__.'\tagged() is deprecated since Symfony 4.4 and will be removed in 5.0, use '.__NAMESPACE__.'\tagged_iterator() instead.', E_USER_DEPRECATED);
+
+    return new TaggedIteratorArgument($tag, $indexAttribute, $defaultIndexMethod);
+}
+
+/**
+ * Creates a lazy iterator by tag name.
+ */
+function tagged_iterator(string $tag, string $indexAttribute = null, string $defaultIndexMethod = null): TaggedIteratorArgument
 {
     return new TaggedIteratorArgument($tag, $indexAttribute, $defaultIndexMethod);
 }

src/Symfony/Component/DependencyInjection/Loader/XmlFileLoader.php

@@ -545,6 +545,9 @@ class XmlFileLoader extends FileLoader
                     }
                     break;
                 case 'tagged':
+                    @trigger_error(sprintf('Type "%s" of tag <%s> in "%s" is deprecated since Symfony 4.4 and will be removed in 5.0, use "tagged_iterator" instead.', $arg->getAttribute('type'), $name, $file), E_USER_DEPRECATED);
+                    // no break
+                case 'tagged_iterator':
                 case 'tagged_locator':
                     $type = $arg->getAttribute('type');
                     $forLocator = 'tagged_locator' === $type;

src/Symfony/Component/DependencyInjection/Loader/YamlFileLoader.php

@@ -725,7 +725,11 @@ class YamlFileLoader extends FileLoader
                     throw new InvalidArgumentException(sprintf('"!service_locator" tag only accepts maps of "@service" references in "%s".', $file));
                 }
             }
-            if (\in_array($value->getTag(), ['tagged', 'tagged_locator'], true)) {
+            if (\in_array($value->getTag(), ['tagged', 'tagged_iterator', 'tagged_locator'], true)) {
+                if ('tagged' === $value->getTag()) {
+                    @trigger_error('"!tagged" is deprecated since Symfony 4.4 and will be removed in 5.0, use "!tagged_iterator" instead.', E_USER_DEPRECATED);
+                }
+
                 $forLocator = 'tagged_locator' === $value->getTag();
 
                 if (\is_string($argument) && $argument) {

src/Symfony/Component/DependencyInjection/Loader/schema/dic/services/services-1.0.xsd

@@ -264,7 +264,9 @@
       <xsd:enumeration value="constant" />
       <xsd:enumeration value="iterator" />
       <xsd:enumeration value="service_locator" />
+      <!-- "tagged" is deprecated since Symfony 4.4 and will be removed in 5.0, use "tagged_iterator" instead. -->
       <xsd:enumeration value="tagged" />
+      <xsd:enumeration value="tagged_iterator" />
       <xsd:enumeration value="tagged_locator" />
     </xsd:restriction>
   </xsd:simpleType>

src/Symfony/Component/DependencyInjection/Tests/Fixtures/config/anonymous.expected.yml

@@ -7,7 +7,7 @@ services:
     listener_aggregator:
         class: Bar\FooClass
         public: true
-        arguments: [!tagged listener]
+        arguments: [!tagged_iterator listener]
     .2_stdClass~%s:
         class: stdClass
         public: false

src/Symfony/Component/DependencyInjection/Tests/Fixtures/config/anonymous.php

@@ -15,7 +15,7 @@ return function (ContainerConfigurator $c) {
         ->decorate('decorated', 'decorator42')
         ->args([ref('decorator42')]);
 
-    $s->set('listener_aggregator', FooClass::class)->public()->args([tagged('listener')]);
+    $s->set('listener_aggregator', FooClass::class)->public()->args([tagged_iterator('listener')]);
 
     $s->set(null, stdClass::class)->tag('listener');
 };

src/Symfony/Component/DependencyInjection/Tests/Fixtures/config/services9.php

@@ -128,7 +128,7 @@ return function (ContainerConfigurator $c) {
 
     $s->set('tagged_iterator', 'Bar')
         ->public()
-        ->args([tagged('foo')]);
+        ->args([tagged_iterator('foo')]);
 
     $s->set('runtime_error', 'stdClass')
         ->args([new Reference('errored_definition', ContainerInterface::RUNTIME_EXCEPTION_ON_INVALID_REFERENCE)])

src/Symfony/Component/DependencyInjection/Tests/Fixtures/xml/services9.xml

@@ -142,7 +142,7 @@
       <tag name="foo"/>
     </service>
     <service id="tagged_iterator" class="Bar" public="true">
-      <argument type="tagged" tag="foo"/>
+      <argument type="tagged_iterator" tag="foo"/>
     </service>
     <service id="runtime_error" class="stdClass" public="true">
       <argument type="service" id="errored_definition"/>

src/Symfony/Component/DependencyInjection/Tests/Fixtures/xml/services_with_tagged_arguments.xml

@@ -6,7 +6,7 @@
       <tag name="foo_tag"/>
     </service>
     <service id="foo_tagged_iterator" class="Bar" public="true">
-      <argument type="tagged" tag="foo_tag" index-by="barfoo" default-index-method="foobar"/>
+      <argument type="tagged_iterator" tag="foo_tag" index-by="barfoo" default-index-method="foobar"/>
     </service>
     <service id="foo_tagged_locator" class="Bar" public="true">
       <argument type="tagged_locator" tag="foo_tag" index-by="barfoo" default-index-method="foobar"/>

src/Symfony/Component/DependencyInjection/Tests/Fixtures/yaml/service_instanceof_factory.yml

@@ -8,7 +8,7 @@ services:
         public: true
 
     Symfony\Component\DependencyInjection\Tests\Fixtures\BarFactory:
-        arguments: [!tagged 'bar']
+        arguments: [!tagged_iterator 'bar']
 
     Symfony\Component\DependencyInjection\Tests\Fixtures\BarInterface:
         factory: ['@Symfony\Component\DependencyInjection\Tests\Fixtures\BarFactory', 'getDefaultBar']

src/Symfony/Component/DependencyInjection/Tests/Fixtures/yaml/services9.yml

@@ -157,7 +157,7 @@ services:
     tagged_iterator:
         class: Bar
         arguments:
-            - !tagged foo
+            - !tagged_iterator foo
         public: true
     Psr\Container\ContainerInterface:
         alias: service_container

src/Symfony/Component/DependencyInjection/Tests/Fixtures/yaml/services_with_tagged_argument.yml

@@ -10,7 +10,7 @@ services:
             - { name: foo }
     foo_service_tagged_iterator:
         class: Bar
-        arguments: [!tagged { tag: foo, index_by: barfoo, default_index_method: foobar }]
+        arguments: [!tagged_iterator { tag: foo, index_by: barfoo, default_index_method: foobar }]
     foo_service_tagged_locator:
         class: Bar
         arguments: [!tagged_locator { tag: foo, index_by: barfoo, default_index_method: foobar }]