安装软件栈

在Symfony工作之前,设置一个友ob娱乐下载好的环境使用以下软件:

• Git;
• 5.3.3 PHP版本或以上;
• PHPUnit) 3.6.4或以上。

配置Git

设置用户信息与你的真实姓名和工作电子邮件地址:

1 2

git配置全球user.name美元“你的名字”git配置美元——全球用户。电子邮件you@example.com

1

git配置core.autocrlf美元

1

git配置美元——全球核心。autocrlf输入

Symfony的ob娱乐下载源代码

Symfony的ob娱乐下载源代码:

• 创建一个GitHub账户和登录;
• 叉的ob娱乐下载Symfony库(点击“叉”按钮);
• “分叉行动”完成后,在本地克隆叉(这将创建一个ob娱乐下载目录):

1

git美元克隆git@github.com:用户名/ symfob娱乐下载ony.git

• 添加上游库作为远程:

1 2

美元cdob娱乐下载symfony git远程增加上游git:美元/ /github.com/symfony/symfony.git

检查当前的测试通过

现在安装Symfoob娱乐下载ny,检查所有单元测试通过为您的环境作为专门的解释文档。

许可

在你开始之前,你必须知道所有的补丁你要提交必须下发布麻省理工学院的许可在你提交,除非显式指定。

选择正确的分支

在一块工作之前,你必须确定你需要哪个部门去工作。应该基于分支主如果你想添加一个新特性分支。但如果你想修复一个缺陷,使用最古老但仍保持版本Symfony的缺陷(如发生ob娱乐下载2.3)。

创建一个主题分支

每次你想工作在一个补丁一个bug或增强,创建一个主题分支:

1

git checkout美元- b BRANCH_NAME主人

或者,如果你想要提供的错误修复2.3分支,首先跟踪远程2.3本地分支:

1

git checkout - t起源/ 2.3美元

然后创建一个新的分支2.3部门工作错误修复:

1

git checkout - b BRANCH_NAME 2.3美元

上面的付款命令自动切换到新创建的代码分支(检查你正在研究的分支git分支)。

你的补丁

工作的代码尽可能多的你想要提交多达你想要的;但请记住以下几点:

• 读到的Symfonyob娱乐下载约定并遵循编码标准(使用git diff -检查检查尾部空格——也读下面的提示);
• 添加单元测试来证明虫子是固定的,或者新功能实际上作品;
• 努力不是打破向后兼容性(如果你必须这样做,试图提供一个兼容层支持老方法)——补丁打破向后兼容性更少被合并的机会;
• 原子和逻辑上独立的提交(使用的力量吗git变基有一个干净的历史和逻辑);
• 南瓜无关的承诺,只是固定编码标准或修复拼写错误在您自己的代码;
• 从来没有解决编码标准在某些现有的代码,因为它使代码评审更加困难;
• 写好提交消息(参见下面的提示)。

准备提交你的补丁

当你的补丁不是一个bug修复(当你添加一个新的功能或改变现有的一个实例),它还必须包括以下:

• 相关的变化的解释更新日志文件(s) ((公元前打破)或者是(弃用)时,必须使用前缀相关);
• 解释如何升级现有的应用程序相关的升级文件如果打破向后兼容性的变化或者轻视的东西最终将打破向后兼容性。

变基你的补丁

之前提交你的补丁,更新你的分支(如果需要一段时间来完成你的需要更改):

1 2 3 4 5

git checkout掌握上游git获取git美元美元合并上游/主git checkout BRANCH_NAME git美元变基的主人

当在做变基命令,您可能必须解决合并冲突。git状态将告诉你unmerged文件。解决所有的冲突,然后继续变基:

1 2

美元git添加…#添加解析文件git变基——美元继续

检查所有测试仍然通过,推动你的远程分支:

1

git推动美元——迫使BRANCH_NAME起源

做一个拉请求

你现在可以把请求的ob娱乐下载symfony / symfonyGitHub库。

为了缓解核心团队的工作,总是在将请求消息中包含修改后的组件,如:

1 2

