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 می‌دهد تا کوئری‌های ناخواسته را در کدهای حساس پیدا کنید.
views.pypython
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_CASCADE
  • DB_SET_NULL
  • DB_SET_DEFAULT
models.pypython
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 چند بک‌اند ایمیل با تنظیمات مختلف داشته باشید:

settings.pypython
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) بدون نام فیلد منسوخ شده است
bash
pip install --upgrade "django>=6.1,<6.2"
python -Wd manage.py check

جمع‌بندی #

Django 6.1 نسخه‌ای است که بیشتر روی کارایی ORM و تمیزتر شدن تنظیمات تمرکز دارد. FETCH_PEERS و گزینه‌های DB_CASCADE به‌تنهایی می‌توانند تعداد کوئری‌ها و زمان حذف داده را در پروژه‌های بزرگ چشمگیر کاهش دهند. برای جزئیات کامل، یادداشت‌های انتشار Django 6.1 را بخوانید.

این پست چطور بود؟

پست‌های مرتبط