Opened 4 years ago

Closed 4 years ago

Last modified 4 years ago

#32176 closed Cleanup/optimization (fixed)

Outdated LOCATION requirement in Filesystem caching docs.

Reported by: Carles Pina Estany Owned by: Carles Pina Estany
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: Carles Pina Estany Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: yes UI/UX: no

Description (last modified by Carles Pina Estany)

In: https://docs.djangoproject.com/en/3.1/topics/cache/#filesystem-caching

It says that LOCATION needs to exist. But the code creates it if it doesn't exist:
https://github.com/django/django/blob/354c1524b38c9b9f052c1d78dcbfa6ed5559aeb3/django/core/cache/backends/filebased.py#L116 called from https://github.com/django/django/blob/master/django/core/cache/backends/filebased.py#L23

Current documentation:
Make sure the directory pointed-to by this setting exists and is readable and writable by the system user under which your Web server runs. Continuing the above example, if your server runs as the user apache, make sure the directory /var/tmp/django_cache exists and is readable and writable by the user apache.

PR: https://github.com/django/django/pull/13649

Change History (7)

comment:2 by Carles Pina Estany, 4 years ago

Cc: Carles Pina Estany added

comment:3 by Carles Pina Estany, 4 years ago

Description: modified (diff)

comment:4 by Mariusz Felisiak, 4 years ago

Summary: Filesystem caching documentation incorrectOutdated LOCATION requirement in Filesystem caching docs.
Triage Stage: UnreviewedAccepted
Type: BugCleanup/optimization

comment:5 by Carlton Gibson, 4 years ago

Triage Stage: AcceptedReady for checkin

comment:6 by GitHub <noreply@…>, 4 years ago

Resolution: fixed
Status: assignedclosed

In a43e2f66:

Fixed #32176 -- Clarified filesystem cache docs.

comment:7 by Carlton Gibson <carlton.gibson@…>, 4 years ago

In 09dbae21:

[3.1.x] Fixed #32176 -- Clarified filesystem cache docs.

Backport of a43e2f66d76fddd791ff0b88361faba304447ff9 from master

Note: See TracTickets for help on using tickets.
Back to Top