[filters] Jinja - urlencode() 필터 - URL 주소나 또는 쿼리에 적합한 문자열로 변환 (= urlencode필터 = 유알엘인코드필터)

1. urlencode() 예제 - URL 경로나 쿼리에 적합한 문자열로 변환
2. urlencode() 정의
3. urlencode() 구문

urlencode() 예제 - URL 경로나 쿼리에 적합한 문자열로 변환

[예제1] - 문자열 경우

 

{% set str = "홈짱닷컴 Homzzang.com" %}

{{ str|urlencode }}

 

결과값:

%ED%99%88%EC%A7%B1%EB%8B%B7%EC%BB%B4%20Homzzang.com

---

[예제2] - dict 경우

 

{% set dict = {"name": "홈짱", "open": 2012} %}

{{ dict|urlencode }}

 

결과값: name=%ED%99%88%EC%A7%B1&open=2012

---

[예제3] - 반복자 (List와 Tuple이 결합된 형태) 경우

 

{% set iter = [("key1", "value1"), ("key2", "value2")] %}

{{ iter|urlencode }}

 

결과값: key1=value1&key2=value2

---

 

[예제4] - 슬래시 문자열 처리

 

{% set urlstr = "https://homzzang.com/b/jinja-113" %}

{{ urlstr|urlencode|replace("/", "%2F") }}

 

결과값: https%3A%2F%2Fhomzzang.com%2Fb%2Fjinja-113 

urlencode() 정의

 

UTF-8을 사용하는 URL 경로 또는 쿼리에 사용할 데이터를 인용하는 필터. 

 

---

 

1.

• 문자열에 대해선 urllib.parse.quote() 사용하고, dict나 반복자에 대해선 urllib.parse.urlencode() 사용해 쿼리 문자열로 결합.
• 문자열이 주어지면 "/"는 인용되지 않음. HTTP 서버는 경로에서 "/" 및 "%2F"를 동일하게 처리함. 슬래시를 인용해야 하는 경우 |replace("/", "%2F") 필터를 사용.

 

2.

Jinja2 2.7 +

 

3. 공식 매뉴얼

https://jinja.palletsprojects.com/en/3.1.x/templates/#jinja-filters.urlencode

 

urlencode() 구문

 

jinja-filters.urlencode(value: str | Mapping[str, Any] | Iterable[Tuple[str, Any]]) → str

 

---

[매개변수]

 

value: str | Mapping[str, Any] | Iterable[Tuple[str, Any]]

필수. URL주소나 쿼리에 적합한 문자열로 변환시킬 데이터. 

• sring 경우, 직접 인용. 빈공백 등 특수문자 경우, 실체값으로 바뀜.
• (key, value) 쌍의 dict 또는 iterable 경우, 쿼리 문자열로 결합.