symfony · nicolas-grekas · Aug 25, 2021 · Aug 24, 2021
diff --git a/src/Symfony/Bridge/Twig/Mime/WrappedTemplatedEmail.php b/src/Symfony/Bridge/Twig/Mime/WrappedTemplatedEmail.php
@@ -57,6 +57,9 @@ public function attach(string $file, string $name = null, string $contentType =
        }
    }

+    /**
+     * @return $this
+     */
    public function setSubject(string $subject): static
    {
        $this->message->subject($subject);
@@ -69,6 +72,9 @@ public function getSubject(): ?string
        return $this->message->getSubject();
    }

+    /**
+     * @return $this
+     */
    public function setReturnPath(string $address): static
    {
        $this->message->returnPath($address);
@@ -81,6 +87,9 @@ public function getReturnPath(): string
        return $this->message->getReturnPath();
    }

+    /**
+     * @return $this
+     */
    public function addFrom(string $address, string $name = ''): static
    {
        $this->message->addFrom(new Address($address, $name));
@@ -96,6 +105,9 @@ public function getFrom(): array
        return $this->message->getFrom();
    }

+    /**
+     * @return $this
+     */
    public function addReplyTo(string $address): static
    {
        $this->message->addReplyTo($address);
@@ -111,6 +123,9 @@ public function getReplyTo(): array
        return $this->message->getReplyTo();
    }

+    /**
+     * @return $this
+     */
    public function addTo(string $address, string $name = ''): static
    {
        $this->message->addTo(new Address($address, $name));
@@ -126,6 +141,9 @@ public function getTo(): array
        return $this->message->getTo();
    }

+    /**
+     * @return $this
+     */
    public function addCc(string $address, string $name = ''): static
    {
        $this->message->addCc(new Address($address, $name));
@@ -141,6 +159,9 @@ public function getCc(): array
        return $this->message->getCc();
    }

+    /**
+     * @return $this
+     */
    public function addBcc(string $address, string $name = ''): static
    {
        $this->message->addBcc(new Address($address, $name));
@@ -156,6 +177,9 @@ public function getBcc(): array
        return $this->message->getBcc();
    }

