ToWebs

Descripción

string htmlentities ( string string [, int quote_style [, string charset]] )

Esta función es identica en todo a htmlspecialchars(), excepto que con htmlentities(), todos los caracteres que tengan una entidad equivalente en HTML serán cambiados a esas entidades.

En htmlspecialchars(), el parámetro opcional quote_style le permite definir lo que será hecho con las comillas 'sencillas' y las "dobles". Toma uno de tres constantes con ENT_COMPAT:

Tabla 1. Constantes disponibles para quote_style

Nombre de Constante	Descripción
`ENT_COMPAT`	Convertirá las dobles comillas y dejará solo las comillas sencillas.
`ENT_QUOTES`	Convertirá las comillas dobles y sencillas.
`ENT_NOQUOTES`	Mantendrá las comillas dobles y sencillas sin cambios.

El parámetro opcional quote fue agregado en PHP 4.0.3.

Además htmlspecialchars(), tiene un tercer parámetro opcional charset el cual define el conjunto de caracteres que serán utilizados en la conversión. Este parámetro fue agregado en PHP 4.1.0. Actualmente, el conjunto de caracteres IS-8859-1 es usado como valor por defecto.

Los siguientes juegos de caracteres son soportados a partir de PHP 4.3.0.

Tabla 2. Juegos de caracteres soportados

Juego de caracteres	Aliases	Descripción
ISO-8859-1	ISO8859-1	Europeo Occidental, Latin-1
ISO-8859-15	ISO8859-15	Europeo Occidental, Latin-9. Añade el signo de Euro, y letras del Francés y Finlandés que hacían falta en Latin-1(ISO-8859-1).
UTF-8		Multi-byte Unicode de 8-bits compatible con ASCII.
cp866	ibm866, 866	Juego de caracteres cirílicos específico de DOS. Este juego de caracteres está soportado en 4.3.2.
cp1251	Windows-1251, win-1251, 1251	Juego de caracteres cirílicos específico de Windows. Este juego de caracteres está soportado en 4.3.2.
cp1252	Windows-1252, 1252	Juego de caracteres específico de Windows para Europa Occidental.
KOI8-R	koi8-ru, koi8r	Ruso. Este juego de caracteres está soportado en 4.3.2.
BIG5	950	Chino Tradicional, usado principalmente en Taiwán.
GB2312	936	Chino Simplificado, juego de caracteres estándar nacional.
BIG5-HKSCS		Big5 con extensiones de Hong Kong, Chino Tradicional.
Shift_JIS	SJIS, 932	Japonés
EUC-JP	EUCJP	Japonés

Nota: Cualquier otro juego de caracteres no es reconocido y en su lugar se utilizará ISO-8859-1.

Si quiere hacer la operación inversa puede usar html_entity_decode().

Ejemplo 1. Un ejemplo de 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);
?>

Vea también html_entity_decode(), get_html_translation_table(), htmlspecialchars(), nl2br(), y urlencode().