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. |