PHP如何编写易读的代码


Posted in PHP onJuly 10, 2007

成功的开发团队要求队伍中的每一位成员遵守代码重用规则,这些规定把代码的重用性推到极至同时却不会显著降低开发人员的创造力和开发效率。如果编写和使用代码的开发人员遵守共同的程序命名规范代码和代码注释要求,那么代码的重用性就会得以大大提升。这些标准的起点是系统结构级的。你的功能规范应该在类、属性的名字、函数返回值以及其他关键程序元素的定义中反映这些标准。本文将就基本的命名规则和注释提出一些可行的建议,意图帮助读者开发自己的代码重用标准。 

大小写标准

在我们开始讨论各类程序要素命名的正确方式之前,先让我们定义区分元素的字符大小写的两种最常用方式,它们是:

Pascal规范—第1个字符大写,目标名中的每个单词的第1个字母也大写,比如InvoiceNumber或者PrintInvoice。其他的所有字符都小写。 
Camel规范—第1个字符不大写,但目标名中的每个单词的第1个字母大写,比如,invoiceNumber。其他的所有字符都小写。 
可是,采用字符大小写区分元素可能在对大小写不敏感的编程语言中引发问题。比方说,由于C#语言区分大小写,所以你可以调用私有变量employee,接着它所具有的公共属性Employee则可以被调用者所用。这些操作是完全合法的。但是,对Visual Basic来说就会产生错误,因为VB是不区分字母大小写的,以上两种元素在VB看来都是一回事。假如你在混合语言环境下工作,你只能指定某些规则要求开发人员合理利用多种语言阅读其他人开发的代码。

命名标准
假设我们采用了以上的大小写标准,现在就让我们了解一些通用程序元素的简单命名建议。


某些类设计为模拟真实世界的对象,就这些类来说,所选用的名字就应该反映真实世界的对象、具有单数名词的格式,比方Employee、 Invoice或者Timecard等。对内部类而言可以采用Pascal规范令结果类具有单数形式的名字,比如ThreadPool或者CustomColor等。类应当是单数的,这样它们的复数形式就可以代表同类的集合名,比如Employees数组等。

类的成员
采用C#以及其他大小写敏感编程语言的开发人员应当采用camel规范命名类成员的名字。这样做可以让开发者更易于区分内部变量的名字(name)和公共属性的名字(Name)。许多VB开发人员更喜欢采用匈牙利命名法为类成员起名,也就是在名字前面加上前缀表示变量的类型,比如sName就指的是string类型的Name变量。我认为,在使用VS.NET这样高级的开发环境下这样做是不必要的,因为在这种情况下系统鼠标停留在变量之上即可可自动显示变量的类型。我个人喜欢在类成员名前加上前缀:小写的字母m。这样内部变量就保存了足够的内部类信息:内部变量mName就正好代表了公共属性Name。

方法
方法应该用Pascal规范命名,同时用合理的方式说明他们的实施行为。比方说,给数据库添加雇员的方法可以命名为AddEmployee,而打印发票的方法则不妨命名为PrintInvoice。假如方法返回的是布尔值,那么方法名应该以动词开头以便用在if语句的时候其含义更明显。比如说,假如你有一个方法的功能是确定某位雇员是否符合公司401k计划的要求,那么你可以在If语句中调用IsEligible401k方法:If IsEligible401k then…

方法参数、返回值和变量
所有的方法参数、返回值和变量都应该采用Pascal规范命名,同方法名一样也应该能反映参数或者变量所代表的含义。这一点对参数方法而言特别重要,因为你在调用方法的时候智能感知(Intellisense)会返回参数名和参数类型。所有采用方法的开发人员都应该使用描述性的名字和类型,便于相互理解其含义。

控件
控件命名是开发领域一个经常引发争议的问题。虽然大多数人赞同不应该使用控件的默认名称,比如TextBox1或者Label1等等,但是,他们还反对按照变量的方式命名控件或者采用前缀表示控件的类型。我比较喜欢采用标准的三字母前缀命名窗体中控件的名字。比如说,保存姓氏和名字的文本框控件就不妨分别命名为txtLastName和txtFirstName。处理窗体数据的命令按钮则可以命名为cmdSubmit或者cmdCancel。其实,只要你能保证控件命名的一致性而且标准易于理解即可。

注释
注释代码对所有开发人员来说都是必要的。为了教授正确的注释技术,我就经常在自己的演示程序中添加注释代码。同时,为了简化注释过程,我建议开发人员首先编写注释说明他们想编写的程序。我首先会写注释说明程序中的过程、类或者其他程序要素,但对其具体工作原理不做阐述。然后我会编写一系列的注释代码描述过程的每一主要步骤或者类的元素。在编写了定义类或者说明过程的代码之后,我对各个外部变量、控件、打开的文件乃至其他过程所访问的元素文档化,对输入参数和返回值做简要说明。

