url_for static으로 에셋 연결하기

모든 템플릿에 /static/style.css를 직접 작성하는 것은 쉬워 보이지만 취약합니다. Flask는 에셋 링크를 대신 만들어 주는 url_for를 제공합니다. 🔧

Flask는 에셋을 위해 static이라는 기본 엔드포인트를 등록합니다. 원시 경로를 직접 입력하는 대신 url_for에 이 엔드포인트를 요청합니다.

엔드포인트와 filename 인수를 사용해 url_for를 호출합니다. Flask는 static 폴더 안의 파일을 가리키는 올바른 URL을 반환합니다.

Jinja2 템플릿 안에서는 호출을 중괄호 두 개로 감쌉니다. 그러면 link 태그가 생성된 올바른 href를 받습니다.

하위 경로를 filename 안에 바로 넣으세요. 값에 포함된 슬래시는 static 안의 폴더에 그대로 대응합니다.

static_url_path를 변경하더라도 모든 url_for 링크가 자동으로 업데이트됩니다. 경로를 직접 작성했다면 모두 조용히 작동하지 않게 됩니다.

앱이 서버의 하위 경로에서 실행될 때 url_for가 올바른 접두사를 자동으로 추가하므로 어디서나 링크가 계속 작동합니다.

스크립트도 같은 방식으로 연결합니다. script 태그가 url_for를 가리키게 하면 하드코딩한 경로 없이 static에서 JS를 불러옵니다.

이미지도 동일한 패턴을 따릅니다. 파일 이름을 url_for에 전달하고 결과를 img 태그의 소스에 넣으세요.

url_for는 템플릿에서만 사용하는 기능이 아닙니다. 뷰 안에서도 url_for를 호출해 에셋 URL을 계산한 뒤 반환하거나 기록할 수 있습니다.

규칙으로 정하세요. 모든 에셋 링크는 url_for를 거치게 하세요. 그러면 나중에 이름이나 접두사를 바꾸거나 캐시를 무효화할 때도 자동으로 처리됩니다. ✅

이제 static 엔드포인트와 함께 url_for를 사용해 모든 에셋 링크를 만들 수 있습니다. 따라서 설정이 어떻게 바뀌어도 경로가 올바르게 유지됩니다. 🎯