其他实践
下面还有集中其他的实践习惯值得提及到的,也值得加入到你自己的编程习惯里面的。
UML
统一建模语言(UML)是一种与具体编程语言无关的用来描述面对对象编程观念的方法。关于UML的相关信息资料你可以从http://www.uml.org上找到。
UML涉及到很多方面,但对PHP程序员来说,其中最相关的两方面是类图和序列图。
类图描述了一个或者更多的类以及他们在你的程序之间的相互关系。(译者注:最好能够参考相关的UML教材,将有助于你的理解。)每个类都用一个盒子标识,每个盒子都分成三部分:第一部分是类名,第二步分列举了类的属性(变量),最后一部分列举了类的方法。属性和方法的可见度被设计为:+代表public(公开),—代表private(私有),#代表protected(受保护的)。
序列图描述了为一个特定的任务或者事件,你对代码中的对象之间的典型的交互活动。一个序列图主要传达这样的信息:谁,以什么样的顺序,在什么时候,调用不同的方法(由名字也可以看出:“序列图”)。序列图是对象集和开发人员之间交互沟通的非常有用工具。
在我自己的工程里,我使用这两种典型的类图来勾画我们的设计,但是很少能将他们格式化到项目文档里面。对象之间的关系经常随着你对系统理解的深化和用户需求的变化而改变,因此这些图表很快就会过时。这也就是说“一张图足足值一千个文字”。这些图表对新开发人员理解系统是非常由帮助的,也能做为使用你软件的开发人员的手册。
资源控制
“及时的、经常性的保存”是开发人员另外一个有用的格言。即使你是这个项目的唯一的开发人员,你也应该维持所有的资源处于控制下。
网上可以获取到很多关于资源控制的解决方法,其中两个出色:CVS(http://www.cvshome.org)和Subversion(http://subversion.tigris.org)。CVS是一个非常流行的用于解决PHP和Apache项目的工具。同时,Subversion也正在迅速的成为流行的二选一工具之一,因为它克服了CVS的一些不足之处(特别是在原语命令和删除/重命名文件夹或文件方面)。然而很少有项目安装Subversion服务器。
在工作的时候,我采用CVS,但这本书的代码都是使用Subversion来维护的。
资源代码文档
如果你浏览完了这本书的所有页面,你可以会注意到一些明显的格式化的注释块类似于:
/**
* funny multi-line comments
* @something what is this?
*/
它们被称为“docblocks”(译者注:文档块),是由程序,比如说phpDocumentor(http://phpdocu.sf.net),为你的PHP项目自动生成的应用程序接口(API)文档。
Docblocks(文档块)是特定格式的多行注释,以/**标识开始,接下来的每行都以*为第一个字符,并以*/标识注释终止。在每行的前缀前面允许有空格。
@something 代表一个“标签”(tag),当文档需要转化为解析格式时,标签用来阐明一些必要的信息。比如说标签@private,使用在php4中,常用来标识类的这个方法或者属性时私有的,因为在php4中时没有提供这种天然的能力的(译者注:在php4中时无法说明一个变量或者方法是否私有的)。
资源代码文档比如说docblocks即是一个有用的参考资料,也是开源项目的一个好广告。其中一个例子(我帮忙维护的)就是SimpleTestAPI文档(http://simpletest.org)。