Add doc for strict JsonManifest strategy

Author: GromNaN

components/asset.rst

@@ -160,11 +160,31 @@ In those cases, use the
     use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
 
     // assumes the JSON file above is called "rev-manifest.json"
-    $package = new Package(new JsonManifestVersionStrategy(__DIR__.'/rev-manifest.json'));
+    $package = new Package(new JsonManifestVersionStrategy(__DIR__.'/rev-manifest.json'), $strict);
 
     echo $package->getUrl('css/app.css');
     // result: build/css/app.b916426ea1d10021f3f17ce8031f93c2.css
 
+If you request an asset that is *not found* in the ``manifest.json`` file, the original -
+*unmodified* - asset path will be returned.
+The ``$strict`` argument helps for debugging as it throws an exception when the asset is
+not listed in the manifest::
+
+    use Symfony\Component\Asset\Package;
+    use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
+
+    // The value of $strict can be specific per environment "true" for debugging and "false" for stability.
+    $strict = true;
+    // assumes the JSON file above is called "rev-manifest.json"
+    $package = new Package(new JsonManifestVersionStrategy(__DIR__.'/rev-manifest.json'), $strict);
+
+    echo $package->getUrl('not-found.css');
+    // error:
+
+.. versionadded:: 5.2
+
+    Option ``strict`` was introduced in Symfony 5.2.
+
 If your JSON file is not on your local filesystem but is accessible over HTTP,
 use the :class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
 with the :doc:`HttpClient component </http_client>`::

reference/configuration/framework.rst

@@ -41,6 +41,7 @@ Configuration
   * `base_urls`_
   * `json_manifest_path`_
   * `packages`_
+  * `strict`_
   * `version_format`_
   * `version_strategy`_
   * `version`_
@@ -1842,6 +1843,7 @@ Each package can configure the following options:
 * :ref:`version <reference-framework-assets-version>`
 * :ref:`version_format <reference-assets-version-format>`
 * :ref:`json_manifest_path <reference-assets-json-manifest-path>`
+* :ref:`strict <reference-assets-strict>`
 
 .. _reference-framework-assets-version:
 .. _ref-framework-assets-version:
@@ -2084,6 +2086,8 @@ package:
                     foo_package:
                         # this package uses its own manifest (the default file is ignored)
                         json_manifest_path: "%kernel.project_dir%/public/build/a_different_manifest.json"
+                        # for debug, an exception is thrown when an asset is not found in the manifest
+                        strict: "%kernel.debug%"
                     bar_package:
                         # this package uses the global manifest (the default file is used)
                         base_path: '/images'
@@ -2104,9 +2108,11 @@ package:
                 <!-- you can use absolute URLs too and Symfony will download them automatically -->
                 <!-- <framework:assets json-manifest-path="https://cdn.example.com/manifest.json"> -->
                     <!-- this package uses its own manifest (the default file is ignored) -->
+                    <!-- for debug, an exception is thrown when an asset is not found in the manifest -->
                     <framework:package
                         name="foo_package"
-                        json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json"/>
+                        json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json"
+                        strict="true"/>
                     <!-- this package uses the global manifest (the default file is used) -->
                     <framework:package
                         name="bar_package"
@@ -2128,6 +2134,8 @@ package:
                     'foo_package' => [
                         // this package uses its own manifest (the default file is ignored)
                         'json_manifest_path' => '%kernel.project_dir%/public/build/a_different_manifest.json',
+                        // for debug, an exception is thrown when an asset is not found in the manifest
+                        'strict' => '%kernel.debug%',
                     ],
                     'bar_package' => [
                         // this package uses the global manifest (the default file is used)
@@ -2152,11 +2160,21 @@ package:
 
     If you request an asset that is *not found* in the ``manifest.json`` file, the original -
     *unmodified* - asset path will be returned.
+    Set `strict` to `true` to get an exception when an asset is *not found*.
 
 .. note::
 
     If an URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
 
+strict
+......
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 5.2
+
+    This option was introduced in Symfony 5.2.
+
 translator
 ~~~~~~~~~~