# wp_list_sort()

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

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

## Сигнатура

```php
wp_list_sort( array $input_list, string|array $orderby = array(), string $order = 'ASC', bool $preserve_keys = false ): array
```

## Описание

Сортирует массив объектов или массивов по одному или нескольким аргументам orderby.

## Параметры

- `$input_list` `array` — обязательный. Массив объектов или массивов для сортировки.
- `$orderby` `string|array` — необязательный, по умолчанию `array()`. Либо имя поля для сортировки, либо массив из нескольких полей сортировки в виде $orderby => $order.
- `$order` `string` — необязательный, по умолчанию `'ASC'`. Либо 'ASC', либо 'DESC'. Используется только если $orderby — строка. Значение по умолчанию 'ASC'.
- `$preserve_keys` `bool` — необязательный, по умолчанию `false`. Нужно ли сохранять ключи.

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

`array`

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

Файл: `wp-includes/functions.php:5419`

```php
function wp_list_sort( $input_list, $orderby = array(), $order = 'ASC', $preserve_keys = false ) {
	if ( ! is_array( $input_list ) ) {
		return array();
	}

	$util = new WP_List_Util( $input_list );

	return $util->sort( $orderby, $order, $preserve_keys );
}
```

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

- 4.7.0 — Introduced.

## Связанные

Использует: `WP_List_Util::__construct`.
Используется в: `WP_Sitemaps_Posts::get_url_list`, `WP_Customize_Nav_Menu_Setting::filter_wp_get_nav_menus`, [`wp_get_nav_menus`](https://chugunov.pro/api-wordpress/functions/wp_get_nav_menus/), `WP_Customize_Nav_Menu_Item_Setting::sort_wp_get_nav_menu_items`, [`wp_get_nav_menu_items`](https://chugunov.pro/api-wordpress/functions/wp_get_nav_menu_items/), `WP_Customize_Manager::prepare_controls`, [`get_permalink`](https://chugunov.pro/api-wordpress/functions/get_permalink/).

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