貢獻導引 · Laravel 5.4 完全開發手冊

* * * * * [TOC] ## 錯誤反饋為了提倡積極協作，Laravel 強烈地鼓勵使用 Pull Request，而不僅僅只是反饋錯誤。「錯誤反饋」可以以一個包含失敗測試的 Pull Request 的形式發送。假如你提交了錯誤反饋，那么反饋中應該包含著標題和詳盡的問題描述，并盡可能多的提供相關的信息和錯誤問題的代碼示例。錯誤反饋的主要目的是讓自己和其他人可以簡單地重現并修復錯誤。請記住，錯誤反饋的初衷是讓其它有相同問題的人可以協作解決問題。不要期望反饋錯誤后會很快有人會馬上修復它。創建錯誤反饋主要是為了能幫助你自己和其他人開始著手修復問題。 Laravel 源代碼托管在 GitHub 上面，并且每個 Laravel 的項目都有自己的代碼倉庫： * [Laravel Framework](https://github.com/laravel/framework) * [Laravel Application](https://github.com/laravel/laravel) * [Laravel Documentation](https://github.com/laravel/docs) * [Laravel Cashier](https://github.com/laravel/cashier) * [Laravel Cashier for Braintree](https://github.com/laravel/cashier-braintree) * [Laravel Envoy](https://github.com/laravel/envoy) * [Laravel Homestead](https://github.com/laravel/homestead) * [Laravel Homestead Build Scripts](https://github.com/laravel/settler) * [Laravel Website](https://github.com/laravel/laravel.com) * [Laravel Art](https://github.com/laravel/art) ## 核心開發討論如果你想提出功能建議，或者改進現有的 Laravel 的行為，請到 Laravel Internals 項目的?[反饋欄](https://github.com/laravel/internals/issues)?討論。如果你想提出功能建議，我們希望你愿意為此功能貢獻一些代碼。有關錯誤、新功能和現有功能的實現討論會在 Slack 的?[LaraChat](http://larachat.co/)?群組上的?`#internals`?頻道中進行。Laravel 的維護者 Taylor Otwell 在工作日的 8am 到 5pm（ UTC-06:00 或 America/Chicago ）通常都會出現在頻道上，其它時間偶爾也會出現。 ## 選擇分支 **所有的**?錯誤修復都應該發送到最新的穩定分支上。除非它們修復的功能只存在下一版的發布中，不然錯誤修復?**永遠不**?應該發送到?`master`?分支。 **次要的**?且與現有的 Laravel 發布版本?**完全向下兼容**?的功能可以發送到最新的穩定分支。 **主要的**?新功能應該都發送到?`master`?分支，它包含下一版的 Laravel 發布內容。如果不確定你的功能是主要的還是次要的，請在 Slack 的?[LaraChat](http://larachat.co/)?群組上的?`#internals`?頻道詢問 Taylor Otwell。 ## 安全漏洞如果你發現 Laravel 存在安全漏洞，請發送電子郵件到?[taylor@laravel.com](mailto:taylor@laravel.com)?給 Taylor Otwell。所有的安全漏洞將會及時予以處理。 ## 編碼風格 Laravel 遵守?[PSR-2](https://phphub.org/topics/2079)?編碼規范和?[PSR-4](https://phphub.org/topics/2081)?自動加載規范。 > 譯者注：擴展閱讀 -?[所有 PSR 的標準規范](https://psr.phphub.org/)。 ### 注釋區塊 `@param`?標簽應該分行顯示，并且每一個參數中間需相隔?**兩個空格**，舉個例子: ~~~ /** * 為服務容器注冊一個綁定 * * @param string|array $abstract * @param \Closure|string|null $concrete * @param bool $shared * @return void */ public function bind($abstract, $concrete = null, $shared = false) { // } ~~~ ### StyleCI Laravel 使用?[StyleCI](https://styleci.io/)?來做代碼矯正，所有 PR 都會在合并后被矯正代碼樣式，這樣做允許我們把精力放到貢獻的內容上，而不是代碼風格。 * * *