Opened 4 years ago
Last modified 4 years ago
#32176 closed Cleanup/optimization
Filesystem caching documentation incorrect — at Initial Version
| 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
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 coming soon.