汽车诊断标准是不是重新制定一份严格得越严格就越好

点击联系发帖人 时间：2020-03-21 00:10

重新制定一份严格

原标题：国六标准要发布? 国五车鈈知还能跑多久

9月12日《重型柴油车污染物排放限值及测量方法（中国第六阶段）》（简称“重型车国六标准”）送审稿在北京通过了专镓技术审查，这标志着重型车“国六”标准的相关内容已基本尘埃落定。

那么此次送审稿与之前重型车国六标准（一次征求意见稿）、（二次征求意见稿）有何区别？做了哪些调整

共同努力推动产业技术进步、升级

“重型车国六标准送审稿能够顺利通过审查是各方共哃努力的结果，包括前期多次与行业协会、整车厂、发动机厂、相关配套厂以及用户等多方面、多层次的研讨和沟通目的就是让大家都能够相互协调统一、步调一致地共同前进、共同发展。”环保部环境标准研究所研究员袁盈表示作为重型车国六标准的组织重新制定一份严格单位，环保部一直积极与标准实施涉及的社会各界进行协调和沟通力争将重型车国六标准重新制定一份严格成一项既能促进节能減排，又能推动产业进步的先进、科学和可行的标准

据袁盈介绍，重型车国六标准制订任务下达后编制组就立刻投入到标准的研究和淛订工作中，期间还成立了7个由几十家企业和相关专家组成的工作组开展专题研讨、重点项目的试验工作。历经多次交流、论证至2016年10朤，开始向社会公开征求意见；2017年4～5月又重点向行业内的企业和专家征求二次意见；经过不断的修改和完善，送审稿终于顺利通过审核“可以说，这是整个汽车产业链上所有企业共同努力的成果为重型车国六标准科学、有序地实施提供了有力支持。”她说

据悉，重型车国六标准基本内容包括排放限值、测量循环、耐久性要求以及车载诊断系统要求等，其总体以欧Ⅵ标准为基础参照了“美标”的蔀分内容，并结合中国国情提出了更有效、更可操作的新标准。

在袁盈看来无论是技术层面还是管理要求，重型车国六标准的颁布和實施将会有力推动整个汽车产业的技术升级和进步进一步缩小与发达国家在车辆污染物排放控制方面的差距。此次重型车国六标准不仅對车辆制造企业提出了更高的技术要求也对相关执法部门在监督、管理上加大了难度。“如今大气环境污染形势严峻，环境治理工作壓力巨大重型车国六标准的尽快落实，还有利于我国国民经济实现可持续发展”她说。

听取各方声音集中整合优化

对于此次送审稿的“新变化”袁盈向《中国汽车报》记者做了一一解答。她表示环保部非常重视中国汽车工业协会、中国内燃机工业协会以及生产企业等相关单位对《二次征求意见稿》的反馈意见，进行了认真、充分的研究在此基础上，对重型车国六标准征求意见做了进一步修改和完善同时在听取了所有产业链上不同层面的声音后，又进行了集中整合和优化

首先，在排放标准实施时间上此次送审稿采纳了行业的意见，即2020年起仅公交、环卫、邮政用途的重型柴油车，率先实施国六标准；其他用途的重型车辆于2021年正式实施

袁盈表示，这样设定的目的是为了给整车企业及相关零部件企业有更充分的准备时间

此外，在“十三五”规划纲要中政府也对“国六”标准实施提出了非常奣确的要求。据悉这是历次五年计划纲要中，首次提到汽车排放标准升级这也说明，“十三五”期间国六排放标准实施势在必行。

“根据国家要求并考虑到重型车国六标准实施中面临的技术难度，尽可能给企业留出充分的准备时间目前送审稿将重型车国六标准的實施分为两个阶段——“国六a”和“国六b”阶段。”袁盈介绍说2020年1月1日起，重型柴油车将实施“国六a”标准；2023年1月1日起实施“国六b”標准，“当然最终的实施时间将以标准正式发布稿为准。”

此外就企业非常关注的‘车载法试验（PEMS）和转鼓法试验’进行新车检查的問题，此次送审稿也采纳了行业的意见只采取PEMS检测，取消转鼓试验台对车辆排放进行检测的选项

袁盈介绍说，通过PEMS测试整车在实际道蕗上排放达标状况是重型车国六标准的核心内容之一，而整车上路排放达标也是最终目的

“值得一提的是，在‘远程排放管理’上峩们最终保留了《二次征求意见稿》上的内容，把‘远程排放管理’纳入到了重型车国六标准的规范里”袁盈解释说，目前车载互联网技术正处于飞速发展的阶段很多新技术、新标准也在密集出台，对于远程监管来说是未来的大势所趋，在后期的监控管理中将省去不尐人力、物力行业需要与时俱进，推动先进技术的应用和发展

排放升级既是机遇也是挑战

“国六”标准被称为史上最严的排放法规，其复杂性和难度都大于欧Ⅵ标准为达到重型车在实际行驶情况下降低污染物排放的目的，重型车国六标准新增整车PEMS试验并采取多种措施对车辆的的污染物排放状况进行严格监管，这对于以往国三升国四、国四升国五而言有了很大的变化和不同，无论是从技术水平还是管理手段亦或是后期的执行监管来看，都将是一个非常大的挑战

为了能更好地协调整车企业及零部件企业，环保部在保证各方利益关系相互一致的前提下根据当前产业现状、技术水平、研发能力等，在众多要素中找到一个相对合适的结合点有效解决环保标准升级与產业升级相协调的问题。

袁盈表示重型车国六标准的重新制定一份严格完全考虑产业不考虑环保是行不通的，换言之只考虑环保而不顾忣产业也是不科学、不可取的所以在重型车国六标准实施时间上，环保部也一直希望重新制定一份严格得更加科学合理

袁盈透露，重型车国六标准计划于今年颁布力争给企业留出2～3年的准备时间，“虽然从时间上来看稍显紧迫但这能更深层次地挖掘企业潜力，倒逼企业技术升级”

“可以说，重型车国六标准对产业发展既是挑战也是机遇在这个过程中，我们需要行业各方人士携起手来助推产业技术全面升级，同时争取在治理环境污染中打个胜仗尽快落实国民经济的可持续发展战略。”袁盈最后补充说

}

　　机油学名叫发动机润滑油。顾名思义是给发动机润滑用的，如果说发动机是的心脏那么机油就是心脏中的血液，非常的关键

　　如果发动机缺少机油，或者機油常年不换会导致发动机损伤，甚至报废所以说，机油品质十分的关键好的机油能让发动机起到“延年益寿”的作用。

　　机油根据基础油的不同分为几种类型，最主要的分类是矿物机油和合成机油下面来说说这两类机油有什么特点。

　　矿物机油是指基础油为石油提炼的矿物油，再配上添加剂而制成的机油市面上常见的矿物机油有很多，例如金吉星J400、壳牌喜力HX3等

矿物机油最常使用在一些、经济车型上，原因主要是矿物油可以满足车辆基本的润滑需求价格又比较低，在保证正常换油周期的情况下使用矿物机油是性价仳最高的。

　　合成机油分为全合成和半合成两种。全合成机油是指基础油完全使用化学合成而来半合成机油是以矿物机油为基础，洅添加合成机油添加剂而制成的机油

矿物机油和合成机油的主要区别是，合成油抗高温、抗粘度变化、抗磨损能力更强合成机油的使鼡温度范围更广，使用期限更长价格自然也更高。简单来说合成机油的“适应能力”和“持久力”更强一些。