+    /**
+     * @return $this
+     */
    public function setPriority(int $priority): static
    {
        $this->message->priority($priority);

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/DefaultsConfigurator.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/DefaultsConfigurator.php
@@ -38,6 +38,8 @@ public function __construct(ServicesConfigurator $parent, Definition $definition
    /**
     * Adds a tag for this definition.
     *
+     * @return $this
+     *
     * @throws InvalidArgumentException when an invalid tag name or attribute is provided
     */
    final public function tag(string $name, array $attributes = []): static

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/ParametersConfigurator.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/ParametersConfigurator.php
@@ -27,13 +27,19 @@ public function __construct(ContainerBuilder $container)
        $this->container = $container;
    }

+    /**
+     * @return $this
+     */
    final public function set(string $name, mixed $value): static
    {
        $this->container->setParameter($name, static::processValue($value, true));

        return $this;
    }

+    /**
+     * @return $this
+     */
    final public function __invoke(string $name, mixed $value): static
    {
        return $this->set($name, $value);

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/PrototypeConfigurator.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/PrototypeConfigurator.php
@@ -75,6 +75,8 @@ public function __destruct()
     * Excludes files from registration using glob patterns.
     *
     * @param string[]|string $excludes
+     *
+     * @return $this
     */
    final public function exclude(array|string $excludes): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/ReferenceConfigurator.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/ReferenceConfigurator.php
@@ -29,20 +29,29 @@ public function __construct(string $id)
        $this->id = $id;
    }

+    /**
+     * @return $this
+     */
    final public function ignoreOnInvalid(): static
    {
        $this->invalidBehavior = ContainerInterface::IGNORE_ON_INVALID_REFERENCE;

        return $this;
    }

+    /**
+     * @return $this
+     */
    final public function nullOnInvalid(): static
    {
        $this->invalidBehavior = ContainerInterface::NULL_ON_INVALID_REFERENCE;

        return $this;
    }

+    /**
+     * @return $this
+     */
    final public function ignoreOnUninitialized(): static
    {
        $this->invalidBehavior = ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE;

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/AbstractTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/AbstractTrait.php
@@ -16,6 +16,8 @@ trait AbstractTrait
    /**
     * Whether this definition is abstract, that means it merely serves as a
     * template for other definitions.
+     *
+     * @return $this
     */
    final public function abstract(bool $abstract = true): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ArgumentTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ArgumentTrait.php
@@ -15,6 +15,8 @@ trait ArgumentTrait
 {
    /**
     * Sets the arguments to pass to the service constructor/factory method.
+     *
+     * @return $this
     */
    final public function args(array $arguments): static
    {
@@ -25,6 +27,8 @@ final public function args(array $arguments): static

    /**
     * Sets one argument to pass to the service constructor/factory method.
+     *
+     * @return $this
     */
    final public function arg(string|int $key, mixed $value): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/AutoconfigureTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/AutoconfigureTrait.php
@@ -18,6 +18,8 @@ trait AutoconfigureTrait
    /**
     * Sets whether or not instanceof conditionals should be prepended with a global set.
     *
+     * @return $this
+     *
     * @throws InvalidArgumentException when a parent is already set
     */
    final public function autoconfigure(bool $autoconfigured = true): static

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/AutowireTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/AutowireTrait.php
@@ -15,6 +15,8 @@ trait AutowireTrait
 {
    /**
     * Enables/disables autowiring.
+     *
+     * @return $this
     */
    final public function autowire(bool $autowired = true): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/BindTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/BindTrait.php
@@ -28,6 +28,8 @@ trait BindTrait
     *
     * @param string $nameOrFqcn A parameter name with its "$" prefix, or an FQCN
     * @param mixed  $valueOrRef The value or reference to bind
+     *
+     * @return $this
     */
    final public function bind(string $nameOrFqcn, mixed $valueOrRef): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/CallTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/CallTrait.php
@@ -22,6 +22,8 @@ trait CallTrait
     * @param array  $arguments    An array of arguments to pass to the method call
     * @param bool   $returnsClone Whether the call returns the service instance or not
     *
+     * @return $this
+     *
     * @throws InvalidArgumentException on empty $method param
     */
    final public function call(string $method, array $arguments = [], bool $returnsClone = false): static

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ClassTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ClassTrait.php
@@ -15,6 +15,8 @@ trait ClassTrait
 {
    /**
     * Sets the service class.
+     *
+     * @return $this
     */
    final public function class(?string $class): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ConfiguratorTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ConfiguratorTrait.php
@@ -17,6 +17,8 @@ trait ConfiguratorTrait
 {
    /**
     * Sets a configurator to call after the service is fully initialized.
+     *
+     * @return $this
     */
    final public function configurator(string|array|ReferenceConfigurator $configurator): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/DecorateTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/DecorateTrait.php
@@ -21,6 +21,8 @@ trait DecorateTrait
     *
     * @param string|null $id The decorated service id, use null to remove decoration
     *
+     * @return $this
+     *
     * @throws InvalidArgumentException in case the decorated service id and the new decorated service id are equals
     */
    final public function decorate(?string $id, string $renamedId = null, int $priority = 0, int $invalidBehavior = ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE): static

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/DeprecateTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/DeprecateTrait.php
@@ -22,6 +22,8 @@ trait DeprecateTrait
     * @param string $version The version of the package that introduced the deprecation
     * @param string $message The deprecation message to use
     *
+     * @return $this
+     *
     * @throws InvalidArgumentException when the message template is invalid
     */
    final public function deprecate(string $package, string $version, string $message): static

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/FactoryTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/FactoryTrait.php
@@ -18,6 +18,8 @@ trait FactoryTrait
 {
    /**
     * Sets a factory.
+     *
+     * @return $this
     */
    final public function factory(string|array|ReferenceConfigurator $factory): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/FileTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/FileTrait.php
@@ -15,6 +15,8 @@ trait FileTrait
 {
    /**
     * Sets a file to require before creating the service.
+     *
+     * @return $this
     */
    final public function file(string $file): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/LazyTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/LazyTrait.php
@@ -17,6 +17,8 @@ trait LazyTrait
     * Sets the lazy flag of this service.
     *
     * @param bool|string $lazy A FQCN to derivate the lazy proxy from or `true` to make it extend from the definition's class
+     *
+     * @return $this
     */
    final public function lazy(bool|string $lazy = true): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ParentTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ParentTrait.php
@@ -19,6 +19,8 @@ trait ParentTrait
    /**
     * Sets the Definition to inherit from.
     *
+     * @return $this
+     *
     * @throws InvalidArgumentException when parent cannot be set
     */
    final public function parent(string $parent): static

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/PropertyTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/PropertyTrait.php
@@ -15,6 +15,8 @@ trait PropertyTrait
 {
    /**
     * Sets a specific property.
+     *
+     * @return $this
     */
    final public function property(string $name, mixed $value): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/PublicTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/PublicTrait.php
@@ -13,13 +13,19 @@

 trait PublicTrait
 {
+    /**
+     * @return $this
+     */
    final public function public(): static
    {
        $this->definition->setPublic(true);

        return $this;
    }

+    /**
+     * @return $this
+     */
    final public function private(): static
    {
        $this->definition->setPublic(false);

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ShareTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/ShareTrait.php
@@ -15,6 +15,8 @@ trait ShareTrait
 {
    /**
     * Sets if the service must be shared or not.
+     *
+     * @return $this
     */
    final public function share(bool $shared = true): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/SyntheticTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/SyntheticTrait.php
@@ -16,6 +16,8 @@ trait SyntheticTrait
    /**
     * Sets whether this definition is synthetic, that is not constructed by the
     * container, but dynamically injected.
+     *
+     * @return $this
     */
    final public function synthetic(bool $synthetic = true): static
    {

diff --git a/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/TagTrait.php b/src/Symfony/Component/DependencyInjection/Loader/Configurator/Traits/TagTrait.php
@@ -17,6 +17,8 @@ trait TagTrait
 {
    /**
     * Adds a tag for this definition.
+     *
+     * @return $this
     */
    final public function tag(string $name, array $attributes = []): static
    {

diff --git a/src/Symfony/Component/Dotenv/Dotenv.php b/src/Symfony/Component/Dotenv/Dotenv.php
@@ -46,6 +46,9 @@ public function __construct(string $envKey = 'APP_ENV', string $debugKey = 'APP_
        $this->debugKey = $debugKey;
    }

+    /**
+     * @return $this
+     */
    public function setProdEnvs(array $prodEnvs): static
    {
        $this->prodEnvs = $prodEnvs;
@@ -56,6 +59,8 @@ public function setProdEnvs(array $prodEnvs): static
    /**
     * @param bool $usePutenv If `putenv()` should be used to define environment variables or not.
     *                        Beware that `putenv()` is not thread safe, that's why this setting defaults to false
+     *
+     * @return $this
     */
    public function usePutenv(bool $usePutenv = true): static
    {