[DependencyInjection] Document ServiceConfigurator remove method

alamirault · alamirault · commit 3d9dfe669f45 · 2023-04-07T17:12:32.000+02:00
diff --git a/service_container/remove.rst b/service_container/remove.rst
@@ -0,0 +1,23 @@
+How to Remove a Service
+=======================
+
+A service can be removed from the service container if needed
+(for instance in the test or a specific environment):
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // config/services_test.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\RemovedService;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->remove(RemovedService::class);
+        };
+
+Now, the container will not contain the ``App\RemovedService``
+in the test environment.
