htmlentities

(PHP 3, PHP 4, PHP 5)

htmlentities --  Μετατρέπει τους κατάλληλους χαρακτήρες σε HTML οντότητες

Περιγραφή

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

Η συνάρτηση είναι όμοια, από κάθε άποψη, με την htmlspecialchars(), εκτός του ότι με την htmlentities(), κάθε χαρακτήρας που έχει μία αντίστοιχη HTML οντότητα μεταφράζεται σε αυτή.

Όπως και στη συνάρτηση htmlspecialchars(), η προαιρετική δεύτερη παράμετρος quote_style σας επιτρέπει να ορίσετε τι θα γίνει με τα 'απλά' και "διπλά" εισαγωγικά. Δέχεται μία από τις τρεις σταθερές με προκαθορισμένη την ENT_COMPAT:

Ðßíáêáò 1. Διαθέσιμες quote_style σταθερές

Όνομα σταθεράςΠεριγραφή
ENT_COMPATΘα μετατρέψει τα διπλά εισαγωγικά και θα αφήσει τα απλά ανέγγιχτα.
ENT_QUOTESΘα μετατρέψει τα διπλά και τα απλά εισαγωγικά.
ENT_NOQUOTESΔε θα μετατρέψει τα διπλά και τα απλά εισαγωγικά.

Η υποστήριξη για την προαιρετική παράμετρο quote προστέθηκε στην έκδοση 4.0.4 της PHP.

Όπως η συνάρτηση htmlspecialchars(), έτσι και αυτή χρειάζεται ένα προαιρετικό τρίτο όρισμα charset, το οποίο ορίζει το σύνολο χαρακτήρων που θα χρησιμοποιηθεί στην μετροπή. Η υποστήριξη αυτής της παραμέτρου προστέθηκε στην έκδοση 4.1.0 της PHP. Προς το παρόν, το προκαθορισμένο σύνολο χαρακτήρων ISO-8859-1.

Η έκδοση PHP 4.3.0 και οι νεώτερες αυτής υποστηρίζουν τα ακόλουθα σύνολα χαρακτήρων:

Ðßíáêáò 2. Υποστηριζόμενα σύνολα χαρακτήρων

Σύνολο χαρακτήρωνΔεύτερη ονομασίαΠεριγραφή
ISO-8859-1ISO8859-1 Western European, Latin-1
ISO-8859-15ISO8859-15 Western European, Latin-9. Περιέχει επιπλέον το σύμβολο του Ευρώ, καθώς επίσης γαλλικά και φινλανδικά γράμματα, που δεν περιλαμβάνονται στο Latin-1(ISO-8859-1).
UTF-8  Συμβατό με ASCII, multi-byte 8-bit Unicode.
cp866ibm866, 866 Σύνολο χαρακτήρων του DOS για ρώσικα. Αυτό το σύνολο χαρακτήρων υποστηρίζεται από την έκδοση 4.3.2 και μετά.
cp1251Windows-1251, win-1251, 1251 Σύνολο χαρακτήρων των Windows για ρώσικα. Αυτό το σύνολο χαρακτήρων υποστηρίζεται από την έκδοση 4.3.2 και μετά.
cp1252Windows-1252, 1252 Σύνολο χαρακτήρων των Windows για Western European.
KOI8-Rkoi8-ru, koi8r Ρώσικα. Αυτό το σύνολο χαρακτήρων υποστηρίζεται από την έκδοση 4.3.2 και μετά.
BIG5950 Παραδοσιακά κινέζικα, κυρίως αυτά που χρησιμοποιούνται στην Ταϊβάν.
GB2312936 Απλοποιημένα κινέζικα, το εθνικά χρησιμοποιούμενο σύνολο χαρακτήρων.
BIG5-HKSCS  Big5 με επεκτάσεις για το Hong Kong, παραδοσικά κινέζικα.
Shift_JISSJIS, 932 Japanese
EUC-JPEUCJP Γιαπωνέζικα

Óçìåßùóç: Στη θέση οποιουδήποτε συνόλου χαρακτήρων που δεν αναγνωρίζεται θα χρησιμοποιηθεί το ISO-8859-1.

Εάν θέλετε αποκωδικοποίηση (αντίστροφο λειτουργία) μπορείτε να χρησιμοποιείσετε τη συνάρτηση html_entity_decode().

ÐáñÜäåéãìá 1. Παραδείγματα χρήσης της 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);
?>

Ανατρέξτε επίσης στις: html_entity_decode(), get_html_translation_table(), htmlspecialchars(), nl2br(), και urlencode().