DocBlock for hooks not parsed correctly in some cases
还没有人认领这个 Issue。
评估
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 新手友好度
- 45/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 停滞
- 技术栈
- php
调研方向
首先使用 issue 中的两个 PHP 代码片段重现问题，并跟踪 hook DocBlock 的解析方式。完成的标准是：内联 @since 1.2.3 标签与导入的 hook 关联，而文件级 DocBlock 中的 @since 标签不与其关联。
由索引模型根据 Issue 内容生成。
描述
While parsing the source for a plugin, I came across a case where the DocBlock for a hook isn't parsed correctly.
The code contains the following:
/**
* Filters the filename to be required.
*
* @since 1.2.3
*
* @param string $filename The filename to require.
*/
require apply_filters( 'my-filter', 'some filename' );
The hook gets imported (including the description), but for some reason the @since tag is not. Instead, @since tags from the file-level DocBlock are associated with the hook.
Changing the code to the equivalent:
/**
* Filters the filename to be required.
*
* @since 1.2.3
*
* @param string $filename The filename to require.
*/
$filename = apply_filters( 'my-filter', 'some filename' );
require $filename;
works just fine.
- 主要语言
- 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 于 4 天前认领。 未关闭
难度 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 于 79 天前认领。 未关闭
难度 3/5 1-2 天 新手友好度 64/100
WordPress/phpdoc-parser#268 · 2 条评论 ·
-
Some characters are stripped from documentation可能已有人在做 @sirreal 于 80 天前认领。 未关闭
难度 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 小时 新手友好度 65/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 2 天内回复
-
backend bug
难度 2/5 1-3 小时 新手友好度 76/100
-
bug
难度 1/5 1 小时以内 新手友好度 85/100
-
难度 2/5 1-3 小时 新手友好度 63/100
smarty-php/smarty#1215 ·