Description

  • Vérifie si les caractères sont encodés en UTF-8
  • Convertie le caratère < en entité
  • Enlève toutes les balises html, ainsi que les balises <script> et <style> et php
  • Supprime les retours à la ligne, les tabulations et tous les types d'espaces
  • Enlève les octets

Paramètre

$str

(string) (Requis) Chaîne à nettoyer.

Retourne

(string) La chaîne nettoyée.

Structure de la fonction sanitize_text_field()

Définie dans le fichier wp-includes/formatting.php à la ligne 5352 :

function sanitize_text_field( $str ) {
    $filtered = _sanitize_text_fields( $str, false );

    /**
     * Filters a sanitized text field string.
     *
     * @since 2.9.0
     *
     * @param string $filtered The sanitized string.
     * @param string $str      The string prior to being sanitized.
     */
    return apply_filters( 'sanitize_text_field', $filtered, $str );
}

Fonctions et Hook utilisés par sanitize_text_field()

_sanitize_text_fields()

Fonction d'aide interne qui nettoie une chaîne provenant d'un champ de formulaire ou d'une base de donnée.

sanitize_text_field

Filtre une chaîne nettoyée.

apply_filters()

Appel les fonctions qui ont été attaché à un filtre (hook).

Où trouver la fonction sanitize_text_field() dans le CMS Wordpress

Exemple

Usage basique :
$str = "<h2>Titre</h2>";
sanitize_text_field( $str );
echo $str;
// Affichera "Titre" sans les balises

Sources

Codex Wordpress : sanitize_text_field()

Autres fonctions dans le même fichier : wp-includes/formatting.php

Retour