Skip to content

Commit 03da816

Browse files
committed
minor #10109 Add explanation about prefix decision (greg0ire)
This PR was submitted for the master branch but it was merged into the 4.3 branch instead (closes #10109). Discussion ---------- Add explanation about prefix decision See #9886, I left out reasons related to overhead during compilation steps because that might be too technical. Commits ------- 305879d Add explanation about prefix decision
2 parents c7cdae0 + 305879d commit 03da816

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

bundles/best_practices.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -451,7 +451,11 @@ Services
451451
--------
452452

453453
If the bundle defines services, they must be prefixed with the bundle alias.
454-
For example, AcmeBlogBundle services must be prefixed with ``acme_blog``.
454+
For example, AcmeBlogBundle services must be prefixed with ``acme_blog``
455+
instead of using fully qualified class names like in a project. This is
456+
because a bundle should not pollute the list of autowireable types with
457+
its own services, and to avoid service ids collisions with projects or
458+
other bundles that might do so.
455459

456460
In addition, services not meant to be used by the application directly, should
457461
be :ref:`defined as private <container-private-services>`. For public services,

0 commit comments

Comments
 (0)