WordPress: Submitting Bugs：修訂間差異

導(dǎo)航: 上一級(jí) | WordPress | 首頁(yè) | WordPress中文論壇 | WordPress主機(jī) | CMS程序 | 論壇程序 | ECShop | ShopNC | PowerEasy

每種軟件都有錯(cuò)誤 – 只要是人寫(xiě)代碼，軟件中就會(huì)有錯(cuò)誤，有些錯(cuò)誤是微不足道的，但是有些是非常嚴(yán)重的。開(kāi)源項(xiàng)目如 WordPress 需要使用者的參與來(lái)找出軟件中的錯(cuò)誤，同樣也包括新功能的開(kāi)發(fā)。 所有類型的反饋— 不管是真正的錯(cuò)誤還是有用的請(qǐng)求— 都在WordPress 中用同樣的方法提交。閱讀WordPress關(guān)于如何提交錯(cuò)誤和問(wèn)題的信息... 你可能會(huì)想要閱讀為WordPress做貢獻(xiàn)來(lái)找出如何為文檔資料和WordPress其他方面做貢獻(xiàn)。

目錄

• 1 提交安全問(wèn)題
• 2 提交插件和主題中的錯(cuò)誤
• 3 錯(cuò)誤提交和解決總覽
• 4 錯(cuò)誤報(bào)告和解決方案的詳細(xì)內(nèi)容
  • 4.1 報(bào)告錯(cuò)誤之前
  • 4.2 提交錯(cuò)誤
  • 4.3 找到錯(cuò)誤修正
  • 4.4 打補(bǔ)丁
  • 4.5 Trac 關(guān)鍵詞
  • 4.6 錯(cuò)誤解決方案
• 5 注

提交安全問(wèn)題

當(dāng)我們?cè)囍乐钩霈F(xiàn)安全問(wèn)題時(shí)，我們不能認(rèn)為它們不會(huì)出現(xiàn)。如果你相信你在WordPress某個(gè)版本中找到了安全問(wèn)題，發(fā)郵件到WordPress.org上的security 區(qū)域，我們將盡力盡快解決。

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

提交插件和主題中的錯(cuò)誤

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

WordPress插件庫(kù)中的插件有一個(gè)來(lái)自 WordPress 核心的單獨(dú)的錯(cuò)誤跟蹤系統(tǒng)。有一個(gè)如何使用這個(gè)系統(tǒng)的 單獨(dú)的說(shuō)明。

對(duì)于不在官方庫(kù)中的插件和主題，查看其附帶的文檔資料作為關(guān)于如何提交錯(cuò)誤的說(shuō)明。如果沒(méi)有錯(cuò)誤提交信息，你需要直接聯(lián)系作者。

錯(cuò)誤提交和解決總覽

提交和解決WordPress錯(cuò)誤的過(guò)程有幾步，這里是一個(gè)總的概括，下面可以找到更多細(xì)節(jié)。

