minor #49377 [DependencyInjection] Add doc for RUNTIME_EXCEPTION_ON_INVALID_REFERENCE behavior (alamirault)

nicolas-grekas · nicolas-grekas · commit c15367ec37d3 · 2023-02-15T19:29:30.000+01:00
This PR was merged into the 5.4 branch. Discussion ---------- [DependencyInjection] Add doc for `RUNTIME_EXCEPTION_ON_INVALID_REFERENCE` behavior | Q | A | ------------- | --- | Branch? | 5.4 | Bug fix? | no | New feature? | no  | Deprecations? | no  | Tickets | Fix #...  | License | MIT | Doc PR | symfony/symfony-docs#...  While working on documentation of container behaviors symfony/symfony-docs#17903, I saw `RUNTIME_EXCEPTION_ON_INVALID_REFERENCE` was not documented Commits ------- 308e59e [DependencyInjection] Add doc for RUNTIME_EXCEPTION_ON_INVALID_REFERENCE behavior
diff --git a/src/Symfony/Component/DependencyInjection/Container.php b/src/Symfony/Component/DependencyInjection/Container.php
@@ -36,11 +36,12 @@ class_exists(ArgumentServiceLocator::class);
  * The container can have four possible behaviors when a service
  * does not exist (or is not initialized for the last case):
  *
- *  * EXCEPTION_ON_INVALID_REFERENCE: Throws an exception (the default)
+ *  * EXCEPTION_ON_INVALID_REFERENCE: Throws an exception at compilation time (the default)
  *  * NULL_ON_INVALID_REFERENCE:      Returns null
  *  * IGNORE_ON_INVALID_REFERENCE:    Ignores the wrapping command asking for the reference
  *                                    (for instance, ignore a setter if the service does not exist)
  *  * IGNORE_ON_UNINITIALIZED_REFERENCE: Ignores/returns null for uninitialized services or invalid references
+ *  * RUNTIME_EXCEPTION_ON_INVALID_REFERENCE: Throws an exception at runtime
  *
  * @author Fabien Potencier <fabien@symfony.com>
  * @author Johannes M. Schmitt <schmittjoh@gmail.com>

Original file line number	Diff line number	Diff line change
`@@ -36,11 +36,12 @@ class_exists(ArgumentServiceLocator::class);`
`36`	`36`	`* The container can have four possible behaviors when a service`
`37`	`37`	`* does not exist (or is not initialized for the last case):`
`38`	`38`	`*`
`39`		`- * * EXCEPTION_ON_INVALID_REFERENCE: Throws an exception (the default)`
	`39`	`+ * * EXCEPTION_ON_INVALID_REFERENCE: Throws an exception at compilation time (the default)`
`40`	`40`	`* * NULL_ON_INVALID_REFERENCE: Returns null`
`41`	`41`	`* * IGNORE_ON_INVALID_REFERENCE: Ignores the wrapping command asking for the reference`
`42`	`42`	`* (for instance, ignore a setter if the service does not exist)`
`43`	`43`	`* * IGNORE_ON_UNINITIALIZED_REFERENCE: Ignores/returns null for uninitialized services or invalid references`
	`44`	`+ * * RUNTIME_EXCEPTION_ON_INVALID_REFERENCE: Throws an exception at runtime`
`44`	`45`	`*`
`45`	`46`	`* @author Fabien Potencier <fabien@symfony.com>`
`46`	`47`	`* @author Johannes M. Schmitt <schmittjoh@gmail.com>`