올바르게 한 이스케이프
왜 중요한가 모든 템플릿 시스템과 모든 프레임워크 안에는 이스케이퍼가 있어요. 한 번 직접 써 보면 어떤 문자가 중요하고 왜 단계 순서가 중요한지 정확히 알게 돼요. 그러면 이스케이퍼가 꺼져 있거나 잘못된 곳에서 쓰인 걸 보면 알아챌 거예요.
비유: 라벨 프린터
라벨 프린터는 치는 무엇이든 인쇄해요. 누군가 프린터 자신의 제어 코드를 치면 부주의한 라벨 프린터는 그것을 따를 거예요. 신중한 프린터는 대신 그 코드의 그림을 인쇄해요. HTML 이스케이퍼는 신중한 라벨 프린터예요: 특수 문자는 인쇄되지, 결코 따르지 않아요.
엔티티: HTML이 문자를 안전하게 보여 주는 데 쓰는 코드. &로 시작해 ;로 끝나요. <는 <를, &는 &를 보여 줘요.
다섯 문자
| 문자 | 바뀌는 것 | 왜 특별한가 |
|---|---|---|
& | & | 엔티티를 시작해요 |
< | < | 태그를 시작해요 |
> | > | 태그를 끝내요 |
" | " | 큰따옴표 속성을 끝내요 |
' | ' | 작은따옴표 속성을 끝내요 |
순서가 중요해요: 앰퍼샌드 먼저
<를 먼저 바꾸면 <가 나와요. 그다음 &를 바꾸면 그게 &lt;가 되어, 방문자는 < 대신 글 <를 봐요. 그러니 &를 먼저, 그다음 나머지를 바꾸세요.
"<".replace("<", "<").replace("&", "&") # '&lt;' wrong: escaped twice
"<".replace("&", "&").replace("<", "<") # '<' right따옴표가 중요한 이유: 속성
글은 태그 사이에만 가지 않아요. 친 걸 기억하는 검색 상자처럼 흔히 속성 안에 가요:
template = '<input name="q" value="{}">'
typed = 'tent" onfocus="alert(1)'
print(template.format(typed))
# <input name="q" value="tent" onfocus="alert(1)"> the quote ended the value early꺾쇠가 필요 없었어요. "가 값을 닫고 나머지가 새 속성이 됐어요. "를 "로 이스케이프하면 모두 값 안에 머물러요. 어떤 템플릿은 작은따옴표를 쓰니 '도 이스케이프하세요. 그리고 속성 값은 언제나 따옴표로 감싸세요: 따옴표가 없으면 공백 하나로 새 속성을 시작하기에 충분해요.
이스케이프가 덮지 않는 것
HTML 이스케이프는 태그 사이의 글과 따옴표로 감싼 속성 안에 맞는 도구예요. <script> 블록 안, CSS 안, 그리고 링크 주소에는 틀린 도구예요: href="javascript:..."에는 특수 문자가 하나도 없어요. 링크는 https://나 http://로 시작하는(또는 상대) 주소만 허락하세요. 스크립트에 필요한 데이터는 data- 속성이나 프레임워크가 만들어 주는 JSON 블록(예: Django의 json_script)에 넣으세요.
연습
escape_html(text)를 쓰세요. 여기서는 html.escape를 쓰지 마세요: 요점은 직접 만드는 거예요. 테스트는 태그 사이, 큰따옴표와 작은따옴표 속성 안, 그리고 수백 개의 무작위 문자열로 시도해요.
흔한 오해
"두 번 이스케이프하면 더 안전하다." 안전한 게 아니라 망가진 거예요: 방문자는 화면에서 &lt; 쓰레기를 봐요. 글이 HTML에 들어가는 순간에 정확히 한 번 이스케이프하세요.
해 보기 통과하면 escape_html("Fish & chips <3")을 출력하고, 결과를 load("<p>" + ... + "</p>").text에 붙여 넣으세요. 원래 말이 돌아와요: 이스케이프는 손실이 없어요.
다른 언어로
// JavaScript
function escapeHtml(text) {
return String(text)
.replaceAll("&", "&") // first
.replaceAll("<", "<")
.replaceAll(">", ">")
.replaceAll('"', """)
.replaceAll("'", "'");
}
// Rust (by hand, one pass)
fn escape_html(s: &str) -> String {
let mut out = String::with_capacity(s.len());
for c in s.chars() {
match c {
'&' => out.push_str("&"),
'<' => out.push_str("<"),
'>' => out.push_str(">"),
'"' => out.push_str("""),
'\'' => out.push_str("'"),
_ => out.push(c),
}
}
out
}
// PHP has it built in
htmlspecialchars($text, ENT_QUOTES | ENT_HTML5, "UTF-8");요약
- 다섯 문자를 이스케이프하세요:
&,<,>,",'. &를 먼저 바꾸세요. 아니면 자기 엔티티를 두 번 이스케이프해요.- 글이 흔히 속성 안에 떨어지니 따옴표가 중요해요. 속성 값은 언제나 따옴표로 감싸세요.
- HTML 이스케이프는 스크립트 블록, CSS, 링크 주소를 위한 도구가 아니에요.
html.escape 없이 escape_html(text)를 쓰세요. str()로 입력을 문자열로 바꾸고, 그다음 &를 &로 먼저, 그다음 <를 <로, >를 >로, "를 "로, '를 '로 바꾸세요. 결과를 돌려주세요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.