Forum und email

htmlentities

(PHP 4, PHP 5)

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

Περιγραφή

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

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

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

Διαθέσιμες 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 και οι νεώτερες αυτής υποστηρίζουν τα ακόλουθα σύνολα χαρακτήρων:

Υποστηριζόμενα σύνολα χαρακτήρων
Σύνολο χαρακτήρων Δεύτερη ονομασία Περιγραφή
ISO-8859-1 ISO8859-1 Western European, Latin-1
ISO-8859-15 ISO8859-15 Western European, Latin-9. Περιέχει επιπλέον το σύμβολο του Ευρώ, καθώς επίσης γαλλικά και φινλανδικά γράμματα, που δεν περιλαμβάνονται στο Latin-1(ISO-8859-1).
UTF-8   Συμβατό με ASCII, multi-byte 8-bit Unicode.
cp866 ibm866, 866 Σύνολο χαρακτήρων του DOS για ρώσικα. Αυτό το σύνολο χαρακτήρων υποστηρίζεται από την έκδοση 4.3.2 και μετά.
cp1251 Windows-1251, win-1251, 1251 Σύνολο χαρακτήρων των Windows για ρώσικα. Αυτό το σύνολο χαρακτήρων υποστηρίζεται από την έκδοση 4.3.2 και μετά.
cp1252 Windows-1252, 1252 Σύνολο χαρακτήρων των Windows για Western European.
KOI8-R koi8-ru, koi8r Ρώσικα. Αυτό το σύνολο χαρακτήρων υποστηρίζεται από την έκδοση 4.3.2 και μετά.
BIG5 950 Παραδοσιακά κινέζικα, κυρίως αυτά που χρησιμοποιούνται στην Ταϊβάν.
GB2312 936 Απλοποιημένα κινέζικα, το εθνικά χρησιμοποιούμενο σύνολο χαρακτήρων.
BIG5-HKSCS   Big5 με επεκτάσεις για το Hong Kong, παραδοσικά κινέζικα.
Shift_JIS SJIS, 932 Japanese
EUC-JP EUCJP Γιαπωνέζικα

Note: Στη θέση οποιουδήποτε συνόλου χαρακτήρων που δεν αναγνωρίζεται θα χρησιμοποιηθεί το ISO-8859-1.

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

Example#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($strENT_QUOTES);
?>

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