{"title":"Aplikasi staticfiles","version":"5.2","locale":"id","docname":"ref/contrib/staticfiles","url":"/id/5.2/ref/contrib/staticfiles/","canonical":"https://djangodocs.dev/id/5.2/ref/contrib/staticfiles/","summary":"django.contrib.staticfiles menyimpan berkas-berkas tetap dari setiap dari aplikasi anda (dan setiap tempat lain anda tentukan) kedalam tempat tunggal yang dapat…","html":"

Aplikasi staticfilesLink to this heading#

\n

django.contrib.staticfiles menyimpan berkas-berkas tetap dari setiap dari aplikasi anda (dan setiap tempat lain anda tentukan) kedalam tempat tunggal yang dapat dengan mudah dilayani di produksi.

\n\n
\n

PengaturanLink to this heading#

\n

Lihat staticfiles settings untuk rincian pada pengaturan berikut:

\n\n
\n
\n

Pengelolaan perintahLink to this heading#

\n

django.contrib.staticfiles membuka tiga perintah pengelolaan.

\n
\n

collectstaticLink to this heading#

\n
\n
\ndjango-admin collectstaticLink to this definition#
\n
\n\n

Kumpulkan berkas-berkas tetap kedalam STATIC_ROOT.

\n

Gandakan nama-nama berkas secara awalan diselesaikan dalam cara mirip untuk bagaimana ketetapan cetakan bekerja: berkas yaitu pertama ditemukan dalam satu dari tempat yang ditentukan akan digunakan. Jika anda sedang bingung, perintah findstatic dapat membantu anda dimana berkas-berkas ditemukan.

\n

Pada jalanan collectstatic selanjutnya (jika STATIC_ROOT tidak kosong), berkas disalain hanya jike mereka telah merubah timestamp lebih besar dari timestamp dari berkas dalam STATIC_ROOT. Oleh karena itu jika anda memindahkan sebuah aplikasi dari INSTALLED_APPS, itu adalah ide bagus menggunakan pilihan collectstatic --clear untuk memindahkan berkas tetap yang lama.

\n

Berkas-berkas dicari dengan menggunakan enabled finders. Awalan adalah mencari dalam semua tempat ditentukan dalam STATICFILES_DIRS dan dalam direktori 'static' dari aplikasi ditentukan oleh pengaturan INSTALLED_APPS.

\n

The collectstatic management command calls the\npost_process()\nmethod of the staticfiles storage backend from STORAGES after\neach run and passes a list of paths that have been found by the management\ncommand. It also receives all command line options of collectstatic.\nThis is used by the\nManifestStaticFilesStorage by\ndefault.

\n

Secara awalan, berkas-berkas terkumpul menerima perizinan dari FILE_UPLOAD_PERMISSIONS dan direktori terkumpul menerima perizinan dari FILE_UPLOAD_DIRECTORY_PERMISSIONS. Jika anda ingin perizinan berbeda untuk berkas dan direktori ini, anda dapat mensubkelaskan salah satu dari static files storage classes dan menentukan file_permissions_mode dan/atau parameter directory_permissions_mode, masing-masing. Sebagai contoh:

\n
Code
from django.contrib.staticfiles import storage\n\n\nclass MyStaticFilesStorage(storage.StaticFilesStorage):\n    def __init__(self, *args, **kwargs):\n        kwargs["file_permissions_mode"] = 0o640\n        kwargs["directory_permissions_mode"] = 0o760\n        super().__init__(*args, **kwargs)\n
\n

Then set the staticfiles storage backend in STORAGES setting to\n'path.to.MyStaticFilesStorage'.

\n

Beberapa pilihan umum digunakan adalah:

\n
\n
\n--noinput, --no-inputLink to this definition#
\n

JANGAN mengarahkan pengguna untuk masukan apapun.

\n
\n\n
\n
\n--ignore PATTERN, -i PATTERNLink to this definition#
\n

Mengabaikan berkas-berkas, direktori, atau jalur cocok pola gaya-global ini. Gunakan beberapa kali untuk mengabaikan lebih. Ketika menentukan sebuah jalur, selalu gunakan garis miring ke depan, bahkan pada Windows.

\n
\n\n
\n
\n--dry-run, -nLink to this definition#
\n

Lakukan apapun kecuali merubah sistem berkas.

\n
\n\n
\n
\n--clear, -cLink to this definition#
\n

Bersihkan berkas-berkas yang ada sebelum mencoba menyalin atau menaut berkas asli.

\n
\n\n
\n
\n--link, -lLink to this definition#
\n

Buat sebuah tautan simbolus pada setiap berkas daripada menyalin.

\n
\n\n
\n
\n--no-post-processLink to this definition#
\n

Don't call the\npost_process()\nmethod of the configured staticfiles storage backend from\nSTORAGES.

\n
\n\n
\n
\n--no-default-ignoreLink to this definition#
\n

Jangan abaikan pola-gaya-blobal pribadi umum 'CVS', '.*' dan '*~'.

\n
\n\n

Untuk daftar penuh dari pilihan, mengacu pada bantuan perintah sendiri dengan menjalankan:

\n

Linux / macOS

Shell
$ python manage.py collectstatic --help\n
\n

Windows

Windows
...\\> py manage.py collectstatic --help\n
\n
\n

Menyesuaikan daftar pola diabaikanLink to this heading#

\n

The default ignored pattern list, ['CVS', '.*', '*~'], can be customized in\na more persistent way than providing the --ignore command option at each\ncollectstatic invocation. Provide a custom AppConfig\nclass, override the ignore_patterns attribute of this class and replace\n'django.contrib.staticfiles' with that class path in your\nINSTALLED_APPS setting:

\n
Code
from django.contrib.staticfiles.apps import StaticFilesConfig\n\n\nclass MyStaticFilesConfig(StaticFilesConfig):\n    ignore_patterns = [...]  # your custom ignore list\n
\n
\n
\n
\n

findstaticLink to this heading#

\n
\n
\ndjango-admin findstatic staticfile [staticfile ...]Link to this definition#
\n
\n\n

Mencari untuk satu atau lebih jalur relatif dengan diadakan penemu.

\n

Sebagai contoh:

\n

Linux / macOS

Shell
$ python manage.py findstatic css/base.css admin/js/core.js\nFound 'css/base.css' here:\n  /home/special.polls.com/core/static/css/base.css\n  /home/polls.com/core/static/css/base.css\nFound 'admin/js/core.js' here:\n  /home/polls.com/src/django/contrib/admin/media/js/core.js\n
\n

Windows

Windows
...\\> py manage.py findstatic css\\base.css admin\\js\\core.js\nFound 'css/base.css' here:\n  /home/special.polls.com/core/static/css/base.css\n  /home/polls.com/core/static/css/base.css\nFound 'admin/js/core.js' here:\n  /home/polls.com/src/django/contrib/admin/media/js/core.js\n
\n
\n
\nfindstatic --firstLink to this definition#
\n
\n\n

Secara awalan, semua tempat cocok ditemukan. Kembalian satu-satunya pertama yang cocok untuk setiap jalur relatif, gunakan pilihan --first:

\n

Linux / macOS

Shell
$ python manage.py findstatic css/base.css --first\nFound 'css/base.css' here:\n  /home/special.polls.com/core/static/css/base.css\n
\n

Windows

Windows
...\\> py manage.py findstatic css\\base.css --first\nFound 'css/base.css' here:\n  /home/special.polls.com/core/static/css/base.css\n
\n

Ini adalah pertolongan mencari kesalahan; itu akan menunjukkan anda tepatnya berkas tetap mana akan dikumpulkan untuk jalur yang diberikan.

\n

Dengan mensetel bendera --verbosity menjadi 0, anda dapat menekan keluaran tambahan dan hanya mendapatkan jalur nama:

\n

Linux / macOS

Shell
$ python manage.py findstatic css/base.css --verbosity 0\n/home/special.polls.com/core/static/css/base.css\n/home/polls.com/core/static/css/base.css\n
\n

Windows

Windows
...\\> py manage.py findstatic css\\base.css --verbosity 0\n/home/special.polls.com/core/static/css/base.css\n/home/polls.com/core/static/css/base.css\n
\n

Disisi lain, dengan mengatur bendera --verbosity menjadi 2, anda dapat mendapatkan semua direktori yang dicari:

\n

Linux / macOS

Shell
$ python manage.py findstatic css/base.css --verbosity 2\nFound 'css/base.css' here:\n  /home/special.polls.com/core/static/css/base.css\n  /home/polls.com/core/static/css/base.css\nLooking in the following locations:\n  /home/special.polls.com/core/static\n  /home/polls.com/core/static\n  /some/other/path/static\n
\n

Windows

Windows
...\\> py manage.py findstatic css\\base.css --verbosity 2\nFound 'css/base.css' here:\n  /home/special.polls.com/core/static/css/base.css\n  /home/polls.com/core/static/css/base.css\nLooking in the following locations:\n  /home/special.polls.com/core/static\n  /home/polls.com/core/static\n  /some/other/path/static\n
\n
\n
\n

runserverLink to this heading#

\n
\n
\ndjango-admin runserver [addrport]
\n
\n\n

Timpa perintah inti runserver jika aplikasi staticfiles installed dan tambah penyajian otomatis dari berkas-berkas statis. Penyajian berkas tidak berjalan melalui MIDDLEWARE.

\n

Perintah menambah pilihan-pilihan ini:

\n
\n
\n--nostaticLink to this definition#
\n
\n\n

Gunakan pilihan --nostatic untuk meniadakan penyajian berkas-berkas statis dengan aplikasi staticfiles seluruhnya. Pilihan ini hanya tersedia jika aplikasi staticfiles dalam pengaturan INSTALLED_APPS proyek anda.

\n

Contoh penggunaan:

\n

Linux / macOS

Shell
$ django-admin runserver --nostatic\n
\n

Windows

Windows
...\\> django-admin runserver --nostatic\n
\n
\n
\n--insecureLink to this definition#
\n
\n\n

Gunakan pilihan --insecure untuk memaksa melayani berkas-berkas statis dengan aplikasi staticfiles bahkan jika pengaturan DEBUG adalah False. Dengan menggunakan ini anda mengetahui kenyataan bahwa itu adalah terlalu tidak efesien dan mungkin tidak nyaman. Ini hanya bertujuan untuk pengembangan lokal, harus jangan pernah digunakan dalam produksi dan hanya tersedia jika aplikasi staticfiles berada dalam pengaturan INSTALLED_APPS proyek anda.

\n

--insecure tidak dapat bekerja dengan ManifestStaticFilesStorage.

\n

Contoh penggunaan:

\n

Linux / macOS

Shell
$ django-admin runserver --insecure\n
\n

Windows

Windows
...\\> django-admin runserver --insecure\n
\n
\n
\n
\n

PenyimpananLink to this heading#

\n
\n

StaticFilesStorageLink to this heading#

\n
\n
\nclass storage.StaticFilesStorageLink to this definition#
\n
\n\n

Sebuah subkelas dari backend penyimpanan FileSystemStorage yang menggunakan pengaturan STATIC_ROOT sebagai berkas dasar tempat sistem dan pengaturan STATIC_URL masing-masing sebagai dasar URL.

\n
\n
\nstorage.StaticFilesStorage.post_process(paths, **options)Link to this definition#
\n
\n\n

Jika metode ini ditentukan pada penyimpanan, itu dipanggil oleh perintah pengelolaan collectstatic setelah tiap larian dan meloloskan penyimpanan lokal dan jalur dari berkas-berkas ditemukan sebagai sebuah dictionary, sama halnya pilihan baris perintah. Itu menghasilkan tuple-tuple dari tiga nilai: original_path, processed_path, processed. Nilai jalur adalah string dan processed adalah boolean mengunjukkan apakah atau tidak nilai setelah-diolah, atau sebuah pengecualian jika setelah-diolah gagal.

\n

ManifestStaticFilesStorage menggunakan dibelakang layar ini untuk mengganti jalur dengan pasangan campuran mereka dan memperbaharui cache secara tepat.

\n
\n
\n

ManifestStaticFilesStorageLink to this heading#

\n
\n
\nclass storage.ManifestStaticFilesStorageLink to this definition#
\n
\n\n

Sebuah subkelas dari backend penyimpanan StaticFilesStorage yang menyimpan nama berkas itu tangani dengan menambahkan campuran MD5 dari isi berkas ke nama berkas. Sebagai contoh, berkas css/styles.css akan juga disimpan sebagai css/styles.55e7cbb9ba48.css.

\n

Tujuan dari penyimpanan ini adalah tetap melayani berkas-berkas bilamana beberapa halaman masih mengacu ke berkas-berkas tersebut, misalnya karena mereka di cache oleh anda atau peladen proxy pihak ke 3. Sebagai tambahan, itu sangat membantu jika anda ingin memberlakukan far future Expires headers pada berkas pengembangan untuk mempercepat waktu muat untuk kunjungan halaman selanjutnya.

\n

The storage backend automatically replaces the paths found in the saved\nfiles matching other saved files with the path of the cached copy (using\nthe post_process()\nmethod). The regular expressions used to find those paths\n(django.contrib.staticfiles.storage.HashedFilesMixin.patterns) cover:

\n\n

Subclass ManifestStaticFilesStorage and set the\nsupport_js_module_import_aggregation attribute to True, if you want to\nuse the experimental regular expressions to cover:

\n\n

For example, the 'css/styles.css' file with this content:

\n
Css
@import url("../admin/css/base.css");\n
\n

...would be replaced by calling the\nurl() method of the\nManifestStaticFilesStorage storage backend, ultimately saving a\n'css/styles.55e7cbb9ba48.css' file with the following content:

\n
Css
@import url("../admin/css/base.27e20196a850.css");\n
\n\n

You can change the location of the manifest file by using a custom\nManifestStaticFilesStorage subclass that sets the manifest_storage\nargument. For example:

\n
Code
from django.conf import settings\nfrom django.contrib.staticfiles.storage import (\n    ManifestStaticFilesStorage,\n    StaticFilesStorage,\n)\n\n\nclass MyManifestStaticFilesStorage(ManifestStaticFilesStorage):\n    def __init__(self, *args, **kwargs):\n        manifest_storage = StaticFilesStorage(location=settings.BASE_DIR)\n        super().__init__(*args, manifest_storage=manifest_storage, **kwargs)\n
\n\n
\n
\nstorage.ManifestStaticFilesStorage.manifest_hashLink to this definition#
\n
\n\n

This attribute provides a single hash that changes whenever a file in the\nmanifest changes. This can be useful to communicate to SPAs that the assets on\nthe server have changed (due to a new deployment).

\n
\n
\nstorage.ManifestStaticFilesStorage.max_post_process_passesLink to this definition#
\n
\n\n

Sejak berkas-berkas tetap mungkin mengacu berkas-berkas tetap lainnya yang butuh jalur mereka diganti, banyak pelewatan dari mengganti jalur mungkin dibutuhkan sampai campuran berkas bertemu di satu tempat. Untuk mencegah dari putaran tak terbatas pada campuran tidak bertemu di satu tempat (sebagai contoh, jika 'foo.css' mengacu 'bar.css' yang mengacu 'foo.css') ada angka maksimal dari pelewatan sebelum setelah-pengolahan diabaikan. Dalam kasus dengan sejumlah besar acuan, ankga tertinggi dari pelewatan mungkin dibutuhkan. Meningkatkan angka maksimal dari pelewatan dengan mensubkelaskan ManifestStaticFilesStorage dan mengatur atribut``max_post_process_passes``. Itu awalan pada 5.

\n

Untuk mengadakan ManifestStaticFilesStorage anda harus memastikan persyaratan berikut terpenuhi:

\n\n

Sejak membuat campuran MD5 hash bisa menjadi beban kinerja ke situs jaringan anda selama waktu berjalan, staticfiles akan otomatis menyimpan pemetaan dengan nama dicampur untuk semua berkas-berkas terolah dalam sebuah panggilan berkas staticfiles.json. Ini terjadi sekali ketika anda menjalankan perintah pengelolaan collectstatic.

\n
\n
\nstorage.ManifestStaticFilesStorage.manifest_strictLink to this definition#
\n
\n\n

Jika sebuah berkas tidak ditemukan dalam wujud staticfiles.json pada waktu berjalan, sebuah ValueError dimunculkan. Perilaku ini dapat ditiadakan dengan mensubkelaskan ManifestStaticFilesStorage dan mengatur atribut manifest_strict menjadi False -- jalur tidak ada akan tetap tidak berubah.

\n

Due to the requirement of running collectstatic, this storage\ntypically shouldn't be used when running tests as collectstatic isn't run\nas part of the normal test setup. During testing, ensure that staticfiles\nstorage backend in the STORAGES setting is set to something else\nlike 'django.contrib.staticfiles.storage.StaticFilesStorage' (the default).

\n
\n
\nstorage.ManifestStaticFilesStorage.file_hash(name, content=None)Link to this definition#
\n
\n\n

Metode yang digunakan ketika membuat nama dicampur dari berkas. Butuh mengembalikan sebuah campuran untuk nama berkas dan isi yang diberikan. Secara awalan itu menghitung campuran MD5 dari potongan isi seperti disebutkan diatas. Merasa bebas untuk menimpa metode ini untuk digunakan algotirma campuran anda sendiri.

\n
\n
\n

ManifestFilesMixinLink to this heading#

\n
\n
\nclass storage.ManifestFilesMixinLink to this definition#
\n
\n\n

Gunakan mixin ini dengan penyimpanan penyesuaian untuk menambahkan campuran MD5 dari isi berkas ke nama berkas seperti ManifestStaticFilesStorage lakukan.

\n
\n
\n
\n

penemu ModulLink to this heading#

\n

Penemu staticfiles mempunyai sebuah atribut searched_locations dimana daftar dari jalur direktori dimana penemu mencari. Contoh penggunaan:

\n
Code
from django.contrib.staticfiles import finders\n\nresult = finders.find("css/base.css")\nsearched_locations = finders.searched_locations\n
\n
\n
\n

Pembantu LainLink to this heading#

\n

Ada sedikit pembantu lain diluar dari aplikasi staticfiles untuk bekerja dengan berkas-berkas tetap:

\n\n
\n

Tampilan pengembahan berkas tetapLink to this heading#

\n

Alat-alat berkas statis kebanyakan dirancang untuk membantu dengan mendapatkan berkas-berkas statis berhasil disebarkan kedalam produksi. Ini biasanya berarti memisahkan, peladen berkas statis berdedikasi, yaitu banyak overhead dikacaukan ketika mengembangkan secara lokal. Dengan demikian, aplikasi staticfiles dikirim dengan sebuah tampilan pembantu cepat dan jorok yang anda dapat gunakan untuk melayani berkas-berkas secara lokal dalam pengembangan.

\n
\n
\nviews.serve(request, path)Link to this definition#
\n
\n\n

Ini menampilkan fungsi melayani berkas-berkas tetap dalam pengembangan.

\n\n\n

Tampilan ini otomatis diadakan oleh runserver (dengan pengaturan DEBUG disetel menjadi True). Untuk menggunakan tampilan dengan peladen pengembangan lokal bereda, tambah potongan berikut ke akhir dari konfigurasi URL utama anda:

\n
Code
from django.conf import settings\nfrom django.contrib.staticfiles import views\nfrom django.urls import re_path\n\nif settings.DEBUG:\n    urlpatterns += [\n        re_path(r"^static/(?P<path>.*)$", views.serve),\n    ]\n
\n

catat, awal dari pola (r'^static/') seharusnya pengaturan STATIC_URL anda.

\n

Sejak ini adalah sedikit rewel, ada juga fungsi pembantu yang akan melakukan ini untuk anda:

\n
\n
\nurls.staticfiles_urlpatterns()Link to this definition#
\n
\n\n

Ini akan mengembalikan pola URL sebenarnya untuk melayani berkas-berkas tetap ke daftar pola anda sudah tetapkan. Gunakan itu seperti ini:

\n
Code
from django.contrib.staticfiles.urls import staticfiles_urlpatterns\n\n# ... the rest of your URLconf here ...\n\nurlpatterns += staticfiles_urlpatterns()\n
\n

Ini akan memeriksa pengaturan STATIC_URL anda dan mengikat tampilan untuk melayani berkas-berkas tetap sesuai. jangan lupa mensetel pengaturan STATICFILES_DIRS dengan tepat untuk membuat django.contrib.staticfiles tahu dimana mencari untuk berkas-berkas tambahan ke berkas-berkas dalam direktori aplikasi.

\n\n
\n
\n

Kasus percobaan khusus untuk mendukung 'live testing'Link to this heading#

\n
\n
\nclass testing.StaticLiveServerTestCaseLink to this definition#
\n
\n\n

Subkelas TestCase unittest ini memperpanjang django.test.LiveServerTestCase.

\n

Sama seperti orang tuanya, anda dapat menggunakan itu menulis percobaan yang melibatkan kode dibawah percobaan dan menkonsumsi itu dengan alat-alat percobaan melalui HTTP (misalnya Selenium, PhantomJS, dll.), karena dimana itu dibutuhkan bahwa aset-aset statis juga diterbitkan.

\n

Tetapi diberikan kenyataan bahwa itu menggunakan dari tampilan django.contrib.staticfiles.views.serve() digambarkan diatas, itu dapat secara transparan melapisi pada waktu-penjalanan aset-aset disediakan oleh penemu staticfiles. Ini berarti anda tidak perlu menjalankan collectstatic sebelum atau sebagai bagian dari pengaturan percobaan anda.

\n
\n
","rootId":"module-django.contrib.staticfiles","toc":[{"title":"Pengaturan","anchor":"settings","children":[]},{"title":"Pengelolaan perintah","anchor":"management-commands","children":[{"title":"collectstatic","anchor":"collectstatic","children":[{"title":"Menyesuaikan daftar pola diabaikan","anchor":"customizing-the-ignored-pattern-list","children":[]}]},{"title":"findstatic","anchor":"findstatic","children":[]},{"title":"runserver","anchor":"runserver","children":[]}]},{"title":"Penyimpanan","anchor":"storages","children":[{"title":"StaticFilesStorage","anchor":"staticfilesstorage","children":[]},{"title":"ManifestStaticFilesStorage","anchor":"manifeststaticfilesstorage","children":[]},{"title":"ManifestFilesMixin","anchor":"manifestfilesmixin","children":[]}]},{"title":"penemu Modul","anchor":"finders-module","children":[]},{"title":"Pembantu Lain","anchor":"other-helpers","children":[{"title":"Tampilan pengembahan berkas tetap","anchor":"static-file-development-view","children":[]},{"title":"Kasus percobaan khusus untuk mendukung 'live testing'","anchor":"specialized-test-case-to-support-live-testing","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Acuan API","url":"/id/5.2/ref/"},{"docname":"ref/contrib/index","title":"Paket contrib","url":"/id/5.2/ref/contrib/"}],"prev":{"docname":"ref/contrib/sites","title":"Kerangka kerja \"sites\"","url":"/id/5.2/ref/contrib/sites/"},"next":{"docname":"ref/contrib/syndication","title":"Kerangka kerja umpan perkongsian","url":"/id/5.2/ref/contrib/syndication/"},"formats":{"html":"/id/5.2/ref/contrib/staticfiles/","markdown":"/id/5.2/ref/contrib/staticfiles.md","json":"/id/5.2/ref/contrib/staticfiles.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/staticfiles.txt","official":"https://docs.djangoproject.com/id/5.2/ref/contrib/staticfiles/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}