File storage API

    When called without the import_path parameter get_storage_classwill return the current default storage system as defined byDEFAULT_FILE_STORAGE. If import_path is provided,get_storage_class will attempt to import the class or module from thegiven path and will return it if successful. An exception will beraised if the import is unsuccessful.

    • class FileSystemStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None)

    • The class implementsbasic file storage on a local filesystem. It inherits fromStorage and provides implementationsfor all the public methods thereof.

      • location

      • Absolute path to the directory that will hold the files.Defaults to the value of your MEDIA_ROOT setting.

      • base_url

      • URL that serves the files stored at this location.Defaults to the value of your MEDIA_URL setting.

      • file_permissions_mode

      • The file system permissions that the file will receive when it issaved. Defaults to FILE_UPLOAD_PERMISSIONS.

      • The file system permissions that the directory will receive when it issaved. Defaults to .

    注解

    • getcreated_time(_name)[源代码]
    • Returns a datetime of the system's ctime, i.e.. On some systems (like Unix), this is thetime of the last metadata change, and on others (like Windows), it'sthe creation time of the file.
    • class Storage[源代码]
    • The Storage class provides astandardized API for storing files, along with a set of defaultbehaviors that all other storage systems can inherit or overrideas necessary.

    注解

    When methods return naive datetime objects, the effective timezoneused will be the current value of os.environ['TZ']; note that thisis usually set from Django's .

    • (name)[源代码]

    • Deletes the file referenced by name. If deletion is not supportedon the target storage system this will raise NotImplementedErrorinstead

    • exists(name)[源代码]

    • Returns True if a file referenced by the given name already existsin the storage system, or False if the name is available for a newfile.

    • getaccessed_time(_name)[源代码]

    • Returns a datetime of the last accessed time of thefile. For storage systems unable to return the last accessed time thiswill raise .

    If USE_TZ is True, returns an aware datetime,otherwise returns a naive datetime in the local timezone.

    • getavailable_name(_name, max_length=None)
    • Returns a filename based on the name parameter that's free andavailable for new content to be written to on the target storagesystem.

    The length of the filename will not exceed max_length, if provided.If a free unique filename cannot be found, a exception will be raised.

    If a file with name already exists, an underscore plus a random7 character alphanumeric string is appended to the filename beforethe extension.

    • getcreated_time(_name)[源代码]
    • Returns a datetime of the creation time of the file.For storage systems unable to return the creation time this will raise.

    If USE_TZ is True, returns an aware datetime,otherwise returns a naive datetime in the local timezone.

    • Returns a of the last modified time of thefile. For storage systems unable to return the last modified time thiswill raise NotImplementedError.

    If is True, returns an aware datetime,otherwise returns a naive in the local timezone.

    The filename argument may include a path as returned byFileField.upload_to.In that case, the path won't be passed to butwill be prepended back to the resulting name.

    The default implementation uses os.path operations. Overridethis method if that's not appropriate for your storage.

    • listdir(path)

    • Lists the contents of the specified path, returning a 2-tuple of lists;the first item being directories, the second item being files. Forstorage systems that aren't able to provide such a listing, this willraise a NotImplementedError instead.

    • open(name, mode='rb')

    • Opens the file given by name. Note that although the returned fileis guaranteed to be a File object, it might actually be somesubclass. In the case of remote file storage this means thatreading/writing could be quite slow, so be warned.

    • path(name)

    • The local filesystem path where the file can be opened using Python'sstandard open(). For storage systems that aren't accessible fromthe local filesystem, this will raise NotImplementedError instead.

    • save(name, content, max_length=None)

    • Saves a new file using the storage system, preferably with the namespecified. If there already exists a file with this name name, thestorage system may modify the filename as necessary to get a uniquename. The actual name of the stored file will be returned.

    The max_length argument is passed along to.

    The content argument must be an instance ofdjango.core.files.File or a file-like object that can bewrapped in File.

    • size(name)
    • Returns the URL where the contents of the file referenced by namecan be accessed. For storage systems that don't support access by URLthis will raise instead.