Products
GG网络技术分享 2025-03-18 16:12 0
我们使用 WordPress 开发的时候，有很大一部分的工作和数组处理有关，WordPress 本身也内置了一些非常方便的数组处理函数，今天给大家罗列一下，也方便自己以后写代码的时候查询。
wp_parse_args($args, $defaults=[])
将用户定义的参数（$args）合并到默认的参数（$defaults）中，用户自定义的参数可以是数组，也可以是对象，甚至支持链接地址查询类型的字符串（比如："id=5&status=draft"）。
$args = wp_parse_args($args, [
'post_type'=> 'post',
'posts_per_page'=> 5,
'cat' => 1
]);
也可以使用该函数将链接地址查询类型的字符串转换成数组：
$args = wp_parse_args('post_type=post&posts_per_page=5&cat=1');
// 输出 Array ( [type] => post [posts_per_page] => 5 [cat] => 1 )
wp_parse_list( $list )
将逗号或者空格隔开的标量转换成数组。
wp_parse_list('1 2,3 abc');
// 输出 Array ( [0] => 1 [1] => 2 [2] => 3 [3] => abc )
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 ( [0] => 1 [1] => 13 [2] => 11 )
wp_parse_slug_list($list)
将多个字符串组成的数组，或者逗号或者空格分隔的字符串列表，转换过一个别名（slug）（对数组每个元素调用 sanitize_title 处理）的数组。
用法和 wp_parse_id_list 类似，这里就不再重复。
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( $data )
判断数组是否数字索引的数组，非常简单，就不再举例了。
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( $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
(
[0] => Banana
[1] => Apple
[2] => Lettuce
[3] => 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( $list, $args = array(), $operator = 'and', $field = false )
这个函数就是先 wp_filter_list 操作，然后如果 $field 参数值不为空，则再进行 wp_list_pluck 操作，不过它没有 wp_list_pluck 的 $index_key 参数。
wp_list_sort($list, $orderby = array(), $order = 'ASC', $preserve_keys = false)
根据 orderby 的参数对对象（或者数组）列表进行排序，最后一个参数 $preserve_keys 用于是否保持原来的 key。
比如我们可以把文章列表按照发布时间降序排序：
$sorted_posts = wp_list_sort( $posts, 'post_date', 'DESC' );
根据时间降序，然后根据标题升序排序：
$sorted_posts = wp_list_sort($posts, array(
'post_date'=> 'DESC',
'post_title'=> 'ASC',
));map_deep( $value, $callback )
将函数映射到数组或对象的所有不可迭代元素，有点类似于 array_walk_recursive() 函数，但是 map_deep 还支持对象：
比如，对数组或者对象的所有元素进行 URL 编码：
map_deep( $value, 'urlencode' )
所以 WordPress 基于 map_deep 创建几个深度映射回调的函数：
当然我们也可以基于函数创建执行深度映射操作的函数。
关于 WordPress 内置的函数，我目前收集到就是那么多，如果你有发现什么好的函数也可以留言告诉我。
使用WordPress博客的站长朋友肯定对文章别名不陌生，很多人的固定连接都是围绕着文章的 ID（/%post_id%.html） 展开的，而在国外很多站点的固定链接都是采用文章别名的。且有些插件和主题是必须要设置%postname%.html 这样的别名固定链接才能使用，而中文站点自动生成的文章别名直接是汉字（默认为文章的标题生成为文章别名），就会出现中文链接，那么调用出来的将会是一堆乱码（因为WordPress对中文的别名进行了编码，在数据库中存储的不是中文），文章链接地址也会很长，不利于SEO优化，非常不好。
为了SEO优化，在不改变以前的用文章ID作为文章链接地址且已经被收录的文章则要保证全部还能访问，不会造成了大量的死链接。这样就需要我们手动修改别名（WordPress使用自动生成的文章ID作为文章别名），今天就介绍如何用纯代码实现直接将 WordPress 所有文章别名设置为文章ID的方法。
PS：为了安全起见，所有设置数据库的操作务必记得先备份网站的数据库，避免因失误带来无法挽回的损失！然后再按照下文操作！
在后台的 “设置” → “固定连接” → “自定义结构”选项 里设置一下固定连接，把 ID 改成别名，也就是把固定连接里的 /%post_id%.html 改成/%postname%.html
使用方法：将下边的代码添加到到当前主题目录下 functions.php 文件，在php结束标记 ?> 前 即可。
// 修改WordPress旧文章别名为文章IDfunction Bing_post_name_id(){
query_posts( \'posts_per_page=-1\' );
while( have_posts() ){
the_post();
$post_id = $GLOBALS[\'post\']->ID;
wp_update_post( array(
\'ID\' => $post_id,
\'post_name\' => $post_id
) );
}
wp_reset_query();
}
if( $_GET[\'post_name_id\'] == \'yes\' ) add_action( \'init\', \'Bing_post_name_id\' );
放置好代码后，访问一下下边的网站，注意替换成你的域名，访问前注意一定要备份数据，以免出错。
http://www.aszhi.com?post_name_id=yes
文章多的话网页加载会比较慢，因为正在一篇文章一篇文章的修改别名，要耐心等到网页完全加载好才可以。
PS：加载好后，删除之前添加的代码，修改完成，所有文章的别名都会变成自身的ID。
使用方法：将下面的代码添加到网站 根目录的 wp-config.php 的最底部，保存后，访问一次网站首页（你将看到浏览器一直都在努力打开网页，不要急，耐心等待，直到网页真正打开，所需时间看文章数和网络情况而定）。等网页打开后，删除刚刚添加到 wp-config.php 的代码！（删除代码是为了防止下次打开网站首页缓慢的情况发生）
/** 批量更改旧文章的别名为文章ID */// 添加一个变量来包容文章标题数组，防止重复操作
$slug_done = array();
// 查询所有文章
$posts = $wpdb->get_results( \"
SELECT
`ID`,
`post_title`
FROM
`\" . $wpdb->posts . \"`
WHERE
`post_type` = \'post\'
\" );
// 输出文章
foreach( $posts AS $single ) {
$this_slug = $single->ID;
$slug_done[] = $this_slug;
// 使用文章ID替换文章原来的别名
$wpdb->query( \"
UPDATE
`\" . $wpdb->posts . \"`
SET
`post_name` = \'\" . $this_slug . \"\'
WHERE
`ID` = \'\" . $single->ID . \"\'
LIMIT 1
\" );
}
进入 mysql 命令【 选择你所创建的数据库的命令：mysql> USE MYSQLDATA; （注：MYSQLDATA是数据库的名称。按回车键出现 Database changed 时说明操作成功！） 】或者 phpmyadmin 的 SQL （登录后打开数据库管理系统，找到网站对应的wordpress数据库，点击后，在上方有个SQL按钮） ，执行如下SQL命令修改即可：
update wp_posts set post_name=ID where post_status=\'publish\' and post_type=\'post\';
PS：wp_posts 是 WordPress 的文章数据表，wp_ 是默认的前缀，如果自定义更改过，请根据实际修改即可。
Demand feedback
