編輯“WordPress:Submitting Bugs”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>導航:</strong> [[WordPress:WordPress文檔|上一級]] | [[WordPress]] | {{Template:WordPress導航}}</span>
<div style="clear:both;"></div>
每種軟件都有[[WordPress:Wikipedia:Computer bug|錯誤]] – 只要是人寫代碼，軟件中就會有錯誤，有些錯誤是微不足道的，但是有些是非常嚴重的。開源項目如 [[WordPress:WordPress| WordPress]] 需要使用者的參與來找出軟件中的錯誤，同樣也包括新功能的開發(fā)。
所有類型的反饋&mdash; 不管是真正的錯誤還是有用的請求&mdash; 都在WordPress 中用同樣的方法提交。閱讀WordPress關于如何提交錯誤和問題的信息... 你可能會想要閱讀[[WordPress:Contributing to WordPress|為WordPress做貢獻]]來找出如何為文檔資料和WordPress其他方面做貢獻。

== 提交安全問題 ==

當我們試著防止出現安全問題時，我們不能認為它們不會出現。如果你相信你在WordPress某個版本中找到了安全問題，發(fā)郵件到<tt>WordPress.org</tt>上的<tt>security</tt> 區(qū)域，我們將盡力盡快解決。

通知賣主(這里是指WordPress開發(fā)人員)是在發(fā)布之前的安全問題的標準練習，這樣可以準備好修正版本，這造成的損失可以降低到最小。

== 提交插件和主題中的錯誤 ==

如果你在使用時插件或者主題中發(fā)現了錯誤，'''不要''' 使用本文中的方法進行提交! 本文提供的方法只適用于WordPress核心文件的錯誤，不適合于插件和主題中的錯誤。

