贡献指南
错误报告
为了鼓励积极的协作,Laravel 强烈鼓励提交拉取请求,而不仅仅是错误报告。“错误报告”也可以以包含失败单元测试的拉取请求形式发送。
然而,如果您提交错误报告,您的问题应包含一个标题和对问题的清晰描述。您还应尽可能多地包含相关信息和演示问题的代码示例。错误报告的目标是让您自己和其他人能够轻松地重现错误并开发修复方案。
请记住,错误报告是为了希望其他有相同问题的人能够与您合作解决它。不要期望错误报告会自动看到任何活动或其他人会立即修复它。创建错误报告是为了帮助您自己和其他人开始解决问题的路径。
Laravel 源代码在 Github 上管理,并且每个 Laravel 项目都有相应的仓库:
- Laravel 框架
- Laravel 应用程序
- Laravel 文档
- Laravel Cashier
- Laravel Envoy
- Laravel Homestead
- Laravel Homestead 构建脚本
- Laravel 网站
- Laravel 艺术
核心开发讨论
关于错误、新功能和现有功能实现的讨论在 #laravel-dev
IRC 频道(Freenode)进行。Laravel 的维护者 Taylor Otwell 通常在工作日的上午 8 点到下午 5 点(UTC-06:00 或美国/芝加哥时间)在频道中出现,并在其他时间不定期出现。
#laravel-dev
IRC 频道对所有人开放。欢迎所有人加入频道,无论是参与讨论还是仅仅观察讨论!
哪个分支?
所有错误修复都应发送到最新的稳定分支。错误修复绝不应发送到 master
分支,除非它们修复的功能仅存在于即将发布的版本中。
完全向后兼容当前 Laravel 版本的小功能可以发送到最新的稳定分支。
重大新功能应始终发送到 master
分支,该分支包含即将发布的 Laravel 版本。
如果您不确定您的功能是重大还是小功能,请在 #laravel-dev
IRC 频道(Freenode)询问 Taylor Otwell。
安全漏洞
如果您发现 Laravel 中的安全漏洞,请发送电子邮件至 Taylor Otwell,邮箱地址为 taylor@laravel.com。所有安全漏洞将被及时处理。
编码风格
Laravel 遵循 PSR-4 和 PSR-1 编码标准。除了这些标准,还应遵循以下编码标准:
- 类命名空间声明必须与
<?php
在同一行。 - 类的开头
{
必须与类名在同一行。 - 函数和控制结构必须使用 Allman 风格的大括号。
- 使用制表符缩进,使用空格对齐。