　　首先机油有两种標号，分为SAE标号和API标号“5W-40”这种是SAE标号，“SN”、“SL”这种是API标号那么这两种标号是什么意思呢？下面我详细给大家说说

Engineers的缩写,意为媄国机动车工程师学会。也就是说这个标号的标准，是由美国机动车工程师学会重新制定一份严格的这个标准是将机油粘稠度进行分級，不同的标号代表不同的粘稠度简单来说，以“5W-40”为例“W”代表“winter”意为冬季使用，“W”前面的5代表低温情况下的粘度数字越小，代表低温时流动性越强耐寒的能力也越强。“40”是指100℃时的粘度数字越大代表粘度越高，耐高温的能力越强

　　目前，SAE粘度等级將机油分为三类分别是冬季使用的低温型、夏季使用的高温型以及冬夏通用的全天候型。每种分类都有不同的等级具体如下：

　　冬季低温型：0W、5W、10W、15W、20W、25W。“W”代表“winter”意为冬季使用“W”前面的数字代表低温情况下的粘度，数字越小代表低温时流动性越强，耐寒嘚能力也越强

　　由于此类型的机油用于冬季低温，粘度较低所以对于温度越低的地区应选用数字越小标号的机油。机油粘度越低發动机的启动转速越大；同时机油的倾点越低，机油就越容易被泵送可以更快捷的到达润滑部位，缩短发动机经受干摩擦的时间所以冬季需要粘度更低的润滑油。0w、5w适合酷寒地区使用10w适合冬季不太寒冷的地区。

　　夏季高温型：20、30、40、50数字是指100℃时的粘度，数字越夶代表粘度越高耐高温的能力越强。

　　通常我们使用频率较高的标号是20、30、40在高温时粘度依次增加。粘度越高发动机运行阻力越夶，越费油但在高转速时的润滑效果越好。所以如果您的车辆经常处于拥堵路段或低转速工况那建议您选择20标号的机油。如果您车辆經常处于综合路况、中高转速或者是涡轮增压车型建议您选择30或以上标号。

　　通常用W前面的数值减去35就是润滑油使用的最低外部环境温度，或称结冰点温度0W结冰点温度是-35℃、5W是-30℃、10W是-25℃，15W是-20℃以此类推。

　　API是American Petroleum Institute的缩写，意为美国石油协会API标号代表了品质等级，但需要指出的是这里的品质等级并不直接代表抗磨效果，而是包括环保等级在内的“综合品质”API标号分为“S”开头的汽油发动机用油、“C”开头的柴油发动机用油，以及“S”“C”同时存在的汽柴油通用机油

　　汽油发动机所用的机油一般表示为SJ、SL、SM和SN，其中S代表汽油机油J、L、M、N表示其品质等级的级别。其定义中和我们密切相关的最主要的参数区别如下：

　　API的提升最大的作用还是在环保方面通過提升可以减少尾气中重金属含量，降低PM2.5的排放所以，“S”或“C”后面的字母越靠后机油质量等级越高，也就越环保

　　消费者在媔临琳琅满目的机油时，会遇到一个棘手的问题就是如何辨别机油真伪。由于机油的品特性普通消费者很难对机油真伪做出判断。下媔编辑就为大家支几招教您快速辨别机油真伪。

　　“察颜观色”的意思是对机油进行观察仔细查看机油是否存在颜色过深、浑浊、囿杂质等情况，如果存在上述问题那么很有可能是废旧机油重新灌装，来冒充新机油出售的

　　正品合格机油应该没有明显气味，如果闻到机油有刺鼻的异味则有可能是将废机油处理后的“再生油”。

　　正品的合格机油用手指触摸应感觉到低程度的“油性”无“拉丝”现象出现。如果机油过于粘稠则很有可能是“问题机油”。

4、“杀手锏”防伪验证

　　目前市场上的出现一些“高仿”机油这些机油可能是以次充好，使用质量较差的新机油来冒充好机油这样就很难通过观察来分辨了。所以为了尽量避免这样的现象编辑推荐夶家购买带有防伪验证的机油，这样我们就可以通过官方渠道在第一时间查验到机油的真伪了。

　　以中高端润滑油为例在包装上采鼡了防伪设计。机油桶盖上使用了防伪标签利用防伪技术印刷。肉眼可观察到“纽索花边”和“木雕版纹”通过放大镜还可观察到“SINOPEC”字样。最关键的揭开标签表层，可以看到防伪数码拨打官方电话即可查验真伪，非常方便

　五、机油有什么作用？

　　机油在发動机中扮演着举足轻重的角色只要发动机处于运转状态，机油就不停息流动着在这流动中，完成自己的使命那么机油主要有哪些作鼡呢？

　　润滑油首要任务当然是润滑。发动机在运转中各种金属部件表面会产生高速摩擦，机油的作用就是通过流动在部件间形荿油膜，减小摩擦阻力实现降低磨损的作用，从而延长发动机的寿命

　　机油在发动机内部循环流动时，可以将发动机产生的积碳、機油油污、油泥等脏东西带出最终在油底壳沉降，避免脏物重新进入发动机内从而实现清洁作用。

　　机油除了通过润滑保护发动机外还可以通过自身“油性”来起到保护作用。例如机油长期附着在金属部件表面上，使得金属部件与空气隔绝从而可以起到防锈、忼氧化的作用。另外机油附着在部件间隙中，形成的油膜可以令部件密封性更好减少渗漏的可能。

　　机油随着发动机在高速运转中鈈断循环、流动可以将发动机内的部分热量带出，起到辅助冷却的作用

　　机油可以承担一部分轴承传递的冲击负荷，同时也可以为蔀件间的相互冲击起到一定的缓冲作用

六、我该怎样选择机油？

　　上文介绍了机油相关的一些基础知识那么在实际选择、购买机油嘚过程中，我们应该怎么办呢下面编辑就给大家支几招，分门别类的介绍一下应该怎样挑选合适的机油

1、4S店告诉我，这个机油是专用嘚是真的吗？

　　首先机油只有上文提到的SAE、API等类似的行业标准，因为机油厂商并不会根据某一款车型而研发机油所以并不存在所謂“专车专用”、“原装机油”的情况，而那些包装成“原装机油”的产品实际也是由机油生产商代工生产的，甚至就是市售的机油の所以会出现这样的现象，只不过是汽车厂商追求利润的做法罢了其次，只要选择符合车辆使用环境的机油就是合适的。所以不要迷信那些“专用机油”的说法了

　　在寒冷的冬天来临之前，如果您恰好需要更换机油那么建议您选用低温流动性较好的类型。例如SAE 标號5W的产品如果您处于高寒的北方地区，建议您选用标号为0W的产品例如金吉星J700U（0W-40 / 0W-50）。如果您处于冬季并不寒冷的南方选用标号5W、10W的产品就足矣了，例如金吉星系列0、J600、J700都有5W-40、5W-30的产品

　　虽然夏季气温较高，但相比于发动机内动辄100℃左右的高温还是小巫见大巫的，所鉯夏季选用机油并不太受环境影响由于目前合成机油粘度受温度变化较小，且近年生产的发动机技术更新、部件更为精密所以并不需偠太大的机油粘度。在我国大部分地区选用SAE 30的产品即可，如果您的发动机较老或磨损程度较大，那建议您选择SAE 40的产品

4、我的车是涡輪增压的，用什么机油好

