documenting non-empty parameters

yceruto · yceruto · commit eb3b89037933 · 2024-09-22T11:34:16.000-04:00
diff --git a/configuration.rst b/configuration.rst
@@ -382,6 +382,21 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
     They are useful when working with :ref:`Compiler Passes </service_container/compiler_passes>`
     to declare some temporary parameters that won't be available later in the application.
 
+Configuration parameters are usually constraint-free, but you can ensure that 
+essential parameters for your application's functionality are present and not 
+empty::
+
+    // ContainerBuilder
+    $container->nonEmptyParameter('app.private_key', 'Did you forget to configure the "app.private_key" parameter?');
+
+If a non-empty parameter is missing or empty (e.g. ``null``, an empty string ``''``, 
+or an empty array ``[]``), Symfony will throw an exception with the custom error 
+message when attempting to retrieve the value of this parameter.
+
+.. versionadded:: 7.2
+
+    Defining non-empty parameters was introduced in Symfony 7.2.
+
 .. seealso::
 
     Later in this article you can read how to
