貢獻指南

• 錯誤回饋
• 核心開發討論
• 分支選擇
• 編譯資產
• #安全漏洞
• #編碼風格
  • ##編碼風格

核心開發討論

你可以在 Laravel Ideas 的  問題板 中對 Laravel 現有的行為提出新特性或改進建議。如果你提出了一個新功能，我們希望請你至少完成該特性所需的一些程式碼。

關於 Bug，新功能和新功能的實現的非正式討論會在 Laravel Discord 的 #internals 頻道中進行。 Laravel 的維護者 Taylor Otwell, 通常會在工作日的早上八點到下午五點 (UTC-06:00 或 America/Chicago) 出現在頻道上，偶爾也會在其它時間出現在該頻道。

分支選擇

所有 Bug 修復都應該發送到最新的穩定版分支或目前的LTS 分支上。 Bug 修復絕不應該發送到 master 分支，除非修復的是僅在即將發布的版本中發布的功能。

次要的完全向後相容的新功能會傳送到最新的穩定分支。

主要的新功能都應該發送到 master 分支，其中包含即將發布的 Laravel 版本。

如果你不確定你的功能符合主要的還是次要的，請在  Laravel Discord 的 #internals 頻道中詢問 Taylor Otwell。

編譯資產

如果你提交的更改會影響已編譯的文件，例如在laravel/laravel 儲存庫中的resources/sass 或resources/js 中的大多數文件，請不要提交已編譯好的文件。因為它們尺寸較大，審查人員無法進行實際審查。這樣可以被利用向 Laravel 注入惡意程式碼，為了防止這種情況的發生，所有靜態資產都由 Laravel 維護者產生並提交。

安全漏洞

如果你發現 Laravel 有安全漏洞，請發送電子郵件給 Taylor Otwell: taylor@laravel.com。他會及時處理所有的安全漏洞。

編碼風格

Laravel 遵循PSR-2 編碼規格和PSR-4 自動加載規範。

PHPDoc

以下是正確寫法的 Laravel 文件註解。請注意，@param 屬性後面跟著兩個空格、參數類型、兩個空格，最後是變數名稱：

/**
 * 在容器中注册绑定。
 *
 * @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 儲存庫。這使得我們更多的專注於貢獻的內容而不是程式碼風格。