sanitize_textarea_field( string $str )
Nettoie une chaîne multi-ligne provenant d'un champ de formulaire ou d'une base de donnée.
Paramètre
$str(string)requisChaîne à nettoyer.
Description / Informations supplémentaires
Cette fonction est comme sanitize_text_field() mais préserve les nouvelles lignes ('\n') et les autres espaces blancs qui viennent habituellement de l'élément HTML <textarea>.
Retourne
(string) Chaîne nettoyée.
Déclaration et structure de la fonction sanitize_textarea_field()
sanitize_textarea_field() est déclarée dans le fichier wp-includes/formatting.php à la ligne 5598 :
function sanitize_textarea_field( $str ) {
$filtered = _sanitize_text_fields( $str, true );
/**
* Filters a sanitized textarea field string.
*
* @since 4.7.0
*
* @param string $filtered The sanitized string.
* @param string $str The string prior to being sanitized.
*/
return apply_filters( 'sanitize_textarea_field', $filtered, $str );
}
Fonctions utilisées par sanitize_textarea_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.
apply_filters()Appel les fonctions qui ont été attaché à un filtre (hook).
Hook utilisé par sanitize_textarea_field()
sanitize_textarea_fieldFiltre la chaîne nettoyée d'un champ textarea.
Où est utilisée la fonction sanitize_textarea_field()
dans le CMS WordPress
Sources
Codex WordPress : sanitize_textarea_field()
Autres fonctions dans le même fichier : wp-includes/formatting.php