参与开源如何为EaglePHP贡献代码

maoxiaojian 发布于 2012/10/22 20:05
阅读 303
收藏 1
EaglePHP官方已把源代码迁移到了git下管理, 同时也在github(https://github.com/maojian/EaglePHP)上做了镜像, 这样一来, 就方便了更多的开发者为EaglePHP来贡献代码.

  今天写这篇文章, 就是为了给在国内的同学们, 愿意为EaglePHP开源社区做贡献的同学们, 做个示例, 如何为EaglePHP来贡献你的智慧.

  现在, 假设你要为贡献一个新特性, 或者简单点, 你要为EaglePHP修复一个bug(一般来说, 大家可以在这里发现EaglePHP已经报告的bug:

  1.注册github

  2. fork EaglePHP的源代码, 在EaglePHP的Github页面上的右上角有一个fork按钮, 点它

  3. Fork以后, 你就有了一份属于你自己的EaglePHP源代码仓库, 现在你就可以在这个仓库下, 修改EaglePHP的源代码来为它修复Bug了.

  4. 等你修复完成以后, 你提交到你属于你自己的这个EaglePHP仓库中, 然后, 在你的EaglePHP源代码仓库的Github页面的右上角, 会有一个pull request按钮. 点它.

  5. 然后, 填写相关的信息, Github就会给EaglePHP的pull request邮件组发送一份包含着你的更新的Pull Request邮件(大家不用担心你的英文, 只要你能说出来, 我们就能

看懂, 当然, 如果你实在不愿意写英文, 也没关系, 写中文吧, 我看到了会处理, 我处理不了的, 我也会为大家翻译).

  6. 最后, 如果EaglePHP的Committers们认为你的修复正确(有一些为EaglePHP贡献代码要注意的选项, 我留在下面). 就会Merge你的Pull Request到EaglePHP的源代码中.

  为EaglePHP贡献源代码有几点要注意的(常见的错误):

1. 只写C89兼容的代码, 比如, 不要用单行注释(//), 变量的定义一定要在所有语句之前(block的开始)..
2. 变量命名, 遵循EaglePHP已有的规范, 不要使用驼峰命名.
3. 对于一些非常小的更新, 比如代码中有拼写错误, 还是鼓励大家到www.eaglephp.com上留言反馈, 毕竟Merge Pull Request有的时候会比较麻烦.

  更多的EaglePHP代码规范, 参看这里: https://github.com/maojian/EaglePHP
加载中
返回顶部
顶部