[Contracts][DependencyInjection] Add ServiceCollectionInterface

alexandre-daubois · alexandre-daubois · commit 3bbf43aa6264 · 2024-01-03T08:49:32.000+01:00
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
@@ -122,6 +122,24 @@ It is also a callable and a countable::
 
     return $handler->handle($command);
 
+Because the service locator implements the
+:class:`Symfony\\Contracts\\Service\\ServiceCollectionInterface`, it is also
+a ``\Traversable``. This allows to iterate through all registered services to
+apply some operations on them::
+
+    foreach ($this->locator as $serviceId => $service) {
+        // access to the service directly
+        $service->someMethod();
+
+        // or via the `get()` method
+        $this->locator->get($serviceId)->someMethod();
+    }
+
+.. versionadded:: 7.1
+
+    The :class:`Symfony\\Contracts\\Service\\ServiceCollectionInterface`
+    was introduced in Symfony 7.1.
+
 Including Services
 ------------------
 
