Skip to content

Commit 5be53eb

Browse files
committed
[HttpKernel] Document that Monolog handles the creation of log folder
1 parent 0454597 commit 5be53eb

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

logging.rst

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -92,8 +92,14 @@ In the ``prod`` environment, logs are written to `STDERR PHP stream`_, which
9292
works best in modern containerized applications deployed to servers without
9393
disk write permissions.
9494

95-
If you prefer to store production logs in a file, set the ``path`` of your
96-
log handler(s) to the path of the file to use (e.g. ``var/log/prod.log``).
95+
If you prefer to store production logs in a file, set the ``path`` option of your
96+
log handler(s) to the desired file path (e.g. ``var/log/prod.log``). This directory
97+
is created by Monolog if needed, so Symfony applications running on read-only
98+
filesystems don't need to create it manually or make it writable.
99+
100+
.. versionadded:: 7.3
101+
102+
The feature to create the log directory automatically was introduced in Symfony 7.3.
97103

98104
Handlers: Writing Logs to different Locations
99105
---------------------------------------------

0 commit comments

Comments
 (0)