编码规范（一）之文本标记

文本格式：

1. 文本标记

所有PHP文件，其代码标记均使用完整的PHP标签，不建议使用短标签，例如：

<span style="font-family:Microsoft YaHei;font-size:18px;"><?PHP
Echo ‘hello world!’;
?>
<?</span>

<span style="font-family:Microsoft YaHei;font-size:18px;"><span style="white-space:pre">	</span>//不建议使用
Echo ‘not suggest’;
?></span>

使用短标签格式容易和XML混淆，并且不是所有的PHP版本和服务器都默认支持或打开短标签选项。

对于只含有PHP代码的文件，将在文件结尾处忽略’?>’,这是为了防止多余空格或者其他字符影响到代码。

【提示】 这个问题会在不开启压缩和缓存时出现，可以在php.ini中设置。当一个目标文件中‘?>’后面有换行时，包含该目标的文件实际上会输出这个换行。这些换行会影响一些函数。比如session_start()前面不能有换行和空格。

2. 文件和目录命名

程序文件名和目录名均采用有意义的英文命名，不使用拼音和无意义的字母，只允许出现字母数字下划线和中画线字符。

包含类命名：

DemoTest.class.php

接口统一采用：

DemoTest.interface.php

3. 文件目录结构

在开发规范、独立的PHP项目时，使用规范的文件目录结构，有助于提高项目逻辑结构合理性，对于扩展和合作以及团队开发均有好处。

例如,通常如下：

——app //独立的应用

——class //单个类文件，公用的类文件

——conf/inc //配置文件目录

——data //数据文件目录

——doc //程序相关文档

——htdocs //document_root

——images //所有图片文件存放路径

——css //css文件

——js //js脚本文件

——lib //共用类库

——template //模板文件

——temp //临时文件

——upload //上传文件

——manage //后台管理文件存放目录