(Yaml)固定的东西(形式)(Validator) [FrameworkBundle]添加一些东西

拉请求描述必须包括以下清单顶部确保贡献可能审查没有不必要的反馈循环,你的贡献可以列入Symfony尽快:ob娱乐下载

1 2 3 4 5 6 7 8 9 10

|问| | - - - - - - - - - - - - - | - - - | Bug修复吗?(是的|不)| |新功能吗?(是的|不)| | BC休息吗?(是的|不)| |不支持?(是的|不)| |测试通过?| |否]| |固定门票(门票固定的逗号分隔列表公关)|许可协议|麻省理工学院| Doc公关|(参考文档公关如果任何)欧宝官网下载app

提交一个例子现在可能看起来如下:

1 2 3 4 5 6 7 8 9 10

|问| | - - - - - - - - - - - - - | - - - | Bug修复吗?| |新功能?公元前| |不休息吗?| |不支持?没有| |测试通过?|是| |固定票# 12 # 43 |许可协议|麻省理工学院| Doc公关| symfony / symfony-docob娱乐下载s # 123

必须包括整个表(做的不删除你认为不相关行)。PHPDocs对于简单的拼写错误,微小的变化,或改变翻译文件,使用较短的版本的检查表:

1 2 3 4

|问| | - - - - - - - - - - - - - | - - - | |固定门票(门票固定的逗号分隔列表公关)|许可协议|麻省理工学院

一些答案的问题引发更多的要求:

• 如果你的回答肯定“Bug修复?”,check if the bug is already listed in the Symfony issues and reference it/them in "Fixed tickets";
• 如果你的回答肯定“新特性?”,you must submit a pull request to the documentation and reference it under the "Doc PR" section;
• 如果你的回答肯定“BC休息?”,the patch must contain updates to the relevant更新日志和升级文件;
• 如果你的回答肯定“用法吗?”,the patch must contain updates to the relevant更新日志和升级文件;
• 如果你回答没有测试通过,您必须添加一个项目一个todo - list的行为必须修复完成测试;
• 如果“许可证”不是麻省理工学院,只是不提交拉请求,因为它不会被接受。

如果一些之前的需求没有得到满足,创建一个todo - list和添加相关项目:

1 2 3

——[]修复测试作为他们尚未更新-[]文档提交变化[]文档BC优惠欧宝官网下载app

如果代码还没有完成,因为你没有时间完成它还是因为你想要的早期反馈在你的工作上,添加一个todo - list:项

1 2

————[][]完成代码收集反馈为我改变

只要你在为todo - list条目,请前缀拉请求标题用“(在制品)”。

把请求中的描述,给尽可能多的细节您的更改(不要犹豫给代码示例来说明你的观点)。如果你把请求是关于添加或修改一个现有的一个新特性,解释变化的基本原理。拉请求描述帮助代码评审和它作为一个参考当代码合并(拉请求描述和其相关的评论是合并提交消息的一部分)。

除了这个“代码”拉请求,你必须发送一个请求欧宝官网下载app文档存储库在适当的时候来更新文档。欧宝官网下载app

修改你的补丁

基于反馈拉请求,您可能需要重做你的补丁。在重新提交补丁之前,变基上游/主或上游/ 2.3,不要合并;和力推动原点:

1 2

git上游变基- f /主git推动美元——迫使BRANCH_NAME起源

通常,版主会问你“南瓜”提交。这意味着您将许多提交转换为一个承诺。要做到这一点,使用变基命令:

1 2

git变基-我上游/主git推动美元——迫使BRANCH_NAME起源

你输入这个命令后,将弹出一个编辑器显示的列表提交:

1 2 3

选择1 a31be6第一次提交选择7 fc64b4第二次提交选择7 d33018第三次提交

南瓜所有提交到第一个,删除这个词选择第二个和最后一个提交之前,通过这个词和替换它南瓜或者只是年代。当您保存,Git将重新开始,如果成功,会问你编辑提交消息,默认情况下是一个清单的提交信息的提交。当你完成后,执行命令。