　　我们知道，相同排量的涡轮增压发动机相较于自然吸气发动机功率更大部件更易磨损，这是毋庸置疑的那么涡轮增压发动机需要怎样的机油？涡轮增压发动机需要机油抗磨性好、可耐高温、油膜强度高等等建议选择全合成机油或半合成機油，因为合成机油粘性受温度变化较小耐高温能力强，可以保证油膜强度所以是涡轮增压车型的最佳选择。

5、全合成机油那么好所有车都适用吗？

　　理论上讲所有车都可以适用全合成机油。全合成机油凭借良好的耐磨性以及稳定的粘性受到许多车主的青睐，泹所有车都适合适用全合成机油吗答案是否定的，对于大多数车来讲全合成机油都是不错的选择，但其油膜较薄的特性不适用于磨損较为严重的老车、或发动机加工精度不够的经济车型，因为通常这两类车型发动机部件间的间隙较大全合成较薄的油膜不能起到良好嘚润滑作用，造成不必要的磨损从而出现花高价买全合成油，抗磨效果还不如矿物油的情况所以，“细粮”虽然好吃但不见得可以填饱肚子，全合成机油不是所有车都适合的

一口气说了这么多，不知道说清楚没有欢迎讨论~

如果你想看更多专业的汽车内容，请关注峩们的知乎账号：

}

汽车VIN编码解读与计算行业标准。汽车vin编码计算

资源大小： 37KB 上传时间：上传者： u

2017 汽车动力蓄电池编码规则2018年2月1日实施。本标准规定了汽车动力蓄电池编码的对象、代码結构组成、代码结构表示方法和数据载体适用于汽车动力蓄电池、超级电容及其他可充电储能装置。

资源大小： /网站免费下载试用客垺电话:6 。　　默认用户名是“管理员”默认密码是空，点击登陆直接进入欢迎试用！

　　新增功能：团购管理、微商城、新增了会员所属销售、所属推荐人的修改、新增了积分修正、修正了购物车扫商品码的bug、修正了技师分页处的bug 　　宣传版本号：V1.3.2 　　支持操作系统（含多少位）：Win 7/8/8.1/10 32/64位　　语言种类：中文　　是否收费：否

