функция since 2.5.1

sanitize_sql_orderby()

Проверено на WordPress 6.9, обновлено 06.08.2026 Источник: WordPress Developer Resources.

Сигнатура

sanitize_sql_orderby( string $orderby ): string|false

Описание

Принимает один или несколько столбцов, с указанием порядка сортировки (ASC / DESC) или без него.
Например, ‘column_1’, ‘column_1, column_2’, ‘column_1 ASC, column_2 DESC’ и т. д.
Также принимает ‘RAND()’.

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

Accepts one or more columns, with or without a sort order (ASC / DESC).
e.g. ‘column_1’, ‘column_1, column_2’, ‘column_1 ASC, column_2 DESC’ etc.

Also accepts ‘RAND()’.

Параметры

$orderby string обязательный

Выражение order by, которое нужно проверить.

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

string|false

Исходный код

wp-includes/formatting.php:2415

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

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

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