array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'it', ), 'this' => array ( 0 => 'function.htmlentities.php', 1 => 'htmlentities', 2 => 'Converte tutti i possibili caratteri in entità HTML', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String Funzioni', ), 'prev' => array ( 0 => 'function.html-entity-decode.php', 1 => 'html_entity_decode', ), 'next' => array ( 0 => 'function.htmlspecialchars.php', 1 => 'htmlspecialchars', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'it', 'path' => 'reference/strings/functions/htmlentities.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

htmlentities

(PHP 4, PHP 5, PHP 7, PHP 8)

htmlentities — Converte tutti i possibili caratteri in entità HTML

Descrizione

htmlentities(string $string, int $quote_style = ?, string $charset = ?): string

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:
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:
Set di caratteri supportati
Set di caratteri Alias Descrizione
ISO-8859-1 ISO8859-1 Western European, Latin-1.
ISO-8859-5 ISO8859-5 Il charset cirillico poco utilizzato (Latin/Cyrillic).
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.
cp1251 Windows-1251, win-1251, 1251 Set di caratteri cirillico specifico di Windows.
cp1252 Windows-1252, 1252 Set di caratteri specifico di Windows per l'Europa occidentale.
KOI8-R koi8-ru, koi8r Russo.
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, SJIS-win, cp932, 932 Giapponese.
EUC-JP EUCJP, eucJP-win Giapponese.
MacRoman   Charset che veniva utilizzato dal Mac OS.
''   Una stringa vuota attiva il rilevamento della codifica dallo script (Zend multibyte), default_charset e l'attuale locale (guarda nl_langinfo() e setlocale()), in quest'ordine. Non consigliato.

Nota: Ogni altro set di caratteri non è riconosciuto. Sarà invece utilizzata la codifica predefinita e verrà mostrato un avviso.

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

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