PHP编码规范

php 规范

1.5.3. 项目的四个阶段  

1. 数据库结构  

2. 设计  

3. 数据层  

4. HTML层  

 

2. 命名规则  

 

2.1. 合适的命名 

 

命名是程序规划的核心。古人相信只要知道一个人真正的名字就会获得凌驾于那个人之上的不可思议的力量。只要你给事物想到正确的名字,就会给你以及后来的人带来比代码更 强的力量。别笑!  

名字就是事物在它所处的生态环境中一个长久而深远的结果。总的来说,只有了解系统的程序员才能为系统取出最合适的名字。如果所有的命名都与其自然相适合,则关系清晰, 含义可以推导得出,一般人的推想也能在意料之中。  

如果你发觉你的命名只有少量能和其对应事物相匹配的话, 最好还是重新好好再看看你的设计吧。  

 

2.2. 类命名  

 

· 在为类(class )命名前首先要知道它是什么。如果通过类名的提供的线索,你还是想不起这个类是什么的话,那么你的设计就还做的不够好。  

· 超过三个词组成的混合名是容易造成系统各个实体间的混淆,再看看你的设计,尝试使用(CRC Session card)看看该命名所对应的实体是否有着那么多的功用。  

· 对于派生类的命名应该避免带其父类名的诱惑,一个类的名字只与它自身有关,和它的父类叫什么无关。  

· 有时后缀名是有用的,例如:如果你的系统使用了代理(agent ),那么就把某个部件命名为“下载代理”(DownloadAgent)用以真正的传送信息。  

 

2.3. 方法和函数命名  

 

· 通常每个方法和函数都是执行一个动作的,所以对它们的命名应该清楚的说明它们是做什么的:用CheckForErrors()代替ErrorCheck(),用DumpDataToFile()代替DataFile()。 这么做也可以使功能和数据成为更可区分的物体。  

· 有时后缀名是有用的:  

o Max ‐ 含义为某实体所能赋予的最大值。  

o Cnt ‐ 一个运行中的计数变量的当前值。  

o Key ‐ 键值。  

例如:RetryMax 表示最多重试次数,RetryCnt 表示当前重试次数。  

· 有时前缀名是有用的:  

o Is ‐ 含义为问一个关于某样事物的问题。无论何时,当人们看到Is就会知道这是一个问题。  o Get ‐ 含义为取得一个数值。  

o Set ‐ 含义为设定一个数值  

你可能喜欢

  • PHP代码
  • php编码规范
  • PHP常用
  • 数据库规范
  • 网站架构分析
  • PHP教程
  • 淘宝开放平台

PHP编码规范相关文档

最新文档

返回顶部