---
title: "Catatan terbitan Django 1.10"
version: 3.2
locale: id
source: https://docs.djangoproject.com/id/3.2/releases/1.10/
canonical: https://djangodocs.dev/id/3.2/releases/1.10/
---
# Catatan terbitan Django 1.10
*Agustus 1, 2016*
Selamat datang di Django 1.10!
Catatan terbitan ini melingkupi [new features](#whats-new-1-10), sama halnya beberapa [backwards incompatible changes](#backwards-incompatible-1-10) anda ingin sadari dari ketika meningkatkan dari Django 1.9 atau versi terlama. Kami telah [dropped some features](#removed-features-1-10) yang telah mencapai akhir dari siklus pengusangan mereka, dan kami telah [begun the deprecation process for some features](#deprecated-features-1-10).
Lihat panduan [Meningkatkan Django ke versi terbaru](/id/3.2/howto/upgrade-version/) jika anda sedang memperbaharui proyek yang ada.
## Kesesuaian Python
Seperti Django 1.9, Django 1.10 membutuhkan Python 2.7, 3.4, atau 3.5. Kami **sangat menganjurkan** dan hanya secara resmi mendukung terbitan terakhir dari setiap rangkaian.
## Apa yang baru di Django 1.10
### Pencarian teks penuh untuk PostgreSQL
`django.contrib.postgres` sekarang menyertakan [collection of database functions](/id/3.2/ref/contrib/postgres/search/) untuk mengizinkan penggunaan dari pencarian teks penuh mesin pencarian. Anda dapat mencari lintas bidang banyak di hubungan basisdata, memadukan pencarian dengan pencarian lain, menggunakan konfigurasi dan pembobotan bahasa berbeda, dan memangkatkan hasil berdasarkan pertalian.
Itu juga sekarang menyertakan dukungan trigram, menggunakan pencarian [`trigram_similar`](/id/3.2/ref/contrib/postgres/lookups/#std-fieldlookup-trigram_similar), dan pernyataan [`TrigramSimilarity`](/id/3.2/ref/contrib/postgres/search/#django.contrib.postgres.search.TrigramSimilarity) dan [`TrigramDistance`](/id/3.2/ref/contrib/postgres/search/#django.contrib.postgres.search.TrigramDistance).
### Middleware gaya-baru
[A new style of middleware is introduced](/id/3.2/topics/http/middleware/) to
solve the lack of strict request/response layering of the old-style of
middleware described in [DEP 0005](https://github.com/django/deps/blob/main/final/0005-improved-middleware.rst).
You'll need to [adapt old, custom middleware](/id/3.2/topics/http/middleware/#upgrading-middleware) and
switch from the `MIDDLEWARE_CLASSES` setting to the new [`MIDDLEWARE`](/id/3.2/ref/settings/#std-setting-MIDDLEWARE)
setting to take advantage of the improvements.
### Dukungan resmi untuk nama pengguna Unicode
Model [`User`](/id/3.2/ref/contrib/auth/#django.contrib.auth.models.User) dalam `django.contrib.auth` aslinya hanya menerima huruf ASCII dan angka dalam nama penggna. Meskipun itu bukan pilhan disengaja, karakter Unicode selalu diterima ketika menggunakan Python 3.
Validator username saat ini menerima karakter Unicode secara default hanya di Python 3.
Penyesuaian model user mungkin menggunakan [`ASCIIUsernameValidator`](/id/3.2/ref/contrib/auth/#django.contrib.auth.validators.ASCIIUsernameValidator) atau [`UnicodeUsernameValidator`](/id/3.2/ref/contrib/auth/#django.contrib.auth.validators.UnicodeUsernameValidator).
### Fitur kecil
#### [`django.contrib.admin`](/id/3.2/ref/contrib/admin/#module-django.contrib.admin)
- Untuk situs-situs berjalan pada subjalur, [`URL awal untuk tautan "View site"`](/id/3.2/ref/contrib/admin/#django.contrib.admin.AdminSite.site_url) pada atas dari setiap halaman admin akan sekarang menunjuk ke `request.META['SCRIPT_NAME']` jika disetel, daripada `/`.
- Pesan berhasil yang muncul setelah menambahkan atau menyunting sebuah obyek sekarang mengandung sebuah tautan ke formulir rubah obyek.
- Semua deretan JavaScript dipindahkan jadi anda dapat mengadakan kepala HTTP `Content-Security-Policy` jika anda ingin.
- Atribut [`InlineModelAdmin.classes`](/id/3.2/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin.classes) baru mengizinkan menetapkan kelas-kelas pada deretam kumpulan bidang. Berderet dengan kelas `collapse` akan awalnya diruntuhkan dan kepala mereka akan mempunyai tautan "show" kecil.
- If a user doesn't have the add permission, the `object-tools` block on a
model's changelist will now be rendered (without the add button). This makes
it easier to add custom tools in this case.
- Model [`LogEntry`](/id/3.2/ref/contrib/admin/#django.contrib.admin.models.LogEntry) sekarang menyimpan pesan-pesan berubah di struktur JSON sehingga pesan dapat secara dinamis diterjemahkan menggunakan bahasa aktif saat ini. Metode `LogEntry.get_change_message()` baru sekarang dipilih dari mengambil pesan berubah.
- Obyek terpilih untuk bidang di `ModelAdmin.raw_id_fields` sekarang mempunyai sebuah tautan ke formulir rubah obyek.
- Ditambahkan pilihan "No date" dan "Has date" untuk `DateFieldListFilter` jika bidang adalah nullable.
- Pustaka jQuery ditanam di admin ditingkatkan dari versi 2.1.4 ke 2.2.3.
#### [`django.contrib.auth`](/id/3.2/topics/auth/#module-django.contrib.auth)
- Ditambahkan dukungan untuk [Argon2 password hash](/id/3.2/topics/auth/passwords/#argon2-usage). Dianjurkan terhadap PBKDF2, bagaimanapun, itu bukan awal seperti itu membutuhkan pustaka pihak-ketiga.
- Perhitungan perulangan awal untuk pengacak sandi PBKDF2 telah ditingkatkan oleh 25%. Perubahan kesesuaian kebelakang tidak akan mempengaruhi pengguna yang mempunyai subkelas `django.contrib.auth.hashers.PBKDF2PasswordHasher` untuk merubah nilai awal.
- Tampilan `django.contrib.auth.views.logout()` mengirim kepala "no-cache" untuk mencegah sebuah masalah dimana cache Safari pengalihan dan mencegah seorang pengguna menjadi dapat keluar.
- Ditambahkan argumen pilihan `backend` pada [`django.contrib.auth.login()`](/id/3.2/topics/auth/default/#django.contrib.auth.login) untuk menggunakan itu tanpa without surat pengenal.
- Pengaturan [`LOGOUT_REDIRECT_URL`](/id/3.2/ref/settings/#std-setting-LOGOUT_REDIRECT_URL) baru mengendalikan pengalihan dari tampilan `logout()`, jika tampilan tidak mendapatkan argumen `next_page`.
- Parameter `redirect_authenticated_user` baru untuk tampilan `django.contrib.auth.views.login()` mengizinkan pengalihan pengguna terautentifikasi mengunjungi halaman masuk.
- [`AllowAllUsersModelBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersModelBackend) dan [`AllowAllUsersRemoteUserBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersRemoteUserBackend) baru mengabaikan nilai dari `User.is_active`, selagi [`ModelBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.ModelBackend) dan [`RemoteUserBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend) sekarang menolak pengguna tidak aktif.
#### [`django.contrib.gis`](/id/3.2/ref/contrib/gis/#module-django.contrib.gis)
- [Distance lookups](/id/3.2/ref/contrib/gis/geoquerysets/#distance-lookups) sekarang menerima pernyataan sebagai jarak parameter nilai.
- Harta [`GEOSGeometry.unary_union`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.unary_union) baru menghitung gabungan dari semua unsur dari geometri ini.
- Ditambahkan sebutan biner [`GEOSGeometry.covers()`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.covers).
- Ditambahkan metode [`GDALBand.statistics()`](/id/3.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.statistics) dan atribut [`mean`](/id/3.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.mean) dan [`std`](/id/3.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.std).
- Ditambahkan dukungan untuk pengumpulan fungsi [`MakeLine`](/id/3.2/ref/contrib/gis/geoquerysets/#django.contrib.gis.db.models.MakeLine) dan [`GeoHash`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.GeoHash) pada SpatiaLite.
- Ditambahkan dukungan untuk fungsi [`Difference`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.Difference), [`Intersection`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.Intersection), dan [`SymDifference`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.SymDifference) pada MySQL.
- Ditambahkan dukungan untuk instantisi geometri GEOS kosong.
- Harta [`trim`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.WKTWriter.trim) dan [`precision`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.WKTWriter.precision) baru dari [`WKTWriter`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.WKTWriter) mengizinkan mengendalikan keluaran dari bagian pecahan dari kordinat di WKT.
- Ditambahkan harta [`LineString.closed`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.LineString.closed) dan [`MultiLineString.closed`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.MultiLineString.closed).
- [GeoJSON serializer](/id/3.2/ref/contrib/gis/serializers/) sekarang mengeluarkan primary key dari obyek di kamus `properties` jika bidang tertentu tidak ditetapkan.
- Kemampuan melipat data masukan pada metode [`GDALBand.data()`](/id/3.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GDALBand.data) telah ditambahkan. Pita data sekarang dapat diperbaharui dengan nilai berulang secara efisien.
- Ditambahkan fungsi basisdata [`IsValid`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.IsValid) dan [`MakeValid`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.MakeValid), sama halnya seperti pencarian [`isvalid`](/id/3.2/ref/contrib/gis/geoquerysets/#std-fieldlookup-isvalid), semua untuk PostGIS. Ini mengizinkan menyaring dan memperbaiki geometri tidak sah pada sisi basisdata.
- Ditambahkan dukungan raster untuk semua [spatial lookups](/id/3.2/ref/contrib/gis/geoquerysets/).
#### [`django.contrib.postgres`](/id/3.2/ref/contrib/postgres/#module-django.contrib.postgres)
- Untuk meyakinkan, [`HStoreField`](/id/3.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.HStoreField) sekarang memberikan kunci dan nilainya ke deretan karakter.
#### [`django.contrib.sessions`](/id/3.2/topics/http/sessions/#module-django.contrib.sessions)
- Perintah pengelolaan [`clearsessions`](/id/3.2/ref/django-admin/#django-admin-clearsessions) sekarang memindahkan sesi berdasarkan-berkas.
#### [`django.contrib.sites`](/id/3.2/ref/contrib/sites/#module-django.contrib.sites)
- Model [`Site`](/id/3.2/ref/contrib/sites/#django.contrib.sites.models.Site) sekarang mendukung [natural keys](/id/3.2/topics/serialization/#topics-serialization-natural-keys).
#### [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles)
- Etiket cetakan [`static`](/id/3.2/ref/templates/builtins/#std-templatetag-static) sekarang menggunakan `django.contrib.staticfiles` jika itu didalam `INSTALLED_APPS`. Ini khususnya berguna untuk aplikasi pihak ketiga yang dapat sekarang selalu menggunakan `{% load static %}` (sebagai gantinya dari `{% load staticfiles %}` atau `{% load static from staticfiles %}`) dan tidak khawatir tentang apakah atau tidak aplikasi `staticfiles` terpasang.
- Anda dapat more easily customize 1 pilihan `collectstatic --ignore` dengan `AppConfig` penyesuaian.
#### Tembolok
- Backend tembolok berdasarkan-berkas sekarang menggunakan protokol pengasaman tertinggi.
#### CSRF
- [`CSRF_FAILURE_VIEW`](/id/3.2/ref/settings/#std-setting-CSRF_FAILURE_VIEW) awal, `views.csrf.csrf_failure()` sekarang menerima sebuah pilihan parameter `template_name`, awal ke `'403_csrf.html'`, untuk mengendalikan cetakan digunakan untuk membangun halaman.
- Untuk melindungi terhadap serangan [BREACH](http://breachattack.com/), mekanisme perlindungan CSRF sekarang merubah nilai token formulir pada setiap permintaan (selagi menjaga sebuah rahasia tidak berubah yang dapat digunakan untuk mensahkan token berbeda).
#### Backend basisdata
- Pengurangan data sementara telah digabungkan pada semua backend.
- Jika basisdata mendukungnya, backend dapat menyetel `DatabaseFeatures.can_return_ids_from_bulk_insert=True` dan menerapkan `DatabaseOperations.fetch_returned_insert_ids()` untuk menyetel primary key pada obyek dibuat menggunakan `QuerySet.bulk_create()`.
- Ditambahkan argumen kata kunci pada metode `as_sql()` dari beragam pernyataan (`Func`, `When`, `Case`, dan `OrderBy`) untuk mengizinkan backend basisdata untuk menyesuaikan mereka tanpa mengubah `self`, yang tidak aman menggunakan backend basisdata berbeda. Lihat parameter `arg_joiner` dan `**extra_context` dari [`Func.as_sql()`](/id/3.2/ref/models/expressions/#django.db.models.Func.as_sql) untuk sebuah contoh.
#### Penyimpanan Berkas
- Backend penyimpanan sekarang menghadirkan API sadar-zona waktu dengan metode baru [`get_accessed_time()`](/id/3.2/ref/files/storage/#django.core.files.storage.Storage.get_accessed_time), [`get_created_time()`](/id/3.2/ref/files/storage/#django.core.files.storage.Storage.get_created_time), dan [`get_modified_time()`](/id/3.2/ref/files/storage/#django.core.files.storage.Storage.get_modified_time). Mereka mengembalikan `datetime` waspada zona waktu jika [`USE_TZ`](/id/3.2/ref/settings/#std-setting-USE_TZ) adalah `True` dan `datetime` tidak dibuat-buat di zona waktu lokal jikalau tidak.
- Metode [`Storage.generate_filename()`](/id/3.2/ref/files/storage/#django.core.files.storage.Storage.generate_filename) baru membuatnya semakin mudah untuk menerapkan penyimpanan penyesuaian yang tidak menggunakan `os.path` memanggil sebelumnya di [`FileField`](/id/3.2/ref/models/fields/#django.db.models.FileField).
#### Formulir
- Formulir dan widget `Media` sekarang dilayani menggunakan [`django.contrib.staticfiles`](/id/3.2/ref/contrib/staticfiles/#module-django.contrib.staticfiles) jika terpasang.
- Etiket `` dibangun oleh [`CharField`](/id/3.2/ref/forms/fields/#django.forms.CharField) sekarang menyertakan atribut `minlength` jika bidang mempunyai `min_length`.
- Bidang formulir yang diwajibkan sekarang mempunyai atribut HTML `required`. Setel atribut [`Form.use_required_attribute`](/id/3.2/ref/forms/api/#django.forms.Form.use_required_attribute) baru menjadi `False` untuk meniadakannya. Atribut `required` tidak disertakan pada formulir dari formset karena pengesahan peramban mungkin tidak benar ketika menambahkan dan menghapus formset.
#### Tampilan Umum
- Kelas [`View`](/id/3.2/ref/class-based-views/base/#django.views.generic.base.View) sekarang dapat diimpor dari `django.views`.
#### Internasionalisasi
- Fungsi pembantu [`i18n_patterns()`](/id/3.2/topics/i18n/translation/#django.conf.urls.i18n.i18n_patterns) sekrang dapat digunakan di akar URLConf ditentukan menggunakan [`request.urlconf`](/id/3.2/ref/request-response/#django.http.HttpRequest.urlconf).
- Dengan menyetel parameter `prefix_default_language` baru untuk [`i18n_patterns()`](/id/3.2/topics/i18n/translation/#django.conf.urls.i18n.i18n_patterns) menjadi `False`, anda dapat mengizinkan mengakses bahasa awal tanpa awalan URL.
- [`set_language()`](/id/3.2/topics/i18n/translation/#django.views.i18n.set_language) sekarang mengembalikan kode keadaan 204 (Tidak ada Isi) untuk permintaan AJAX ketika tidak ada parameter `next` di `POST` atau `GET`.
- Tampilan berdasarkan kelas [`JavaScriptCatalog`](/id/3.2/topics/i18n/translation/#django.views.i18n.JavaScriptCatalog) dan [`JSONCatalog`](/id/3.2/topics/i18n/translation/#django.views.i18n.JSONCatalog) menggantikan pengusangan tampilan berdasarkan fungsi `javascript_catalog()` dan `json_catalog()`. Tampilan baru hampir sama ke yang lama kecuali itu oleh awal tampilan baru mengumpulkan semua deretan karakter JavaScript di ranag terjemahan `djangojs` dari semua aplikasi terpasang daripada hanya deretan karakter JavaScript dari [`LOCALE_PATHS`](/id/3.2/ref/settings/#std-setting-LOCALE_PATHS).
#### Pengelolaan perintah
- [`call_command()`](/id/3.2/ref/django-admin/#django.core.management.call_command) sekarang mengembalikan nilai dikembalikan dari metode `command.handle()`.
- Pilihan [`check --fail-level`](/id/3.2/ref/django-admin/#cmdoption-check-fail-level) baru mengizinkan menentukan tingkatan pesan yang akan menyebabkan perintah keluar dengan keadaan bukan nol.
- Pilihan [`makemigrations --check`](/id/3.2/ref/django-admin/#cmdoption-makemigrations-check) baru membuat perintah keluar dengan keadaan bukan nol ketika model berubah tanpa perpindahan dikenali.
- [`makemigrations`](/id/3.2/ref/django-admin/#django-admin-makemigrations) sekarang menampilkan jalur ke berkas perpindahan yang dia bangkitkan.
- Pilihan [`shell --interface`](/id/3.2/ref/django-admin/#cmdoption-shell-interface) sekarang menerima `python` untuk memaksa menggunakan penafsir Python `plain`.
- Pilihan [`shell --command`](/id/3.2/ref/django-admin/#cmdoption-shell-command) baru membiarkan anda menjalankan perintah sebagai Django dan keluar, daripada membuka shell interaktif.
- Ditambahkan peringatan ke [`dumpdata`](/id/3.2/ref/django-admin/#django-admin-dumpdata) jka model proxy ditentukan (yang menghasilkan tidak ada keluaran) tanpa wujud induknya.
- Atribut [`BaseCommand.requires_migrations_checks`](/id/3.2/howto/custom-management-commands/#django.core.management.BaseCommand.requires_migrations_checks) baru mungkin disetel menjadi `True` jika anda ingin perintah anda mencetak peringatan, seperti [`runserver`](/id/3.2/ref/django-admin/#django-admin-runserver) lakukan, jika kumpulan dari perpindahan pada cakram tidak cocok perpindahan di basisdata.
- Untuk memandu dengan percobaan, [`call_command()`](/id/3.2/ref/django-admin/#django.core.management.call_command) sekarang menerima obyek perintah sebagai argumen pertama.
- Perintah [`shell`](/id/3.2/ref/django-admin/#django-admin-shell) mendukung penyelesaian label pada sistem menggunakan `libedit`, misalnya macOS.
- Perintah [`inspectdb`](/id/3.2/ref/django-admin/#django-admin-inspectdb) membiarkan anda memilih tabel apa harus diperiksa dengan menentukan nama-nama mereka sebagai argumen.
#### Perpindahan
- Ditambahkan dukungan untuk serialisasi dari obyek `enum.Enum`.
- Ditambahkan argumen `elidable` pada tindakan [`RunSQL`](/id/3.2/ref/migration-operations/#django.db.migrations.operations.RunSQL) dan [`RunPython`](/id/3.2/ref/migration-operations/#django.db.migrations.operations.RunPython) untuk mengizinkan mereka dipindahkan ketika melumat perpindahan.
- Ditambahkan dukungan untuk [non-atomic migrations](/id/3.2/howto/writing-migrations/#non-atomic-migrations) dengan mengatur atribut `atomic` pada `Migration`.
- Perintah `migrate` dan `makemigrations` sekarang [check for a consistent migration history](/id/3.2/topics/migrations/#migration-history-consistency). Jika mereka menemukan beberapa ketergantungan yang tidak berlaku pada sebuah perpindahan yang dilakukan, `InconsistentMigrationHistory` muncul.
- Sinyal [`pre_migrate()`](/id/3.2/ref/signals/#django.db.models.signals.pre_migrate) dan [`post_migrate()`](/id/3.2/ref/signals/#django.db.models.signals.post_migrate) sekarang mengirim perpindahan `plan` dan `apps` mereka.
#### Model
- Membalikkan foreign key dari model proxy sekarang diperbanyak ke wujud kelas mereka. Membalikkan hubungan dilampirkan oleh [`ForeignKey`](/id/3.2/ref/models/fields/#django.db.models.ForeignKey) menunjuk ke model proxy sekarang tersedia sebagai penjelasan pada kelas model yang di proxy kan dan mungkin diacukan di penyaring queryset.
- Metode [`Field.rel_db_type()`](/id/3.2/ref/models/fields/#django.db.models.Field.rel_db_type) baru mengembalikan jenis data basisdata untuk bidang seperti `ForeignKey` dan `OneToOneField` yang menunjuk ke bidang lain.
- Atribut kelas [`arity`](/id/3.2/ref/models/expressions/#django.db.models.Func.arity) ditambahkan ke [`Func`](/id/3.2/ref/models/expressions/#django.db.models.Func). Atribut ini dapat digunakan untuk menyetel sejumlah argumen fungis penerimaan.
- Ditambahkan [`BigAutoField`](/id/3.2/ref/models/fields/#django.db.models.BigAutoField) yang bertindak seperti sebuah pengecualian [`AutoField`](/id/3.2/ref/models/fields/#django.db.models.AutoField) yang di jaminkan untuk mencocokkan angka dari `1` sampai `9223372036854775807`.
- [`QuerySet.in_bulk()`](/id/3.2/ref/models/querysets/#django.db.models.query.QuerySet.in_bulk) mungkin dipanggil tanpa argumen apapun untuk mengembalikan semua obyek di queryset.
- [`related_query_name`](/id/3.2/ref/models/fields/#django.db.models.ForeignKey.related_query_name) sekarang mendukung label aplikasi dan penyisipan kelas menggunakan deretan karakter `'%(app_label)s'` dan `'%(class)s'`.
- Diizinkan mengutamakan bidang model diwariskan dari kelas-kelas berdasarkan abstrak.
- Fungsi [`prefetch_related_objects()`](/id/3.2/ref/models/querysets/#django.db.models.prefetch_related_objects) sekarang APU umum.
- [`QuerySet.bulk_create()`](/id/3.2/ref/models/querysets/#django.db.models.query.QuerySet.bulk_create) menyetel primary key pada obyek ketika menggunakan PostgreSQL.
- Ditambahkan fungsi basisdata [`Cast`](/id/3.2/ref/models/database-functions/#django.db.models.functions.Cast).
- Sebuah model proxy mungkin sekarang mewarisi banyak model proxy yang berbagi kelas induk bukan-abstrak umum.
- Ditambahkan fungsi-fungsi [`Extract`](/id/3.2/ref/models/database-functions/#django.db.models.functions.Extract) untuk mengambil komponen-komponen datetime sebagai integer, seperti tahun dan jam.
- Ditambahkan fungsi-fungsi [`Trunc`](/id/3.2/ref/models/database-functions/#django.db.models.functions.Trunc) untuk memotong tanggal atau datetime pada komponen penting. Mereka mengadakan permintaan seperti penjualan-per-hari atau penjualan-per-jam.
- `Model.__init__()` sekarang menyetel nilai dari bidang maya dari argumen kata kuncinya.
- Pilihan [`Meta.base_manager_name`](/id/3.2/ref/models/options/#django.db.models.Options.base_manager_name) dan [`Meta.default_manager_name`](/id/3.2/ref/models/options/#django.db.models.Options.default_manager_name) baru mengizinkan mengendalikan [`_base_manager`](/id/3.2/topics/db/managers/#django.db.models.Model._base_manager) dan [`_default_manager`](/id/3.2/topics/db/managers/#django.db.models.Model._default_manager), masing-masing.
#### Permintaan dan Tanggapan
- Ditambahkan `request.user` pada tampilan mencai kesalahan.
- Ditambahkan metode [`HttpResponse`](/id/3.2/ref/request-response/#django.http.HttpResponse) [`readable()`](/id/3.2/ref/request-response/#django.http.HttpResponse.readable) dan [`seekable()`](/id/3.2/ref/request-response/#django.http.HttpResponse.seekable) untuk membuat sebuah contoh obyek seperti-arus dan mengizinkan membungkusnya dengan [`io.TextIOWrapper`](https://docs.python.org/3/library/io.html#io.TextIOWrapper).
- Ditambahkan atribut [`HttpRequest.content_type`](/id/3.2/ref/request-response/#django.http.HttpRequest.content_type) dan [`content_params`](/id/3.2/ref/request-response/#django.http.HttpRequest.content_params) yang diuraikan dari kepala `CONTENT_TYPE`.
- Pengurai untuk `request.COOKIES` disederhanakan untuk perilaku pencocokan lebih baik dari peramban `request.COOKIES` sekarang mengandung kue yang tidak sah menurut [**RFC 6265**](https://datatracker.ietf.org/doc/html/rfc6265.html) tetapi memunginkan menyetel melalui `document.cookie`.
#### Serialisasi
- `django.core.serializers.json.DjangoJSONEncoder` sekarang mengetahui bagaimana menserialisasikan deretan karakter lazy, khususnya digunakan untuk isi terjemahan.
#### Templat
- Ditambahkan pilihan `autoescape` pada backend [`DjangoTemplates`](/id/3.2/topics/templates/#django.template.backends.django.DjangoTemplates) dan kelas [`Engine`](/id/3.2/ref/templates/api/#django.template.Engine).
- Ditambahkan penghubung perbandingan `is` dan `is not` pada etiket [`if`](/id/3.2/ref/templates/builtins/#std-templatetag-if).
- Diizinkan [`dictsort`](/id/3.2/ref/templates/builtins/#std-templatefilter-dictsort) untuk mengurutkan daftar dari daftar oleh unsur pada indeks yang ditentukan.
- Pengolah konteks [`debug()`](/id/3.2/ref/templates/api/#django.template.context_processors.debug) mengandung permintaan untuk semua nama lain basisdata daripada hanya nama lain awalan.
- Ditambahkan dukungan jalur relatif untuk argumen deretan karakter dari etiket cetakan [`extends`](/id/3.2/ref/templates/builtins/#std-templatetag-extends) dan [`include`](/id/3.2/ref/templates/builtins/#std-templatetag-include).
#### Pengujian
- Untuk penangkapan kesalahan lebih baik, [`TestCase`](/id/3.2/topics/testing/tools/#django.test.TestCase) sekarang memeriksa batasan basisdata dapat ditunda pada akhir setiap percobaan.
- Percobaan dan kasus percobaan dapat di [marked with tags](/id/3.2/topics/testing/tools/#topics-tagging-tests) dan dijalankan dipilih-pilih dengan pilihan [`test --tag`](/id/3.2/ref/django-admin/#cmdoption-test-tag) dan [`test --exclude-tag`](/id/3.2/ref/django-admin/#cmdoption-test-exclude-tag) baru.
- Anda sekarang dapat masuk dan menggunakan sesi dengan klien percobaan bahkan jika [`django.contrib.sessions`](/id/3.2/topics/http/sessions/#module-django.contrib.sessions) tidak di [`INSTALLED_APPS`](/id/3.2/ref/settings/#std-setting-INSTALLED_APPS).
#### URL
- Sebuah tambahan di [`django.setup()`](/id/3.2/ref/applications/#django.setup) mengizinkan URL menangani yang terjadi diluar dari siklus permintaan/tanggapan (sebagai contoh di perintah pengelolaan dan tulisan berdiri sendiri) untuk mengambil [`FORCE_SCRIPT_NAME`](/id/3.2/ref/settings/#std-setting-FORCE_SCRIPT_NAME) kedalam akun ketiks dia disetel.
#### Pengesah
- [`URLValidator`](/id/3.2/ref/validators/#django.core.validators.URLValidator) sekarang membatasi panjang dari label nama ranah sampai 63 karakter dan jumlah panjang dari nama ranah sampai 253 karakter per [**RFC 1034**](https://datatracker.ietf.org/doc/html/rfc1034.html).
- [`int_list_validator()`](/id/3.2/ref/validators/#django.core.validators.int_list_validator) sekarang menerima sebuah pilihan `allow_negative` parameter boolean, nilai awal ke `False`, untuk mengizinkan integer negatif.
## Perubahan bertentangan kebelakang di 1.10
> **Warning**
>
> Sebagai tambahan pada uraian berubah di bagian ini, pastikan meninjau [Fitur-fitur dipindahkan di 1.10](#removed-features-1-10) untuk fitur yang telah mencapai akhir dari siklus pengusangan mereka dan karena itu telah dipindahkan. Jika anda belum memperbaharui kode anda dalam linimasa pengusangan untuk fitur diberikan, perpindahan ini mungkin muncul sebagai perubahan ketidaksesuaian kebelakang.
### API backend basisdata
- `AreaField` GIS menggunakan jenis numerik dasar tidak ditentukan yang dapat dalam praktiknya menjadi jenis Python numerik apapun. Nilai `decimal.Decimal` diambil dari basisdata sekarang dirubah menjadi `float` untuk membuatnya lebih mudah memadukan mereka dengan nilai-nilai digunakan oleh pustaka GIS.
- Untuk mengadakan pengurangan sementara anda harus menyetel bendera fitur basisdata `supports_temporal_subtraction` menjadi `True` dan menerapkan metode `DatabaseOperations.subtract_temporals()`. Cara ini harus mengembalikan SQL dan parameter yang dibutuhkan untuk menghitung perbedaan dalam mikrodetik diantara argumen `lhs` dan `rhs` di jenis data digunakan untuk menyimpan [`DurationField`](/id/3.2/ref/models/fields/#django.db.models.DurationField).
### `select_related()` melarang bidang bukan-berhubungan untuk hubungan bersarang
Django 1.8 ditambahkan pengesahan untuk bidang bukan-hubungan di `select_related()`:
```
>>> Book.objects.select_related('title')
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'title'
```
Tetapi dia tidak melarang bidang bukan-hubungan bersarang seperti yang dia lakukan sekarang:
```
>>> Book.objects.select_related('author__name')
Traceback (most recent call last):
...
FieldError: Non-relational field given in select_related: 'name'
```
### `_meta.get_fields()` mengembalikan kesesuaian bidang membalikkan untuk model proxy
Sebelum Django 1.10, metode [`get_fields()`](/id/3.2/ref/models/meta/#django.db.models.options.Options.get_fields) mengembalikan bidang membalikkan yang berbeda ketika dipanggil pada model dibandingkan pada wujud kelas yang diwakilkan. Ketidaksesuaian telah diperbaiki dengan mengembalikan sekumpulan penuh dari bidang-bidang menunjuk ke kelas berwujud atau satu dari wakilnya di kedua kasus.
### [`AbstractUser.username`](/id/3.2/ref/contrib/auth/#django.contrib.auth.models.User.username) `max_length` ditingkatkan sampai 150
Sebuah perpindahan [`django.contrib.auth.models.User.username`](/id/3.2/ref/contrib/auth/#django.contrib.auth.models.User.username) disertakan. Jika anda mempunyai model pengguna penyesuaian diwariskan dari `AbstractUser`, anda akan butuh membangkitkan dan berlakukan perpindahan basisdata untuk model pengguna anda.
Kami mempertimbangkan peningkatan sampai 254 karakter untuk lebih mudah mengizinkan penggunaan alamat surel (yang terbatas sampai 254 karakter) sebagai nama pengguna tetapi ditolak karena batasan MySQL. Ketika menggunakan penyandian `utf8mb4` (dianjurkan untuk dukungan Unicode sesuai), MySQL dapat hanya membuat indeks unik dengan 191 karakter secara awal. Karena itu, jika anda butuh panjang lebih, harap gunakan model pengguna penyesuaian.
Jika anda ingin menyediakan batas 30 karakter untuk nama pengguna, gunakan formulir penyesuaian ketika membuat pengguna atau merubah nama pengguna:
```
from django.contrib.auth.forms import UserCreationForm
class MyUserCreationForm(UserCreationForm):
username = forms.CharField(
max_length=30,
help_text='Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only.',
)
```
Jika anda berharap menjaga batasan ini di admin, setel `UserAdmin.add_form` untuk menggunakan formulir ini:
```
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin
from django.contrib.auth.models import User
class UserAdmin(BaseUserAdmin):
add_form = MyUserCreationForm
admin.site.unregister(User)
admin.site.register(User, UserAdmin)
```
### Dibuang dukungan untuk PostgreSQL 9.1
Dukungan hulu untuk PostgreSQL 9.1 berakhir di September 2016. Sebagai konsekuensinya, Django 1.10 menyetel PostgreSQL 9.2 sebagai versi minimal dia secara resmi dukung.
### Keluaran `runserver` melewati pencatatan
Menangani permintaan dan tanggapan dari perintah `runserver` dikirim ke pencatat [django.server](/id/3.2/topics/logging/#django-server-logger) sebagai gantinya pada `sys.stderr`. Jika anda meniadakan konfigurasi pencatatan Django atau menimpa dengan anda sendiri, anda akan butuh menambahkan konfigurasi pencatatan yang sesuai jika anda ingin melihat keluaran itu:
```
'formatters': {
'django.server': {
'()': 'django.utils.log.ServerFormatter',
'format': '[%(server_time)s] %(message)s',
}
},
'handlers': {
'django.server': {
'level': 'INFO',
'class': 'logging.StreamHandler',
'formatter': 'django.server',
},
},
'loggers': {
'django.server': {
'handlers': ['django.server'],
'level': 'INFO',
'propagate': False,
}
}
```
### Model percobaan `auth.CustomUser` dan `auth.ExtensionUser` dipindahkan.
Sejak perkenalan dari perpindahan untuk bantuan aplikasi di Django 1.8, tabel dari model percobaan pengguna penyesuaian ini tidak dibuat lagi membuat mereka tidak berguna dalam konteks percobaan.
### Registrar aplikasi tidak lagi otomatis dikumpulkan ketika membongkar model diluar Django
The apps registry is no longer auto-populated when unpickling models. This was
added in Django 1.7.2 as an attempt to allow unpickling models outside of
Django, such as in an RQ worker, without calling `django.setup()`, but it
creates the possibility of a deadlock. To adapt your code in the case of RQ,
you can [provide your own worker script](https://python-rq.org/docs/workers/)
that calls `django.setup()`.
### Dipindahkan pemeriksaan penugasan null untuk bidang foreign key bukan-null
Dalam versi terlama, menugaskan `None` pada `ForeignKey` atau `OneToOneField` nukan-null memunculkan `ValueError('Cannot assign None: "model.field" does not allow null values.')`. Untuk ketidakkonsistenan dengan bidang model lain yang tidak mempunyai pemeriksaan sama, pemeriksaan ini dipindahkan.
### Dipindahkan pengacak sandi lemah dari pengaturan `PASSWORD_HASHERS` awal
Django 0.90 menyimpan sandi sebagai MD5 tidak tergarami. Django 0.91 ditambahkan dukungan untuk SHA1 tergarami dengan peningkatan otomatis dari sandi ketika penggina masuk. Django 1.4 ditambahkan PBKDF2 sebagai pengacak sandi awal.
Jika anda mempunyai proyek Django lama dengan MD5 atau SHA1 (bahkan tergarami) sandi dikodekan, sadarilah bahwa ini dapat dirusak dengan mudah dengan perangkat keras hari ini. Untuk membuat pengguna Django mengakui penggunaan berkelanjutan dari pengacak lemah, pencampur berikut dipindahkan dari [`PASSWORD_HASHERS`](/id/3.2/ref/settings/#std-setting-PASSWORD_HASHERS) setting awal:
```
'django.contrib.auth.hashers.SHA1PasswordHasher'
'django.contrib.auth.hashers.MD5PasswordHasher'
'django.contrib.auth.hashers.UnsaltedSHA1PasswordHasher'
'django.contrib.auth.hashers.UnsaltedMD5PasswordHasher'
'django.contrib.auth.hashers.CryptPasswordHasher'
```
Pertimbangkan menggunakan [wrapped password hasher](/id/3.2/topics/auth/passwords/#wrapping-password-hashers) untuk menguatkan campuran di basisdata anda. Jika itu tidak layak, tambah pengaturan [`PASSWORD_HASHERS`](/id/3.2/ref/settings/#std-setting-PASSWORD_HASHERS) ke proyek anda dan tambah kembali pencampur apapun yang anda butuhkan.
Anda dapat memeriksa jika basisdata anda mempunyai tiap dari pengacak dipindahkan seperti ini:
```
from django.contrib.auth import get_user_model
User = get_user_model()
# Unsalted MD5/SHA1:
User.objects.filter(password__startswith='md5$$')
User.objects.filter(password__startswith='sha1$$')
# Salted MD5/SHA1:
User.objects.filter(password__startswith='md5$').exclude(password__startswith='md5$$')
User.objects.filter(password__startswith='sha1$').exclude(password__startswith='sha1$$')
# Crypt hasher:
User.objects.filter(password__startswith='crypt$$')
from django.db.models import CharField
from django.db.models.functions import Length
CharField.register_lookup(Length)
# Unsalted MD5 passwords might not have an 'md5$$' prefix:
User.objects.filter(password__length=32)
```
### Metode `Field.get_prep_lookup()` dan `Field.get_db_prep_lookup()` dipindahkan.
Jika anda mempunyai bidang penyesuaian yang menerapkan baik metode ini, mendaftarkan pencarian penyesuaian untuknya. Sebagai contoh:
```
from django.db.models import Field
from django.db.models.lookups import Exact
class MyField(Field):
...
class MyFieldExact(Exact):
def get_prep_lookup(self):
# do_custom_stuff_for_myfield
....
MyField.register_lookup(MyFieldExact)
```
### [`django.contrib.gis`](/id/3.2/ref/contrib/gis/#module-django.contrib.gis)
- Dukungan untuk SpatiaLite \< 3.0 dan GEOS \< 3.3 dibuang.
- Nama lain kesesuaian kebelakang `add_postgis_srs()` untuk `django.contrib.gis.utils.add_srs_entry()` dipindahkan.
- Pada Oracle/GIS, fungsi pengumpulan [`Area`](/id/3.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.Area) sekarang mengembalikan `float` daripada `decimal.Decimal`. (Itu masih dibungkus dalam ukuran meter persegi.)
- Perwakilan [`GEOSGeometry`](/id/3.2/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry) awal (keluaran WKT) dipangkas secara awal. Yaitu, daripada `POINT (23.0000000000000000 5.5000000000000000)`, anda akan mendapatkan `POINT (23 5.5)`.
### Ukuran maksimum dari permintaan badan dan angka dari parameter GET/POST dibatasi
Dua pengaturan baru membantu mengurangi serangan denial-of-service melalui permintaan besar:
- [`DATA_UPLOAD_MAX_MEMORY_SIZE`](/id/3.2/ref/settings/#std-setting-DATA_UPLOAD_MAX_MEMORY_SIZE) membatasi ukuran yang permintaan badan mungkin. Unggah berkas tidak menghitung menuju batasan ini.
- [`DATA_UPLOAD_MAX_NUMBER_FIELDS`](/id/3.2/ref/settings/#std-setting-DATA_UPLOAD_MAX_NUMBER_FIELDS) membatasi angka dari parameter GET/POST yang diuraikan.
Aplikasi yang menerima penempatan formulir tidak biasanya besar mungkin butuh merubah pengaturan ini.
### Bermacam-macam
- `repr()` dari `QuerySet` dibungkus dalam `` untuk memindahkan kedua artian nya dari daftar kosong ketika mencari kesalahan.
- `utils.version.get_version()` mengembalikan [**PEP 440**](https://peps.python.org/pep-0440/) versi calon terbitan (sebagai contoh '1.10rc1' instead of '1.10c1').
- Nilai token CSRF sekarang diwajibkan menjadi deretan karakter 64 alfanumerik; nilai dari 32 alfanumerik, seperti disetel oleh versi terlama Django secara awal, otomatis diganti dengan deretan karakter dari 64 karakter. Nilai lain dianggap tidak sah. Ini harus hanya mempengaruhi pengembang atau pengguna yang mengganti token ini.
- Pengaturan `LOGOUT_URL` dipindahkan sebagai Django belum membuat menggunakannya sejak pra-1.0. Jika anda ingin menggunakannya di proyek anda, anda dapat menambahkannya ke pengaturan proyek anda. Nilai awal adalah `'/accounts/logout/'`.
- Obyek dengan metode `close()` seperti berkas dan pembangkit dilewatkan ke [`HttpResponse`](/id/3.2/ref/request-response/#django.http.HttpResponse) sekarang ditutup segera sebagai gantinya ketika peladen WSGI memanggil `close()` pada tanggapan.
- Memanggil `transaction.atomic()` berlebihan dalam `QuerySet.update_or_create()` dipindahkan. Ini mungkin mempengaruhi permintaan perhitungan dicoba oleh `TransactionTestCase.assertNumQueries()`.
- Dukungan untuk `skip_validation` di `BaseCommand.execute(**options)` dipindahkan. Gunakan `skip_checks` (ditambahkan di Django 1.7) sebagai gantinya.
- [`loaddata`](/id/3.2/ref/django-admin/#django-admin-loaddata) sekarang memunculkan sebuah `CommandError` sebagai gantinya dari menampilkan sebuah peringatan ketika berkas peralatan tetap ditentukan tidak ditemukan.
- Daripada secara langsung mengakses atribut `LogEntry.change_message`, sekarang lebih baik memanggil metode `LogEntry.get_change_message()` yang akan menyediakan pesan di bahasa saat ini.
- Tampilan kesalahan awal sekarang menampilkan `TemplateDoesNotExist` jika `template_name` tidak ada ditentukan.
- Argumen kata kunci `choices` tidak digunakan dari widgets `Select` dan `SelectMultiple` metode `render()` dipindahkan. Argumen `choices` dari metode `render_options()` juga dipindahkan, membuat `selected_choices` argumen pertama.
- Percobaan yang melanggar penundaan batasan basisdatasekarang akan salah ketika berjalan pada sebuah basisdata yang mendukung batasan penundaan.
- Perintah pengelolaan pasang-tetap sekarang menggunakan pengindeksan dari kunci di `options`, sebagai contoh `options['verbosity']`, daripada `options.get()` dan tidak lagi melakukan jenis paksaan apapun. Ini dapat menjadi sebuah masalah jika anda sedang memanggil perintah menggunakan `Command.execute()` (yang melewatkan pengurai argumen yang menyetel nilai awalan) daripada [`call_command()`](/id/3.2/ref/django-admin/#django.core.management.call_command). Daripada memanggil `Command.execute()`, lewati obyek perintah sebagai argumen pertama untuk `call_command()`.
- [`ModelBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.ModelBackend) dan [`RemoteUserBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.RemoteUserBackend) sekarang menolak pengguna tidak aktif. Ini berarti bahwa pengguna tidak aktif tidak dapat masuk dan akan keluar jika mereka diganti dari `is_active=True` menjadi `False`. Jika anda butuh perilaku sebelumnya, gunakan [`AllowAllUsersModelBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersModelBackend) atau [`AllowAllUsersRemoteUserBackend`](/id/3.2/ref/contrib/auth/#django.contrib.auth.backends.AllowAllUsersRemoteUserBackend) di [`AUTHENTICATION_BACKENDS`](/id/3.2/ref/settings/#std-setting-AUTHENTICATION_BACKENDS) sebagai gantinya.
- Dalam terangnya perubahan sebelumnya, percobaan metode [`login()`](/id/3.2/topics/testing/tools/#django.test.Client.login) klien tidak lagi selalu menolak pengguna tidak aktif tetapi malahan menugaskan keputusan ini ke backend otentifikasi. [`force_login()`](/id/3.2/topics/testing/tools/#django.test.Client.force_login) juga menugaskan keputusan ke backend otentifikasi, jadi jika anda sedang menggunakan backend awal, anda butuh menggunakan pengguna aktif.
- [`django.views.i18n.set_language()`](/id/3.2/topics/i18n/translation/#django.views.i18n.set_language) sekarang mungkin mengembalikan kode keadaan 204 untuk permintaan AJAX.
- Atribut `base_field` dari [`RangeField`](/id/3.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.RangeField) sekarang jenis dari bidang, bukan sebuah instance dari bidang. Jika anda telah membuat subkelas penyesuaian dari [`RangeField`](/id/3.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.RangeField), anda harus merubah atribut `base_field`.
- Kelas-kelas middleware sekarang diinisialisasikan ketika peladen mulai daripada selama permintaan pertama.
- Jika anda menimpa `is_authenticated()` atau `is_anonymous()` dalam model pengguna penyesuaian, anda harus merubah mereka ke atribut atau sifat seperti digambarkan di [the deprecation note](#user-is-auth-anon-deprecation).
- Ketika menggunakan [`ModelAdmin.save_as=True`](/id/3.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.save_as), tombol "Save as new" sekarang mengalihkan ke merubah tampilan untuk obyek baru daripada ke daftar rubah model. Jika anda butuh perilaku sebelumnya, setel atribut [`ModelAdmin.save_as_continue`](/id/3.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.save_as_continue) baru menjadi `False`.
- Bidang-bidang formulir diwajibkan sekarang mempunyai atribut HTML `required`. Setel atribut [`Form.use_required_attribute`](/id/3.2/ref/forms/api/#django.forms.Form.use_required_attribute) menjadi `False` untuk meniadakannya. Anda dapat juga menambah atribut `novalidate` pada `