Opened 23 months ago

Closed 23 months ago

Last modified 23 months 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 Changed 23 months ago by Carles Pina Estany

Cc: Carles Pina Estany added

comment:3 Changed 23 months ago by Carles Pina Estany

Description: modified (diff)

comment:4 Changed 23 months ago by Mariusz Felisiak

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

comment:5 Changed 23 months ago by Carlton Gibson

Triage Stage: AcceptedReady for checkin

comment:6 Changed 23 months ago by GitHub <noreply@…>

Resolution: fixed
Status: assignedclosed

In a43e2f66:

Fixed #32176 -- Clarified filesystem cache docs.

comment:7 Changed 23 months ago by Carlton Gibson <carlton.gibson@…>

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