Manuale PHP
Indietro |  | Avanti

# htmlentities

(PHP 3, PHP 4, PHP 5)

htmlentities -- Converte tutti i possibili caratteri in entità HTML

## Descrizione

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

Questa funzione è identica a htmlspecialchars() tranne che htmlentities() converte tutti i caratteri che hanno una corrispettiva entità HTML.

Come per la funzione htmlspecialchars(), il secondo parametro opzionale quote_style indica cosa occorre fare per gli apici 'singoli' e "doppi". Sono possibili tre scelte indicate da tre costanti con default `ENT_COMPAT`:

Tabella 1. Costanti disponibili per quote_style

Nome della costante | Descrizione
--- | ---
`ENT_COMPAT` | Converte gli apici doppi e lascia inalterati gli apici singoli.
`ENT_QUOTES` | Converte sia gli apici doppi sia gli apici singoli.
`ENT_NOQUOTES` | Lascia entrambi i tipi di apici inalterati.

Il suupporto per il parametro quote è stato introdotto in PHP 4.0.3.

Come per la funzione htmlspecialchars(), questa ha un terzo parametro charset, opzionale, che definisce quale set di caratteri utilizzare per la conversione. Il supporto per questo parametro è stato aggiunto in PHP 4.1.0. Attualmente per default si utilizza il set ISO-8859-1.

Elenco dei set di caratteri supportati dal PHP 4.3.0 e successivi.

Tabella 2. set di caratteri supportati

Set di caratteri | Alias | Descrizione
--- | --- | ---
ISO-8859-1 | ISO8859-1 | Western European, Latin-1
ISO-8859-15 | ISO8859-15 | Western European, Latin-9. Con in più il simbolo dell'Euro e i caratteri francesi e finnici mancanti in Latin-1(ISO-8859-1).
UTF-8 |  | Set ASCII compatibile con il set multi-byte Unicode su 8-bit.
cp866 | ibm866, 866 | Set di caratteri cirillico specifico del Dos. Supportato dalla 4.3.2.
cp1251 | Windows-1251, win-1251, 1251 | Set di caratteri cirillico specifico di Windows, Supportato dalla 4.3.2.
cp1252 | Windows-1252, 1252 | Set di caratteri specifico di Windows per l'Europa occidentale.
KOI8-R | koi8-ru, koi8r | Russo. Supportato dalla 4.3.2.
BIG5 | 950 | Cinese tradizionale, usato principalmente a Taiwan.
GB2312 | 936 | Cinese semplificato, set di caratteri nazionale standard.
BIG5-HKSCS |  | Big5 con estensioni per Hong Kong, cinese tradizionale.
Shift_JIS | SJIS, 932 | Giapponese.
EUC-JP | EUCJP | Giapponese.

> Nota: Ogni altro set di caratteri non è riconosciuto e sarà sostituito con con il set ISO-8859-1.

Se si deve esere una decodifica (un giro al contrario) occorre utilizzare la funzione html_entity_decode().

Esempio 1. Un esempio di htmlentities()

`<?php $str = "A 'quote' is <b>bold</b>"; // Visualizza: A 'quote' is &lt;b&gt;bold&lt;/b&gt; echo htmlentities($str); // Visualizza: A &#039;quote&#039; is &lt;b&gt;bold&lt;/b&gt; echo htmlentities($str, ENT_QUOTES); ?>`

Vedere anche html_entity_decode(), get_html_translation_table(), htmlspecialchars(), nl2br() e urlencode().

Indietro | Partenza | Avanti
html_entity_decode | Risali | htmlspecialchars_decode