PHP htmlentities()Fonctions
Manuel de référence des chaînes PHP
Exemples
Convertir certains caractères en entités HTML :
$str = "<© W3CSçh°°¦§>";
echo htmlentities($str);
?>
La sortie HTML du code ci-dessus est la suivante (afficher la source) :
<html>
<body>
<© W3CSçh°°¦§>
</body>
</html>
La sortie du navigateur du code ci-dessus est la suivante :
Exécuter l'exemple »
Définition et utilisation
La fonction htmlentities() convertit les caractères en entités HTML.
Astuce :Pour reconvertir les entités HTML en caractères, utilisez la fonctionhtml_entity_decode().
Astuce :Veuillez utiliser la get_html_translation_table(): fonction permettant de renvoyer la table de traduction utilisée par htmlentities().
Syntaxe
| Paramètre | Description |
|---|---|
| string | Obligatoire. Spécifie la chaîne à convertir. |
| indicateurs | Facultatif. Spécifie comment gérer les guillemets, l'encodage invalide et le type de document à utiliser. Types de guillemets disponibles :
Encodage invalide :
Indicateurs supplémentaires spécifiant le type de document à utiliser :
|
| jeu de caractères | Facultatif. Une chaîne spécifiant le jeu de caractères à utiliser. Valeurs autorisées :
Remarques :Dans les versions antérieures à PHP 5.4, les jeux de caractères non reconnus sont ignorés et remplacés par ISO-8859-1. À partir de PHP 5.4, les jeux de caractères non reconnus sont ignorés et remplacés par UTF-8. |
| double_encode | Facultatif. Un booléen qui indique si les entités HTML existantes doivent être encodées.
|
Détails techniques
| Valeur de retour : | Retourne la chaîne convertie. Sistringcontient un encodage non valide, une chaîne vide est renvoyée, sauf si l'indicateur ENT_IGNORE ou ENT_SUBSTITUTE est défini. |
|---|---|
| Version de PHP : | 4+ |
| Journal des modifications : | En PHP 5, la valeur par défaut du paramètrecharacter-seta été changée en UTF-8. Dans PHP 5.4, ajout de : ENT_SUBSTITUTE, ENT_DISALLOWED, ENT_HTML401, ENT_HTML5, ENT_XML1 et ENT_XHTML. En PHP 5.3, ajout de ENT_IGNORE. Dans PHP 5.2.3, ajout du paramètredouble_encode. Dans PHP 4.1, ajout du paramètrecharacter-set. |
Plus d’exemples
Exemple 1
Convertir certains caractères en entités HTML :
$str = "Jane & 'Tarzan'";
echo htmlentities($str, ENT_COMPAT); // Ne convertira que les guillemets doubles
echo "<br>";
echo htmlentities($str, ENT_QUOTES); // Convertit les guillemets doubles et simples
echo "<br>";
echo htmlentities($str, ENT_NOQUOTES); // Ne convertit aucun guillemet
?>
La sortie HTML du code ci-dessus est la suivante (afficher la source) :
<html>
<body>
Jane & 'Tarzan'<br>
Jane & 'Tarzan'<br>
Jane & 'Tarzan'
</body>
</html>
La sortie du navigateur du code ci-dessus est la suivante :
Jane & 'Tarzan'
Jane & 'Tarzan'
Exécuter l'exemple »
Exemple 2
Convertir certains caractères en entités HTML à l'aide du jeu de caractères d'Europe occidentale :
$str = "My name is Øyvind Åsane. I'm Norwegian.";
echo htmlentities($str, ENT_QUOTES, "ISO-8859-1"); // Ne convertira que les guillemets doubles (pas les guillemets simples), et utilise le jeu de caractères d'Europe occidentale
?>
La sortie HTML du code ci-dessus est la suivante (afficher la source) :
<html>
<body>
Je m'appelle Øyvind Åsane. Je suis norvégien.
</body>
</html>
La sortie du navigateur du code ci-dessus est la suivante :
Exécuter l'exemple »
Manuel de référence des chaînes PHP Autres extensions