根据一个或多个orderby参数对对象列表进行排序。

原型

wp_list_sort( array $list, string|array $orderby = array(), string $order = 'ASC', bool $preserve_keys = false )

参数

$list (array) (Required) 要过滤的对象数组。

$orderby (string|array) (Optional)  要按顺序排序的字段名称,要么将多个orderby字段的数组作为$ orderby => $ order。

$order (string) (Optional)  ‘ASC’或’DESC’。仅在$ orderby是字符串时使用。

$preserve_keys (bool) (Optional)  是否保存钥匙。

返回值

(array)  排序的数组。

源文件

路径:wp-includes/functions.php

<?php
...
function wp_list_sort( $list, $orderby = array(), $order = 'ASC', $preserve_keys = false ) {
	if ( ! is_array( $list ) ) {
		return array();
	}
	$util = new WP_List_Util( $list );
	return $util->sort( $orderby, $order, $preserve_keys );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_list_sort/