[http://dev.wp-plugins.org/ WordPress插件庫]中的插件有一個來自 WordPress 核心的[http://dev.wp-plugins.org/report 單獨的錯誤跟蹤系統(tǒng)]。有一個如何使用這個系統(tǒng)的 [http://dev.wp-plugins.org/wiki/TracTickets 單獨的說明]。

對于不在官方庫中的插件和主題，查看其附帶的文檔資料作為關于如何提交錯誤的說明。如果沒有錯誤提交信息，你需要直接聯系作者。


==錯誤提交和解決總覽==

提交和解決WordPress錯誤的過程有幾步，這里是一個總的概括，下面可以找到更多細節(jié)。 
# 用戶發(fā)現了錯誤，出現在WordPress核心文件中 (不在主題或者插件中).
# 用戶嘗試著確認這確實是一個錯誤。參見 [[#WordPress:Before You Report a Bug|提交錯誤之前(下面)]].
# 如果確定它是一個錯誤，用戶提交錯誤報告到[http://trac.wordpress.org/ Trac]，叫做''ticket''，WordPress錯誤跟蹤系統(tǒng)。參見[[#WordPress:Reporting a Bug|提交錯誤 (下面)]]. 
# WordPress 開發(fā)人員 (可能也是象你一樣的志愿者) 確認錯誤的確存在，然后它應該被修正。然后象在票上做記號那樣標記出來。參見[[#WordPress:Trac Keywords|Trac 關鍵詞列表(下面)]] 和 [[#WordPress:Bug Resolutions|錯誤解決方案(下面)]].
# WordPress 開發(fā)人員 (可能是你)決定修復這個錯誤。開發(fā)者可能選擇通過點擊ticket底部附近的 ''Accept ticket''操作來負責這個錯誤，盡管這不是必須的。然后開發(fā)人員指出如何修復這個錯誤，創(chuàng)建一個或者多個補丁，上傳到Trac. 參見 [[#WordPress:Patching Bugs|錯誤補丁(下面)]]。同樣的，如果你想要幫助修復錯誤，但是不知道需要修復哪個錯誤，參見[[#WordPress:Finding Bugs to Fix|找到錯誤并修復 (下面)]].
# WordPress開發(fā)小組成員(包括志愿者)測試補丁，查看是否錯誤被修復了而沒有影響到其他東西。它們添加評論和關鍵詞到ticket，顯示出它們的結果。參見 [[#WordPress:Trac Keywords|Trac 關鍵詞列表(下面)]].
# WordPress 開發(fā)員中的一個擁有修改官方WordPress源代碼權限的人(Matt Mullenweg, Ryan Boren, Mark Jaquith or Peter Westwood) ''提交'' 補丁給SVN庫中的核心代碼。如果錯誤和補丁被他們所信任的某人驗證過后，他們會這樣做的。
# 最后，提交補丁的這個人設定ticket狀態(tài)為''closed''，結論是''fixed''。參見 [[#WordPress:Bug Resolutions|錯誤結論(下面)]].

==錯誤報告和解決方案的詳細內容==

下面的部分給上述的提綱添加了詳細內容。

=== 報告錯誤之前 ===

如WordPress這么大的項目，如此多的使用者提交錯誤報告，很有可能你的錯誤已經被提交過了，正因為這樣，檢查并確定系統(tǒng)中它還沒有被提交過是很重要的。如果你剛開始在WordPress中使用提交錯誤，在提交之前和有經驗的開發(fā)人員討論這個問題是個好辦法。請按照下面的步驟。

# 在Trac中通過使用[http://trac.wordpress.org/search 搜索]或者是[http://trac.wordpress.org/query 查詢]來查找你的錯誤或者是功能請求。
#* 如果你的問題已經被提交過了，請不要重復提交。如果你有更深入的信息，登陸并添加信息記錄到已存在的錯誤中。
#* 如果你的問題相似，但是不完全和另一個問題相同，你可以決定是否添加一個記錄到相似問題中，或者是重新提交。很難決定是否你的問題可以作為一個新的問題提交，但是通常情況下，如果你只是有更多信息來提交的話，打開問題，簡單的添加一個記錄就可以了。 如果你有個完全不同的問題，或者如果你正經歷了一個重復的以前解決過的問題，可以提交一個新錯誤。
#* 如果你的問題最近提交了也關閉了，但是你不同意這樣的解決方法，你可以重新打開ticket添加注釋，寫明你的理由。
# 想在Trac上在提交之前討論一個錯誤， (如判斷它是否是一個WordPress核心的而不是插件或者主題的錯誤)，你可以在[http://wordpress.org/support/ WordPress 支持論壇]上發(fā)個帖子，在[[WordPress:WordPress IRC Live Help|#wordpress IRC 頻道]] 討論你的問題，或者在[[WordPress:Mailing Lists#Testers|檢測器]] 或[[WordPress:Mailing Lists#hackers|Hackers]]郵件列表上參與郵件討論。
=== 提交錯誤 ===

[http://trac.wordpress.org/ Trac]是官方WordPress錯誤跟蹤器的名字。它使用開發(fā)源碼跟蹤軟件[http://projects.edgewall.com/trac/ Trac]，它是 [http://www.edgewall.com/ Edgewall Software]的產品。安裝下面的步驟在Trac建立一個好的錯誤報告:

# 閱讀 [[WordPress:#Before You Report a Bug|提交錯誤之前(上面)]], 然后驗證你有一個新的可以提交的錯誤。
# 閱讀[http://www.chiark.greenend.org.uk/~sgtatham/bugs.html 如何有效的提交錯誤]這個文章，和[http://trac.wordpress.org/wiki/TracTickets Trac Ticket 文檔].
#使用你的 using your [http://wordpress.org/support/ 支持論壇]的用戶名和密碼登陸[http://trac.wordpress.org/ WordPress Trac]。如果你沒有帳戶， [http://wordpress.org/support/register.php 注冊] 一個這樣才可以登陸Trac。這隊伍你錯誤的交流是必需的。因為開發(fā)人員可能需要更多的信息(而你不能創(chuàng)建ticket 如果不登陸的話).
 在新的ticket頁面上填寫如下信息:
#; 簡單摘要: 讓摘要簡短但是要包含信息并且準確，因為這是ticket的標題，將會顯示在搜索結果中。
#; 完整的描述: 填寫你的錯誤或者是功能要求的完整的描述。包括一個問題的描述，別人可以重復這個問題的步驟，也可以是一個錯誤的運轉的例子 (如 URL), 或者是一個為什么問題值得更正的描述。同樣包括關于你的平臺的信息，如操作系統(tǒng)，網絡服務器軟件，PHP 版本, MySQL 版本, WordPress 版本。你描述的越好，解決錯誤的可能性就越大。
#; Ticket 屬性:
#:; 優(yōu)先級: 你需要確定這個問題的優(yōu)先權 – 這個錯誤有多緊急。除非它是一個致命的錯誤，最好是讓它保持默認狀態(tài)，因為開發(fā)人員通常都是按照錯誤優(yōu)先級的排序來的。
#:; 組件: 選擇發(fā)現問題所在的WordPress組件
#:; 嚴重 : 這個問題的''重要性''。選擇一個severity基于你認為這個問題有多嚴重，如果有疑問，就保持默認的''Normal''.
#:; 分配: 如果你知道有負責存在錯誤的代碼的開發(fā)人員，把他們的Trac用戶名放在這里。你也可以自己為這個錯誤負責，把你自己的Trac用戶名放在這里就可以了。這是可以選擇的，這可以讓開發(fā)人員更快的注意到這個錯誤。
#:; 里程表: 最遲在哪個版本這個問題會被解決。不要更改它。這是WordPress 開發(fā)人員設置的。
#:; 版本: 錯誤發(fā)現的WordPress 版本。你可以在管理面板的頁腳找到WordPress版本號。
#:; 關鍵詞: 關鍵詞讓開發(fā)人員更容易的找到錯誤所在，確定它的影響范圍。例如'posting'， 一個涉及到WordPress發(fā)表文章機制的錯誤的關鍵詞。同樣，有標準關鍵詞用來標記你的錯誤的狀態(tài)(參見 [[WordPress:#Trac Keywords|Trac 關鍵詞]] 下面).
#:; CC: 錯誤信息和更新信息發(fā)送的對象。如果你想保持可以被通知到，把你自己的Trac名字寫上。 當這個報告有任何更改的時候，你將會被郵件通知。不要忽視這些郵件; 做出任何改動后，確定查看一下報告更新。開發(fā)人員可能需要從你這里獲得更多的信息，這是他們與你聯系的唯一的方法。 '''注意''': 你需要進入Trac ''設置''頁面來設置你的email地址。把他放到你的支持論壇個人資料里并不能讓你的資料進入Trac以達到接收CC信息的目的。
# 點擊 '''提交Ticket''' (預覽之后). 然后返回。

=== 找到錯誤修正 ===

如果你想修正WordPress核心部分的錯誤，但是不知道修正哪個，這里是一些關于如何找到修正的錯誤的建議:
* 仔細閱讀 [http://trac.wordpress.org/report/13 需要關于Trac的補丁報告] (列出了沒有標出"has_patch"關鍵詞的錯誤)， [http://trac.wordpress.org/report/18 缺乏關于Trac的附件報告] (列出了沒有補丁文件的錯誤)，或者是其他對于看起來比較有趣的錯誤的 [http://trac.wordpress.org/report Trac 報告].
* 發(fā)送郵件信息到[[WordPress:Mailing_Lists#Hackers|wp-hackers 郵件列表]] 詢問你能幫什么忙. 
* 有時也有一些錯誤幫助在 <tt>#wordpress-dev</tt> [[WordPress:IRC|IRC]] 頻道。
* 偶然在<tt>#wordpress-bugs</tt>上有錯誤日。你可以在[[WordPress:WordPress Bug Hunts|錯誤搜尋]]上閱讀關于什么錯誤日發(fā)生了什么，并且預定[[WordPress:Mailing_Lists#Hackers|wp-hackers]]或者是 [[WordPress:Mailing_Lists#Testers|wp-testers]] 郵件列表來找出它們是什么時候出現的。
* 考慮加入[http://lists.automattic.com/mailman/listinfo/wp-trac wp-trac 郵件列表] 來參與關于每個[http://trac.wordpress.org/report Trac Ticket]的討論。


=== 打補丁 ===

如果你熟悉[[WordPress:Glossary#PHP|PHP]]和 [[WordPress:Glossary#MySQL|MySQL]]，并且想幫助WordPress發(fā)展，那么我們鼓勵你為WordPress 的錯誤打上補丁。如下是打補丁的步驟:

#閱讀 [[#WordPress:Finding Bugs to Fix|找到錯誤修正(上面)]], 然后在[http://trac.wordpress.org Trac]中找到錯誤并修正
#使用你[http://wordpress.org/support/register.php 注冊]的用戶名和密碼連接到[http://wordpress.org/download/svn/ WordPress Subversion (SVN) Repository]，閱讀 [[WordPress:Using Subversion|使用子版本]]，如果你對SVN不熟悉的話。所有的補丁都會被提交的SVN，而不考慮最新的代碼。
# 找出如何通過修改WordPress核心文件修正錯誤。你可能想在結束之前在[[WordPress:Mailing_Lists#Hackers|wp-hackers 郵件列表]]上討論你的解決方案。
# 測試你的修改，驗證錯誤已經被修正，而且在此過程中沒有其他的WordPress內的東西被破壞。
# 創(chuàng)建一個包含你的修改的''補丁文件''。這完全與修正文件和SVN中的源文件''不同''。參見[http://asymptomatic.net/2005/12/03/586/how-to-patch-wordpress 如何為WordPress打補丁 by Owen Winkler]獲得詳細說明。有Linux/Mac 的說明，[http://markjaquith.wordpress.com/2005/11/02/my-wordpress-toolbox/ Mark Jaquith 的工具書]中的命令行使用者，和[http://blog.ftwr.co.uk/archives/2005/11/03/windows-wordpress-toolbox/ Westi的Blog]中Windows Tortoise SVN 的使用者.
# 使用[http://trac.wordpress.org/ Trac]的 ''Attach file'' 按鈕上傳到ticket，添加 ''has-patch''到關鍵詞中。如果補丁需要測試，你可以把''needs-testing''也添加上，或者其他的Trac 關鍵詞; 參見 [[#WordPress:Trac Keywords|Trac 關鍵詞 (下面)]] 獲得更多信息。

=== Trac 關鍵詞 ===

有很多有固定意思的關鍵詞經常在[http://trac.wordpress.org Trac]中使用; 一些可以通過[http://trac.wordpress.org/report Trac Reports]搜索。

;reporter-feedback : 提交人的回復是必需的。深入的調查如果沒有經歷過問題本身的人的回復的話是靠不住的。

;has-patch : 已經附上ticket的解決方法，準備好再次檢查或者是提交。

;needs-testing : 某人需要測試這個解決方案

;2nd-opinion : 需要另外一個人來傳遞一個關于問題或者解決方案的觀點

;dev-feedback : 需要開發(fā)人員的回復 (不常用)

;tested : 補丁測試過了. 當添加這個標簽時請加入測試的文件名字，補丁如何測試的，和使用了哪個WordPress版本(包括SVN版本號，如果不是官方發(fā)布的版本的話).

;commit : 補丁已經被某個開發(fā)團體中可以信任的人檢查過，測試過; 這樣這個補丁就已經準備添加到WordPress核心文件中了.

;needs-patch : ticket已經被檢查過，發(fā)現描述為解決，但是標記為特別需要一個補丁，或者提交的補丁不能使用需要重新做

;needs-unit-tests : ticket已經通過檢查，發(fā)現描述為解決，我們希望一個聯合測試，來測試功能性，因為提交前各種補丁的存在造成導致其他問題的風險很高。

;needs-doc : 需要代碼的內嵌文檔。這可以是在它們被提交之前保存ticket單獨文件或者是帶有新函數補丁需要的文檔資料。 

=== 錯誤解決方案===

Trac 中的ticket 在''open''狀態(tài)下開始，最終到''closed''。當一個ticket關閉后，它會被以下某個狀態(tài)之一標記:

* 如果你的錯誤已經提交到別的地方，它將以''duplicate''結束. 
* 如果錯誤在最新的版本代碼中已經修正(可能不是你在運行的版本除非你有一個本地測試的blog)，標記為''fixed''.
* 如果確定你的錯誤事實上不是錯誤，而是你故意的行為，會標記為''invalid''.
* 如果沒有其他人可以重現你所描述的現象，會以''worksforme''結束。
* 如果你的錯誤是一個功能請求，而開發(fā)人員不想讓它出現在核心代碼中，標記為 ''wontfix''.

請驗證你的錯誤在提交時不屬于其中任何一種。


== 注 ==

* 你的錯誤的處理過程可能需要你的參與，希望你自愿并準備好幫助開發(fā)人員解決問題。
* 如果你的問題被解決為"Not a bug" 或者 "Won't fix"時不要生氣，看起來對你是錯誤的東西很可能是一種"功能". 這些解決方法只是意味這"現在不能解決", 可能將來會被解決的.
* 感謝為WordPress做出的貢獻!
# 點擊Trac中 '''[http://trac.wordpress.org/newticket New Ticket]''' 打開錯誤提交頁面。
# 在ticket頁面的如下區(qū)域填寫：
# 簡短概要：使概要簡短的但是很具有信息化和準確性，象這個是在搜索結果中將被展示的ticket標題
# 全部描述：填寫