PHP 编程,有很大一部分的工作就是数组的处理,WordPress 本身也整合一些非常方便的数组处理函数,今天给大家罗列一下,也方便自己以后写代码的时候查询。 🙂
wp_parse_args
wp_parse_args($args, $defaults='')
将用户定义的参数($args)合并到默认的参数($defaults),用户自定义的参数可以是数组,也可以是链接地址查询类型的字符串(比如:"id=5&status=draft")。
$args = wp_parse_args($args, array(
'type'=> 'post',
'posts_per_page'=> 5,
'cat'=> '1'
));
或者:
$args = wp_parse_args($args, 'type=post&posts_per_page=5&cat=1');
wp_parse_id_list
wp_parse_id_list($list)
将多个 ID 组成数组,或者逗号或者空格隔开的 ID 列表,转换过一个纯数字的 ID 数组。
wp_parse_id_list(array( 1, 13, '11', 13 ))
或者
wp_parse_id_list('1, 13 11, 13')
这两个都输出:
array( 1, 13, 11 )
wp_parse_slug_list
wp_parse_slug_list($list)
将多个字符串组成的数组,或者逗号或者空格分隔的字符串列表,转换过一个别名(slug)的数组。用法和 wp_parse_id_list 类似,这里就不再重复。
wp_array_slice_assoc
wp_array_slice_assoc( $array, $keys )
根据给定的键值列表从关联数组中获取相关的子数组。这个非常好理解:
$array = array(
1 => 'Item 1',
2 => 'Item 2',
3 => 'Item 3',
4 => 'Item 4',
5 => 'Item 5',
);
wp_array_slice_assoc($array, array(1,3,5));
将会返回:
array(
1 => 'Item 1',
3 => 'Item 3',
5 => 'Item 5',
)
wp_is_numeric_array
wp_is_numeric_array( $data )
判断数组是否数字索引的数组,非常简单,就不在举例了。
wp_list_filter
wp_list_filter($list, $args = array(), $operator = 'AND')
根绝一组 key=>value 的参数,来过滤一组对象(或者数组)列表,比如下面就是 WordPress 查询到了多种 post_type 的日志列表结果,过滤出 page 类型的:
$pages = wp_list_filter( $wp_query->posts, array('post_type' => 'page'));
第三个元素 $openrator 默认值是 AND,他还有 OR 和 NOT 这两个参数,意思是 $args 参数中的 key value 对的比较方式,AND 就是所有都要相等,OR 只要一组值相等即可,NOT 所有的值都不相等才行。
当然我们也可以使用 PHP 的原生函数 array_filter 实现相同的功能。
wp_list_pluck
wp_list_pluck( $list, $field, $index_key = null )
从对象(或者数组)列表中每个元素冲去某个字段组成一个新数组,最后一个参数是新数组的元素 key,使用原来列表元素的 $index_key 值,比如下面的数组:
$foods = array(
array(
'id' => 4,
'name' => 'Banana',
'color' => 'Yellow',
),
array(
'id' => '5',
'name' => 'Apple',
'color' => 'Red',
),
array(
'id' => 2,
'name' => 'Lettuce',
'color' => 'Green',
),
array(
'id' => '7',
'name' => 'Apple',
'color' => 'Red',
),
);
我们取出 'name' 列的值组成新数组:
$food_names = wp_list_pluck( $foods, 'name' );
将返回:
array(
'Banana',
'Apple',
'Lettuce',
'Apple'
);
如果我们想使用原来列表的每个元素的 id 作为 key
$food_names = wp_list_pluck( $foods, 'name', 'id' );
将得到:array(
4 => 'Banana',
5 => 'Apple',
2 => 'Lettuce',
7 => 'Apple'
);
从 PHP 5.5 开始,PHP 的 array_column 函数也可实现同样的功能了。
wp_filter_object_list
wp_filter_object_list( $list, $args, $operator, $field );
这个函数就是先 wp_filter_list 操作,然后再进行 wp_list_pluck 操作,不过它没有 wp_list_pluck 的 $index_key 参数。
wp_list_sort
wp_list_sort($list, $orderby = array(), $order = 'ASC', $preserve_keys = false)
根据 orderby 的参数对对象(或者数组)列表进行排序,最后一个参数是:是否保持原来的 key。
比如我们可以吧日志列表按照发布时间降序排序:
$sorted_posts = wp_list_sort( $posts, 'post_date', 'DESC' );
根据时间降序,然后根据标题升序排序:
$sorted_posts = wp_list_sort($posts, array(
'post_date' => 'DESC',
'post_title' => 'ASC',
));
©我爱水煮鱼,本站推荐使用的主机:
本站长期承接 WordPress 优化和建站业务,请联系微信:「chenduopapa」。