钩子文档

flush_rewrite_rules_hard

💡 云策文档标注

概述

flush_rewrite_rules_hard 是一个 WordPress 过滤器,用于控制是否执行“硬”重写规则刷新。硬刷新会更新服务器的配置文件,如 Apache 的 .htaccess 或 IIS 的 web.config。

关键要点

  • 这是一个过滤器,允许开发者干预重写规则刷新过程,决定是否执行硬刷新。
  • 硬刷新涉及更新服务器配置文件,可能影响性能或需要特定权限。
  • 参数 $hard 是一个布尔值,默认值为 true,表示默认执行硬刷新。
  • 过滤器在 WP_Rewrite::flush_rules() 方法中使用,用于移除并重新创建重写规则。
  • 自 WordPress 3.7.0 版本引入。

代码示例

if ( ! $hard || ! apply_filters( 'flush_rewrite_rules_hard', true ) ) {
    // 代码逻辑
}

注意事项

使用此过滤器时,需考虑服务器配置和性能影响,硬刷新可能不适用于所有环境或需要额外处理。


📄 原文内容

Filters whether a “hard” rewrite rule flush should be performed when requested.

Description

A “hard” flush updates .htaccess (Apache) or web.config (IIS).

Parameters

$hardbool
Whether to flush rewrite rules “hard”. Default true.

Source

if ( ! $hard || ! apply_filters( 'flush_rewrite_rules_hard', true ) ) {

Changelog

Version Description
3.7.0 Introduced.