# 貢獻指南 - [錯誤反饋](#bug-reports) - [核心開發討論](#core-development-discussion) - [選擇分支？](#which-branch) - [安全漏洞](#security-vulnerabilities) - [編碼風格](#coding-style) - [PHPDoc](#phpdoc) - [StyleCI](#styleci) <a name="bug-reports"></a> ## 錯誤反饋 為了鼓勵積極協作，Laravel 強烈地鼓勵使用 Pull Request 指出修改的內容，而不僅僅只是反饋錯誤。「錯誤反饋」也可以用 PR 來提交失敗測試。 如果你要提交錯誤反饋，你的問題應該包含標題和明確的問題描述，并盡可能多的提供相關的信息和演示該問題的代碼示例。錯誤反饋的目的是讓你和其他人可以輕松地重現并修復錯誤。 請記住，錯誤反饋的初衷是讓其它有相同問題的人能夠和你協作解決問題。不要指望反饋錯誤后會很快有人修復它。創建錯誤反饋是能幫助你和其他人開始著手修復問題的途徑。 Laravel 源代碼托管在 GitHub 上面，并且每個 Laravel 的項目都有自己的代碼倉庫： <div class="content-list" markdown="1"> - [Laravel 應用](https://github.com/laravel/laravel) - [Laravel Art](https://github.com/laravel/art) - [Laravel 文檔](https://github.com/laravel/docs) - [Laravel Cashier](https://github.com/laravel/cashier) - [Braintree 版 Laravel Cashier](https://github.com/laravel/cashier-braintree) - [Laravel Envoy](https://github.com/laravel/envoy) - [Laravel 框架](https://github.com/laravel/framework) - [Laravel Homestead](https://github.com/laravel/homestead) - [Laravel Homestead 構建腳本](https://github.com/laravel/settler) - [Laravel Passport](https://github.com/laravel/passport) - [Laravel 搜索系統](https://github.com/laravel/scout) - [Laravel Socialite](https://github.com/laravel/socialite) - [Laravel 網站](https://github.com/laravel/laravel.com) </div> <a name="core-development-discussion"></a> ## 核心開發討論 如果你想提出現有的 Laravel 的功能建議或者改進，請到 Laravel Internals 的 [反饋欄](https://github.com/laravel/internals/issues) 討論。如果你提出新功能，如果愿意，我們希望能請你至少實現一些完成該功能所需的代碼。 有關錯誤、新功能和現有功能的實現的非正式討論會在 [LaraChat](http://larachat.co) Slack 團隊的 `#internals` 頻道中進行。Laravel 的維護者 Taylor Otwell 通常都會在工作日的早上 8 點 到下午 5點（ UTC-06:00 或 America/Chicago ）出現在頻道上，其它時間偶爾也會出現。 <a name="which-branch"></a> ## 選擇分支？ **所有**錯誤修復都應該發送到最新的穩定分支或當前的 LTS 分支（5.5）上。錯誤修復**不**應該發送到 `master` 支，除非它們修復僅在即將發布的版本中存在的功能。 與當前 Laravel 版本**完全向后兼容**的**次要**功能可能會發送到最新的穩定分支。 **主要的** 新功能都應該發送到 `master` 分支，它包含即將發布的 Laravel 版本。 如果不確定你的功能是主要的還是次要的，請咨詢 [LaraChat](http://larachat.co) Slack 團隊的 `#internals` 頻道上的 Taylor Otwell。 <a name="security-vulnerabilities"></a> ## 安全漏洞 如果你發現 Laravel 存在安全漏洞，請發送電子郵件給Taylor Otwell： <a href="mailto:taylor@laravel.com">taylor@laravel.com。他會及時解決所有安全漏洞。</a> <a name="coding-style"></a> ## 編碼風格 Laravel 遵循 [PSR-2](https://phphub.org/topics/2079) 編碼規范和 [PSR-4](https://phphub.org/topics/2081) 自動加載規范。 <a name="phpdoc"></a> ### PHPDoc 以下是正確的 Laravel 注釋的示例。請注意，`@param` 屬性后跟兩個空格、參數類型、兩個空格，最后是變量名稱： /** * 注冊一個綁定到容器。 * * @param string|array $abstract * @param \Closure|string|null $concrete * @param bool $shared * @return void */ public function bind($abstract, $concrete = null, $shared = false) { // } <a name="styleci"></a> ### StyleCI 別擔心你的編碼風格不夠漂亮！在合并 PR 后 [StyleCI](https://styleci.io) 會自動修正樣式后再合并到 Laravel 倉庫中。這樣使得我們可以專注于貢獻內容本身而不是編碼風格。 ## 譯者署名 | 用戶名 | 頭像 | 職能 | 簽名 | |---|---|---|---| | [Seven Du](https://github.com/medz) | <img class="avatar-66 rm-style" src="https://avatars3.githubusercontent.com/u/5564821?s=300"> | 翻譯 | 基于 Laravel 的社交開源系統 [ThinkSNS+](https://github.com/slimkit/thinksns-plus) 歡迎 Star。 | | [@JokerLinly](https://laravel-china.org/users/5350) | <img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/5350_1481857380.jpg"> | Review | Stay Hungry. Stay Foolish. | --- > {note} 歡迎任何形式的轉載，但請務必注明出處，尊重他人勞動共創開源社區。 > > 轉載請注明：本文檔由 Laravel China 社區 [laravel-china.org](https://laravel-china.org) 組織翻譯，詳見 [翻譯召集帖](https://laravel-china.org/topics/5756/laravel-55-document-translation-call-come-and-join-the-translation)。 > > 文檔永久地址： https://d.laravel-china.org