贡献导引
错误反馈
为了提倡积极协作,Laravel 强烈地鼓励使用 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
核心开发讨论
有关错误、新功能和现有功能的实现讨论会在 Slack 的 LaraChat 群组上的 #internals
频道中进行。Laravel 的维护者 Taylor Otwell 在工作日的 8am 到 5pm( UTC-06:00 或 America/Chicago )通常都会出现在频道上,其它时间偶尔也会出现。
选择分支
所有的 错误修复都应该发送到最新的稳定分支上。除非它们修复的功能只存在下一版的发布中,不然错误修复 永远不 应该发送到 master
分支。
次要的 且与现有的 Laravel 发布版本 完全向下兼容 的功能可以发送到最新的稳定分支。
主要的 新功能应该都发送到 master
分支,它包含下一版的 Laravel 发布内容。
如果不确定你的功能是主要的还是次要的,请在 Slack 的 LaraChat 群组上的 #internals
频道询问 Taylor Otwell。
安全漏洞
如果你 发现 Laravel 存在安全漏洞,请发送电子邮件到 taylor@laravel.com 给 Taylor Otwell。所有的安全漏洞将会及时予以处理。
编码风格
Laravel 遵守 PSR-2 编码规范和 PSR-4 自动加载规范。
译者注:扩展阅读 - 所有 PSR 的标准规范。
注释区块
@param
标签应该分行显示,并且每一个参数中间需相隔 两个空格,举个例子:
/**
* 为服务容器注册一个绑定
*
* @param string|array $abstract
* @param \Closure|string|null $concrete
* @param bool $shared
* @return void
*/
public function bind($abstract, $concrete = null, $shared = false)
{
//
}
代码风格矫正器
你可以使用 PHP-CS-Fixer 在提交代码之前进行代码格式矫正。
你需要 全局安装命令行 ,然后在根目录下运行以下命令进行矫正:
php-cs-fixer fix
欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译。
文档永久地址: http://d.laravel-china.org