* * * * * [TOC] ## 錯誤反饋 為了鼓勵積極協作，Laravel 強烈地鼓勵使用 Pull Request 指出修改的內容，而不僅僅只是反饋錯誤。「錯誤反饋」也可以用 PR 來提交失敗測試。 如果你要提交錯誤反饋，你的問題應該包含標題和明確的問題描述，并盡可能多的提供相關的信息和演示該問題的代碼示例。錯誤反饋的目的是讓你和其他人可以輕松地重現并修復錯誤。 請記住，錯誤反饋的初衷是讓其它有相同問題的人能夠和你協作解決問題。不要指望反饋錯誤后會很快有人修復它。創建錯誤反饋是能幫助你和其他人開始著手修復問題的途徑。 Laravel 源代碼托管在 GitHub 上面，并且每個 Laravel 的項目都有自己的代碼倉庫： * [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 Horizon](https://github.com/laravel/horizon) * [Laravel Passport](https://github.com/laravel/passport) * [Laravel Scout](https://github.com/laravel/scout) * [Laravel Socialite](https://github.com/laravel/socialite) * [Laravel 網站](https://github.com/laravel/laravel.com) ## 核心開發討論 如果你想提出現有的 Laravel 的功能建議或者改進，請到 Laravel Internals 的?[issue board](https://github.com/laravel/internals/issues)討論。如果你提出新功能，如果愿意，我們希望能請你至少實現一些完成該功能所需的代碼。 有關錯誤、新功能和現有功能的實現的非正式討論會在?[LaraChat](https://larachat.co/)?Slack 團隊的?`#internals`?頻道中進行。Laravel 的維護者 Taylor Otwell 通常都會在工作日的早上 8 點 到下午 5點（ UTC-06:00 或 America/Chicago ）出現在頻道上，其它時間偶爾也會出現。 ## 選擇分支? **所有**?錯誤修復都應該發送到最新的穩定分支或當前的 LTS 分支（5.5）上。 錯誤修復?**不**?應該發送到?`master`?分支，除非它們修復僅在即將發布的版本中存在的功能。 與當前 Laravel 版本**完全向后兼容**的**次要**功能可能會發送到最新的穩定分支。 **主要**?新功能都應該發送到?`master`?分支，它包含即將發布的 Laravel 版本。 如果你不確定你的功能是主要的還是次要的，請咨詢?[LaraChat](https://larachat.co/)?Slack 團隊上的?`#internals`?頻道中詢問 Taylor Otwell。 ## 安全漏洞 如果你發現 Laravel 存在安全漏洞，請發送電子郵件給 Taylor Otwell：?[taylor@laravel.com](mailto:taylor@laravel.com)。他會及時解決所有安全漏洞。 ## 編碼風格 Laravel 遵循?[PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)?編碼規范和?[PSR-4](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader.md)?自動加載規范。 ### 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) { // } ~~~ ### StyleCI 別擔心你的編碼風格不夠漂亮！在合并 PR 后?[StyleCI](https://styleci.io/)?會自動修正樣式后再合并到 Laravel 倉庫中。這樣使得我們可以專注于貢獻內容本身而不是編碼風格。