如何报告Bug
PHP用户数量众多。人数少得多开发PHP语言和扩展的人。还有一个更小的积极修复用户报告的错误的人数。
这对你这个有抱负的错误记者意味着什么？为了抓住这几个坚定的人之一的眼睛志愿者，你需要请记住一些关于如何报告错误的提示，以便它们能够并且将对您有所帮助。
请特别注意上面粗体的那个单词。那些打算帮助您解决您报告的错误志愿者.你不仅没有付钱给他们帮助你，但其他人也没有。所以，为了解释不朽的话比尔和特德,“对他们很好”.
除了黄金法则之外，以下是一些关于如何让你的错误报告更好，以便有人能够帮助你。
基本要素：你做了什么，你想发生什么，以及实际上发生了什么发生了。
这是错误报告的三个基本元素。你需要告诉我们你做了什么（例如，“我的脚本调用make_happy_meal（“汉堡包”，“洋葱圈”）”），你期望发生的事情（为了继续这个示例，“我希望PHP为我提供一顿愉快的晚餐汉堡和洋葱圈”），以及实际发生的事情（“它给了我一个快乐用炸薯条吃饭。").
是的，这个例子很愚蠢。但是如果你的错误报告只是说“make_happy_meat函数不起作用，“我们不能说”因为你不能在一顿美餐中吃洋葱圈，所以你只能吃法语炸薯条或卷薯条。“告诉我们你的要求，你的期望得到了，你实际得到了什么，我们不必猜测。
始终先搜索错误数据库。
建议很好，我们会重复两次。总是搜索首先是bug数据库。如上所述很多PHP用户。如果你发现了问题，其他人也发现了它。如果你花几分钟的时间确保你没有提交重复的bug，这需要几分钟的时间可以花时间帮助修复该bug，而不是清理重复的bug报告。
如果您不理解错误消息，请寻求帮助。
不要将您不理解的错误消息报告为错误。有很多地方你可以寻求帮助在您可以声明错误消息之前了解发生了什么你不明白是一个错误。
（现在，一旦您理解了错误消息，并提出了一个好的建议为了使错误消息更清晰，您可以考虑报告它作为功能请求。）
简短，但不要遗漏任何重要的细节。
这是一条很好的路线。但有一些通用指南：
- 记住三个基本要素：你做了什么，你期望发生什么，以及发生了什么。
- 当您提供演示问题的代码时，它几乎应该永远不要超过十行。更长的内容可能包含许多与问题无关的代码，只会增加是时候找出真正的问题了。（但别忘了确保您的代码仍然显示您报告的错误，并且没有其他问题，因为你不小心剪掉了你认为不重要但很重要的事情！）
- 如果PHP崩溃，请包含回溯。操作说明可以找到这里为*NIX用户提供和此处适用于Windows用户.
-
瓦尔格林德日志也很有用。请参见如何生成的说明.
使用英语。
是的，PHP用户和开发人员社区是全球性的，包括许多人能说多种语言。但如果你要报告许多（如果不是大多数的话）如果你担心你的英语技能使描述错误变得困难，您可以尝试寻求帮助在其中一个非英语邮件列表.
不要报告旧版本的错误。
每次发布新版本的PHP时，都会修复数十个错误。如果您使用的PHP版本比最新版本，您应该升级到最新版本以确保bug你所经历的仍然存在。
请注意，不再积极支持将仅接收关键安全问题的修复。所以请不要报告不影响任何主动支持的PHP的非安全相关错误分支机构。
每个错误报告中只报告一个问题。
如果您遇到两个看起来不相关的错误，请创建一个每个新的错误报告。这使得不同的人更容易提供帮助带有不同的错误。
查看这些其他资源。
|
