钩子文档

mod_rewrite_rules

💡 云策文档标注

概述

mod_rewrite_rules 是一个 WordPress 过滤器,用于修改格式化后输出到 .htaccess 文件的 rewrite 规则列表。开发者可以通过此 Hook 自定义或添加规则。

关键要点

  • 过滤器名称:mod_rewrite_rules
  • 参数:$rules(字符串类型,表示格式化后的 .htaccess rewrite 规则)
  • 用途:允许开发者过滤或修改即将写入 .htaccess 的 rewrite 规则
  • 相关函数:WP_Rewrite::mod_rewrite_rules() 用于检索这些规则
  • 引入版本:WordPress 1.5.0

代码示例

// 添加 X-Content-Type-Options 头部到 .htaccess
function add_headers_htaccess( $rules ) {
  $new_rule = 
  Header always set X-Content-Type-Options "nosniff"
  
  EOD;

  return $new_rule . $rules;
}
add_filter('mod_rewrite_rules', 'add_headers_htaccess');

注意事项

使用此过滤器时,需确保返回的规则字符串格式正确,以避免 .htaccess 文件错误。示例中使用了 heredoc 语法(EOD),需注意其正确闭合。


📄 原文内容

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

Parameters

$rulesstring
mod_rewrite Rewrite rules formatted for .htaccess.

Source

$rules = apply_filters( 'mod_rewrite_rules', $rules );

Changelog

Version Description
1.5.0 Introduced.

User Contributed Notes