1. 用戶發(fā)現(xiàn)了錯(cuò)誤，出現(xiàn)在WordPress核心文件中 (不在主題或者插件中).
2. 用戶嘗試著確認(rèn)這確實(shí)是一個(gè)錯(cuò)誤。參見(jiàn) 提交錯(cuò)誤之前(下面).
3. 如果確定它是一個(gè)錯(cuò)誤，用戶提交錯(cuò)誤報(bào)告到Trac，叫做ticket，WordPress錯(cuò)誤跟蹤系統(tǒng)。參見(jiàn)提交錯(cuò)誤 (下面).
4. WordPress 開(kāi)發(fā)人員 (可能也是象你一樣的志愿者) 確認(rèn)錯(cuò)誤的確存在，然后它應(yīng)該被修正。然后象在票上做記號(hào)那樣標(biāo)記出來(lái)。參見(jiàn)Trac 關(guān)鍵詞列表(下面) 和 錯(cuò)誤解決方案(下面).
5. WordPress 開(kāi)發(fā)人員 (可能是你)決定修復(fù)這個(gè)錯(cuò)誤。開(kāi)發(fā)者可能選擇通過(guò)點(diǎn)擊ticket底部附近的 Accept ticket操作來(lái)負(fù)責(zé)這個(gè)錯(cuò)誤，盡管這不是必須的。然后開(kāi)發(fā)人員指出如何修復(fù)這個(gè)錯(cuò)誤，創(chuàng)建一個(gè)或者多個(gè)補(bǔ)丁，上傳到Trac. 參見(jiàn) 錯(cuò)誤補(bǔ)丁(下面)。同樣的，如果你想要幫助修復(fù)錯(cuò)誤，但是不知道需要修復(fù)哪個(gè)錯(cuò)誤，參見(jiàn)找到錯(cuò)誤并修復(fù) (下面).
6. WordPress開(kāi)發(fā)小組成員(包括志愿者)測(cè)試補(bǔ)丁，查看是否錯(cuò)誤被修復(fù)了而沒(méi)有影響到其他東西。它們添加評(píng)論和關(guān)鍵詞到ticket，顯示出它們的結(jié)果。參見(jiàn) Trac 關(guān)鍵詞列表(下面).
7. WordPress 開(kāi)發(fā)員中的一個(gè)擁有修改官方WordPress源代碼權(quán)限的人(Matt Mullenweg, Ryan Boren, Mark Jaquith or Peter Westwood) 提交 補(bǔ)丁給SVN庫(kù)中的核心代碼。如果錯(cuò)誤和補(bǔ)丁被他們所信任的某人驗(yàn)證過(guò)后，他們會(huì)這樣做的。
8. 最后，提交補(bǔ)丁的這個(gè)人設(shè)定ticket狀態(tài)為closed，結(jié)論是fixed。參見(jiàn) 錯(cuò)誤結(jié)論(下面).

錯(cuò)誤報(bào)告和解決方案的詳細(xì)內(nèi)容

下面的部分給上述的提綱添加了詳細(xì)內(nèi)容。

報(bào)告錯(cuò)誤之前

如WordPress這么大的項(xiàng)目，如此多的使用者提交錯(cuò)誤報(bào)告，很有可能你的錯(cuò)誤已經(jīng)被提交過(guò)了，正因?yàn)檫@樣，檢查并確定系統(tǒng)中它還沒(méi)有被提交過(guò)是很重要的。如果你剛開(kāi)始在WordPress中使用提交錯(cuò)誤，在提交之前和有經(jīng)驗(yàn)的開(kāi)發(fā)人員討論這個(gè)問(wèn)題是個(gè)好辦法。請(qǐng)按照下面的步驟。

1. 在Trac中通過(guò)使用搜索或者是查詢來(lái)查找你的錯(cuò)誤或者是功能請(qǐng)求。
   • 如果你的問(wèn)題已經(jīng)被提交過(guò)了，請(qǐng)不要重復(fù)提交。如果你有更深入的信息，登陸并添加信息記錄到已存在的錯(cuò)誤中。
   • 如果你的問(wèn)題相似，但是不完全和另一個(gè)問(wèn)題相同，你可以決定是否添加一個(gè)記錄到相似問(wèn)題中，或者是重新提交。很難決定是否你的問(wèn)題可以作為一個(gè)新的問(wèn)題提交，但是通常情況下，如果你只是有更多信息來(lái)提交的話，打開(kāi)問(wèn)題，簡(jiǎn)單的添加一個(gè)記錄就可以了。 如果你有個(gè)完全不同的問(wèn)題，或者如果你正經(jīng)歷了一個(gè)重復(fù)的以前解決過(guò)的問(wèn)題，可以提交一個(gè)新錯(cuò)誤。
   • 如果你的問(wèn)題最近提交了也關(guān)閉了，但是你不同意這樣的解決方法，你可以重新打開(kāi)ticket添加注釋，寫(xiě)明你的理由。
2. 想在Trac上在提交之前討論一個(gè)錯(cuò)誤， (如判斷它是否是一個(gè)WordPress核心的而不是插件或者主題的錯(cuò)誤)，你可以在WordPress 支持論壇上發(fā)個(gè)帖子，在#wordpress IRC 頻道 討論你的問(wèn)題，或者在檢測(cè)器 或Hackers郵件列表上參與郵件討論。

提交錯(cuò)誤

Trac是官方WordPress錯(cuò)誤跟蹤器的名字。它使用開(kāi)發(fā)源碼跟蹤軟件Trac，它是 Edgewall Software的產(chǎn)品。安裝下面的步驟在Trac建立一個(gè)好的錯(cuò)誤報(bào)告:

