钩子文档

rewrite_rules

💡 云策文档标注

概述

本文档介绍 WordPress 中的 rewrite_rules 过滤器,用于过滤格式化后输出到 .htaccess 文件的重写规则列表。该过滤器已弃用,建议使用替代过滤器。

关键要点

  • rewrite_rules 过滤器允许开发者修改或过滤用于 .htaccess 文件输出的重写规则。
  • 该过滤器已从 WordPress 1.5.0 版本开始弃用,推荐使用 mod_rewrite_rules 作为替代。
  • 过滤器参数为 $rules,表示格式化后的重写规则字符串。

代码示例

return apply_filters_deprecated( 'rewrite_rules', array( $rules ), '1.5.0', 'mod_rewrite_rules' );

注意事项

使用 rewrite_rules 过滤器时需注意其已弃用状态,建议迁移到 mod_rewrite_rules 以避免兼容性问题。


📄 原文内容

Filters the list of rewrite rules formatted for output to an .htaccess file.

Parameters

$rulesstring
mod_rewrite Rewrite rules formatted for .htaccess.

Source

return apply_filters_deprecated( 'rewrite_rules', array( $rules ), '1.5.0', 'mod_rewrite_rules' );

Changelog

Version Description
1.5.0 Introduced.