(PHP 4, PHP 5)
htmlentities — Converte todos os caracteres aplicáveis em entidades html.
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().
A string de entrada.
Como htmlspecialchars(), o segundo parâmetro opcional quote_style você define o que irá ser feito com aspas 'simples' e "duplas". Use uma das três constantes com o padrão sendo ENT_COMPAT:
Nome da constante | Descrição |
---|---|
ENT_COMPAT | Irá converter aspas duplas e deixar somente aspas simples. |
ENT_QUOTES | Irá converter ambas as aspas. |
ENT_NOQUOTES | Irá deixar ambas as aspas não convertidas. |
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.
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.
Quando double_encode esta'off, o PHP não irá codificar entidades HTML existentes. O padrão é converter qualquer coisa.
Retorna a string codificada.
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. |
Exemplo #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);
?>