貢獻(xiàn)指南

缺陷報(bào)告

為了促進(jìn)有效積極的合作，相對(duì)于僅提交 缺陷報(bào)告 來說， Laravel 團(tuán)隊(duì)更鼓勵(lì)使用 GitHub的 Pull Request。 當(dāng)然也可以用 Pull Request 的方式發(fā)送含有失敗單元測(cè)試的「缺陷報(bào)告」。

當(dāng)您在呈遞缺陷報(bào)告的時(shí)候，請(qǐng)確保您所提交的問題含有標(biāo)題和清晰的描述。同時(shí)應(yīng)該附帶盡可能詳細(xì)的與問題相關(guān)的信息和代碼示例。 缺陷報(bào)告的目標(biāo)是盡可能的方便您與他人去重現(xiàn)錯(cuò)誤并修復(fù)它。

請(qǐng)謹(jǐn)記，建立缺陷報(bào)告是希望您與其他遇到同樣問題的人一起解決這個(gè)問題。 但請(qǐng)不要期望其他人會(huì)主動(dòng)的過來修復(fù)它。 創(chuàng)建缺陷報(bào)告是為了給您和他人提供一個(gè)修復(fù)問題的切入點(diǎn)。

Laravel 框架的源代碼托管在 Github， 以下列出了每個(gè) Laravel 相關(guān)項(xiàng)目倉(cāng)庫(kù)的連接:

• Laravel Framework

• Laravel Application

• Laravel Documentation

• Laravel Cashier

• Laravel Envoy

• Laravel Homestead

• Laravel Homestead Build Scripts

• Laravel Website

• Laravel Art

核心開發(fā)討論區(qū)

討論區(qū)在 (Freenode) 上的 #laravel-dev IRC 頻道， 討論內(nèi)容包括缺陷，新特性和計(jì)劃實(shí)施的已有特性. Laravel 項(xiàng)目維護(hù)者 Taylor Otwell 通常會(huì)在周一至周五的美國(guó)芝加哥時(shí)間 8am-5pm 上線 (UTC-06:00 or America/Chicago)， 當(dāng)然其它時(shí)間他也會(huì)偶爾出現(xiàn)。

#laravel-dev IRC 頻道是對(duì)所有人開放的，歡迎任何有興趣的朋友參與進(jìn)來討論或哪怕只是圍觀!

如何選擇分支?

所有的 缺陷修正都應(yīng)該提交到最后一版的穩(wěn)定分支。 永遠(yuǎn) 不要把缺陷修正提交到 master 分支除非這些正是在下個(gè)發(fā)行版本中他們要修復(fù)的特性。

那些 完全向后兼容 并隨當(dāng)前 Laravel 版發(fā)行的 非重要 特性也許可以提交到最后一版的穩(wěn)定分支。

那些在下一個(gè) Laravel 發(fā)行版中將要出現(xiàn)的 重要的 新特性應(yīng)該總是被提交到 master 分支。

如果您也不確定你寫的特性是否重要時(shí)，請(qǐng)到 (Freenode) 的 #laravel-dev IRC 頻道 問一下 Taylor Otwell。

安全缺陷

如果你在 Laravel 中發(fā)現(xiàn)安全缺陷，煩請(qǐng)以電子郵件的方式發(fā)送給 Taylor Otwell taylor@laravel.com。所有的安全缺陷都將會(huì)被及時(shí)的處理掉。

代碼風(fēng)格

Laravel 框架遵循 PSR-4 和 PSR-1 代碼標(biāo)準(zhǔn)。除了這些以外，如下的代碼標(biāo)準(zhǔn)也應(yīng)該被遵守:

• 類命名空間的聲明必須與 <?php 處在同一行。

• 類的起始花括號(hào) { 必須與類名處在同一行。

• 函數(shù)和控制結(jié)構(gòu)必須使用 Allman 樣式 括起來。

• 縮進(jìn)使用制表符，對(duì)齊使用空格。