API penyimpanan berkasLink to this heading#

Mendapatkan penyimpanan saat iniLink to this heading#

Django menyediakan dua cara meyakinkan untuk mengakses kelas penyimpanan saat ini:

class DefaultStorageLink to this definition#

DefaultStorage provides lazy access to the current default storage system as defined by DEFAULT_FILE_STORAGE. DefaultStorage uses get_storage_class() internally.

get_storage_class(import_path=None)Link to this definition#

Mengembalikan sebuah kelas atau modul yang menerapkan API penyimpanan.

When called without the import_path parameter get_storage_class will return the current default storage system as defined by DEFAULT_FILE_STORAGE. If import_path is provided, get_storage_class will attempt to import the class or module from the given path and will return it if successful. An exception will be raised if the import is unsuccessful.

Kelas FileSystemStorageLink to this heading#

class FileSystemStorage(location=None, base_url=None, file_permissions_mode=None, directory_permissions_mode=None)Link to this definition#

The FileSystemStorage class implements basic file storage on a local filesystem. It inherits from Storage and provides implementations for all the public methods thereof.

locationLink to this definition#

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

base_urlLink to this definition#

URL yang melayani berkas-berkas disimppan pada tempat ini. Awalan pada nilai dari pengaturan MEDIA_URL anda.

file_permissions_modeLink to this definition#

The file system permissions that the file will receive when it is saved. Defaults to FILE_UPLOAD_PERMISSIONS.

directory_permissions_modeLink to this definition#

Perizinan sistem berkas dimana direktori akan menerima ketika itu disimpan. Awalan pada FILE_UPLOAD_DIRECTORY_PERMISSIONS.

get_created_time(name)Link to this definition#

Returns a datetime of the system's ctime, i.e. os.path.getctime(). On some systems (like Unix), this is the time of the last metadata change, and on others (like Windows), it's the creation time of the file.

Kelas StorageLink to this heading#

class StorageLink to this definition#

The Storage class provides a standardized API for storing files, along with a set of default behaviors that all other storage systems can inherit or override as necessary.

delete(name)Link to this definition#

Deletes the file referenced by name. If deletion is not supported on the target storage system this will raise NotImplementedError instead.

exists(name)Link to this definition#

Mengembalikan True jika sebuah berkas diacukan oleh nama yang sudah diberikan dalam sistem penyimpanan, atau False jika nama tersedia untuk sebuah berkas baru.

get_accessed_time(name)Link to this definition#

Mengembalikan sebuah datetime dari waktu akses terakhir dari berkas. Untuk sistem penyimpanan tidak dapat mengembalikan ke waktu akses terakhir ini akan memunculkan NotImplementedError.

Jika USE_TZ adalah True, mengembalikan sebuah kewaspadaan datetime, sebaliknya mengembalikan datetime tidak dibuat-buat dalam zona waktu lokal.

get_alternative_name(file_root, file_ext)Link to this definition#

Returns an alternative filename based on the file_root and file_ext parameters, an underscore plus a random 7 character alphanumeric string is appended to the filename before the extension.

get_available_name(name, max_length=None)Link to this definition#

Mengembalikan sebuah nama berkas berdasarkan pada parameter name yang bebas dan tersedia untuk isi baru untuk ditulis pada sasaran sistem penyimpanan.

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

If a file with name already exists, get_alternative_name() is called to obtain an alternative name.

get_created_time(name)Link to this definition#

Returns a datetime of the creation time of the file. For storage systems unable to return the creation time this will raise NotImplementedError.

Jika USE_TZ adalah True, mengembalikan sebuah kewaspadaan datetime, sebaliknya mengembalikan datetime tidak dibuat-buat dalam zona waktu lokal.

get_modified_time(name)Link to this definition#

Returns a datetime of the last modified time of the file. For storage systems unable to return the last modified time this will raise NotImplementedError.

Jika USE_TZ adalah True, mengembalikan sebuah kewaspadaan datetime, sebaliknya mengembalikan datetime tidak dibuat-buat dalam zona waktu lokal.

get_valid_name(name)Link to this definition#

Returns a filename based on the name parameter that's suitable for use on the target storage system.

generate_filename(filename)Link to this definition#

Mensahkan filename dengan memanggil get_valid_name() dan mengembalikan sebuah nama berkas dilewatkan ke metedo save().

The filename argument may include a path as returned by FileField.upload_to. In that case, the path won't be passed to get_valid_name() but will be prepended back to the resulting name.

Penerapan awal menggunakan operasi os.path. Kesampingkan cara ini jika itu tidak sesuai untuk penyimpanan anda.

listdir(path)Link to this definition#

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

open(name, mode='rb')Link to this definition#

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

path(name)Link to this definition#

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

save(name, content, max_length=None)Link to this definition#

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

Argumen max_length dilewatkan bersama pada get_available_name().

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

size(name)Link to this definition#

Returns the total size, in bytes, of the file referenced by name. For storage systems that aren't able to return the file size this will raise NotImplementedError instead.

url(name)Link to this definition#

Returns the URL where the contents of the file referenced by name can be accessed. For storage systems that don't support access by URL this will raise NotImplementedError instead.