提交补丁 (Patches)

如果你修改了一个包去扩展它的功能或者修改了一个BUGS,你应该把你的改动送回到社区(一些许可证迫使你这样做,否则将通常被认为是不道德的)。

在创建一个补丁之前,你首先必须从CVS取得你要修改的包的最新的源代码,你可以执行下面的命令(以Foo_Bar作为包的例子):
cvs -d:pserver:cvsread@cvs.php.net:/repository login
password is "phpfi"

cvs -z3 -d:pserver:cvsread@cvs.php.net:/repository co pear/Foo_Bar
现在你取得了最新的源代码了,你可以修改相应的文件。请确定你的补丁与PEAR的编码标准
coding standards.完全一致.

在你完成了代码的添加或修改后,请对它进行测试:我们不接受没有经过仔细测试的代码。当你完全确定新的代码不会引入BUGS后,请运行下面的命令创建一个统一的diff:
cd pear/Foo_Bar
cvs diff -u >Foo_Bar.diff
结果生成的.diff文件包含了你的补丁,它使我们更容易发现哪里被改变了。

下一个步骤是提交补丁。发一封EMAIL到pear-dev@lists.php.net并且Cc包的维护者,标题的前缀应该是'[Patch]',以表明你在提交补丁,并且包含一份关于补丁作用的详细说明。不要忘记在EMAIL中把.diff作为附件发出。在每个源文件的头部通常会列出维护者。除此之外,他们的EMAIL地址会出现在http://pear.php.net/ 有关包的信息的网页。

注意: 如果你使用Outlook 或者 Outlook Express,请把diff文件的扩展名改为.txt.。因为Outlook的MIME-Type是依赖文件扩展名的检测而定的,如果附件的MIME-Type不是 text/plain那就会被我们的邮件列表软件所拒收。

注意: 如果你的补丁不能向后兼容,那被维护者青睐的机会就相对较少。因而某种程度上你应该致力于修改漏洞而不是改变公共的API。不过果然你确实没办法保持向后兼容,而且的你的补丁有groundbraking的改进,那API的改动也是好的。

后退

向前


复制


PEAR 包Packages

开发者邮件列表

总邮件列表

CVS 提交邮件列表

PHP 手册

Google

所有网站


打印

刷新