htmlentities
(PHP 4, PHP 5)
htmlentities — Convert all applicable characters to HTML entities
Descrição
Esta função é idêntica a htmlspecialchars() em toda forma, exceto que com htmlentities(), todos caracteres que tem entidade HTML equivalente são convertidos para estas entidades.
Se você está querendo decodificar (o inverso), você pode usar html_entity_decode().
Parâmetros
- string
-
A string de entrada.
- quote_style
-
Como htmlspecialchars(), o segundo parâmetro opcional quote_style você define o que irá ser feito com aspas 'simples' e "dupla". Use uma das três constantes com o padrão sendo ENT_COMPAT:
Constantes quote_style disponíveis Nome da constante Descrição ENT_COMPAT Irá converter aspas dupla e double-quotes e deixar somente aspas simples. ENT_QUOTES Irá converter ambas as aspas. ENT_NOQUOTES Irá deixar ambas as aspas não convertidas. - charset
-
Como htmlspecialchars(), o terceiro parâmetro opcional charset que define o conjunto de caracteres usado na conversão. Atualmente, o conjunto de caracteres ISO-8859-1 é usado com o padrão.
Os seguintes conjuntos de caracteres são suportados no PHP 4.3.0 e posterior.
Conjuntos de caracteres suportados Conjunto de caracteres Apelidos Descrição ISO-8859-1 ISO8859-1 Western European, Latin-1 ISO-8859-15 ISO8859-15 Western European, Latin-9. Adiciona o símbolo do Euro, letras Francesas e Filandesas faltando no Latin-1(ISO-8859-1). UTF-8 Código de multi-byte 8-bit Unicode compatível com ASCII. cp866 ibm866, 866 Conjunto de caracteres do DOS específico para o Russo. Este conjunto de caracteres é suportado no 4.3.2. cp1251 Windows-1251, win-1251, 1251 Conjunto de caracteres do Windows específico para o Russo. Este conjunto de caracteres é suportado no 4.3.2. cp1252 Windows-1252, 1252 Conjunto de caracteres do Windows específico para a Europa Ocidental. KOI8-R koi8-ru, koi8r Russo. Este conjunto de caracteres é suportado no 4.3.2. BIG5 950 Chinês Tradicional, usado principalmente em Taiwan. GB2312 936 Chins Simplificado, conjunto de caracteres padrão nacional. BIG5-HKSCS Big5 com extenções de Hong Kong, Chinês Tradicional. Shift_JIS SJIS, 932 Japonês EUC-JP EUCJP Japonês Nota: Qualquer outro conjunto de caracteres não é reconhecido e será usado o ISO-8859-1.
- double_encode
-
Quando double_encode esta'off, o PHP não irá codificar entidades HTML existentes. O padrão é converter qualquer coisa.
Valor Retornado
Retorna a string codificada.
Histórico
| Versão | Descrição |
|---|---|
| 5.2.3 | O parâmetro double_encode foi adicionado. |
| 4.1.0 | O parâmetro charset foi adicionado. |
| 4.0.3 | O parâmetro quote_style foi adicionado. |
Exemplos
Example#1 Exemplo da htmlentities()
<?php
$str = "A 'quote' is <b>bold</b>";
// Outputs: A 'quote' is <b>bold</b>
echo htmlentities($str);
// Outputs: A 'quote' is <b>bold</b>
echo htmlentities($str, ENT_QUOTES);
?>