安装软件堆栈

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

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

配置Git

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

1 2

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

1

$ git config core. selflf

1

$ git配置——全局核心。autocrlf输入

获取Symfonob娱乐下载y源代码

获取Symfonob娱乐下载y源代码:

• 创建一个GitHub登记和签到;
• 叉的ob娱乐下载Symfony库(点击“Fork”按钮);
• 在“fork动作”完成后，在本地克隆你的fork(这将创建一个ob娱乐下载目录):

1

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

• 将上游存储库添加为远程:

1 2

＄cdob娱乐下载Symfony $ git远程添加上游git://github.com/symfony/symfony.git

检查当前的测试是否通过

现在已经安装了Syob娱乐下载mfony，请检查您的环境中的所有单元测试是否都通过了文档．

许可

在开始之前，您必须知道您要提交的所有补丁必须在麻省理工学院的许可，除非在提交中明确指定。

选择正确的分支

在开始一个补丁之前，你必须确定你需要在哪个分支上工作:

• 2．3，如果你正在修复一个现有功能的错误(如果你正在修复的功能是在后续版本中引入的，你可能必须选择一个更高的分支);
• 2.7，如果你要添加向后兼容的新功能;
• 主，如果您正在添加一个新的向后不兼容的特性。

创建主题分支

每次你想要为一个bug或者一个增强做补丁的时候，创建一个topic分支:

1

$ git checkout -b BRANCH_NAME master

或者，如果您想为2．3布兰奇，先追踪遥控器2．3本地分支:

1

$ git checkout -t origin/2.3

然后创建一个新的分支2．3分支来进行错误修复:

1

$ git checkout -b BRANCH_NAME

上面的签出命令自动将代码切换到新创建的分支(检查您正在使用的分支git分支）.

完善你的补丁

你想做多少就做多少，提交多少就提交多少;但请记住以下几点:

• 阅读Symfonyob娱乐下载约定并遵循编码标准(使用Git diff——检查检查尾随空格——也可以阅读下面的提示);
• 添加单元测试，以证明bug已修复或新功能确实有效;
• 尽量不要破坏向后兼容性(如果你必须这样做，尝试提供一个兼容层来支持旧的方式)——破坏向后兼容性的补丁被合并的机会更少;
• 进行原子提交和逻辑上分离的提交(使用git变基有一个干净的和合乎逻辑的历史);
• 排除那些与修改编码标准或修改自己代码中的错别字无关的提交;
• 永远不要在一些现有的代码中修正编码标准，因为这会使代码审查更加困难;
• 编写好的提交消息(参见下面的提示)。

准备提交补丁

当你的补丁不是关于bug修复(例如，当你添加一个新功能或改变一个现有功能时)，它还必须包括以下内容:

• 对相关变化的解释更新日志文件(s) ((公元前打破)或者是(弃用)在相关情况下必须使用前缀);
• 有关如何升级现有应用程序的说明升级如果更改破坏了向后兼容性，或者如果您弃用了最终会破坏向后兼容性的某些内容，则文件。

调整你的补丁

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

1 2 3 4 5

$ git checkout master $ git fetch upstream $ git merge upstream/master $ git checkout BRANCH_NAME $ git rebase master

当做变基命令时，您可能必须修复合并冲突。git状态会向你展示unmerged文件。解决所有冲突，然后继续重基:

1 2

$ git add…#添加解析文件$ git rebase——继续

检查所有测试仍然通过，并远程推动分支:

1

$ git push——force origin BRANCH_NAME

提出拉请求

对象上的拉取请求ob娱乐下载symfony / symfonyGitHub库。

为了简化核心团队的工作，总是在你的pull request消息中包含修改过的组件，比如:

1 2

[Form] [Validator] [FrameworkBundle]添加了一些东西

拉请求描述必须在顶部包括以下检查表，以确保您的贡献可以在没有不必要的反馈循环的情况下被审查，并且您的贡献可以尽快被包含到Symfony中:ob娱乐下载

1 2 3 4 5 6 7 8 9 10

| Q | A | ------------- |—| Bug修复?| [yes|no] |新特性?| [yes|no] | BC断裂?| [yes|no] |弃用?| [yes|no] |测试通过?|[是|否]|固定票证|[由PR固定的票证列表，逗号分隔]| License | MIT | Doc PR |[参考文档PR(如有)]欧宝官网下载app

现在提交的示例如下所示:

1 2 3 4 5 6 7 8 9 10

| Q | A | ------------- |—| Bug修复?| no |新特性?|没有| BC断裂?|没有|弃用?|没有|测试通过?|是|固定门票| #12，#43 |许可证| MIT | Doc PR | symfony/symfony-docs#1ob娱乐下载23

整个表格必须包括在内不删除你认为不相关的行)。对于简单的拼写错误，PHPDocs中的微小更改，或翻译文件中的更改，使用较短版本的检查列表:

1 2 3 4

| Q | A | ------------- |—|固定门票|[由PR固定的门票列表，逗号分隔]| License | MIT

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

• 如果你对“Bug修复?”的回答是肯定的，检查该Bug是否已经在Symfony问题中列出，并在“修复票据”中引用它/它们;ob娱乐下载
• 如果你对“新功能?”的回答是肯定的，你必须向文档提交一个pull request，并在“Doc PR”部分引用它;欧宝官网下载app
• 如果你回答是“BC中断?”，补丁必须包含相关的更新更新日志而且升级文件;
• 如果你回答是“Deprecations?”，补丁必须包含相关的更新更新日志而且升级文件;
• 如果对“测试通过”回答“否”，则必须向待办事项列表中添加一个项目，其中包含修复测试必须执行的操作;
• 如果“许可证”不是MIT，就不要提交拉请求，因为它无论如何都不会被接受。

如果上面的一些要求不满足，创建一个待办事项列表，并添加相关项目:

1 2 3

-[]修复测试，因为它们还没有更新-[]向文档提交更改-[]记录BC中断欧宝官网下载app

如果代码还没有完成，因为你没有时间完成它，或者因为你想要对你的工作得到早期的反馈，在待办事项列表中添加一个项目:

1 2

-[]完成代码-[]收集修改的反馈

只要您在待办事项列表中有项目，请在拉取请求标题前加上“[WIP]”。

在拉取请求描述中，尽可能详细地描述您的更改(不要犹豫给出代码示例来说明您的观点)。如果您的pull请求是关于添加新功能或修改现有功能，请解释这些更改的基本原理。拉取请求描述有助于代码审查，并在代码合并时作为参考(拉取请求描述及其所有相关注释是合并提交消息的一部分)。

除了这个“代码”的拉请求外，还必须向欧宝官网下载app文档存储库适时更新文档。欧宝官网下载app

重做补丁

根据对拉请求的反馈，您可能需要重做您的补丁。在重新提交补丁之前，使用上游/主或上游/ 2.3，不要合并;并将其推至原点:

1 2

$ git rebase -f upstream/master $ git push——force origin BRANCH_NAME

通常，版主会要求你“压缩”你的提交。这意味着您将把多个提交转换为一次提交。要做到这一点，使用rebase命令:

1 2

$ git rebase -i upstream/master $ git push——force origin BRANCH_NAME

在你输入这个命令后，一个编辑器会弹出一个提交列表:

1 2 3

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

要将所有提交压缩到第一个，请删除单词选择在第二个和最后一个提交之前，并将其替换为单词南瓜或者只是年代．当您保存时，Git将开始重基，如果成功，将要求您编辑提交消息，默认情况下，这是所有提交的提交消息的列表。完成后，执行push命令。