贡献指南
缺陷报告
为了促进有效积极的合作,相对于仅提交 缺陷报告 来说, Laravel 团队更鼓励使用 GitHub的 Pull Request。 当然也可以用 Pull Request 的方式发送含有失败单元测试的「缺陷报告」。
当您在呈递缺陷报告的时候,请确保您所提交的问题含有标题和清晰的描述。同时应该附带尽可能详细的与问题相关的信息和代码示例。 缺陷报告的目标是尽可能的方便您与他人去重现错误并修复它。
请谨记,建立缺陷报告是希望您与其他遇到同样问题的人一起解决这个问题。 但请不要期望其他人会主动的过来修复它。 创建缺陷报告是为了给您和他人提供一个修复问题的切入点。
Laravel 框架的源代码托管在 Github, 以下列出了每个 Laravel 相关项目仓库的连接:
- Laravel Framework
- Laravel Application
- Laravel Documentation
- Laravel Cashier
- Laravel Envoy
- Laravel Homestead
- Laravel Homestead Build Scripts
- Laravel Website
- Laravel Art
核心开发讨论区
讨论区在 (Freenode) 上的 #laravel-dev IRC 频道, 讨论内容包括缺陷,新特性和计划实施的已有特性. Laravel 项目维护者 Taylor Otwell 通常会在周一至周五的美国芝加哥时间 8am-5pm 上线 (UTC-06:00 or America/Chicago), 当然其它时间他也会偶尔出现。
#laravel-dev IRC 频道是对所有人开放的,欢迎任何有兴趣的朋友参与进来讨论或哪怕只是围观!
如何选择分支?
所有的 缺陷修正都应该提交到最后一版的稳定分支。 永远 不要把缺陷修正提交到 master
分支除非这些正是在下个发行版本中他们要修复的特性。
那些 完全向后兼容 并随当前 Laravel 版发行的 非重要 特性也许可以提交到最后一版的稳定分支。
那些在下一个 Laravel 发行版中将要出现的 重要的 新特性应该总是被提交到 master
分支。
如果您也不确定你写的特性是否重要时,请到 (Freenode) 的 #laravel-dev IRC 频道 问一下 Taylor Otwell。
安全缺陷
如果你在 Laravel 中发现安全缺陷,烦请以电子邮件的方式发送给 Taylor Otwell taylor@laravel.com。所有的安全缺陷都将会被及时的处理掉。
代码风格
Laravel 框架遵循 PSR-4 和 PSR-1 代码标准。除了这些以外,如下的代码标准也应该被遵守:
-
类命名空间的声明必须与
<?php
处在同一行。 -
类的起始花括号
{
必须与类名处在同一行。 -
函数和控制结构必须使用 Allman 样式 括起来。
-
缩进使用制表符,对齐使用空格。