函数

sanitize_meta( string $meta_key, mixed $meta_value, string $object_type, string $object_subtype = '' )

描述

清理WordPress元数据中的非法字符

参数

$meta_key，( string ) (必需) 元数据键。

$meta_value，（混合） （必需） 要清理的元数据值。

$object_type，( string ) (必需) 对象元数据的类型。接受“post”、“comment”、“term”、“user”或任何其他具有关联元表的对象类型。

$object_subtype，( string ) (可选) 对象类型的子类型。默认值： ''

返回值

（mixed）清理后的 $meta_value。

建站迷·划重点

相关函数

• sanitize_email()
• sanitize_file_name()
• sanitize_html_class()
• sanitize_key()
• sanitize_meta()
• sanitize_mime_type()
• sanitize_option()
• sanitize_sql_orderby()
• sanitize_text_field()
• sanitize_title()
• sanitize_title_for_query()
• sanitize_title_with_dashes()
• sanitize_user()
• esc_url_raw()
• wp_filter_post_kses()
• wp_filter_nohtml_kses()

来源

文件：wp-includes/meta.php

更新日志

示例

$clean_value = sanitize_meta( 'birth-year', $user_input, 'user' );
 
function wpdocs_sanitize_birth_year_meta( $year ) {
 
    $now  = date( 'Y' );
    $then = $now - 115; // No users older than 115.
 
    if ( $then > $year || $year > $now ) {
        wp_die( __( 'Invalid entry, go back and try again.', 'textdomain' ) );
    }
    return $year;
}
add_filter( 'sanitize_user_meta_birth-year', 'wpdocs_sanitize_birth_year_meta' );