Forum und email
Cadenas
PHP Manual

htmlentities

(PHP 4, PHP 5)

htmlentities — Convierte todos los caracteres a su entidad HTML aplicable

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:

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.

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

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

Example#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().

Cadenas
PHP Manual