# sanitize_sql_orderby()

URL: https://chugunov.pro/api-wordpress/functions/sanitize_sql_orderby/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.5.1.

## Сигнатура

```php
sanitize_sql_orderby( string $orderby ): string|false
```

## Описание

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

## Параметры

- `$orderby` `string` — обязательный. Выражение order by, которое нужно проверить.

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

`string|false`

## Исходный код

Файл: `wp-includes/formatting.php:2415`

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

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

- 2.5.1 — Introduced.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/sanitize_sql_orderby/