--- title: "Django 5.1 リリースノート" version: 5.2 locale: ja source: https://docs.djangoproject.com/ja/5.2/releases/5.1/ canonical: https://djangodocs.dev/ja/5.2/releases/5.1/ --- # Django 5.1 リリースノート *2024年8月7日* Django 5.1 へようこそ！ このリリースノートでは、 [バージョン 5.1 の新機能](#whats-new-5-1) と、Django 5.0 以前からアップグレードする際に注意すべき、 [後方互換性のない変更](#backwards-incompatible-5-1) について説明します。また、 [一部の機能を非推奨](/ja/5.2/releases/5.0/#deprecated-features-5-0) としました。 既存のプロジェクトをアップデートするときは、 [Django の新しいバージョンへの更新](/ja/5.2/howto/upgrade-version/) ガイドに従ってください。 ## Python バージョン間の互換性 Django 5.1 は、Python 3.10、3.11、3.12、および 3.13（5.1.3 時点）をサポートしています。 **最新のリリース** を使用することを強く推奨しており、公式にサポートするのも各シリーズの最新リリースのみです。 ## Django 5.1 の新機能 ### `{% querystring %}` テンプレートタグ Django 5.1 では、[`{% querystring %}`](/ja/5.2/ref/templates/builtins/#std-templatetag-querystring) テンプレートタグが導入されました。これにより、URL 内のクエリパラメータの変更が簡略化され、既存のクエリパラメータを維持しつつ、特定の部分を追加または変更してリンクを生成するのが簡単になります。 たとえば、テンプレート内でページネーションやクエリ文字列を操作するのは面倒な場合があります。ページネーションされたビュー内で、次のページに移動するための URL を動的に生成する次のようなテンプレートフラグメントについて考えてみてください。 ```html+django {# Linebreaks added for readability, this should be one, long line. #} Next page ``` これを新しいテンプレートタグを使用するように切り替えると、上記は次のように魔法のように簡略化されます。 ```html+django Next page ``` ### PostgreSQL の接続プール Django 5.1 では、PostgreSQL の [接続プール](/ja/5.2/ref/databases/#postgresql-pool) のサポートも導入されました。新しい接続の確立には比較的長い時間がかかる場合があるため、接続をオープンにしたままにしておくことで、レイテンシを削減できます。 [psycopg](https://www.psycopg.org/) で接続プールを使用するには、次のように [`OPTIONS`](/ja/5.2/ref/settings/#std-setting-OPTIONS) 内の `"pool"` オプションに、[`ConnectionPool`](https://www.psycopg.org/psycopg3/docs/api/pool.html#psycopg_pool.ConnectionPool) に渡されるディクショナリを設定するか、`True` にすることで `ConnectionPool` のデフォルトを使用します。 ``` DATABASES = { "default": { "ENGINE": "django.db.backends.postgresql", # ... "OPTIONS": { "pool": { "min_size": 2, "max_size": 4, "timeout": 10, } }, }, } ``` ### デフォルトで認証を要求するミドルウェア 新しい [`LoginRequiredMiddleware`](/ja/5.2/ref/middleware/#django.contrib.auth.middleware.LoginRequiredMiddleware) は、すべての未認証リクエストをログインページにリダイレクトします。新しい [`login_not_required()`](/ja/5.2/topics/auth/default/#django.contrib.auth.decorators.login_not_required) デコレータを使用すると、ビューで未認証リクエストを許可できるようになります。 `LoginRequiredMiddleware` は、[`login_required()`](/ja/5.2/topics/auth/default/#django.contrib.auth.decorators.login_required) デコレータによって設定された `login_url` と `redirect_field_name` の値を尊重しますが、[`LoginRequiredMixin`](/ja/5.2/topics/auth/default/#django.contrib.auth.mixins.LoginRequiredMixin) による `login_url` または `redirect_field_name` の設定はサポートされていません。 これを有効にするには、`"django.contrib.auth.middleware.LoginRequiredMiddleware"` を [`MIDDLEWARE`](/ja/5.2/ref/settings/#std-setting-MIDDLEWARE) 設定に追加します。 ### マイナーな機能 #### [`django.contrib.admin`](/ja/5.2/ref/contrib/admin/#module-django.contrib.admin) - [`ModelAdmin.list_display`](/ja/5.2/ref/contrib/admin/#django.contrib.admin.ModelAdmin.list_display) において、関連モデルのフィールドをリスト表示するために `__` 演算子によるルックアップができるようになりました。 #### [`django.contrib.auth`](/ja/5.2/topics/auth/#module-django.contrib.auth) - PBKDF2 パスワードハッシュに対するデフォルトのイテレーション回数が 720,000 から 870,000 に増加しました。 - OWASP の推奨に従い、`ScryptPasswordHasher` の `parallelism` が 1 から 5 に増加しました。 - 新しい [`AdminUserCreationForm`](/ja/5.2/topics/auth/default/#django.contrib.auth.forms.AdminUserCreationForm) と、既存の [`AdminPasswordChangeForm`](/ja/5.2/topics/auth/default/#django.contrib.auth.forms.AdminPasswordChangeForm) は、フォームの保存時に使用不可のパスワードを設定することでパスワードベースの認証を無効化できるようになりました。この機能は、管理画面のユーザー作成ページやパスワード変更ページで利用可能です。 - [`login_required()`](/ja/5.2/topics/auth/default/#django.contrib.auth.decorators.login_required)、[`permission_required()`](/ja/5.2/topics/auth/default/#django.contrib.auth.decorators.permission_required)、[`user_passes_test()`](/ja/5.2/topics/auth/default/#django.contrib.auth.decorators.user_passes_test) デコレータが、非同期ビュー関数のラッピングをサポートするようになりました。 - `ReadOnlyPasswordHashWidget` に、ユーザーパスワードのリセットボタンが含まれるようになりました。このボタンは、以前に `ReadOnlyPasswordHashField` のヘルプテキストに埋め込まれていたリンクを置き換えます。これにより、[`UserChangeForm`](/ja/5.2/topics/auth/default/#django.contrib.auth.forms.UserChangeForm) の全体的なアクセシビリティが向上します。 #### [`django.contrib.gis`](/ja/5.2/ref/contrib/gis/#module-django.contrib.gis) - SpatiaLite 5.1 以降で [`BoundingCircle`](/ja/5.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.BoundingCircle) をサポートするようになりました。 - MySQL 8.0.24 以降で [`Collect`](/ja/5.2/ref/contrib/gis/geoquerysets/#django.contrib.gis.db.models.Collect) をサポートするようになりました。 - [`GeoIP2`](/ja/5.2/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2) が、[`ipaddress.IPv4Address`](https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv4Address) または [`ipaddress.IPv6Address`](https://docs.python.org/3/library/ipaddress.html#ipaddress.IPv6Address) オブジェクトを使用してクエリできるようになりました。 - [`GeoIP2.country()`](/ja/5.2/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2.country) が `continent_code`、`continent_name`、`is_in_european_union` の値を公開するようになりました。 - [`GeoIP2.city()`](/ja/5.2/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2.city) は、`accuracy_radius` と `region_name` の値を新たに公開するようになりました。さらに、`dma_code` と `region` の値は、それぞれ `metro_code` と `region_code` として公開されるようになりましたが、後方互換性のために従来のキーも引き続き使用可能です。 - [`Area`](/ja/5.2/ref/contrib/gis/measure/#django.contrib.gis.measure.Area) は、`ha` 単位（ヘクタール）をサポートするようになりました。 - 新しい [`OGRGeometry.is_3d`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.is_3d) 属性により、ジオメトリが `Z` 座標次元を持っているかどうかを確認できるようになりました。 - 新しい [`OGRGeometry.set_3d()`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.set_3d) メソッドにより、`Z` 座標次元の追加および削除が可能になりました。 - [`OGRGeometry`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry)、[`Point`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.Point)、[`LineString`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.LineString)、[`Polygon`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.Polygon)、および [`GeometryCollection`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.GeometryCollection) とそのサブクラスは、新しい [`OGRGeometry.is_measured`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.is_measured) 属性、`m` プロパティ、および [`OGRGeometry.set_measured()`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.set_measured) メソッドを通じて測定ジオメトリ（Measured Geometries）をサポートするようになりました。 - [`OGRGeometry.centroid`](/ja/5.2/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.centroid) が、サポートされるすべてのジオメトリタイプで利用可能になりました。 - [`FromWKB()`](/ja/5.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.FromWKB) および [`FromWKT()`](/ja/5.2/ref/contrib/gis/functions/#django.contrib.gis.db.models.functions.FromWKT) 関数が、オプションの `srid` 引数をサポートするようになりました（ただし、Oracle では無視されます）。 #### [`django.contrib.postgres`](/ja/5.2/ref/contrib/postgres/#module-django.contrib.postgres) - [`BTreeIndex`](/ja/5.2/ref/contrib/postgres/indexes/#django.contrib.postgres.indexes.BTreeIndex) が新たに `deduplicate_items` パラメータをサポートするようになりました。 #### [`django.contrib.sessions`](/ja/5.2/topics/http/sessions/#module-django.contrib.sessions) - [`django.contrib.sessions.backends.cached_db.SessionStore`](/ja/5.2/topics/http/sessions/#django.contrib.sessions.backends.cached_db.SessionStore) は、キャッシュにセッション情報を保存する際に例外を処理するようになりました。新たに追加された [セッションロガー](/ja/5.2/ref/logging/#django-contrib-sessions-logger) を通じて、適切なエラーメッセージとそのトレースバックをログに記録します。 - [`django.contrib.sessions.backends.base.SessionBase`](/ja/5.2/topics/http/sessions/#django.contrib.sessions.backends.base.SessionBase) およびすべての組み込みセッションエンジンが非同期APIを提供するようになりました。新しい非同期メソッドはすべて `a` を接頭辞に持つ名前で提供され、例えば `aget()`、`akeys()`、`acycle_key()` などがあります。 #### データベースバックエンド - `"init_command"` オプションが SQLite の [`OPTIONS`](/ja/5.2/ref/settings/#std-setting-OPTIONS) でサポートされるようになり、接続時に設定する [PRAGMA オプション](/ja/5.2/ref/databases/#sqlite-init-command) を指定できるようになりました。 - `"transaction_mode"` オプションが SQLite の [`OPTIONS`](/ja/5.2/ref/settings/#std-setting-OPTIONS) でサポートされるようになり、[トランザクションの動作](/ja/5.2/ref/databases/#sqlite-transaction-behavior) を指定できるようになりました。 - `"pool"` オプションが PostgreSQL の [`OPTIONS`](/ja/5.2/ref/settings/#std-setting-OPTIONS) でサポートされるようになり、[接続プール](/ja/5.2/ref/databases/#postgresql-pool) を利用できるようになりました。 #### エラー報告 - アクセシビリティ向上のため、技術的な404および500エラーページに、ヘッダー、フッター、メインコンテンツ領域に対応するHTMLランドマーク要素が使用されるようになりました。 #### ファイルストレージ - [`FileSystemStorage`](/ja/5.2/ref/files/storage/#django.core.files.storage.FileSystemStorage) の [`allow_overwrite`](/ja/5.2/ref/files/storage/#django.core.files.storage.FileSystemStorage.allow_overwrite) パラメータにより、既存のファイルを上書きして新しいファイルを保存できるようになりました。 #### フォーム - アクセシビリティを向上させ、スクリーンリーダーがフィールドセットとそのヘルプテキストを関連付けられるようにするため、フォームのフィールドセットに `aria-describedby` HTML属性が追加されました。 #### 管理コマンド - [`makemigrations`](/ja/5.2/ref/django-admin/#django-admin-makemigrations) コマンドが、各オペレーションの [`オペレーション・カテゴリ`](/ja/5.2/ref/migration-operations/#django.db.migrations.operations.base.OperationCategory) を強調表示するために意味のある記号を表示するようになりました。 #### マイグレーション - 新しい `Operation.category` 属性により、[`makemigrations`](/ja/5.2/ref/django-admin/#django-admin-makemigrations) がオペレーションに対して意味のある記号を表示するために使用する [`オペレーション・カテゴリ`](/ja/5.2/ref/migration-operations/#django.db.migrations.operations.base.OperationCategory) を指定できるようになりました。 #### モデル - [`QuerySet.explain()`](/ja/5.2/ref/models/querysets/#django.db.models.query.QuerySet.explain) が PostgreSQL 16以降で `generic_plan` オプションをサポートするようになりました。 - [`RowRange`](/ja/5.2/ref/models/expressions/#django.db.models.expressions.RowRange) は、`start` 引数に正の整数、`end` 引数に負の整数を受け入れるようになりました。 - 新しい `exclusion` 引数が [`RowRange`](/ja/5.2/ref/models/expressions/#django.db.models.expressions.RowRange) と [`ValueRange`](/ja/5.2/ref/models/expressions/#django.db.models.expressions.ValueRange) に追加され、ウィンドウフレームから行、グループ、および同順位（タイ）を除外できるようになりました。 - [`QuerySet.order_by()`](/ja/5.2/ref/models/querysets/#django.db.models.query.QuerySet.order_by) が、アノテーションのトランスフォーム、たとえば `JSONObject` のキーや `ArrayAgg` のインデックスなどによる並び替えをサポートするようになりました。 - [`F()`](/ja/5.2/ref/models/expressions/#django.db.models.F) 式と [`OuterRef()`](/ja/5.2/ref/models/expressions/#django.db.models.OuterRef) 式が、[`CharField`](/ja/5.2/ref/models/fields/#django.db.models.CharField)、[`EmailField`](/ja/5.2/ref/models/fields/#django.db.models.EmailField)、[`SlugField`](/ja/5.2/ref/models/fields/#django.db.models.SlugField)、[`URLField`](/ja/5.2/ref/models/fields/#django.db.models.URLField)、[`TextField`](/ja/5.2/ref/models/fields/#django.db.models.TextField)、あるいは [`ArrayField`](/ja/5.2/ref/contrib/postgres/fields/#django.contrib.postgres.fields.ArrayField) を出力する場合、[スライス](/ja/5.2/ref/models/expressions/#slicing-using-f) が可能になりました。 - [`Model.refresh_from_db()`](/ja/5.2/ref/models/instances/#django.db.models.Model.refresh_from_db) と [`Model.arefresh_from_db()`](/ja/5.2/ref/models/instances/#django.db.models.Model.arefresh_from_db) に新しく追加された `from_queryset` 引数を使用すれば、モデルの値を再読み込みするためのクエリセットをカスタマイズできます。これにより、再読み込み前に行をロックしたり、リレーション先のオブジェクトを取得したりすることが可能になります。 - 新しい [`Expression.constraint_validation_compatible`](/ja/5.2/ref/models/expressions/#django.db.models.Expression.constraint_validation_compatible) 属性を使用すると、制約の検証時にその式を無視するよう指定することができます。 #### テンプレート - カスタムタグは、`Parser` オブジェクトに追加のデータを設定できるようになりました。このデータは `Template` インスタンス上で利用可能になります。このようなデータは、テンプレートローダーや他のテンプレートクライアントで使用できます。 - [テンプレートエンジン](/ja/5.2/topics/checks/#field-checking) は、チェックフレームワークに既に登録されている `check()` メソッドを実装するようになりました。 #### テスト - [`assertContains()`](/ja/5.2/topics/testing/tools/#django.test.SimpleTestCase.assertContains)、[`assertNotContains()`](/ja/5.2/topics/testing/tools/#django.test.SimpleTestCase.assertNotContains)、および [`assertInHTML()`](/ja/5.2/topics/testing/tools/#django.test.SimpleTestCase.assertInHTML) は、アサーションエラーメッセージにヘイスタック（haystacks）を追加するようになりました。 - [`RequestFactory`](/ja/5.2/topics/testing/advanced/#django.test.RequestFactory)、[`AsyncRequestFactory`](/ja/5.2/topics/testing/advanced/#django.test.AsyncRequestFactory)、[`Client`](/ja/5.2/topics/testing/tools/#django.test.Client)、および [`AsyncClient`](/ja/5.2/topics/testing/tools/#django.test.AsyncClient) クラスは、新たに `query_params` パラメータをサポートしました。このパラメータは、クエリ文字列のキーと値を含む辞書を受け付けます。これにより、任意のHTTPメソッドに対してクエリ文字列を簡単に設定できるようになりました。 ```python self.client.post("/items/1", query_params={"action": "delete"}) await self.async_client.post("/items/1", query_params={"action": "delete"}) ``` - 新しい [`SimpleTestCase.assertNotInHTML()`](/ja/5.2/topics/testing/tools/#django.test.SimpleTestCase.assertNotInHTML) アサーションにより、指定されたHTMLヘイスタック内に特定のHTMLフラグメントが含まれていないことをテストできるようになりました。 - テストの独立性を確保するため、[`SimpleTestCase`](/ja/5.2/topics/testing/tools/#django.test.SimpleTestCase) 内でスレッド内のデータベース接続が許可されなくなりました。 #### バリデータ - 新しい [`DomainNameValidator`](/ja/5.2/ref/validators/#django.core.validators.DomainNameValidator) は、国際化ドメイン名を含むドメイン名を検証します。また、新しい [`validate_domain_name()`](/ja/5.2/ref/validators/#django.core.validators.validate_domain_name) 関数は、[`DomainNameValidator`](/ja/5.2/ref/validators/#django.core.validators.DomainNameValidator) のインスタンスを返します。 ## 5.1 における後方互換性のない変更 ### [`django.contrib.gis`](/ja/5.2/ref/contrib/gis/#module-django.contrib.gis) - PostGIS 2.5 に対するサポートが削除されました。 - PROJ \< 6 のサポートが削除されました。 - GDAL 2.4 のサポートが削除されました。 - [`GeoIP2`](/ja/5.2/ref/contrib/gis/geoip2/#django.contrib.gis.geoip2.GeoIP2) は、ディレクトリパスが指定された場合に、これまでのように都市データベースと国データベースの両方を開くことはなくなりました。代わりに、都市データベースが利用可能であればそちらを優先します。国データベースは都市データベースのサブセットであり、通常は両方を使用する必要はありません。同じディレクトリ内で国データベースを使用する必要がある場合は、コンストラクタに国データベースのパスを明示的に渡してください。 ### MariaDB 10.4 のサポートを終了しました MariaDB 10.4のアップストリームサポートは2024年6月に終了します。Django 5.1はMariaDB 10.5以降をサポートします。 ### PostgreSQL 12 のサポートを終了しました PostgreSQL 12 のアップストリーム サポートは 2024 年 11 月に終了します。Django 5.1 は PostgreSQL 13 以降をサポートします。 ### その他 - アクセシビリティを向上させるために、admin サイトの changelist フィルタを `
` タグではなく `