WordPress 5.3 开始不再支持使用整数作为菜单slug别名

WordPress 5.3起禁止使用整数作为菜单slug注册,因array_merge()函数会重排数字索引导致菜单对应错误。例如注册时1对应’First’,实际调用时可能指向’Second’。开发者需改用字符串slug以避免问题,否则系统将发出警告提示。

WordPress基础教程
阅读时间: 5 分钟
最后更新时间:2025年11月13日

之前,菜单可以使用整数slug进行注册,但是这样导致了难以调试的意外问题。例如,假设我们通过 register_nav_menus 函数使用了下面的代码注册菜单:

register_nav_menus(
    array(
        'primary' => 'Primary', 
        1 => 'First', 
        2 => 'Second',
    )
);

按照正常的情况下,上面的 1 对应的应该是 ‘First’ 菜单,但实际得到的结果并不是这样,而是和下面一样:

array( 
    'primary' => 'Primary', 
    0 => 'First', 
    1 => 'Second', 
)

也就是说,当你通过 wp_nav_menu( array( ‘theme_location’ => 1 ) ) 调用菜单的时候,输出的可能不是 First 菜单,而是 Second 菜单。显然,这不是我们想要的结果。

这是因为WordPress使用 array_merge() 将新的导航菜单位置添加到全局 $_wp_registered_nav_menus 变量。而 array_merge() 会重命名数字索引,在结果数组中从零开始递增键名,所以就导致了上面的情况。

所以,从 WordPress 5.3 开始,将不再支持使用整数作为菜单的slug。如果仍旧采用,WP就会通过 _doing_it_wrong() 显示一个警告信息,告知开发人员需要采用字符串作为slug进行菜单注册。

这篇文章有用吗?

点击星号为它评分!

平均评分 0 / 5. 投票数: 0

到目前为止还没有投票!成为第一位评论此文章。

曾凤祥

曾凤祥

技术负责人
小兽WordPress凭借15年的WordPress企业网站开发经验,坚持以“为企业而生的WordPress服务”为宗旨,累计为10万多家客户提供高品质WordPress建站服务,得到了客户的一致好评。我们一直用心对待每一个客户,我们坚信:“善待客户,将会成为终身客户”。小兽WordPress能坚持多年,是因为我们一直诚信。

相关文章

如何让线上业务更上一层楼

还没有WordPress网站

还没有WordPress网站

不管你从事什么行业,WordPress都会为你提供一个专业的主题模板。在WordPress市场上有成千上万的免费主题,适合很多中小企业。

查看所有模板
已经有WordPress网站

已经有WordPress网站

小兽WordPress诚邀你一起学习WordPress,愿与各方携手升级改善您的WordPress网站,一起交流网站加速,网站优化等问题。

马上交个朋友
微信联系
chat 扫码联系
模板建站
挑选模板
网站定制
免费诊断
咨询热线
咨询热线

189-0733-7671

返回顶部