توجيه المسارات (URL routing) (ملف URLconf) يربط عناوين URL الواردة بـ الآراء (views) التي تتعامل معها. يطابق Django عنوان URL المطلوب مقابل قائمة من الأنماط ويستدعي العرض المقابل، مستخرجاً أي معاملات من عنوان URL.
django.urls path
. views
urlpatterns = [
path(, views.home, name=),
path(, views.article_list, name=),
path(, views.article_detail, name=),
path(, views.by_slug, name=),
]
كل path() يربط نمط URL بدالة عرض. يحاول Django كل واحد من الأعلى إلى الأسفل ويستخدم أول مطابقة.
path("articles/<int:pk>/", views.article_detail) # captures an integer as `pk`
# the view receives the captured value as a parameter
def article_detail(request, pk): # pk = 5 for /articles/5/
article = Article.objects.get(pk=pk)
محولات المسار (<int:pk>، <slug:slug>، <str:name>، <uuid:id>) تلتقط وتحول نوع أجزاء من URL، وتمررها إلى العرض كمعاملات.
path("articles/<int:pk>/", views.article_detail, name="detail") # the `name`
# generate URLs by NAME instead of hardcoding them — DRY and refactor-safe
from django.urls import reverse
url = reverse("detail", kwargs={"pk": 5}) # → "/articles/5/"
redirect("detail", pk=5) # in views
<!-- in templates -->
<a href="{% url 'detail' pk=article.pk %}">Read more</a>
عناوين URL المسماة حاسمة الأهمية: بالإشارة إلى عناوين URL من خلال name الخاص بها (عبر {% url %} في القوالب وreverse() في الكود) بدلاً من ترميز المسارات بشكل مباشر، يمكنك تغيير هيكل URL في مكان واحد دون كسر كل رابط — ممارسة DRY آمنة للإعادة.
# project urls.py — delegate to each app's URLconf
from django.urls import include, path
urlpatterns = [
path("blog/", include("blog.urls")), # /blog/... handled by the blog app
path("shop/", include("shop.urls")),
path("admin/", admin.site.urls),
]
include() توكل بادئة URL إلى ملف urls.py الخاص بالتطبيق، مما يحافظ على التوجيه معيارياً ويبقي كل تطبيق مكتفياً بذاته.
توجيه المسارات أساسي لكل تطبيق Django — فهو يحدد هيكل عناوين URL لموقعك وهو كيفية وصول الطلبات إلى العرض الصحيح.
فهمه معرفة أساسية يومية: معرفة كيفية تعريف أنماط URL، التقاط وتحويل نوع المعاملات من عناوين URL (محولات المسار مثل <int:pk>)، وتنظيم التوجيه معيارياً مع include() (توكيل ملفات URLconf لكل تطبيق) ضروري لبناء أي تطبيق متعدد الصفحات أو API.
ما هو حاسم الأهمية هو ممارسة عنوان URL المسمى / حل المراجع العكسي — الإشارة إلى عناوين URL من خلال name عبر {% url %} وreverse() بدلاً من ترميز المسارات — التي تجسد فلسفة Django في DRY وهي فوز صيانة كبير: فهي تتيح لك إعادة هيكلة عناوين URL في مكان واحد دون البحث والبحث عن كل رابط مرمز في القوالب والكود.
هذه ممارسة أفضل تميز مشاريع Django المبنية بشكل جيد عن المشاريع الضعيفة.
توجيه URL يربط نقطة الدخول (عناوين URL) بالمنطق (الآراء)، مكملاً صورة معالجة الطلب إلى جانب النماذج والقوالب، مما يجعلها مادة أساسية يجب معرفتها لتنظيم والحفاظ على أي تطبيق Django.