函数

sanitize_sql_orderby( string $orderby )

描述

该WordPress函数可 确保字符串是有效的 SQL 'order by' 子句。

接受一个或多个列，有或没有排序顺序 (ASC / DESC)。例如“column_1”、“column_1、column_2”、“column_1 ASC、column_2 DESC”等。

也接受’RAND()‘。

参数

$orderby，( string ) （必需） 要验证的 Order by 子句。

返回值

(string|false) 如果有效则返回 $orderby，否则返回 false。

建站迷·划重点

相关函数

• 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/formatting.php

function sanitize_sql_orderby( $orderby ) {
    if ( preg_match( '/^\s*(([a-z0-9_]+|`[a-z0-9_]+`)(\s+(ASC|DESC))?\s*(,\s*(?=[a-z0-9_`])|$))+$/i', $orderby ) || preg_match( '/^\s*RAND\(\s*\)\s*$/i', $orderby ) ) {
        return $orderby;
    }
    return false;
}

更新日志

示例