Oct 20, 2025 · Oct 22, 2025
diff --git a/logging.rst b/logging.rst

 .. _logging-handler-fingers_crossed:


 .. versionadded:: 3.11.0

    The ``enabled`` option was introduced in Monolog 3.11.0.

    You can use the ``enabled`` option to enable or disable a handler depending
    on the environment. For example, you can keep logging in ``dev`` and ``prod``
    but disable it in ``staging``:

    .. code-block:: yaml

        monolog:
            handlers:
                file_log:
                    type: stream
                    path: "%kernel.logs_dir%/%kernel.environment%.log"
                    level: debug
                    enabled: false  # disables the handler

    When ``enabled`` is set to ``false``, the handler is completely ignored.

 Handlers that Modify Log Entries
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Original file line number	Diff line number	Diff line change
Expand Up		@@ -250,6 +250,27 @@

		.. _logging-handler-fingers_crossed:


		.. versionadded:: 3.11.0
Check failure on line 254 in logging.rst View workflow job for this annotation GitHub Actions/ Lint (DOCtor-RST) `Please only provide ".. versionadded::" if the version is greater/equal "7.0"` Check failure on line 254 in logging.rst View workflow job for this annotation GitHub Actions/ Lint (DOCtor-RST) `You are not allowed to use version "3.11.0". Only major version "7" is allowed.`

		The ``enabled`` option was introduced in Monolog 3.11.0.
Check failure on line 256 in logging.rst View workflow job for this annotation GitHub Actions/ Lint (DOCtor-RST) `Please remove trailing whitespace`

		You can use the ``enabled`` option to enable or disable a handler depending
		on the environment. For example, you can keep logging in ``dev`` and ``prod``
		but disable it in ``staging``:

		.. code-block:: yaml

		monolog:
		handlers:
		file_log:
		type: stream
		path: "%kernel.logs_dir%/%kernel.environment%.log"
		level: debug
		enabled: false # disables the handler

		When ``enabled`` is set to ``false``, the handler is completely ignored.

		Handlers that Modify Log Entries
		~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down