明辉站/网站教程/内容

PHP 编码规范(2)

网站教程2024-06-05 阅读
[摘要]3.1 开头注释所有的源文件都应该在开头有一个C语言风格的注释,其中列出类名、功能、版本信息、日期、作者和版权声明:/* * 类名 * 功能 * 版本 * 日期 * 作者 * 版权 */如果对文件进行了修改,应该在文件头中说明修改目的、修改日期、修改人,并变更文件的版本信息;如果修改问文件的一部分...
3.1 开头注释

所有的源文件都应该在开头有一个C语言风格的注释,其中列出类名、功能、版本信息、日期、作者和版权声明:


/*
 * 类名
 * 功能
 * 版本
 * 日期
 * 作者
 * 版权
 */

如果对文件进行了修改,应该在文件头中说明修改目的、修改日期、修改人,并变更文件的版本信息;如果修改问文件的一部分,则在文件中进行注释即可,并且标识出修改部分的起止位置

……

/*
 * 修改目的
 * 修改日期
 * 修改人
 * 版本
 */

……

修改起始

……

……

修改结束

……


……

相关阅读