mirror of
https://github.com/django/django.git
synced 2024-12-25 02:26:12 +00:00
[1.7.x] Fixed #22347 -- Unified FileSystemStorage documentation.
Thanks nliberg for the report.
Backport of ca93f02c62
from master
This commit is contained in:
parent
cfb7eca2a1
commit
36d1e3725f
@ -36,6 +36,16 @@ The FileSystemStorage Class
|
||||
:class:`~django.core.files.storage.Storage` and provides implementations
|
||||
for all the public methods thereof.
|
||||
|
||||
.. attribute:: location
|
||||
|
||||
Absolute path to the directory that will hold the files.
|
||||
Defaults to the value of your :setting:`MEDIA_ROOT` setting.
|
||||
|
||||
.. attribute:: base_url
|
||||
|
||||
URL that serves the files stored at this location.
|
||||
Defaults to the value of your :setting:`MEDIA_URL` setting.
|
||||
|
||||
.. attribute:: file_permissions_mode
|
||||
|
||||
The file system permissions that the file will receive when it is
|
||||
|
@ -149,20 +149,8 @@ See :doc:`/ref/files/storage` for the file storage API.
|
||||
The built-in filesystem storage class
|
||||
-------------------------------------
|
||||
|
||||
Django ships with a built-in ``FileSystemStorage`` class (defined in
|
||||
``django.core.files.storage``) which implements basic local filesystem file
|
||||
storage. Its initializer takes two arguments:
|
||||
|
||||
====================== ===================================================
|
||||
Argument Description
|
||||
====================== ===================================================
|
||||
``location`` Optional. Absolute path to the directory that will
|
||||
hold the files. If omitted, it will be set to the
|
||||
value of your :setting:`MEDIA_ROOT` setting.
|
||||
``base_url`` Optional. URL that serves the files stored at this
|
||||
location. If omitted, it will default to the value
|
||||
of your :setting:`MEDIA_URL` setting.
|
||||
====================== ===================================================
|
||||
Django ships with a :class:`django.core.files.storage.FileSystemStorage` class
|
||||
which implements basic local filesystem file storage.
|
||||
|
||||
For example, the following code will store uploaded files under
|
||||
``/media/photos`` regardless of what your :setting:`MEDIA_ROOT` setting is::
|
||||
|
Loading…
Reference in New Issue
Block a user