minor #17385 [DependencyInjection] [DependencyInjecion] Mention that service definitions replace previous ones (javiereguiluz)

javiereguiluz · javiereguiluz · commit cfd20564351f · 2022-10-21T17:04:25.000+02:00
This PR was merged into the 4.4 branch. Discussion ---------- [DependencyInjection] [DependencyInjecion] Mention that service definitions replace previous ones Replaces #16888 to add the warning message in the main article about services config. Commits ------- c9f83a4 [DependencyInjecion] Mention that service definitions replace previous ones
diff --git a/service_container.rst b/service_container.rst
@@ -178,6 +178,9 @@ each time you ask for it.
                         - '../src/Entity/'
                         - '../src/Kernel.php'
 
+                # order is important in this file because service definitions
+                # always *replace* previous ones; add your own service configuration below
+
                 # ...
 
         .. code-block:: xml
@@ -197,6 +200,9 @@ each time you ask for it.
                     <!-- this creates a service per class whose id is the fully-qualified class name -->
                     <prototype namespace="App\" resource="../src/" exclude="../src/{DependencyInjection,Entity,Kernel.php}"/>
 
+                    <!-- order is important in this file because service definitions
+                         always *replace* previous ones; add your own service configuration below -->
+
                     <!-- ... -->
 
                 </services>
@@ -219,6 +225,9 @@ each time you ask for it.
                 // this creates a service per class whose id is the fully-qualified class name
                 $services->load('App\\', '../src/')
                     ->exclude('../src/{DependencyInjection,Entity,Kernel.php}');
+
+                // order is important in this file because service definitions
+                // always *replace* previous ones; add your own service configuration below
             };
 
     .. tip::
