貢獻導(dǎo)引
貢獻導(dǎo)引
貢獻指南
錯誤反饋
為了鼓勵積極協(xié)作，Laravel 強烈地鼓勵使用 Pull Request 指出修改的內(nèi)容，而不僅僅只是反饋錯誤?！稿e誤反饋」也可以用 PR 來提交失敗測試。
如果你要提交錯誤反饋，你的問題應(yīng)該包含標題和明確的問題描述，并盡可能多的提供相關(guān)的信息和演示該問題的代碼示例。錯誤反饋的目的是讓你和其他人可以輕松地重現(xiàn)并修復(fù)錯誤。
請記住，錯誤反饋的初衷是讓其它有相同問題的人能夠和你協(xié)作解決問題。不要指望反饋錯誤后會很快有人修復(fù)它。創(chuàng)建錯誤反饋是能幫助你和其他人開始著手修復(fù)問題的途徑。
Laravel 源代碼托管在 GitHub 上面，并且每個 Laravel 的項目都有自己的代碼倉庫：
核心開發(fā)討論
你可以在 Laravel Ideas 的 問題板 中對 Laravel 現(xiàn)有的行為提出新特性或者改進建議。 如果你提出了一個新功能，我們希望請你至少完成該特性所需的一些代碼。
關(guān)于 Bug，新功能和新功能的實現(xiàn)的非正式討論會在 Laravel Discord 的 #internals 頻道中進行。Laravel 的維護者 Taylor Otwell, 通常會在工作日的早上八點到下午五點 (UTC-06:00 或 America/Chicago) 出現(xiàn)在頻道上，偶爾也會在其它時間出現(xiàn)在該頻道。
分支選擇
所有 Bug 修復(fù)都應(yīng)該發(fā)送到最新的穩(wěn)定版分支或當前的 LTS 分支上。Bug 修復(fù)決不應(yīng)該發(fā)送到 master 分支，除非修復(fù)的是僅在即將發(fā)布的版本中發(fā)布的功能。
次要的完全向后兼容的新功能會發(fā)送到最新的穩(wěn)定分支。
主要的新功能都應(yīng)該發(fā)送到 master 分支，其中包含即將發(fā)布的 Laravel 版本。
如果你不確定你的功能符合主要的還是次要的，請在 Laravel Discord 的 #internals 頻道中詢問 Taylor Otwell。
編譯資產(chǎn)
如果你提交的更改會影響已編譯的文件，例如在 laravel/laravel 儲存庫中的 resources/sass 或者 resources/js 中的大多數(shù)文件，請不要提交已編譯好的文件。因為它們尺寸較大，審查人員無法進行實際審查。這樣可以被利用向 Laravel 中注入惡意代碼，為了防止這種情況的發(fā)生，所有靜態(tài)資產(chǎn)都由 Laravel 維護者生成并提交。
安全漏洞
如果你發(fā)現(xiàn) Laravel 存在安全漏洞，請發(fā)送電子郵件給 Taylor Otwell: taylor@laravel.com。他會及時處理所有的安全漏洞。
編碼風格
Laravel 遵循 PSR-2 編碼規(guī)范和 PSR-4 自動加載規(guī)范。
PHPDoc
以下是正確寫法的 Laravel 文檔注釋。請注意，@param 屬性后跟兩個空格、參數(shù)類型、兩個空格，最后是變量名稱：
/**
* 在容器中注冊綁定。
*
* @param string|array $abstract
* @param \Closure|string|null $concrete
* @param bool $shared
* @return void
* @throws \Exception
*/public function bind($abstract, $concrete = null, $shared = false){ //}StyleCI
別擔心你的代碼風格不夠漂亮！在合并拉取請求后，StyleCI 將會自動把所有樣式進行修正，再合并到 Laravel 存儲庫中。這使得我們更多的關(guān)注貢獻的內(nèi)容而不是代碼風格。