(PHP 4, PHP 5)
htmlentities — Converte todos os caracteres aplicáveis em entidades html.
$string
[, int $quote_style
[, string $charset
[, bool $double_encode
]]] )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().
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 "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. |
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.
| 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.
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);
?>