1. 閱讀 [[WordPress:#Before You Report a Bug|提交錯(cuò)誤之前(上面)]], 然后驗(yàn)證你有一個(gè)新的可以提交的錯(cuò)誤。
2. 閱讀如何有效的提交錯(cuò)誤這個(gè)文章，和Trac Ticket 文檔.
3. 使用你的 using your 支持論壇的用戶名和密碼登陸WordPress Trac。如果你沒(méi)有帳戶， 注冊(cè) 一個(gè)這樣才可以登陸Trac。這隊(duì)伍你錯(cuò)誤的交流是必需的。因?yàn)殚_(kāi)發(fā)人員可能需要更多的信息(而你不能創(chuàng)建ticket 如果不登陸的話).

在新的ticket頁(yè)面上填寫(xiě)如下信息:

1. 簡(jiǎn)單摘要

   讓摘要簡(jiǎn)短但是要包含信息并且準(zhǔn)確，因?yàn)檫@是ticket的標(biāo)題，將會(huì)顯示在搜索結(jié)果中。

   完整的描述

   填寫(xiě)你的錯(cuò)誤或者是功能要求的完整的描述。包括一個(gè)問(wèn)題的描述，別人可以重復(fù)這個(gè)問(wèn)題的步驟，也可以是一個(gè)錯(cuò)誤的運(yùn)轉(zhuǎn)的例子 (如 URL), 或者是一個(gè)為什么問(wèn)題值得更正的描述。同樣包括關(guān)于你的平臺(tái)的信息，如操作系統(tǒng)，網(wǎng)絡(luò)服務(wù)器軟件，PHP 版本, MySQL 版本, WordPress 版本。你描述的越好，解決錯(cuò)誤的可能性就越大。

   Ticket 屬性

   優(yōu)先級(jí)

   你需要確定這個(gè)問(wèn)題的優(yōu)先權(quán) – 這個(gè)錯(cuò)誤有多緊急。除非它是一個(gè)致命的錯(cuò)誤，最好是讓它保持默認(rèn)狀態(tài)，因?yàn)殚_(kāi)發(fā)人員通常都是按照錯(cuò)誤優(yōu)先級(jí)的排序來(lái)的。

   組件

   選擇發(fā)現(xiàn)問(wèn)題所在的WordPress組件

   嚴(yán)重

   這個(gè)問(wèn)題的重要性。選擇一個(gè)severity基于你認(rèn)為這個(gè)問(wèn)題有多嚴(yán)重，如果有疑問(wèn)，就保持默認(rèn)的Normal.

   分配

   如果你知道有負(fù)責(zé)存在錯(cuò)誤的代碼的開(kāi)發(fā)人員，把他們的Trac用戶名放在這里。你也可以自己為這個(gè)錯(cuò)誤負(fù)責(zé)，把你自己的Trac用戶名放在這里就可以了。這是可以選擇的，這可以讓開(kāi)發(fā)人員更快的注意到這個(gè)錯(cuò)誤。

   里程表

   最遲在哪個(gè)版本這個(gè)問(wèn)題會(huì)被解決。不要更改它。這是WordPress 開(kāi)發(fā)人員設(shè)置的。

   版本

   錯(cuò)誤發(fā)現(xiàn)的WordPress 版本。你可以在管理面板的頁(yè)腳找到WordPress版本號(hào)。

   關(guān)鍵詞

   關(guān)鍵詞讓開(kāi)發(fā)人員更容易的找到錯(cuò)誤所在，確定它的影響范圍。例如'posting'， 一個(gè)涉及到WordPress發(fā)表文章機(jī)制的錯(cuò)誤的關(guān)鍵詞。同樣，有標(biāo)準(zhǔn)關(guān)鍵詞用來(lái)標(biāo)記你的錯(cuò)誤的狀態(tài)(參見(jiàn) [[WordPress:#Trac Keywords|Trac 關(guān)鍵詞]] 下面).

   CC

   錯(cuò)誤信息和更新信息發(fā)送的對(duì)象。如果你想保持可以被通知到，把你自己的Trac名字寫(xiě)上。 當(dāng)這個(gè)報(bào)告有任何更改的時(shí)候，你將會(huì)被郵件通知。不要忽視這些郵件; 做出任何改動(dòng)后，確定查看一下報(bào)告更新。開(kāi)發(fā)人員可能需要從你這里獲得更多的信息，這是他們與你聯(lián)系的唯一的方法。 注意: 你需要進(jìn)入Trac 設(shè)置頁(yè)面來(lái)設(shè)置你的email地址。把他放到你的支持論壇個(gè)人資料里并不能讓你的資料進(jìn)入Trac以達(dá)到接收CC信息的目的。

2. 點(diǎn)擊 提交Ticket (預(yù)覽之后). 然后返回。

找到錯(cuò)誤修正

如果你想修正WordPress核心部分的錯(cuò)誤，但是不知道修正哪個(gè)，這里是一些關(guān)于如何找到修正的錯(cuò)誤的建議:

• 仔細(xì)閱讀 需要關(guān)于Trac的補(bǔ)丁報(bào)告 (列出了沒(méi)有標(biāo)出"has_patch"關(guān)鍵詞的錯(cuò)誤)， 缺乏關(guān)于Trac的附件報(bào)告 (列出了沒(méi)有補(bǔ)丁文件的錯(cuò)誤)，或者是其他對(duì)于看起來(lái)比較有趣的錯(cuò)誤的 Trac 報(bào)告.
• 發(fā)送郵件信息到wp-hackers 郵件列表 詢問(wèn)你能幫什么忙.
• 有時(shí)也有一些錯(cuò)誤幫助在 #wordpress-dev IRC 頻道。
• 偶然在#wordpress-bugs上有錯(cuò)誤日。你可以在錯(cuò)誤搜尋上閱讀關(guān)于什么錯(cuò)誤日發(fā)生了什么，并且預(yù)定wp-hackers或者是 wp-testers 郵件列表來(lái)找出它們是什么時(shí)候出現(xiàn)的。
• 考慮加入wp-trac 郵件列表 來(lái)參與關(guān)于每個(gè)Trac Ticket的討論。

打補(bǔ)丁

如果你熟悉PHP和 MySQL，并且想幫助WordPress發(fā)展，那么我們鼓勵(lì)你為WordPress 的錯(cuò)誤打上補(bǔ)丁。如下是打補(bǔ)丁的步驟:

1. 閱讀 找到錯(cuò)誤修正(上面), 然后在Trac中找到錯(cuò)誤并修正
2. 使用你注冊(cè)的用戶名和密碼連接到WordPress Subversion (SVN) Repository，閱讀 使用子版本，如果你對(duì)SVN不熟悉的話。所有的補(bǔ)丁都會(huì)被提交的SVN，而不考慮最新的代碼。
3. 找出如何通過(guò)修改WordPress核心文件修正錯(cuò)誤。你可能想在結(jié)束之前在wp-hackers 郵件列表上討論你的解決方案。
4. 測(cè)試你的修改，驗(yàn)證錯(cuò)誤已經(jīng)被修正，而且在此過(guò)程中沒(méi)有其他的WordPress內(nèi)的東西被破壞。
5. 創(chuàng)建一個(gè)包含你的修改的補(bǔ)丁文件。這完全與修正文件和SVN中的源文件不同。參見(jiàn)如何為WordPress打補(bǔ)丁 by Owen Winkler獲得詳細(xì)說(shuō)明。有Linux/Mac 的說(shuō)明，Mark Jaquith 的工具書(shū)中的命令行使用者，和Westi的Blog中Windows Tortoise SVN 的使用者.
6. 使用Trac的 Attach file 按鈕上傳到ticket，添加 has-patch到關(guān)鍵詞中。如果補(bǔ)丁需要測(cè)試，你可以把needs-testing也添加上，或者其他的Trac 關(guān)鍵詞; 參見(jiàn) Trac 關(guān)鍵詞 (下面) 獲得更多信息。

Trac 關(guān)鍵詞

有很多有固定意思的關(guān)鍵詞經(jīng)常在Trac中使用; 一些可以通過(guò)Trac Reports搜索。

reporter-feedback

提交人的回復(fù)是必需的。深入的調(diào)查如果沒(méi)有經(jīng)歷過(guò)問(wèn)題本身的人的回復(fù)的話是靠不住的。

has-patch

已經(jīng)附上ticket的解決方法，準(zhǔn)備好再次檢查或者是提交。

needs-testing

某人需要測(cè)試這個(gè)解決方案

2nd-opinion

需要另外一個(gè)人來(lái)傳遞一個(gè)關(guān)于問(wèn)題或者解決方案的觀點(diǎn)

dev-feedback

需要開(kāi)發(fā)人員的回復(fù) (不常用)

tested

補(bǔ)丁測(cè)試過(guò)了. 當(dāng)添加這個(gè)標(biāo)簽時(shí)請(qǐng)加入測(cè)試的文件名字，補(bǔ)丁如何測(cè)試的，和使用了哪個(gè)WordPress版本(包括SVN版本號(hào)，如果不是官方發(fā)布的版本的話).

commit

補(bǔ)丁已經(jīng)被某個(gè)開(kāi)發(fā)團(tuán)體中可以信任的人檢查過(guò)，測(cè)試過(guò); 這樣這個(gè)補(bǔ)丁就已經(jīng)準(zhǔn)備添加到WordPress核心文件中了.

needs-patch

ticket已經(jīng)被檢查過(guò)，發(fā)現(xiàn)描述為解決，但是標(biāo)記為特別需要一個(gè)補(bǔ)丁，或者提交的補(bǔ)丁不能使用需要重新做

needs-unit-tests

ticket已經(jīng)通過(guò)檢查，發(fā)現(xiàn)描述為解決，我們希望一個(gè)聯(lián)合測(cè)試，來(lái)測(cè)試功能性，因?yàn)樘峤磺案鞣N補(bǔ)丁的存在造成導(dǎo)致其他問(wèn)題的風(fēng)險(xiǎn)很高。

needs-doc

需要代碼的內(nèi)嵌文檔。這可以是在它們被提交之前保存ticket單獨(dú)文件或者是帶有新函數(shù)補(bǔ)丁需要的文檔資料。

錯(cuò)誤解決方案

Trac 中的ticket 在open狀態(tài)下開(kāi)始，最終到closed。當(dāng)一個(gè)ticket關(guān)閉后，它會(huì)被以下某個(gè)狀態(tài)之一標(biāo)記:

• 如果你的錯(cuò)誤已經(jīng)提交到別的地方，它將以duplicate結(jié)束.
• 如果錯(cuò)誤在最新的版本代碼中已經(jīng)修正(可能不是你在運(yùn)行的版本除非你有一個(gè)本地測(cè)試的blog)，標(biāo)記為fixed.
• 如果確定你的錯(cuò)誤事實(shí)上不是錯(cuò)誤，而是你故意的行為，會(huì)標(biāo)記為invalid.
• 如果沒(méi)有其他人可以重現(xiàn)你所描述的現(xiàn)象，會(huì)以worksforme結(jié)束。
• 如果你的錯(cuò)誤是一個(gè)功能請(qǐng)求，而開(kāi)發(fā)人員不想讓它出現(xiàn)在核心代碼中，標(biāo)記為 wontfix.

請(qǐng)驗(yàn)證你的錯(cuò)誤在提交時(shí)不屬于其中任何一種。

注

• 你的錯(cuò)誤的處理過(guò)程可能需要你的參與，希望你自愿并準(zhǔn)備好幫助開(kāi)發(fā)人員解決問(wèn)題。
• 如果你的問(wèn)題被解決為"Not a bug" 或者 "Won't fix"時(shí)不要生氣，看起來(lái)對(duì)你是錯(cuò)誤的東西很可能是一種"功能". 這些解決方法只是意味這"現(xiàn)在不能解決", 可能將來(lái)會(huì)被解決的.
• 感謝為WordPress做出的貢獻(xiàn)!

1. 點(diǎn)擊Trac中 New Ticket 打開(kāi)錯(cuò)誤提交頁(yè)面。
2. 在ticket頁(yè)面的如下區(qū)域填寫(xiě)：
3. 簡(jiǎn)短概要：使概要簡(jiǎn)短的但是很具有信息化和準(zhǔn)確性，象這個(gè)是在搜索結(jié)果中將被展示的ticket標(biāo)題
4. 全部描述：填寫(xiě)