跳到主要内容
版本：5.0

贡献指南

缺陷报告​

为了促进有效积极的合作，相对于仅提交 缺陷报告 来说， Laravel 团队更鼓励使用 GitHub的 Pull Request。 当然也可以用 Pull Request 的方式发送含有失败单元测试的「缺陷报告」。

当您在呈递缺陷报告的时候，请确保您所提交的问题含有标题和清晰的描述。同时应该附带尽可能详细的与问题相关的信息和代码示例。 缺陷报告的目标是尽可能的方便您与他人去重现错误并修复它。

请谨记，建立缺陷报告是希望您与其他遇到同样问题的人一起解决这个问题。 但请不要期望其他人会主动的过来修复它。 创建缺陷报告是为了给您和他人提供一个修复问题的切入点。

Laravel 框架的源代码托管在 Github， 以下列出了每个 Laravel 相关项目仓库的连接:

核心开发讨论区​

讨论区在 (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 样式 括起来。

  • 缩进使用制表符，对齐使用空格。