query_string
云策文档标注
概述
query_string 是一个已弃用的 WordPress Hook,用于在解析查询字符串前进行过滤。自 2.1.0 版本起,建议改用 'query_vars' 或 'request' 过滤器。
关键要点
- query_string Hook 接受一个字符串参数 $query_string,用于修改查询字符串。
- 该 Hook 在 WordPress 2.1.0 版本中被弃用,推荐使用 'query_vars' 或 'request' 过滤器替代。
- 相关函数 WP::build_query_string() 用于基于查询变量属性设置查询字符串属性。
代码示例
$this->query_string = apply_filters_deprecated(
'query_string',
array( $this->query_string ),
'2.1.0',
'query_vars, request'
);注意事项
- query_string Hook 自 2.1.0 版本起已弃用,开发者应避免在新代码中使用,并考虑迁移到 'query_vars' 或 'request' 过滤器。
- 该 Hook 在 WordPress 1.5.0 版本中引入,2.1.0 版本弃用,历史代码中可能仍存在相关用法。
原文内容
Filters the query string before parsing.
Parameters
$query_stringstring-
The query string to modify.
Source
$this->query_string = apply_filters_deprecated(
'query_string',
array( $this->query_string ),
'2.1.0',
'query_vars, request'
);
Changelog
| Version | Description |
|---|---|
| 2.1.0 | Deprecated. Use ‘query_vars’ or ‘request’ filters instead. |
| 1.5.0 | Introduced. |