Vous êtes ici Fonction PHP > Description de la fonction htmlspecialchars()

 

Recherche sur les Noms des fonctions php/mysql

 
 

htmlspecialchars()

Définition

Convertit les caractères spéciaux en entités HTML - (PHP 4, PHP 5)

Description

string htmlspecialchars ( string $string [, int $quote_style [, string $charset [, bool $double_encode ]]] )

Certains caractères ont des significations spéciales en HTML, et doivent être remplacés par des entités HTML pour être affichés. htmlspecialchars() remplace tous ces caractères par leur équivalent dans la chaîne string . Cette conversion est très pratique pour la programmation web. Si vous devez remplacer tous les caractères, utilisez plutôt htmlentities() à la place.

htmlspecialchars() est pratique pour éviter que des données fournies par les utilisateurs contiennent des balises HTML, comme pour un forum ou un chat.

Les remplacements effectués sont :

  • "&" (et commercial) devient "&"
  • """ (guillemets doubles) devient """ lorsque ENT_NOQUOTES n'est pas utilisée.
  • "'" (guillemet simple) devient "'" uniquement lorsque ENT_QUOTES est utilisée.
  • "<" (inférieur à) devient "&lt;"
  • ">" (supérieur à) devient "&gt;"

Liste de paramètres

string

La chaîne à convertir.

quote_style

L'argument optionnel quote_style indique comment doivent être traités les guillemets doubles et simples. Vous pouvez utiliser l'une des constantes suivantes : ENT_COMPAT, la constante par défaut, va convertir les guillemets doubles et ignorer les guillemets simples; ENT_QUOTES va convertir les guillemets doubles et les guillemets simples; ENT_NOQUOTES va ignorer les guillemets doubles et les guillemets simples.

charset

Jeu de caractères utilisé lors de la conversion. Par défaut, vaut ISO-8859-1.

Les jeux de caractères suivants sont disponibles et supportés par PHP 4.3.0 et plus récent.

Jeux de caractères supportés
Jeux de caractères Alias Description
ISO-8859-1 ISO8859-1 Europe occidentale, Latin-1
ISO-8859-15 ISO8859-15 Europe occidentale, Latin-9. Dispose du signe Euro, des caractères spéciaux français et finlandais, qui manquent au Latin-1(ISO-8859-1).
UTF-8   Unicode 8 bits multioctets, compatible avec l'ASCII
cp866 ibm866, 866 Jeu de caractères Cyrillic spécifique à DOS. Ce jeu de caractères est supporté depuis PHP 4.3.2.
cp1251 Windows-1251, win-1251, 1251 Jeu de caractères Cyrillic spécifique à Windows. Ce jeu de caractères est supporté depuis PHP 4.3.2.
cp1252 Windows-1252, 1252 Jeu de caractères spécifique de Windows pour l'Europe occidentale.
KOI8-R koi8-ru, koi8r Russe. Ce jeu de caractères est supporté depuis PHP 4.3.2.
BIG5 950 Chinois traditionnel, principalement utilisé à Taïwan.
GB2312 936 Chinois simplifié, officiel.
BIG5-HKSCS   Big5 avec les extensions de Hong Kong, chinois traditionnel.
Shift_JIS SJIS, 932 Japonais
EUC-JP EUCJP Japonais

Note: Les autres jeux de caractères ne sont pas reconnus, et le ISO-8859-1 sera utilisé à la place.

double_encode

Lorsque le paramètre double_encode est désactivé, PHP n'encodera pas les entités html existants ; par défaut, tout est converti.

Valeurs de retour

La chaîne convertie.

Historique

Version Description
5.2.3 Ajout du paramètre double_encode .
4.1.0 Ajout du paramètre charset .

Exemples

Exemple #1 Exemple avec htmlspecialchars()

<?php
$new = htmlspecialchars("<a href='test'>Test</a>", ENT_QUOTES);
echo $new; // &lt;a href=&#039;test&#039;&gt;Test&lt;/a&gt;
?>

Notes

Note: Notez que cette fonction ne fait aucun autre remplacement que ceux qui sont listés ci-dessus. Pour faire un remplacement total, voyez plutôt htmlentities().

Voir aussi



 
 

Bouts de code utilisant la fonction htmlspecialchars()


Favilink - Affichez un favicon à côté de vos adresses

<?php /* ... */                     {                         return '<a href="' . htmlspecialchars ( $url ) . '">' .  htmlspecialchars ( $text ) . '</a>'; /* ... */ ?>
Récupérer les informations d'une vidéos Youtube, dailymotion, vimeo ou google vidéo

<?php /* ... */         //titre         $titre = htmlspecialchars(trim(str_replace("Dailymotion -","",$tags[ "title"]))); /* ... */ ?>
Bloquer dynamiquement des IP hack et stocker ces IP dans des fichiers

<?php /* ... */                 $message_erreur .= 'Voici l\'url source : <a href="' .  htmlspecialchars($url_erreur_complete) . '">' . $url_erreur_complete .  '</a><br><br>'; /* ... */ ?>
Explorateur MySQL

<?php /* ... */                     $tmp .= '<td class="bordpurple">';                         $tmp .= htmlspecialchars(stripslashes($valeur));                     $tmp .= '</td>'; /* ... */ ?>
Récupération des données adsense et affichage de statistiques

<?php /* ... */             die("Impossible de récupérer l'url de redirection :<br>" . nl2br( htmlspecialchars($result)));         } /* ... */ ?>