DocBlocks for filters inside a conditional expression are not imported
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 45/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- php
调研方向
首先复现两个 PHP 示例，并跟踪条件表达式中的 apply_filters 调用是如何与 DocBlocks 关联的。将两个示例的 parser 结果与预期的过滤器文档进行比较，包括 wp_save_post_revision_check_for_changes。完成的标准是：DocBlock 2 被分配给 in_conditional_expression，并且正确的 DocBlock 被分配给 in_conditional。
由索引模型根据 Issue 内容生成。
描述
DocBlocks outside a conditional are not imported if there are other filters (with DocBlocks) within the conditional.
Example 1
In this example DocBlock 2 is not imported for the filter in_conditional_expression
/**
* DocBlock 1
*/
function test_docblocks() {
/**
* DocBlock 2
*/
if ( apply_filters( 'in_conditional_expression', true ) ) {
/**
* DocBlock 3
*/
$value = apply_filters( 'in_conditional', true );
}
}
Example 2
In this example the (wrong) DocBlock 2 is imported for the filter 'in_conditional`.
/**
* DocBlock 1
*/
function test_docblocks() {
/**
* DocBlock 2
*/
if ( apply_filters( 'in_conditional_expression', true ) ) {
$value = apply_filters( 'in_conditional', true );
}
}
The wp_save_post_revision_check_for_changes filter doesn't get its DocBlock imported because of this bug.
See this filter in trac
- 主要语言
- PHP
- 星标
- 239
- 派生
- 81
- 平均合并
- 1 天 11 小时
- 30 天内合并 PR
- 3
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
WordPress/phpdoc-parser 的其他 Issue
-
Adopt PHPStan for types可能已有人在做 @sirreal 于 6 天前认领。 未关闭
难度 5/5 一周以上 新手友好度 20/100
WordPress/phpdoc-parser#304 · 1 个 reaction ·
-
难度 3/5 1-2 天 新手友好度 55/100
WordPress/phpdoc-parser#269 ·
-
Nested union types inside generics are split incorrectly可能已有人在做 @sirreal 于 81 天前认领。 未关闭
难度 3/5 1-2 天 新手友好度 64/100
WordPress/phpdoc-parser#268 · 2 条评论 ·
-
Some characters are stripped from documentation可能已有人在做 @sirreal 于 82 天前认领。 未关闭
难度 3/5 1-2 天 新手友好度 45/100
WordPress/phpdoc-parser#254 ·
-
难度 5/5 一周以上 新手友好度 35/100
WordPress/phpdoc-parser#246 · 9 条评论 ·
查看 WordPress/phpdoc-parser 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复
-
documentation
难度 2/5 1-3 小时 新手友好度 62/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
humanmade/publication-checklist#73 · 1 条评论 ·
-
Do not throw `WordPress.Security.EscapeOutput.OutputNotEscaped` on `apply_shortcodes()`可能已有人在做 @tbradsha 今天认领。 未关闭
难度 2/5 1-3 小时 新手友好度 75/100
-
难度 2/5 1-3 小时 新手友好度 62/100
landsman/adminer-desktop#120 ·
维护者通常 1 天内回复