貢獻導引
貢獻導引
貢獻指南
錯誤反饋
為了鼓勵積極協(xié)作,Laravel 強烈地鼓勵使用 Pull Request 指出修改的內容,而不僅僅只是反饋錯誤?!稿e誤反饋」也可以用 PR 來提交失敗測試。
如果你要提交錯誤反饋,你的問題應該包含標題和明確的問題描述,并盡可能多的提供相關的信息和演示該問題的代碼示例。錯誤反饋的目的是讓你和其他人可以輕松地重現(xiàn)并修復錯誤。
請記住,錯誤反饋的初衷是讓其它有相同問題的人能夠和你協(xié)作解決問題。不要指望反饋錯誤后會很快有人修復它。創(chuàng)建錯誤反饋是能幫助你和其他人開始著手修復問題的途徑。
Laravel 源代碼托管在 GitHub 上面,并且每個 Laravel 的項目都有自己的代碼倉庫:
核心開發(fā)討論
你可以在 Laravel Ideas 的 問題板 中對 Laravel 現(xiàn)有的行為提出新特性或者改進建議。 如果你提出了一個新功能,我們希望請你至少完成該特性所需的一些代碼。
關于 Bug,新功能和新功能的實現(xiàn)的非正式討論會在 Laravel Discord 的 #internals
頻道中進行。Laravel 的維護者 Taylor Otwell, 通常會在工作日的早上八點到下午五點 (UTC-06:00 或 America/Chicago) 出現(xiàn)在頻道上,偶爾也會在其它時間出現(xiàn)在該頻道。
分支選擇
所有 Bug 修復都應該發(fā)送到最新的穩(wěn)定版分支或當前的 LTS 分支上。Bug 修復決不應該發(fā)送到 master
分支,除非修復的是僅在即將發(fā)布的版本中發(fā)布的功能。
次要的完全向后兼容的新功能會發(fā)送到最新的穩(wěn)定分支。
主要的新功能都應該發(fā)送到 master
分支,其中包含即將發(fā)布的 Laravel 版本。
如果你不確定你的功能符合主要的還是次要的,請在 Laravel Discord 的 #internals
頻道中詢問 Taylor Otwell。
編譯資產
如果你提交的更改會影響已編譯的文件,例如在 laravel/laravel
儲存庫中的 resources/sass
或者 resources/js
中的大多數(shù)文件,請不要提交已編譯好的文件。因為它們尺寸較大,審查人員無法進行實際審查。這樣可以被利用向 Laravel 中注入惡意代碼,為了防止這種情況的發(fā)生,所有靜態(tài)資產都由 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 存儲庫中。這使得我們更多的關注貢獻的內容而不是代碼風格。