From 39be3e699885a57f91a2b30a4f34855465f1ec03 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 26 Jun 2024 09:55:47 +0200
Subject: [PATCH] [DependencyInjection] Add `#[WhenNot]` attribute

---
 reference/attributes.rst |  1 +
 service_container.rst    | 26 ++++++++++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 4428dc4c587..d744cb9a9b4 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -43,6 +43,7 @@ Dependency Injection
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
 * :ref:`Target <autowiring-multiple-implementations-same-type>`
 * :ref:`When <service-container_limiting-to-env>`
+* :ref:`WhenNot <service-container_limiting-to-env>`
 
 EventDispatcher
 ~~~~~~~~~~~~~~~
diff --git a/service_container.rst b/service_container.rst
index ebc01b1fc8a..bc8e5f123b1 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -260,6 +260,32 @@ as a service in some environments::
         // ...
     }
 
+If you want to exclude a service from being registered in a specific
+environment, you can use the ``#[WhenNot]`` attribute::
+
+    use Symfony\Component\DependencyInjection\Attribute\WhenNot;
+
+    // SomeClass is registered in all environments except "dev"
+
+    #[WhenNot(env: 'dev')]
+    class SomeClass
+    {
+        // ...
+    }
+
+    // you can apply more than one WhenNot attribute to the same class
+
+    #[WhenNot(env: 'dev')]
+    #[WhenNot(env: 'test')]
+    class AnotherClass
+    {
+        // ...
+    }
+
+.. versionadded:: 7.2
+
+    The ``#[WhenNot]`` attribute was introduced in Symfony 7.2.
+
 .. _services-constructor-injection:
 
 Injecting Services/Config into a Service