[250114] Django의 다중 App과 URL이란?

Django에서 다중 앱(App)이란? 📲

• Django 프로젝트는 하나 이상의 앱(App)으로 구성된다
• 앱(App)이란?: Django에서 특정 기능이나 모듈을 구현한 독립적인 단위임
  • 예: 사용자 인증, 블로그, 상품 관리 등.

장점

1. 모듈화: 기능별로 앱을 나누어 코드의 유지보수성을 높임
2. 재사용성: 앱을 다른 프로젝트에서 쉽게 재사용이 가능함
3. 구조화: 프로젝트의 역할별 구성으로 코드의 가독성이 증가한다

my_project/
├── my_project/
│   ├── settings.py
│   ├── urls.py
│   ├── ...
├── blog/
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── ...
├── shop/
│   ├── models.py
│   ├── views.py
│   ├── urls.py
│   ├── ...

---

1. 다중 앱에서의 URL 구조

• Django는 각 앱이 자체적인 URL 설정을 가질 수 있도록 지원한다
• 프로젝트의 urls.py는 각 앱의 URL을 통합으로 관리함

1) 프로젝트의 urls.py

• 프로젝트의 URL을 총괄적으로 관리
• 앱별로 URL 패턴을 라우팅함

예제

rom django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('blog/', include('blog.urls')),  # blog 앱 URL 연결
    path('shop/', include('shop.urls')),  # shop 앱 URL 연결
]

2) 앱별 urls.py

• 앱 내에서 URL과 뷰를 정의한다
• 각 앱의 URL은 상대적 경로로 작성함

`blog/urls.py`

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='blog_index'),  # /blog/
    path('<int:post_id>/', views.detail, name='blog_detail'),  # /blog/1/
]

`shop/urls.py`

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='shop_index'),  # /shop/
    path('<int:item_id>/', views.detail, name='shop_detail'),  # /shop/1/
]

---

2. URL 연결 흐름

1. 사용자가 `/blog/`로 요청 → 프로젝트의 `urls.py`에서 `blog.urls`로 전달함
2. `blog/urls.py`에서 요청을 받아 적절한 뷰 함수로 매핑

---

3. 다중 앱 URL 설계의 Best Practice

1) 네임스페이스 사용

• URL 패턴 충돌 방지
• 각 앱에 고유한 네임스페이스를 지정함

`blog/urls.py`

app_name = 'blog'  # 네임스페이스 설정

urlpatterns = [
    path('', views.index, name='index'),  # blog:index
    path('<int:post_id>/', views.detail, name='detail'),  # blog:detail
]

`뷰에서 네임스페이스 URL 사용`

from django.urls import reverse

def some_view(request):
    blog_url = reverse('blog:index')  # 'blog' 네임스페이스의 'index' URL

2) URL 구조의 일관성

• 앱 간의 URL 구조를 통일성 있게 설계한다
  • 예: `/app/<resource>/<id>/`

예제

/blog/              -> blog의 인덱스
/blog/<post_id>/    -> 특정 글 보기
/shop/              -> shop의 인덱스
/shop/<item_id>/    -> 특정 상품 보기

3) 공통 URL 패턴 처리

• 여러 앱에서 동일한 URL 처리가 필요하면 별도 URL 구성 파일로 분리함

예제: 공통 URL 처리

from django.urls import path
from . import views

urlpatterns = [
    path('search/', views.search, name='search'),  # /app/search/
]

---

4. 다중 앱과 URL 연결 시 주의사항

URL 충돌 방지

• 네임스페이스를 적극적으로 활용해야함
• URL 패턴 이름이 고유하도록 설정해야함

라우팅 순서

• urls.py의 순서에 따라 URL 매칭이 진행되므로 일반적인 패턴에서 특수한 패턴 순으로 작성한다

테스트

• 각 앱의 URL 패턴이 의도한 대로 작동하는지 확인할 것

---

정리 🧹

• 다중 앱을 활용하면 Django 프로젝트를 모듈화하여 관리가 쉬워진다
• 각 앱은 독립적으로 URL과 뷰를 정의하며, 프로젝트의 urls.py에서 통합으로 관리함
• 네임스페이스를 활용해 충돌을 방지하고, URL 구조는 통일성 있게 설계하는 것이 중요하다~!