＋设为首页 ＋添加到收藏夹
介绍 【程序编程相关:学习java之路】
使用本标准,如果您想拷贝一份留做自用的话,那是完全免费的,这也是我们制作它的原因.假如您发现了任何的错误又或者是.有任何的改进,请您给笔者发一个email,以便笔者将它们合并到最新更新中去. 【推荐阅读:php中 被遗忘的函数】
标准化问题在某些方面上让每个人头痛,让人人都觉得大家处于同样的境地.这有助于让这些建 【扩展信息:如何不让google不漫游我的网站】标准化的重要性
议在许多的项目中不断演进,许多公司花费了许多星期逐子字逐句的进行争论.标准化不是特殊的个人风格,它对本地改良是完全开放的.优点
当一个项目尝试着遵守公用的标准时,会有以下好处: 程序员可以了解任何代码,弄清程序的状况 新人可以很快的适应环境 防止新接触php的人出于节省时间的需要,自创一套风格并养成终生的习惯 防止新接触php的人一次次的犯同样的错误 在一致的环境下,人们可以减少犯错的机会 程序员们有了一致的敌人 :-)缺点
现在轮到坏处了: 因为标准由一些不懂得php的人所制定,所以标准通常看上去很傻 因为标准跟我做的不一样,所以标准通常看上去很傻 标准降低了创造力 标准在长期互相合作的人群中是没有必要的 标准强迫太多的格式 总之人们忽视标准讨论
许多项目的经验能得出这样的结论:采用编程标准可以使项目更加顺利地完成.标准是成功的关
键么?当然不.但它们可以帮助我们,而且我们需要我们能得到的所有的帮助！老实说,对一个细节标准的大部分争论主要是源自自负思想.对一个合理的标准的很少决定能被说为是缺乏技术性的话,那只是口味的原因罢了.所以,要灵活的控制自负思想,记住,任何项目都取决于团队合作的努力.解释
惯例
在本文档中使用“要”字所指的是使用本规范的所有项目需要遵守规定的标准.使用“应该”一词的作用是指导项目定制项目细节规范.因为项目必须适当的包括 (include）,
排除(exclude)或定制（tailor）需求.使用“可以”一词的作用与“应该”类似,因为它指明了可选的需求.
标准实施
首先应该在开发小组的内部找出所有的最重要的元素,也许标准对你的状况还不够恰当.它可能已经概括了 重要的问题,也可能还有人对其中的某些问题表示强烈的反对.无论在什么情况下,只要最后顺利的话,人们将成熟的明白到这个标准是合理的,然后其他的程序员们也会发现它的合理性,并觉得带着一些保留去遵循这一标准是值得的.如果没有自愿的合作,可以制定需求:标准一定要经过代码的检验.如果没有检验的话,这个解决方案仅仅是一个建立在不精确的基础上的一大群可笑的人.认同观点
这行不通; 也许可行吧,但是它既不实用又无聊; 这是真的,而且我也告诉过你啊; 这个是我先想到的; 本来就应该这样. 如果您带着否定的成见而来看待事物的话,请您保持开放的思想.你仍可以做出它是废话的结论,但是做出结论的方法就是你必须要能够接受不同的思想.请您给自己一点时间去做到它.项目的四个阶段
数据库结构 设计 数据层 html层命名规则
合适的命名
命名是程序规划的核心.古人相信只要知道一个人真正的名字就会获得凌驾于那个人之上的不可思议的力
量.只要你给事物想到正确的名字,就会给你以及后来的人带来比代码更强的力量.别笑！名字就是事物在它所处的生态环境中一个长久而深远的结果.总的来说,只有了解系统的程序员才能为系统取出最合适的名字.如果所有的命名都与其自然相适合,则关系清晰,含义可以推导得出,一般人的推想也能在意料之中.如果你发觉你的命名只有少量能与其对应事物相匹配的话, 最好还是重新好好再看看你的设计吧.类命名
在为类（class ）命名前首先要知道它是什么.如果通过类名的提供的线索,你还是想不起这个类是什么 的话,那么你的设计就还做的不够好. 超过三个词组成的混合名是容易造成系统各个实体间的混淆,再看看你的设计,尝试使用（crc se-ssion card)看看该命名所对应的实体是否有着那么多的功用. 对于派生类的命名应该避免带其父类名的诱惑,一个类的名字只与它自身有关,与它的父类叫什么无关. 有时后缀名是有用的,例如:如果你的系统使用了代理（agent ）,那么就把某个部件命名为“下载代理”（downloadagent）用以真正的传送信息.方法与函数命名
通常每个方法与函数都是执行一个动作的,所以对它们的命名应该清楚的说明它们是做什么的:用checkforerrors()代替errorcheck(),用dumpdatatofile()代替datafile().这么做也可以使功能与数据成为更可区分的物体. 有时后缀名是有用的: max - 含义为某实体所能赋予的最大值. cnt - 一个运行中的计数变量的当前值. key - 键值.例如:retrymax 表示最多重试次数,retrycnt 表示当前重试次数.
有时前缀名是有用的: is - 含义为问一个关于某样事物的问题.无论何时,当人们看到is就会知道这是一个问题. get - 含义为取得一个数值. set - 含义为设定一个数值例如:ishitretrylimit.
缩写词不要全部使用大写字母
无论如何,当遇到以下情况,你可以用首字母大写其余字母小写来代替全部使用大写字母的方法来表示缩写词.使用: gethtmlstatistic. 不使用: gethtmlstatistic.理由
当命名含有缩略词时,人们似乎有着非常不同的直觉.统一规定是最好,这样一来,命名的含义就完全可以预知了.举个networkabckey的例子,注意c是应该是abc里面的c还是key里面的c,这个是很令人费解的.有些
人不在意这些,其他人却很讨厌这样.所以你会在不同的代码里看到不同的规则,使得你不知道怎么去叫它.例如
class fluidoz // 不要写成 fluidoz class gethtmlstatistic // 不要写成 gethtmlstatistic类命名
使用大写字母作为词的分隔,其他的字母均使用小写 名字的首字母使用大写 不要使用下划线(´_´)理由
根据很多的命名方式,大部分人认为这样是最好的方式.例如
class nameonetwo class name类库命名
目前命名空间正在越来越广泛的被采用,以避免不同厂商与团体类库间的类名冲突. 当尚未采用命名空间的时候,为了避免类名冲突,一般的做法是在类名前加上独特的前缀,两个字符就可以了,当然多用一些会更好.例如
john johnson的数据结构类库可以用jj做为前缀,如下: class jjlinklist { }方法命名
采用与类命名一致的规则理由
使用所有不同规则的大部分人发现这是最好的折衷办法.例如
class nameonetwo { function doit() {}; function handleerror() {}; }类属性命名
属性命名应该以字符‘m’为前缀. 前缀‘m’后采用于类命名一致的规则. ‘m’总是在名字的开头起修饰作用,就像以‘r’开头表示引用一样.理由
前缀´m´防止类属性与方法名发生任何冲突.你的方法名与属性名经常会很类似,特别是存取元素.例如
class nameonetwo { function varabc() {}; function errornumber() {}; var mvarabc; var merrornumber; var mrname; }方法中参数命名
第一个字符使用小写字母. 在首字符后的所有字都按照类命名规则首字符大写.理由
你可以随时知道那个变量对应那个变量. 你可以使用与类名相似的名称而不至于产生重名冲突.例如
class nameonetwo { function startyourengines( &$rsomeengine, &$ranotherengine); }变量命名
所有字母都使用小写 使用´_´作为每个词的分界.理由
通过这一途径,代码中变量的作用域是清晰的. 所有的变量在代码中都看起来不同,容易辨认.例如
function handleerror($errornumber) { $error = oserr(); $time_of_error = oserr->gettimeoferror; $error_processor = oserr->geterrorprocessor; }引用变量与函数返回引用
引用必须带‘r’前缀理由
使得类型不同的变量容易辨认 它可以确定哪个方法返回可更改对象,哪个方法返回不可更改对象.例如
... 下一页