PHP 编码规范(2)
时间:2007-02-17 来源:PHP爱好者
3.1 开头注释 所有的源文件都应该在开头有一个C语言风格的注释,其中列出类名、功能、版本信息、日期、作者和版权声明:
/*
* 类名
* 功能
* 版本
* 日期
* 作者
* 版权
*/
如果对文件进行了修改,应该在文件头中说明修改目的、修改日期、修改人,并变更文件的版本信息;如果修改问文件的一部分,则在文件中进行注释即可,并且标识出修改部分的起止位置 …… /*
* 修改目的
* 修改日期
* 修改人
* 版本
*/ ……
修改起始
……
……
修改结束
……
php爱好者站 http://www.phpfans.net 为phper提供一切资讯.
/*
* 类名
* 功能
* 版本
* 日期
* 作者
* 版权
*/
如果对文件进行了修改,应该在文件头中说明修改目的、修改日期、修改人,并变更文件的版本信息;如果修改问文件的一部分,则在文件中进行注释即可,并且标识出修改部分的起止位置 …… /*
* 修改目的
* 修改日期
* 修改人
* 版本
*/ ……
修改起始
……
……
修改结束
……
php爱好者站 http://www.phpfans.net 为phper提供一切资讯.
相关阅读 更多 +