htmlentities

(PHP 4, PHP 5)

htmlentities — Converte todos os caracteres aplicáveis em entidades html.

Descrição

string htmlentities ( string $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().

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 "duplas". 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 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.
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

Note: 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.

Changelog

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 &lt;b&gt;bold&lt;/b&gt;
echo htmlentities($str);

// Outputs: A &#039;quote&#039; is &lt;b&gt;bold&lt;/b&gt;
echo htmlentities($str, ENT_QUOTES);
?>

Veja Também