Django 6.1 منتشر شد؛ مهمترین قابلیتهای جدید و نکات ارتقا
Django 6.1 منتشر شد؛ چه چیزهایی تغییر کرده؟ #
تیم جنگو در ۵ اوت ۲۰۲۶ نسخهٔ 6.1 را منتشر کرد. این نسخه بعد از Django 6.0 (منتشرشده در ۳ دسامبر ۲۰۲۵) آمده و چند قابلیت مهم دارد که مستقیماً روی کارایی و نگهداری پروژهها اثر میگذارد. در این مطلب مهمترین تغییرات را بر اساس یادداشتهای رسمی انتشار مرور میکنیم.
اطلاعات
Django 6.1 از پایتون 3.12، 3.13 و 3.14 پشتیبانی میکند و از نسخهٔ 6.1.3 پایتون 3.15 هم به این فهرست اضافه شده است.
Fetch Modes؛ خداحافظی با بخش بزرگی از مشکل N+1 #
اگر مطلب مشکل N+1 در جنگو را خوانده باشید، میدانید که دسترسی به یک ForeignKey داخل حلقه میتواند صدها کوئری اضافه بسازد. Django 6.1 متد جدید QuerySet.fetch_mode() را معرفی کرده که مشخص میکند وقتی به فیلدی که هنوز بارگذاری نشده دسترسی پیدا میکنید، جنگو چه کار کند:
FETCH_ONE(پیشفرض): همان رفتار قدیمی؛ فیلد فقط برای همان یک نمونه خوانده میشود.FETCH_PEERS: فیلد برای همهٔ نمونههایی که از همان QuerySet آمدهاند یکجا خوانده میشود؛ شبیه یکprefetch_related()خودکار و در لحظه.FETCH_RAISE: بهجای اجرای کوئری، خطایFieldFetchBlockedمیدهد تا کوئریهای ناخواسته را در کدهای حساس پیدا کنید.
from django.db import models
books = Book.objects.fetch_mode(models.FETCH_PEERS)
for book in books:
print(book.author.name)
# فقط ۲ کوئری: یکی برای کتابها، یکی برای همهٔ نویسندهها
نکته
در محیط توسعه و تست، FETCH_RAISE را روی ویوهای پرترافیک امتحان کنید. هر جا خطا داد، یعنی یک N+1 پنهان دارید که باید با select_related یا prefetch_related حل شود.
همچنین فراخوانی select_related() بدون آرگومان در این نسخه منسوخ (deprecated) شده است؛ باید فیلدها را صریحاً نام ببرید یا از FETCH_PEERS استفاده کنید.
حذف در سطح پایگاه داده با on_delete #
تا امروز وقتی on_delete=models.CASCADE مینوشتید، جنگو خودش اشیای وابسته را بارگذاری و حذف میکرد. در Django 6.1 سه گزینهٔ جدید اضافه شده که کار را کاملاً به دیتابیس و بند ON DELETE در SQL میسپارند:
DB_CASCADEDB_SET_NULLDB_SET_DEFAULT
from django.db import models
class Comment(models.Model):
post = models.ForeignKey("Post", on_delete=models.DB_CASCADE)
body = models.TextField()
مزیت اصلی: جنگو دیگر لازم نیست قبل از حذف، اشیا را در حافظه بخواند؛ پس حذفهای بزرگ بسیار سریعتر میشوند.
هشدار
DB_CASCADE سیگنالهای pre_delete و post_delete را اجرا نمیکند. اگر منطقی روی این سیگنالها دارید (مثلاً پاک کردن فایل یا کش)، قبل از مهاجرت حتماً مطلب آموزش Django Signals را مرور کنید و آن منطق را جای دیگری منتقل کنید.
تنظیم MAILERS؛ چند سرویس ایمیل در یک پروژه #
تنظیم جدید MAILERS اجازه میدهد مثل DATABASES و CACHES چند بکاند ایمیل با تنظیمات مختلف داشته باشید:
MAILERS = {
"default": {
"BACKEND": "django.core.mail.backends.smtp.EmailBackend",
"OPTIONS": {"host": "smtp.example.com", "use_tls": True},
},
"marketing": {
"BACKEND": "example.third.party.EmailBackend",
"OPTIONS": {"region": "africa-1"},
},
}
برای انتخاب سرویس، از آرگومان جدید using در توابع ارسال ایمیل استفاده کنید یا با mail.mailers["marketing"] به نمونهٔ بکاند دسترسی بگیرید. تنظیمات قدیمی EMAIL_BACKEND، EMAIL_HOST و بقیهٔ EMAIL_* هنوز کار میکنند اما هشدار منسوخشدن میدهند.
نسخهگذاری تقویمی: Django 2028 #
طبق DEP 20، نسخههایی که قرار بود Django 7.0 و 7.1 باشند، حالا Django 2028 و Django 2029 نام دارند. برای همین کلاسهای هشدار هم تغییر نام دادهاند؛ مثلاً RemovedInDjango70Warning حالا RemovedInDjango2028Warning است.
سایر تغییرات مهم #
- توابع جدید
UUID4وUUID7برای تولید UUID در سطح دیتابیس. - عبارت
JSONNullبرای مشخص کردن صریح مقدارnullدرJSONField. - تگ قالب
csp_nonce_attrبرای افزودن nonce سیاست CSP به تگهای<script>و<link>. - دکوراتور
task()حالا**kwargsرا به کلاس task بکاند پاس میدهد وTaskوTaskResultقابل pickle شدهاند. - پنل ادمین: اکشنها با آرگومان
locationدر صفحهٔ ویرایش هم قابل نمایشاند و چیدمان فرمها برای دسترسپذیری بهتر شده است.
قبل از ارتقا اینها را چک کنید #
- PostgreSQL حداقل نسخهٔ 15 (پشتیبانی از 14 حذف شد)
- MySQL حداقل 8.4 و MariaDB حداقل 10.11
- SQLite حداقل 3.37.0
- مقدار پیشفرض
SIGNED_COOKIE_LEGACY_SALT_FALLBACKحالاFalseاست؛ کوکیهای امضاشدهٔ قدیمی ممکن است نامعتبر شوند -
values_list(flat=True)بدون نام فیلد منسوخ شده است
pip install --upgrade "django>=6.1,<6.2"
python -Wd manage.py check
جمعبندی #
Django 6.1 نسخهای است که بیشتر روی کارایی ORM و تمیزتر شدن تنظیمات تمرکز دارد. FETCH_PEERS و گزینههای DB_CASCADE بهتنهایی میتوانند تعداد کوئریها و زمان حذف داده را در پروژههای بزرگ چشمگیر کاهش دهند. برای جزئیات کامل، یادداشتهای انتشار Django 6.1 را بخوانید.