未加星标

[ Laravel 5.4 文档 ] 序言 ―― 贡献指南

字体大小 | |
[开发(php) 所属分类 开发(php) | 发布者 店小二03 | 时间 2017 | 作者 红领巾 ] 0人收藏点击收藏
缺陷报告

为了鼓励促进更加有效积极的合作,Laravel 强烈鼓励使用 GitHub 的 pull requests,而不是仅仅报告缺陷,“缺陷报告”也可以通过一个包含失败测试的 pull requests 的方式提交。

然而,如果你以文件的方式提交缺陷报告,你的问题应该包含一个标题和对该问题的明确说明,还要包含尽可能多的相关信息以及论证该问题的代码样板,缺陷报告的目的是为了让你自己和其他人更方便的重现缺陷并对其进行修复。

记住,缺陷报告被创建是为了其他人遇到同样问题的时候能够和你一起合作解决它,不要寄期望于缺陷会自动解决抑或有人跳出来修复它,创建缺陷报告是为了帮你自己和别人走上修复问题之路。

Laravel 源码通过 Github 进行管理,每一个 Laravel 项目都有其对应的代码库:

Laravel Framework Laravel Application Laravel Documentation Laravel Cashier Laravel Cashier for Braintree Laravel Envoy Laravel Homestead Laravel Homestead Build Scripts Laravel Passport Laravel Scout Laravel Socialite Laravel Website Laravel Art 核心开发讨论

你可以在 issue board 上提议新功能或者优化已有功能,如果是新功能的话请至少实现部分代码以便完成新功能开发。

你也可以在 LaraChat 的 Slack 小组的 #internals 频道讨论关于 Laravel 的 bugs、新特性、以及如何实现已有特性等。Taylor Otwell,Laravel 的主要维护者,通常在工作日的上午8点到下午5点(西六区或美国芝加哥时间)在线,其它时间也可能偶尔在线。

哪个分支?

所有的 bug 修复应该被提交到最新的稳定分支,永远不要把 bug 修复提交到 master 分支,除非它们能够修复下个发行版本中的特性。

当前版本中完全向后兼容的次要特性也可以提交到最新的稳定分支。

重要的新特性总是要被提交到 master 分支,包括下个发行版本。

如果你不确定是重要特性还是次要特性,请在 Slack 小组 LaraChat 的 #internals 频道咨询 Taylor Otwell

安全漏洞

如果你在 Laravel 中发现安全漏洞,请发送邮件到 [email protected] ,所有的安全漏洞将会被及时解决。

编码风格

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 会在提交代码时自动为我们修正代码风格以保持和Laravel仓库代码一致,从而让我们更加专注于代码内容而非风格。

本文开发(php)相关术语:php代码审计工具 php开发工程师 移动开发者大会 移动互联网开发 web开发工程师 软件开发流程 软件开发工程师

主题: Laravel安全漏洞SlackGitGitHubPHP工作日
分页:12
转载请注明
本文标题:[ Laravel 5.4 文档 ] 序言 ―― 贡献指南
本站链接:http://www.codesec.net/view/530602.html
分享请点击:


1.凡CodeSecTeam转载的文章,均出自其它媒体或其他官网介绍,目的在于传递更多的信息,并不代表本站赞同其观点和其真实性负责;
2.转载的文章仅代表原创作者观点,与本站无关。其原创性以及文中陈述文字和内容未经本站证实,本站对该文以及其中全部或者部分内容、文字的真实性、完整性、及时性,不作出任何保证或承若;
3.如本站转载稿涉及版权等问题,请作者及时联系本站,我们会及时处理。
登录后可拥有收藏文章、关注作者等权限...
技术大类 技术大类 | 开发(php) | 评论(0) | 阅读(35)