정의 및 사용 방법

PHP 버전
5+

htmlspecialchars_decode() 함수는
엔디티(entities)로 인코딩된 다섯 개의 HTML 예약 문자(<, >, &, ", ')를 디코딩하여 원래 문자열로 복원합니다.

이 함수는 HTML의 예약된 특수문자를 엔티티로 인코딩하는 htmlspecialchars() 함수의 반대 개념입니다.

디코딩되는 다섯 개의 HTML 예약 문자

디코딩되는 인코딩된 다섯 개의 HTML 예약 문자는 다음의 표를 참고하세요.

htmlspecialchars_decode() 함수로 디코딩되는 인코딩된 다섯 개의 HTML 예약 문자
인코딩된 엔티티디코딩되는 원래 문자
&lt; <
&gt; >
&amp; &
&quot; "
&#039; 또는 &apos; '

기본 예제

PHP 
$encoded_1 = '엔디티(entities)로 인코딩된 다섯 개의 HTML 예약 문자(&lt;, &gt;, &amp;, &quot;, &#039;)를 디코딩합니다.';

echo htmlspecialchars_decode($encoded_1);
// 출력: 엔디티(entities)로 인코딩된 다섯 개의 HTML 예약 문자(<, >, &, ", ')를 디코딩합니다.

$encoded_2 = '그 외 엔티티로 인코딩된 문자(예: ©의 엔티티인 &copy;)는 디코딩하지 않습니다.';
echo htmlspecialchars_decode($encoded_2);

// 출력: 그 외 엔티티로 인코딩된 문자(예: ©의 엔티티인 &copy;)는 디코딩하지 않습니다.

구문

PHP 
htmlspecialchars_decode(string $string, int $flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401): string

매개변수

htmlspecialchars_decode() 함수의 매개변수
$string 필수. 디코딩하려는 원본 문자열입니다.
$flags 옵션. 디코딩 시 동작 방식을 지정하는 상수 옵션입니다. 여러 옵션은 | (비트 OR) 연산자로 결합 가능합니다. 기본값: ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401
  • ENT_COMPAT: 쌍따옴표(")만 디코딩, 홑따옴표(')는 그대로
  • ENT_QUOTES: 쌍따옴표(")와 홑따옴표(') 모두 디코딩
  • ENT_NOQUOTES: 따옴표는 디코딩하지 않음
  • ENT_SUBSTITUTE: 잘못된 코드 유닛 시퀀스를 유니코드 대체 문자(U+FFFD)로 처리
  • ENT_HTML401: HTML 4.01 문서 표준 기준
  • ENT_XML1, ENT_XHTML, ENT_HTML5: 각각 XML 1, XHTML, HTML5 문서 표준 기준

반환 값

디코딩된 문자열을 반환합니다.

변경 이력

htmlspecialchars_decode() 함수의 변경 이력
PHP 8.1.0부터 $flags가 ENT_COMPAT에서 ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401로 변경되었습니다.

예제

PHP 
$str = '&lt;p&gt;는 &quot;문단&quot; 요소입니다.';

echo htmlspecialchars_decode($str);
// 출력: <p>는 "문단" 요소입니다.

// ENT_NOQUOTES 옵션이 설정되어 있으면 따옴표는 디코딩하지 않음
echo htmlspecialchars_decode($str, ENT_NOQUOTES);
// 출력: <p>는 &quot;문단&quot; 요소입니다.

참고문헌

같이 보기