java大牛给大家来一份错误报告

贡献指南

错误报告

核心开发讨论

哪个部门?

安全漏洞

编码风格

PHPDoc

StyleCI

• •  

错误报告

为了鼓励积极的协作，Laravel强烈鼓励的是pull request，而不仅仅是bug报告。“Bug报告”也可以以包含失败测试的pull request的形式发送。

但是，如果您提交了一个bug报告，那么您的问题应该包含一个标题和对问题的清晰描述。您还应该包含尽可能多的相关信息和演示问题的代码示例。bug报告的目标是使您和其他人都可以轻松地复制bug并开发修复程序。

请记住，创建bug报告的目的是希望具有相同问题的其他人能够与您合作解决它。不要期望bug报告会自动看到任何活动，或者其他人会跳起来修复它。创建bug报告可以帮助您和其他人开始修复问题。

Laravel的源代码是在GitHub上管理的，每个Laravel项目都有存储库:

• Laravel应用程序

  Laravel艺术

  Laravel文档

  Laravel收银员

  Laravel收银员对布伦特里

  Laravel特使

  Laravel框架

  Laravel家园

  Laravel家园构建脚本

  Laravel地平线

  Laravel护照

  Laravel童子军

  Laravel社交名媛

  Laravel网站

 

核心开发讨论

您可以在Laravel Ideas issue board中提出对现有Laravel行为的新特性或改进。如果您提出了一个新特性，请至少执行完成该特性所需的一些代码。

LaraChat Slack团队的#internals通道中进行了关于bug、新特性和现有特性实现的非正式讨论。拉拉维尔的维护者泰勒·奥特韦尔(Taylor Otwell)通常会在工作日的早上8点到下午5点(UTC-06:00或美国/芝加哥)出现在该频道，偶尔也会在其他时间出现在该频道。

哪个部门?

所有的错误修复都应该发送到最新的稳定分支或者当前的LTS分支(5.5)。错误修复永远不应该发送到主分支，除非它们修复了仅存在于即将发布的版本中的特性。

与当前Laravel发行版完全向后兼容的次要特性可以发送到最新的stable分支。

主要的新特性应该总是发送到master分支，它包含即将发布的Laravel版本。

如果你不确定你的功能是主要的还是次要的，请在LaraChat Slack团队的#internals channel询问Taylor Otwell。

安全漏洞

如果您发现Laravel存在安全漏洞，请通过[email protected]向Taylor Otwell发送电子邮件。所有安全漏洞将被及时解决。

编码风格

Laravel遵循PSR-2编码标准和PSR-4自动加载标准。

 

PHPDoc

下面是一个有效的Laravel文档块的示例。注意@param属性后面跟着两个空格，参数类型，另外两个空格，最后是变量名:

/**
 * Register a binding with the container.
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 */
public function bind($abstract, $concrete = null, $shared = false)
{
    //
}

StyleCI

如果您的代码样式不是完美的，不要担心!StyleCI将在合并pull request之后自动将任何样式修复合并到Laravel存储库中。这允许我们关注贡献的内容，而不是代码风格。

给大家提供一个学习交流的平台，java架构师群： 558787436

具有1-5工作经验的，面对目前流行的技术不知从何下手，需要突破技术瓶颈的可以加群。

在公司待久了，过得很安逸，但跳槽时面试碰壁。需要在短时间内进修、跳槽拿高薪的可以加群。

如果没有工作经验，但基础非常扎实，对java工作机制，常用设计思想，常用java开发框架掌握熟练的可以加群。