sanitize_post() — описание функции WordPress на русском

Сигнатура

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

Описание

Если контекст — 'raw', то объект или массив записи проходит минимальную очистку только целочисленных полей.
См. alsosanitize_post_field()

Оригинал (английский)

If the context is ‘raw’, then the post object or array will get minimal sanitization of the integer fields.

Параметры

$post object|WP_Post|array обязательный

Объект или массив записи.

$context string необязательный = 'display'

Как очищать поля записи. Принимает 'raw', 'edit', 'db', 'display', 'attribute' или 'js'. Значение по умолчанию 'display'.

Возвращаемое значение

object|WP_Post|array

$post

Исходный код

wp-includes/post.php:2919

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;
}

История изменений

Версия	Описание
2.3.0	Introduced.