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

This commit is contained in:
Jan Schädlich 2019-04-29 23:59:34 +02:00 committed by Nicolas Grekas
parent 8e5b6573ea
commit ab8fb1868f
20 changed files with 80 additions and 16 deletions

View File

@ -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
--------------

View File

@ -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
--------------

View File

@ -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">

View File

@ -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">

View File

@ -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",

View File

@ -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
-----

View File

@ -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()) {

View File

@ -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) {

View File

@ -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);
}

View File

@ -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;

View File

@ -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) {

View File

@ -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>

View File

@ -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

View File

@ -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');
};

View File

@ -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)])

View File

@ -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"/>

View File

@ -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"/>

View File

@ -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']

View File

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

View File

@ -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 }]