Skip to content

[HttpKernel][Logger] Document that Monolog handles the creation of log folder #21011

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: 7.3
Choose a base branch
from
Open

[HttpKernel][Logger] Document that Monolog handles the creation of log folder #21011

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5be53eb
[HttpKernel] Document that Monolog handles the creation of log folder
javiereguiluz May 28, 2025
d78c7db
Tweak
javiereguiluz Jul 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
[HttpKernel] Document that Monolog handles the creation of log folder
  • Loading branch information
@javiereguiluz
javiereguiluz committed May 28, 2025
commit 5be53ebf6c4eaa6c7a12fe45d4edd51071885a88
10 changes: 8 additions & 2 deletions logging.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,8 +92,14 @@ 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 needed, so Symfony applications running on read-only
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If it is a read only filesystem, how can it be created?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed, If I understand, this is useful when symfony app is readonly and logs folder is defined byAPP_LOG_DIR outside symfony app, for example /tmp/log. In this case symfony app keep readonly

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the review. I committed some updates.

filesystems don't need to create it manually or make it writable.

.. versionadded:: 7.3

The feature to create the log directory automatically was introduced in Symfony 7.3.

Handlers: Writing Logs to different Locations
---------------------------------------------
Expand Down
Loading