sanitize_post( object|WP_Post|array $post, string $context = 'display' )

Nettoie tous les champs d'un poste.

Description

Si $context = 'raw', alors le tableau ou l'objet du poste obtiendra un nettoyage minimum des champs où les valeurs sont des entiers.

Paramètres

$post

(object | WP_Post | array) (Requis) Le tableau ou l'objet du poste à nettoyer.

$context

(string) (Optionnel) De quelle façon nettoyer les champs d'un poste. Accepte 'raw', 'edit', 'db', ou 'display'.

Valeur par défaut : 'display'

Retourne

(object | WP_Post | array) Retourne le tableau ou l'objet du poste qui sera du même type que $post.

Structure de la fonction sanitize_post()

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

function sanitize_post( $post, $context = 'display' ) {
    if ( is_object( $post ) ) {
        // Check if post already filtered for this context.
        if ( isset( $post->filter ) && $context == $post->filter ) {
            return $post;
        }
        if ( ! isset( $post->ID ) ) {
            $post->ID = 0;
        }
        foreach ( array_keys( get_object_vars( $post ) ) as $field ) {
            $post->$field = sanitize_post_field( $field, $post->$field, $post->ID, $context );
        }
        $post->filter = $context;
    } elseif ( is_array( $post ) ) {
        // Check if post already filtered for this context.
        if ( isset( $post['filter'] ) && $context == $post['filter'] ) {
            return $post;
        }
        if ( ! isset( $post['ID'] ) ) {
            $post['ID'] = 0;
        }
        foreach ( array_keys( $post ) as $field ) {
            $post[ $field ] = sanitize_post_field( $field, $post[ $field ], $post['ID'], $context );
        }
        $post['filter'] = $context;
    }
    return $post;
}

Fonction utilisée par sanitize_post()

sanitize_post_field()

Nettoie le champ d'un poste basé sur le contexte.

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

Sources

Codex Wordpress : sanitize_post()

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

Retour