From 00db43a4f034ff0f8412953fc4766a01e8fba791 Mon Sep 17 00:00:00 2001 From: Thomas Landauer Date: Tue, 19 Jan 2021 23:16:46 +0100 Subject: [PATCH] Just moving this note upwards MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reasons: * It's a *general* thing, has nothing to do with "Handlers that Modify Log Entries". * Since this is uncommon in Symfony, it should be explained as early as possible. * Fits quite well after this sentence: > This defines a stack of handlers and each handler is called in the order that it’s defined. --- logging.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/logging.rst b/logging.rst index 0b3481a738f..d4ed95189ba 100644 --- a/logging.rst +++ b/logging.rst @@ -159,6 +159,13 @@ to write logs using the :phpfunction:`syslog` function: This defines a *stack* of handlers and each handler is called in the order that it's defined. +.. note:: + + If you want to override the ``monolog`` configuration via another config + file, you will need to redefine the entire ``handlers`` stack. The configuration + from the two files cannot be merged because the order matters and a merge does + not allow to control the order. + Handlers that Modify Log Entries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -263,13 +270,6 @@ debugging much easier! The handler named "file_log" will not be included in the stack itself as it is used as a nested handler of the ``fingers_crossed`` handler. -.. note:: - - If you want to override the ``monolog`` configuration via another config - file, you will need to redefine the entire ``handlers`` stack. The configuration - from the two files cannot be merged because the order matters and a merge does - not allow to control the order. - All Built-in Handlers ---------------------