如何为 PHP 贡献代码

2012 年 9 月 19 日7640

 PHP在之前把源代码迁移到了git下管理, 同时也在github(https://github.com/php/php-src)上做了镜像, 这样一来, 就方便了更多的开发者为PHP来贡代码.

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

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

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

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

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

  5. 然后, 填写相关的信息, Github就会给PHP的pull request邮件组发送一份包含着你的更新的Pull Request邮件(大家不用担心你的英文, 只要你能说出来, 我们就能看懂, 当然, 如果你实在不愿意写英文, 也没关系, 写中文吧, 我看到了会处理, 我处理不了的, 我也会为大家翻译).

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

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

  1. 只写C89兼容的代码, 比如, 不要用单行注释(//), 变量的定义一定要在所有语句之前(block的开始)..

  2. 变量命名, 遵循PHP已有的规范, 不要使用驼峰命名.

  3. 对于一些非常小的更新, 比如代码中有拼写错误, 还是鼓励大家到bugs.php.net上提交Patch, 毕竟Merge Pull Request有的时候会比较麻烦.

  更多的PHP代码规范, 参看这里: Submitting patch

0 0