diff --git a/logging.rst b/logging.rst index 0ad36031dd5..5f10226c30d 100644 --- a/logging.rst +++ b/logging.rst @@ -92,8 +92,15 @@ In the ``prod`` environment, logs are written to `STDERR PHP stream`_, which works best in modern containerized applications deployed to servers without disk write permissions. -If you prefer to store production logs in a file, set the ``path`` of your -log handler(s) to the path of the file to use (e.g. ``var/log/prod.log``). +If you prefer to store production logs in a file, set the ``path`` option of your +log handler(s) to the desired file path (e.g. ``var/log/prod.log``). This directory +is created by Monolog if it doesn't exist. If your Symfony application runs on a +read-only filesystem, set the path to an external writable directory (e.g. +``APP_LOG_DIR=/tmp/log``). + +.. versionadded:: 7.3 + + The feature to create the log directory automatically was introduced in Symfony 7.3. Handlers: Writing Logs to different Locations ---------------------------------------------