如果你在使用C#开发程序,那么VS.NET环境已具有内置的工具帮助你把内部C# 注释转换为外部HTML文档。你可以在自己的文档中加上特殊的处理指示符而改变外部文档的表示方式。有关这方面的更多信息可以参考VS.NET内部帮助文件: ms-help://MS.VSCC/MS.MSDNVS/csref/html/vcoriXMLDocumentation.htm. 

PHP 相关文章推荐
PHP中的超全局变量
Oct 09 PHP
IIS+PHP+MySQL+Zend配置 (视频教程)
Dec 13 PHP
php遍历数组的方法分享
Mar 22 PHP
通过缓存数据库结果提高PHP性能的原理介绍
Sep 05 PHP
基于php下载文件的详解
Jun 02 PHP
使用session判断用户登录用户权限(超简单)
Jun 08 PHP
PHP基于phpqrcode生成带LOGO图像的二维码实例
Jul 10 PHP
php阿拉伯数字转中文人民币大写
Dec 21 PHP
PHP页面间传递值和保持值的方法
Aug 24 PHP
分享一个漂亮的php验证码类
Sep 29 PHP
PHP实现的各类hash算法长度及性能测试实例
Aug 27 PHP
php 后端实现JWT认证方法示例
Sep 04 PHP
php为什么选mysql作为数据库? Mysql 创建用户方法
Jul 02 #PHP
木翼下载系统中说明的PHP安全配置方法
Jun 16 #PHP
PHP 中的批处理的实现
Jun 14 #PHP
关于在php.ini中添加extension=php_mysqli.dll指令的说明
Jun 14 #PHP
用PHP实现维护文件代码
Jun 14 #PHP
用PHP实现的随机广告显示代码
Jun 14 #PHP
PHP生成月历代码
Jun 14 #PHP
You might like
php一个找二层目录的小东东
2012/08/02 PHP
php常见的魔术方法详解
2014/12/25 PHP
php empty 函数判断结果为空但实际值却为非空的原因解析
2018/05/28 PHP
php微信公众号开发之音乐信息
2018/10/20 PHP
PHPStorm2020.1永久激活及下载更新至2020(推荐)
2020/09/25 PHP
简单的代码实现jquery定时器
2013/11/17 Javascript
javascript删除字符串最后一个字符
2014/01/14 Javascript
简单的js图片轮换代码(js图片轮播)
2014/05/06 Javascript
使用正则表达式的格式化与高亮显示json字符串
2014/12/03 Javascript
Javascript基础教程之数据类型 (数值 Number)
2015/01/18 Javascript
JavaScript实现基于十进制的四舍五入实例
2015/07/17 Javascript
浅谈Javascript中substr和substring的区别
2015/09/30 Javascript
jQuery插件echarts实现的多折线图效果示例【附demo源码下载】
2017/03/04 Javascript
浅析bootstrap原理及优缺点
2017/03/19 Javascript
AngularJS实现根据不同条件显示不同控件
2017/04/20 Javascript
微信小程序滚动Tab实现左右可滑动切换
2017/08/17 Javascript
详解vue组件开发脚手架
2018/06/15 Javascript
详解单页面路由工程使用微信分享及二次分享解决方案
2019/02/22 Javascript
浅谈JavaScript_DOM学习篇_图片切换小案例
2019/03/19 Javascript
JavaScript鼠标悬停事件用法解析
2020/05/15 Javascript
python命令行参数sys.argv使用示例
2014/01/28 Python
使用python删除nginx缓存文件示例(python文件操作)
2014/03/26 Python
在Python中使用元类的教程
2015/04/28 Python
python2.7和NLTK安装详细教程
2018/09/19 Python
python的schedule定时任务模块二次封装方法
2019/02/19 Python
python socket通信编程实现文件上传代码实例
2019/12/14 Python
python 双循环遍历list 变量判断代码
2020/05/04 Python
python实现mean-shift聚类算法
2020/06/10 Python
Selenium关闭INFO:CONSOLE提示的解决
2020/12/07 Python
python实现文件+参数发送request的实例代码
2021/01/05 Python
HTML5 embed 标签使用方法介绍
2013/08/13 HTML / CSS
天猫超市:阿里巴巴打造的网上超市
2016/11/02 全球购物
美国标志性加大尺码时装品牌:Ashley Stewart
2016/12/15 全球购物
Microsoft Advertising美国:微软搜索广告
2019/05/01 全球购物
简单的大学生自我鉴定
2014/02/18 职场文书
2019年最新感恩节祝福语(28句)
2019/11/27 职场文书