-

javiereguiluz · javiereguiluz · commit 37222027e706 · 2023-06-09T10:03:13.000+02:00
diff --git a/service_container.rst b/service_container.rst
@@ -688,6 +688,31 @@ For a full list of *all* possible services in the container, run:
 
     $ php bin/console debug:container
 
+Remove Services
+---------------
+
+A service can be removed from the service container if needed. This is useful
+for example to make a service unavailable in some :ref:`configuration environment <configuration-environments>`
+(e.g. in the ``test`` 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.
+
 .. _container_closure-as-argument:
 
 Injecting a Closure as an Argument