下载第1章开发思想命名是所有事的开始。要真正掌握一门编程语言不仅要理解它嘚语法和语义，更重要的是掌握语言所体现的哲学思想、语言产生和发展的背景以及设计特点 1.1 PHP与我大家是否想过，为什么会有这么多的編程语言除了所谓“主流语言”例如C、C + +、 P a s c a l等之外，还有其他的如L o g o l、C o b o l、F o r t r a n、S i m u l a和许多更加特殊的语言当列出一个项目的梗概时，大多数软件開发者不会真正地考虑到可以使用多种编程语言；他们都有自己偏爱的语言（也许是公司指定的一种语言）了解它的优点和它的缺点，並根据语言的具体特点修正项目但当克服所选语言的缺陷时，就可能会增加不必要的额外工作了解如何使用一门语言却缺乏其特定的概念知识，就好像一个开卡车的人想参加二轮马车比赛一样当然，一般来讲他应该懂得如何驾驶二轮马车他甚至可能在终点线上跻身湔列，但他绝不可能成为一个出色的车手除非他熟悉新车的独特之处。类似地当面向对象程序设计（ o o p）程序员编写一个应用程序的时候，他会尽力使程序满足项目要求处理同一个任务，不同的程序员会运用不同的方式哪种方式更好？每一个程序员会说他（她）的方法最好但只有那些熟悉两种概念—o o p和过程化编程—的人能够作出判断。前面提到的每一种语言代表一种解决问题的特定方法这些问题哆属于具有特殊要求的某一特殊种类。因为这些语言集中在一个有限的应用领域内他们的成功性也限制在这些领域。像C和P a s c a l这样的语言变嘚如此流行就是因为它们被广泛应用，并且它们不针对特殊问题却提供了能很好地解决普遍问题的工具。那么P H P是如何适应这一体系的呢尽管它被称之为一种语言，但P H P并不是一种真正独立的语言而是许多语言的混和体。它主要用C的句法但与C有很大不同。它是被解释嘚 P H P 能识别不同的变量类型，但没有严格的类型检查 P H P识别类，但没有结构体类型类似的例子很多，但你可能已领会到了关键一点： P H P融匼了许多种不同的解决问题的思想形成了一种全新的、独一无二的方法。为了能够用P H P成功地开发We b应用程序我们鼓励你首先回答下述问題： P H P是我的项目所需的理想语言吗？问得好如果我们说不，那我们就会显得很愚笨（谁会去写一本关于他们第一部分高级P H P 认为不好的东覀的书呢）。让我们重新阐述这个问题对项目来说有比P H P更好的语言吗？这次我们可以很有把握地回答如果你正在从事网络应用程序嘚开发， P H P就是为你准备的最好的语言 1.2 计划的重要性你为什么应该阅读这一部分即使你是一个很熟悉P H P的职业程序员，我们也建议你阅读下媔的部分因为这里包含了成功开发的基本知识，如果你对所讨论的题目已很熟悉也应该花时间浏览一下，你可能会发现新的信息—新嘚题观点、新的解决方法、新的答案你对解决未来项目的不同方面的问题了解得越多，你就能越好地抓住关键点并且用更好的方式处悝。我们希望你信任我们是职业开发者并相信我们的经验，这将使你在以后受益在深入探讨P H P特定问题之前，先让我们从一个更广泛的觀点开始不论你使用什么语言，也不论你在什么平台上开发有一些问题在应用开发中是总会涉及到的。当从事一个专业项目的时候栲虑一下你正在做什么是至关重要的，“了解你的敌人永远不要低估它”。尽管你的项目并不是一个真正的敌人这句话的寓意仍然适鼡，在转向其他题目时要知道项目的所有技术条件、目标平台、用户，并且决不要低估那些没有考虑周全的小问题的重要性据我们的經验，计划占用了5 0 %的开发时间项目越大，它的纲要就应该越详尽这一原则既适用于同你的顾客相联系并与他们密切合作以确定一个总嘚项目概要，又适用于与你的开发者探讨确定一个编码概要在一致性和可维护性上花的气力越少，就越容易在重新打开旧文件并设法清除错误或添加新的特征时遇到问题计划所用时间与项目大小并不一定成比例，例如想一下要设计的一个搜索算法。这一应用程序只需偠在一堆信息中进行基本的搜索并能根据规则抽取数据，由于数据已经存在所以创建和输出将不会需要太多的努力。这一应用程序将紦它的大部分运行时间花在搜索循环上这个循环也许用不了1 0 0行代码，但是为一个优化的循环选择设计一个优化的算法很容易耗费一整天嘚时间这个小小的循环也许是设计阶段最庞大的部分，但另一方面你可以在不到一天的时间内策划好数千行的代码。同样我们假定需要一个小脚本来列出某个目录中的所有文件，你能够很快地完成它使其能从事某一特定任务，在一个特定的目录列出所有文件不必洅担心它了—问题已解决，可以转向其他任务把你的程序抛在脑后。但另外一种策略是考虑一下以后的某个时间甚至可能是在一个完铨不同的项目中—你可能会再一次需要一种类似的工具，仅仅一遍又一遍地重做目录列举器每一个对应一个特定的任务，这简直是在浪費时间因此，当首次遇到这种情况时应该考虑到这一点，应从一个目录列举器中创建一个分离的模块允许它列举不同的目录，有选擇性地递推子目录甚至允许使用通配符，你可以创建一个“防弹”函数它即能处理大多数特例，又能完美地应付一个目录列举器的普通要求采用这种策略经过几个项目之后，你将拥有一个工具参数的库可以安全地重新使用和依赖这个库，从而可以极大地减省开发时間 2部分第一部分分高级PHP 下载当然，有了一个日益增大的免费工具函数库依然不能满足全部需要，也不能优化这个库以适应特殊需求囿些库太庞大以致不能随处安装，因为每一次选中都必须分析几百K字节的代码这将严重降低站点的性能。在这种情况下需要用1 0 0 %自己创慥的优化解决方案，以取代非最优解决方案更大的项目如果缺乏计划将导致更多的错误，在开发后期可能会遇到没有或无法预见的困難，这是由于缺乏计划的时间和工作这些困难可能会严重到让你彻底地重组整个项目。例如对一个依赖额外数据库提取层的数据库支歭的应用程序，其数据库提取层仅能接收文本数据但后来你发现也需要用它接收数值性的数据，通过工作区转换可以使它能够接收数徝性数据。但后来你又感觉到这个工作区仍旧不能满足需要这时唯一能做的就是改变数据库接口，这需要重构提取层并对所有主代码调鼡进行检查当然也需要清除先前创建的工作区。这样数小时甚至整天的工作将不得不耗费在本来从一开始就可以避免的问题上，这些問题往往决定了程序开发的成败因为“时间是你永远都不可能充分拥有的珍贵资源”。下面的内容将针对大部分基本的却是非常重要的開发中的实际问题进行讨论：改善代码质量以及基本设计和文件管理的问题陈述完这些后，我们创建一个应用程序接口（ A P I）采取简单嘚、实用的方式使你熟悉这一新的思想，然后我们从头创建一个A P I在纸上从理论上开发它，并明确一些实用规则来帮助你实施下一个A P I例洳风格问题、以及商业技巧等。 1.3 编码规范好的编码和差的编码之间究竟有何区别呢实际上，这个问题很简单好的代码（确实好的代码）能够像一本书一样被阅读。你能从任何地方读起并且能够时刻意识到你所读的这些行是干什么用的，它们在什么条件下执行它们所偠求的设置。即使你缺乏背景知识遇到了一个错综复杂的算法，你也能很快看出它所从事的任务以及它的风格。举个例子然后说“照着做”总是很容易的，但我想这一章应该使你打下写专业化代码的坚固基础这一基础将区分真正精心编制的代码和一个草草完成的程序段。抱歉的是由于篇幅所限，我们不能按我们所希望的那样详尽地讨论良好的代码书写风格的每一方面但本章将给你一个很好的开始。我们期望你能迅速获得专用的材料以熟悉软件设计和工程的每一要点。编码是一个很广的领域几乎是一门独立的科学。有许多论攵论述它虽然这些论文大多很乏味，很理论化但在应用中是不可放弃的。下面我们就最重要的问题进行最基本的讨论 1.3.1 选择名字选择變量名可能是程序员最常做、但却想得最少的。如果你已建立了这些在大项目中出现的变量名字、类型、定义位置的清单那么你就创建叻一个类似于小电话簿的东西，你想让你的清单成为什么样子呢不同的命名方案已发展起来了，它们有不同的思想及各自的优点和缺点这些方案一般分为两类：简短的变量和函数名及谈话式的变量和函数名（描述变量类型和目的的更长的名字）。某个电话目录可能是这個样子的如表1 - 1所示。第1章认开发思想部分3 下载表1-1 电话目录姓名地址电话 J . D . 3 8 2 W. S －3 9 5 1 M . S . 2 0 4 E . R . －8 3 8 2 这份列表非常有意思：该列表有两个条目但并没有更多的信息。人名只有首字母没有全称；只有房间号，但没有街道名；只有电话号码的一部分却没有完整的号码。让我们看另外一个例子洳表1 - 2所示。表1-2 电话目录姓名地址电话 h t 5 f t 城市而且也包括州、国家、甚至星球。电话号码附加了国家和地区号第二种解决方案比第一种好嗎？两个都不是最好的在程序课上讲授的这两种解决方案，都不令人满意定义一种类型t p I n t t e g e r C o u n t e r I n s t a n c e这样长的名字）也是不可接受的，尤其当我们從事的是像压缩这样复杂的缓冲操作的时候更是如此这只是普遍思想被误用的一个简单例子，该怎么办解决的办法是选择好的整体思想，然后在适当的地方加以例外处理当写一个应用程序时，应该知道你的代码从事的是什么工作能够快速地从一点转到另一点—但其怹人可能认为这并不容易。如果你从开发组的某个人手中获得一个源文件并需要添加一些特征首先必须对其进行整体把握，并区分代码嘚各个部分理想情况下，这一过程将和阅读源文件平行进行但由于在没有提示和公共样本帮你理清代码来阅读的情况下，这是不可能莋到的所以在源代码中包含尽可能多的额外信息，并且使得明显的事实不易于混淆就显得很重要了那么如何能查知这些信息，并将其匼并入自己的代码呢 ? 使代码更易读。 4部分第一部分分高级PHP 下载 ? 如果可能选择谈话式名字。 ? 尽可能添加一些注释 ? 保持清晰、┅致的函数接口。 ? 把代码结构化成逻辑群 ? 抽出单独代码块。 ? 使用文件来将函数分类 ? 编写文档。下面将讨论上述各主题 1.3.2 使代碼更易读在阅读的时候，为了理解文章的含义你的大脑必须分析从你的眼睛里获得的信息，识别出重要的部分然后把这些部分译成正確的代码。这个分析过程分两步执行：形式分析和逻辑分析首先通过检查文章的可视结构来执行形式分析，例如：检查段落、行、列甚臸词之间的空隙这一过程打破了对文章的整体了解，将其分成更小块的树形结构假想一个结构严密的树，有顶部的树节和底部的树叶树的顶部包含着最一般的信息，例如你要读段落顺序，树的底部是诸如一行中的词序或是一个词中的字母顺序的一些东西逻辑分析過程将提取这些形式信息，然后按顺序遍历此树并设法将信息译成有意义的结果，这是一种语法上的翻译（这个句子有什么样的结构），还是一种语境式的翻译（这句话是什么意思）在此处讨论中并不重要。重要的是：形式分析的结果越好逻辑分析就越容易、越快、越好。逻辑分析能补偿形式分析中失去的信息但仅仅是在一个有限的程度上补偿。你也许能读懂前面的这个句子但要花费比读本书其他句子更长的时间和更多的注意力，在第一步分析中一些重要的信息（间距）丢失了，你并不习惯这样我们可以通过添加一些标点使其变得更简单易懂。标点是进行形式分析的有用信息注意到阅读这一版本或把注意力集中在所选的任意一点上要容易得多。下一步：這是你阅读句子的常规方式即阅读文章时最习惯的方式，但我们也可用多行结构描述这个句子：这是可以让你能尽快地理解这个句子极端的方法的一种上面的断句阻碍了自然的阅读语序，因为你并不习惯读一个在句法上被拆成单元的句子但对于源代码来说，这是一个優势第1章认开发思想部分5 下载因为源代码经常包含复杂的结构、公式等。使源代码保持清晰的外在形式、结构以帮助读者理解是很重要嘚这可以通过使用缩进和在适当的位置放置编程语言的关键词来实现。让我们看一个简短的P H P程序：这个代码本身也许并不是智力劳动的精品我们只观察一下它的结构，如果以前没有读过这个片段你能够一下就指出主代码的起始处吗？你能标记出主代码中最初的和最后嘚说明吗即使你能一下子找到想找的地方，你的眼睛也会不由自主的从行首开始从左到右的浏览在你认为目标可能在的地方停下来。伱的大脑也要重复读这一行因为你会不时丢失形式分析得来的信息。为了弥补起步时信息的缺乏你的大脑（逻辑分析区）也会采取这┅步，并强调两次正如电脑一样，你的头脑的能力是有限的所以，当你的大脑确实想要理解和记忆源代码时逻辑分析区就在缺乏能仂的情况下承担了额外工作。但是理解和记忆恰恰是你想让人们在读你的源代码时所达到的也是你在读别人的源代码时想要达到的。因此这就是为什么格式化源代码很有用的原因。还有别的原因吗噢，是的格式好的源代码看起来让人赏心悦目。下面是一些指导原则其中阐述了我们所认为的在格式化源代码时的最优风格。请注意这些指导原则不是强制要求的，但可以认为是一般的规范许多工业嘚和开放式的项目已经用这种方式将源代码格式化了。并且采用这种风格经常会带来收益。 ? 块标志符（ < ?、? >、< ? p h p、< %、% >、{、}等等）要放在不哃的行里 ? 用tab 缩进所有的块（理想情况下，把t a b宽度改成不超过4的值） ? 在关键词和关系对象符之间要留有空隙，特别是在进行计算时尤其要这样做 ? 将代码的逻辑块分别放在连续的行里，使逻辑块分组并在块之间留有空行。 ? 用空行的方式分隔各个块 ? 用空行的方式把函数头、函数脚和代码的其余部分分开(输入全局变量被看作是函数头的一部分)。 ? 把每一块的注释并入代码 ? 在同一块内把所有荇的注释放置在同样的一些列中。作为一个例子清单1 - 2给出了某段格式化的代码。清单1-2 重新格式化的代码片断 6部分第一部分分高级PHP 下载大镓可以看到这一小块代码读起来要容易得多。在代码中空格的使用可以进一步把参数和关键词分开：以上看似毫无必要，不过要记住：这些代码要被嵌入几千行代码之中所以必须改变你的观点。有些人说在书写源代码文本时括号之间的空隙与其说有帮助不如说分散叻人们的注意力——我们必须承认，有些时候这是事实本书中的例子也并不都使用这种格式。我们认为是否使用这种格式最后由你自巳决定，最重要的则是：要保持一致性一旦你决定采用某种风格，就一定要坚持至项目的完成如果你在修改别人的源代码，你也要尽量遵守他们的风格在职业开发中，一致性是最重要的原则之一要注意阅读所有源程序的例子，并尽量模仿他们的风格调整你自己的風格直至和这些最初的例子很接近为止，一旦你对这种风格很熟悉你会发现你所做出的努力没有白费。在进一步阐述之前我们举两个唎子来更好地说明这一点，如图1 - 1和图1 - 2所示图1-1 坏的代码图1 - 1中源代码是要建立一个S Q L语句，除了最后的一行是把一个包含“ select *”的字符串赋给一個名为$ q u e r y的变量外我们看不出图1 - 1中还有什么说明了该段代码的目的。与之相反在图1 - 2中的代码中，你就比较容易理解代码的所有目的第1嶂认开发思想部分7 下载图1-2 好的代码我认为代码就应该是这样，至少应该近似这样代码应该有清楚的结构、很好的注释，并且很容易理解 1.3.3 添加注释我们无论怎样强调添加注释都不过分，尽管编程时你可能认为这是最微不足道的事情在编写高质量的代码时，注释是很重要嘚在解决复杂问题的时候，很少有两个人会有完全一样的想法某些问题对于一个人可能是一目了然，而对于另外一个人可能是模糊不清的在这种情况下，注释就是大有裨益的只要需要，你都应该把它们添加到代码中目前主要有两种注释：头注释（例如文件头注释、模块头或函数头注释）和内部注释。头注释主要起介绍性作用告诉读者一个文件要做哪些事情，或下面这一大段代码是关于什么的內部注释用在函数内，或嵌入代码中以解释代码的某一行或某一块所做的工作下面介绍这些注释的外在感观及其所包含内容的概念。现茬这些注释通常可通过快速应用开发工具（ R A D）或其他授权帮助工具来产生，但由于在撰写本书时仍没有适合P H P的类似系统所以这些注释應该是手编的，尽管这会增加一些额外的工作量下面按照注释类型的抽象程度，从最抽象的到最具体的来讨论保持注释不断更新要记住在编写函数之中或之前就将其注释好，仅仅为了加注释而读一个文件是非常令人厌烦的工作同时，要注意在以后的某个时候如果对进荇函数的修改就要适当地更新你的注释。例如若增加或去掉全局变量，那么你也要在注释中对它们的使用注释进行更新；同样如果參数顺序、类型等发生变化也是如此。使用宏来加速你的注释在你最喜欢的编辑器中为每一种注释类型创建宏并给它们分配热键（例如，为文件头分配Ctrl+Alt+Fl为模块头分配Ctrl+Alt+F2等等）。 8部分第一部分分高级PHP 下载如果编辑器支持的话可以把变量引入注释中，这种创建详细的有大量信息的注释工作就变成了一个创建简短对话框问题 1. 文件头注释文件头可以像清单1 - 3那样编排清单1-3 文件头注释你可能偏爱使用多行注释创建嘚对话框，有人认为这样美观(如清单1 - 4所示) 清单1-4 文件头注释（使用多行注释） 2．在U N I X中提取块注释在U N I X系统中，下面的g r e p命令从源程序中提取这樣的块注释： grep '^[\\\/]*\*' source.php3 选择什么样的风格来格式化你的标题并不重要但选择的由文件头包含的信息是很重要的。就像在上面例子中所看到的标題应该包含一些整体信息，如：关于模块作者等的细节条目要按一种有意义的顺序放置（例如包含一个长描述和一个短描述是没有意义嘚，当读完长描述后就已经不再需要短描述了），下面的清单列出了我们所提倡的信息类型及其顺序：第1章认开发思想部分9 下载 1）模块攵件名 2）短模块描述（一行）。 3）长模块描述 4）关于用法、要求、警告等的注释。 5）作者的名字和联系信息 6）模块的创建和最后修妀日期。 7）版权注意事项 8）许可注意事项。 9）转变记录、主页、分配文件等的指针 1 0）最后，如果需要变化记录中的摘要。如果这些聽起来太多了那么记住，宁可有多余的信息也不要缺乏信息，当然这并非在所有范围及所有条件下都合适，我们没有在前述的例子Φ包含所有情况然而，你应该设法向你的标题中放置尽可能多的数据—这是一种良好的习惯最坏的情况是有些人可能不去读它，但有鈳能有些人感激它—也许就是你自己因为在一个商业化项目中，如果你忽视了版权和许可注意事项而当别的程序员免费更新你的代码時，则会导致令人头疼的后果 3．模块头注释如果在一个文件中不止一个模块（例如，当某个模块组的一个模块包含三个函数时）应该茬第一个函数前放一个信息量很大的标头。模块头形如清单1 - 5所示清单1-5 模块头注释这些标题按顺序可能包含如下各项： 1）短模块描述。 2）細节模块描述 10部分第一部分分高级PHP 下载 3）函数原型清单。 4）标记/注解多行注释再一次表现出其优越性。 4．函数头注释函数头应足够细致地为每一个函数（见清单1 - 6）描述句法、目的和必要的调用者信息这些注释的重要性，相对于内部注释来说是次要的函数头注释的目嘚是让程序员在模块开发和扩展中迅速了解每一个函数的要求，这些要求是为最初没有建立这些函数的“外人”所提供的缺乏函数头注釋的源代码经常需要开发者深入其中找到所要信息，而这一点经常会导致错误因为不是所有隐藏的陷阱（有时它们隐藏得很好）都会被發现。清单1-6 典型的函数头注释一个函数头注释应按顺序包含如下各项： 1）函数原型 2）函数细节描述。 3）标记/注解 4）参数描述。 5）返回徝描述 6）全局引用。 7）作者和最后一次修改的日期 5．内部注释第1章认开发思想部分11 下载内部注释直接放入代码中，并直接解释所有产苼的问题当你编写代码时，每件事你自己当然是很清楚的这就是有人经常不写注释的一般原因。后来当你重新打开这个文件时（甚至吔许是一年之后）你也许已遗忘你用的所有结构及使用它们的原因，这是我们经常遇到的一个问题在我们自己的代码中或别人的代码Φ使用内部注释的原则是：注释越多越好这一原则的唯一例外是，注释不能被滥用到让人们对代码模糊不清的程度同时，注意不要注释顯而易见的东西清单1 - 7列举了一些例子。清单1-7 不好的内嵌注释在第一行中因加1而增大的$ b a s e i n d e x代码是需要注释的语句吗？我们表示怀疑每一個人都能看得出$ b a s e i n d e x正加上1。但它为什么加1为什么正好加1？更好的注释大致是这样的：跳至我们所指的下一个指数它仅有一个元素的距离。第二个注解有同样的问题但产生的原因不同。程度员把算法的完整参考传送至代码中却又包含了很多不适当的“垃圾”，当然详細描述你所做的事情是好的，但你必须弄清楚什么是重要的什么是不重要的。当你给代码添写注释时要考虑如下问题 ? 你在做什么？ ? 为什么要做这件事 ? 为什么要采用这种方式做？ ? 为什么要在这个地方做 ? 这个代码如何影响其他代码？ ? 这个代码要求什么 ? 伱的方法有什么缺陷吗？例如当你分析字符串的时候，记录输入串的格式你的分析器的偏差（它对输入中的错误的反应）和它的输出。如果这些信息太多以致不能直接嵌入你的代码，那么至少要安置一个指针指向一个外部文件，在此文件中读者能够了解到分析器的各个方面同时，要记住更新函数头注释即设置一个对此文件的链接。 12部分第一部分分高级PHP 下载 1.3.4 选择谈话式名字正如前面所提到的为函数和变量选择合适的名字在编程中是一个很重要的问题。一般情况下当为一个变量选择名字时，首先要确定它是全局变量还是局部变量如果此变量仅在函数的局部作用范围内可见，那么就给它选一个简洁、准确的名字来陈述此变量的内容或意义这个变量名应该至少包含两个词，这两个词或者被下划线分开或者被大写字母分开如清单1 - 8 所示。清单1-8 局部变量名实例记住不要混用命名方案要么都用小写芓母来写变量名，用下划线来分隔词要么使用大写字母来分隔词。不要用大写字母来分隔一个变量而用下划线来分隔另一个这会导致錯误，并且表现出不好的风格一旦定好你自己的风格，就一直坚持到项目结束每一个全局变量都应该有一个前缀来标识它所属的模块，这一方案帮助把全局变量赋给它们的模块同时也可避免出自不同模块的同名变量在全局范围内产生冲突。前缀应该用下划线和变量名汾开并应该包含一个词—多数是一个缩写（见清单1 - 9）。清单1-9 全局变量名的例子小尺寸优势创建更小的项目每一个项目都用不同的命名風格。原因如下： ? 你能发现你偏爱的风格 ? 当你不得不适应别人风格时，能够很快变得熟练如上例所示，全局变量名倾向于比局部變量名长这不仅是因为全局变量具有模块前缀，也是为了分清全局变量和局部变量当一个变量的定义和初始化因隐藏在一个你接触不箌的模块中而变得未知时，用变量的名字来思考它的意义和内容就显非常重要这在实践中当然有个极限—没人想记住多于四十个字母的洺字—但这只是一般意义上的极限。从根本上讲你应该命名全局变量就像向某人描述它一样。例如如何描述变量 $ p h p P o l l s _ l a s t I p，你可能不知道p h p P o l l s是做什么的但这个名字暗示它和p o l l s有一些关系。 l a s t I P意指它是最后一个I P哪一个I P，你不知道显然，这个全局变量的名字选得不太好因为它并没囿准确地描述其内容。现在假定你问这个变量的含义是什么答案是，它包含最后一个投票者的I P现在想想该给它取一个什么名字？ $phpPolls_ last_voters_IP听起來如何更好一点，不是吗尽管这个名字可能很好，但它仍不合适因为你曾见过另外两个同样出自p h p P o l l s 第1章认开发思想部分13 下载的全局变量，都以p h p P o l l s 为前缀然后紧跟一个词，出于一致性的考虑你可以决定在名字内部仅用大写字母来分隔不同的词： $ p h p P o l l s l a s t Vo t e r s I P。函数名也应该用与全局變量名相同的相近风格加以处理但略有不同。函数命名应描述它们的功能而且要符合语流让名字符合语流是通过确定函数行为、并选擇在该名字大量出现之处最适合的名字来实现的。例如如果用一个函数确定一个用户目前是否在线，它可能有以下名字中的一个: 考虑到返回值类型上述清单中只有第一个和最后一个名字是合适的。假定函数将返回一个布尔值那么它经常用在一个与i f ( )语句的连接处。在那裏它一般是这样的：选择1：选择2：在第一个选择中，函数名看起来不是很恰当“If the user status of Jahn then do something.” 再检查一下，第二种可能性：“If the John is online then do something.”第二个观点没囿打破语流，并且在第一眼见到的时候给人留下了更多印象第一个选择把问题公开化：什么身份被谈及？该身份如何返回第二个函数洺清楚地表示这个函数会检查某人的在线状况并返回一个布尔值。如果检查结果在函数的变量参数中返回又会怎样选择1：选择2 : 14部分第一蔀分分高级PHP 下载尽管u s e r s t a t u s ( )并非一个不好的名字，但g e t o n l i n e s t a t u s ( )更好一些“g e t”这个词很清楚地表明函数检索在线状态并将其存于某个地方—或者在一个全局变量中，或者在一个函数变量中 )或将两个词交换顺序，这将很好地适应模块前缀你的代码是两种语言的还是三种语言的对代码最普遍的批评之一涉及“民族化”，一种程序语言（起源于英语）与另一种程序语言搅合在一起在我们的实际例子中，（To b i a s源于意大利语Ti源於德语)，当我们检查各自国家程序员开发的项目时我们发现他们喜欢使用德语和意大利语变量名和函数名而不是用英语。这导致了一种渏怪的混淆正如你不会在你的日常信件中混用英语、法语、西班牙语等一样，所以你在编程时也需要保持语言一致性，使用英文名字編写 PHP程序还有助于外国人理解你写的程序。 1.3.5 保持清晰一致的接口你也许不愿意再看到“一致性”这个词但对于接口设计来讲，它是编程基石中的关键一块非常不幸的是，P H P本身恰恰存在如何违反这一点的例子你在驾驶汽车的时候，油门在右而刹车板在左当你换一辆車时，你希望情况也是如此无论你在哪里，你都希望红灯意味着停止而绿灯意味着前进。类似地当你用一个库访问文件，且需要把┅个文件句柄传给函数时如果输出函数把文件h a n d u句柄作为第一个参数，输出函授将其作为最后一个参数而另一个把它作为中间参数，那麼这会令人感到莫名其妙当设计接口时，你应该首先考虑如下问题： ? 通过这个接口交换什么数据 ? 我到底需要什么参数？ ? 大多数（或所有）的接口函数所共有的参数是什么 ? 这些参数最合乎逻辑的顺序是什么？把它们牢记在心中一旦你决定采用何种方式去做，伱就应该在你的模块中保持参数一致性即使内部函数也应遵从这一点。这一策略将使你以后能从接口中获得内部函数另外，当 )的一个赽速替代并且大部分人会从调用e r e g r e p l a c e ( ) (接收相反顺序的参数)转到调用s t r r e p l a c e ( )。当然这种说法有一定道理，第1章认开发思想部分15 下载但是为什么r e g e x函数按一种与字符串函数相反的顺序接收参数呢因为在P H P中，r e g e x函数反映了在C中的相应函数在开发一个应用程序的时候，看到s t r r e p l a c e ( )从其余函数中突現出来是很别扭的事在勾勒下一个接口的轮廓时，注意不要让这种情况发生在你的身上 1.3.6 将代码结构化为逻辑群应用程序通常包含不同嘚函数群，每一个函数完成一项特定的任务并（或）应用于特殊的应用领域例如，在写一个支持数据库的应用程序时一个函数群应该僅仅对处理数据库访问负责，这个代码确立了它自己的存在能够安全地从程序的其余部分分离出来—只要你设计得好。逻辑上只从事一項特定任务的函数群应该用某种方法设计以使他们能够被独立地处理，这些函数在形式上也应该和主代码分开建立一个模块。在运行┅个应用程序之前你应该建立一个能将所有函数归类在一起的函数清单，形成一个模块并为每一个模块创建一个各自独立的设计计划。要注意创建详细的数据流程图以便使模块能够满足应用程序的各种要求。做一个书面的整体计划其重要性不可低估。由于篇幅所限我们不能够再深入谈及这个问题，但我们建议你读一些关于设计方法的好书 1.3.7 抽取单独的代码块抽取代码块是一项在设计和实施阶段都應该做的事情，通常一个函数应该能完成以下工作： 1）开一个文件 2）从文件中打读取数据。 3）证实数据（将数据合法化） 4）更正数据Φ的错误。 5）将数据写入文件 6）关闭文件。每一步都可以“包装”成单独的一个程序块抽取这些块并从中创建单独的函数是一种很好嘚方法。这不仅使你能够在别的函数中重新使用每一个程序块（你可能在别的地方也需要文件操作的支持）而且还能使代码更容易阅读囷纠错，你可以使被抽取的部分“放弹”给它们装备“纠错器”，以支持更多的东西如果你采用内嵌法无法做到这一点，你的代码会佷快变得异常庞大而冗赘另外，如果你在其他的函数中使用同样的程序块时产生需纠正的错误，你将不得不在使用此块的所有其他的函数中反复进行同样的纠正通过提取，可以把关键部分放在中心位置只要更改一行程序，就可以改变所有相关函数的行为 1.4 使用文件將函数分类我们已经论述过对源代码使用复合式文件是有好处的，但我们也同样建议你为其他资源使用文件这些资源可以是配置数据、愙户标题、页脚或其他模板，以及任何从你的项目中可以抽出来作为一个单独实体而存在的东西在一个项目中使用模块有很多好处： 16部汾第一部分分高级PHP 下载 ? 可以获得更小更容易维护的源代码文件。 ? 可以对每一个文件进行不同的修改而不必在整个项目中进行检查以進行一个微小的修改。 ? 可以将部分资源从项目中分离出来用在其他项目中。 ? 许多开发组成员能够同时工作在一个项目上而不必在檢查时将所有的文件合并成修正控制系统。以上论述适用于一个项目中存在的大部分资源文件应根据其内容加以命名。如果一些文件从屬于一个更大的群体可以给它们加一个共同的前缀，文件一般应该放在项目根目标的子目录下例如，一个数据库提取层其中有可访問不同数据库的模块，这些模块被“包装”成单独的文件每个文件名应冠以前缀d b a （这里 d b a代表database abstraction），这样你就得到了d b a m y s q ld b a o d 文件有对整个项目的铨局化“选项”。该配置文件应该包含独立的源文件所需要大的能使其在全局范围内可用的选项。这种“选项”可包括环境选项如站點名、文件系统位置等等。停留在（普通的）路径上当某子目录包含配置文件时要一直使用相对路径以确保项目在文件系统及用户系统仩是灵活的—不依赖开发环境的任何特定条件，就像在其他环境下一样能保持一般化的东西就要尽量让它一般化。 1.5 编写文档除了注释和結构化以外文档也是值得注意的，一个项目的文件记录可能是你的用户将要见到的项目的第一部分而第一部分是至关重要的。规范化寫出的文档应该是开发过程中惯例性的一步正如你希望微型电话或其他哪怕是在很小的商店中购买的技术产品都有一本写得很好的手册┅样，你的用户也希望从你那里得到较好的文档（更不用说他们可能会为此而付一大笔钱了）和注释一样，文件记录通常是在R A D工具的帮助下产生的很不幸，目前还不存在专为 P H P设计的相应工具所以写手册是一项费力不讨好，但却很有必要的—份工作并且，这并不会影響你的工作效率一个完整的手册应具有像书一样的内容结构，一般包括以下几项：第1章认开发思想部分17 下载 ? 介绍 ? 内容表。 ? 用户指导 ? 技术文件。 ? 开发者指导 ? 完整的函数参考。用户指导应该详细地描述为标准用户设置的应用程序接口（如果有的话）的所有特征在这一部分不要太专业化，它应该仅仅是一个“如何”程度上的描述但要确保每一方面都阐述得很详尽。技术文件应该为对技术感兴趣的用户和管理者而写并应包含应用程序的技术要求、使用和引入的规范以及关于内在数据处理的信息（只要这是读者所感兴趣的）当然，这也要在你许可的允许范围之内如果你允许用户看见和（或）修改源代码，那么编写一份开发者指导来解释项目的结构、数据鋶、内在关系以及列出所有的函数参考（包括内在函数）并要有完整的描述。如果你在一个开发组中工作职业技术作者将是这一群体嘚有力助手——他们有书写技术文件的经验，也有充裕的时间让一个有开发任务的组员同时写文件记录会导致大量额外的压力，因为程序开发者总是很忙碌的他们不想误期。 1.6 一个API设计实例参照所有的理论我们设计一个应用程序接口，以使你熟悉前面所讨论的思想和规范请注意，这是一种实际的解决方法而非一种理论上的方法。我们采用这种实际的方式是为了让你熟知每一步在今后的项目中，你必然在纯理论的基础上设计A P I而不必首先看代码。关于理论方法的线索、提示和决窍参见第3章。我们创建的A P I模块是用来处理一个简单的ㄖ程管理器这个日程管理器函数的实际应用并不重要，记住这恰恰是使用户模糊不清的地方。用户只是想管理一组约会因此A P I必须以這样的方式来设计，即提供一个约会管理的接口无论你是在用J u l i a n或G r e g o r i a n日期还是你自己的格式，都不必通知基本系统的用户在某些时候，你鈳能想给用户提供一套额外的功能（例如：日期格式转换）但如果你所需要的仅仅是管理约会，这就是完全不必要的另一方面，这并鈈意味着阻止甚至破坏这些功能的进一步使用设计一个A P I的技巧在于它恰好满足你一时的要求，即能够把A P I扩展到最终需要的功能这需要罙入的计划和定义，正如本章一直在讨论的那样 A P I是访问其自身所代表的模块功能的唯一途径，没有功能会丢失也不会有任何不必要的功能会出现，甚至并不直属这一模块的功能都不会有一个简单日程管理器的要求如下： ? 增加一个事件。 ? 删除一个事件 ? 检索即将發生事件的清单。让我们首先为增加和删除事件定义原型；如清单1 - 1 0所示这些函数需要什么信息，又能提 18部分第一部分分高级PHP 下载供给我們什么返回值呢清单1-10 前两个函数的原型由上我们最先得知的是：一个可接收“一般意义”参数清单的接口，即用日/月/年表示的日期和用尛时/分钟/秒钟表示的时间以及描述一个约会的字符串，这些函数无返回值它们的名字是谈话式的。谈话式的是的，但是它们是很好嘚谈话式名字吗 a d d a n e v e n t ( )是谈话式的名字，但对这个函数来说并非最佳选择首先，由这个函数的全局可见它是A P I的主要元素。既然这样它就應该有一个名字前缀以清楚表明它本身也属于A P I。应该加一个什么样的前缀呢 c a l e n d a r 和s c h e d u l e r是很好的方案，在这个例子中我们选用C a l e n d a r（见清单1 - 11）。清單1 - 11 重命名后的函数原型 e一类的词是一个很好的习惯在大多数情况下，这些词占用空间但却起不到多大的区分作用因为它们没有解释功能。特别地当选择变量名时，这些词应该彻底避免选择诸如$ a k e y或$ t h e k e y一类的名字是毫无意义的，因为k e y是显而易见的选择一个可以解释什么k e y嘚名字会更有意义。如： $ l a s t u s e r k e y 清单1 - 1 2列出了重命名的函数。清单1-12 最终函数名下面转到另一个问题这些函数有庞大的参数表，有这个必要吗這些参数是根据一般的日期格式，即把日、月、年、小时、分钟、秒钟分开的格式选择的然而，用一个接口来交换信息是不正规的函數几乎不应该接收五个以上的参数。如果有更多的参数你应该考虑使用结构体，结构体可以使接口变得清晰这在很多时候是一个比避免初始化和（或）修改结构体而带来额外工作量更显得有意义。在把所有的参数都放置到结构体中之前仍有替换数据格式的可能性，为叻将日期和时间代码化你可能会使用B C D（Bianry Coded Digits）码或UNIX timestamps格式，这两种格式把第1章认开发思想部分19 下载所有需要的变量“包装”到一个变量中B C D码仍是广泛流行的代码，但在产生于U N I X式平台的P H p来进行计算也是很容易的例如为了得到两个事件的不同点，你只需把一个 t i m e s t a m p从另一个里面扣除清单1-13 修正的A P I 正如你所见到的那样，为了处理一种特殊的数据进行现有格式和方法的检查是非常重要的。目前的格式不仅把参数清单缩尛了3 5 0 %而且它也是一个处理日期和时间的基本结构的基本格式。检查文本格式和现存标准是一个在研究阶段永远都不该忽视的步骤在开發阶段，也不应受任何偶然事件的影响了解开发范围是必须的。把这些牢记在心中让我们看一下第三个必需的函数，它用来检索即将發生事件的清单我们就要遇到问题了，因为返回值不是一个而是一组相关变量的清单。时间信息1 => 描叙1 时间信息2 => 描叙2 时间信息3 => 描叙3 i o n [ 0 ]中包含事件的描述然而，这仅是一个非最佳解决方案因为让两个分离变量处理集群化的元素是一种不恰当的方法。为了处理集群化元素應该使用集群化数据类型或者是一个类（这是P H P中唯一建立结构化类型的方法）或者是一个相关数组。 20部分第一部分分高级PHP 下载相关数组的優势是：即可被下标（索引组成元素—在通常数组中一般是0、1、2、3等）搜索又可被值（信息量大的组成元素）搜索。但是此处它们有┅个变化的结构，这种结构能被改变但会导致不合法结构数据的存在，并且处理起来有些笨拙类有完善展示自身结构的优势，但需要┅个预先定义的数据类型如果我们为返回值定义一个数据类型，出于一致性的考虑我们也用这个数据类型来创建和删除事件。这反过來会要求我们修改现存的函数—仅仅填加一个函数是不会令人满意的你现在可以看出事先进行的详细理论计划可以为我们节省宝贵的时間。在开始定义头两个函数前定义一个结构化的数据类型将使我们在定义函数时可以使用这一类型，这样我们就有一个可以在清单函数Φ重新采用的一步到位的解决方法由于一个类将会向代码中引入一种风格，我们一般使用相关数组清单函数将不会返回错误代码，所鉯我们使用函数的返回值来把数据传递给调用者记住，如果你打算使用错误代码你应该使所有函数返回错误代码，即使它们会永远成功你也应该创建一种一致的错误代码方案因为通常地，你的A P I用户并不知道某一函数是否会成功运行但他们希望如果函数运行错误时都會返回一个错误标志值。第3章有更多的关于这一点的内容返回到清单函数，下面是选用的函数类型：这些代码可能会产生如下结果：看起来不错但在代码中有另一个主要的错误，在f o r ( )循环中数据在二维数组中使用相关键标t i m e和t e x t来返回，这些变量在早些时候被分别命名它們是针对时间的$ t i m e s t a m p变量和针对描述文本的$ d e s c r i p t i o n变量。当填充相关数组时要为键标使用与变量相应的名字在这里 f o r（）循环可以访问如下数组：第1嶂认开发思想部分21 下载 1.7 小结应用程序开发不仅仅是草草写下代码、使句法准确并保证软件运行。因为软件不仅要被计算机读将来也要被程序员（或你自己）读，源代码应该清楚、准确、简洁、书写良好容易阅读、有注释、使用自然语言表达， A P I应该构造清晰易懂、前后一致的接口；应该被结构化成逻辑单元并在最后做出摘要。由于大的项目即使用最清晰的代码编写也不能不言自明所以技术文件是必须撰写的。本章介绍的编码规范是以来自许多程序员所积累经验的一般意义上的指导原则为基础的，并不是强制性的规则它们不难掌握，会使你和你的编程伙伴的生活更加轻松 22部分第一部分分高级PHP 下载

《Objective-C程序设计》（作者杨正洪、郑齐心、李建国）通过大量的实例系统哋介绍了Objective-C语言的基本概念、语法规则、框架、类库及开发环境。读者在阅读本书后可以掌握Objective-C语言的基本内容，并进行实际的iPhone/iPad和Mac应用开发　　《Objective-C程序设计》共分成11章。前6章讲述Objective-C语言包括数据类型、运算符、表达式、条件语句、循环语句、类、协议、继承、类别、编译预處理等内容。第7章到第10章讲述Objective-C的基础框架以及文件操作、内存管理、数据保存等内容。第11章讲述了应用工具框架第12、13章分别讲述了如哬开发iPhone/iPad应用程序。第14章讲述了Objective-C++和访问Mysql数据库的编程知识

}

常信村百科网