浅谈PHP代码设计结构
http://www.edu-hb.com
2012-5-11 8:57:30 来源： 曾经的梦
coding 多年，各种代码日夜相伴，如何跟代码友好的相处，不光成为职业生涯的一种回应，也是编写者功力的直接显露。
如何看待程序和代码呢？
那就让我们从程序定义来谈起，
如果从业务最终呈现来看，一个程序可以看成是一个真实业务需求的逻辑代码映射。
如果从程序逻辑结构看，程序就是数据结构加算法的结合。
这样看，为满足更多的业务需求，更好的满足这些需求，就需要更多的程序代码，
当程序代码堆积达到一定数量后，如何管理好，整理好已有的代码将会成为一个只管重要的问题。这个也是一个程序员编程3~5后，从中级向更高级别探索的一个瓶颈。
满足需要可工作的代码是好的，可被多个需求不断复用的代码，就是更好的了。
随着软件设计的发展，代码的集合，功能逻辑不断向下沉淀封装的趋势越来越明确。
使用好一个工具很快，掌握好一种设计思想就要不断的尝试和改进了。
有专门处理数据的代码，有专门处理呈现的代码，如何在业务流程中管理配置他们？这些逻辑如何更好的被封装，被复用。
其实对于 PHPer 来说，这些思想在处理具体业务来说有些麻烦，这也是 PHP 的最大优势非常的自由方便，自由简单随意的基本语法，方便的连内存资源都不用考虑，很快就可以 hello 一个,
但这也正是 PHP 一个先天的重大劣势，没有一个系统的成脉络的设计体系，
PHP 出生时就是一个单一的（来自：湖北教育考试网www.edu-hb.com）满足业务的语言，并没有像 JAVA 一样有很系统设计体系和原则。在 JAVA 有三个最基础的设计原则：1，不支持全局变量。2，不写万能类。3，代码必须是类封装。
JAVA 的第一个，第三个原则是在语法上就限制了，第二个原则是评判一个 JAVA 程序员是否入门的标准。PHP 相对来说就没什么这样的语法上的设计原则限制，可接触了一些 big company 真没有体系原则呀，哎，
但在我们设计思想里可不能真的没有原则呀！
PHP 程序其实是怎么方便怎么来，解释器很强大，可以屏蔽包容各种思路的程序代码，只要语法 OK，不在乎代码设计。
正因早期的 PHP 太随意了，入门很容易，不用很好的对代码进行有效的管理和方便的复用。
随着 PHP 的发展，PHP 已经告别在 PHP3~PHP4时代动态标记语言，但因为向上兼容原则，PHP 还是一个语法宽松的语言，
系统化的程序设计原则还没有强制融入到语言核心中来。
这样并不代表我们不需要使用成熟的设计思想来完善和编写我们的程序代码。
JAVA 的程序设计原理和代码积累，是 JAVA 的精髓，随着时间的积累越发明显。
将 JAVA 的程序设计思想，引入到 PHP 的编程过程中来。是一个完善 PHP 代码的很好的方法。
1,代码分级封装
2,文件灵活调用加载，资源随用随创建
3,平整抗老化的目录结构
解决这些能为程序编写过程，带来非常多的益处。
如何解决呢？
可以通过对于 MVC 设计思想进行的拆解封装，来实现清晰，有效，一致性的程序设计思想。
一个程序从逻辑结构上可看做是模型(Model)，视图(View)和控制 Controller)三个逻辑块。
在 JAVA 中 Model 层实现系统中的业务逻辑，通常可以用 JavaBean 或 EJB 来实现。 View 层用于与用户的交互，通常用 JSP 来实现。Controller 层是 Model 与 View 之间沟通的桥梁，通常是 router servlet 向应用端的扩展。
可 PHP 没有这样清晰的划分，所以需要将设计思想揉入到程序代码中去。
1,程序代码类封装
对于一个应用需求（ex: similar 相似商品页)，将需求先分为 3 个文件：similar.controller.php;similar.model.php.similar.view.php
通过名字我们也可以看出各文件中的代码用途，剩下就是要给各个文件中的类进行命名。
因为是这对一个应用的不同操作类，所以需要给各个类加不同的类目后缀，
例如 similar.controller.php
similar{
functio do_opensearch (}
}
对应的请求就是
http://s.etao.com/similar/opensearch/
similar.model.php
similarMODEL{
}
similar.view.php
similarVIEW{
function view_getDetail ($_goodDataArr){
return $html;
}
}
2,类调用
我们很清晰的将各个逻辑将不同代码封装在了不同文件和类中了。如何灵活的调用呢？PHP 是一个解释语言，没有像 JAVA 和C一个的编译过程，无法享受编译语言，在预编译过程中的自动连接功能。
其实现在 PHP 解释器也已经意识到这个问题，并在5.3.1以后提出了 autoload 方法来解决，当解释器遇到一个非声明类或者函数时会自动运行 autoload 去再加载一次，如果还没有才报错。
详情参见 http://php.net/manual/en/language.oop5.autoload.php
但这样还是一个被动解决方案。下面提供一个主动动态加载方案。加入资源系统调动类
在讲解这（来自：湖北招生考试网www.edu-hb.com）个类的使用之前先看一下我们之前加载并使用一个类文件的过程：
文件:similar.controller.php
require_once PATH."similar.model.php";
$sModelObj = new similarMODEL;
$goodsData = $sModelObj->getGoodsInfoByNid ($nid);
这是在过程中调用，如果在 controller 类内调用的话就需要写成这样，
functio do_opensearch (= $this->_modelObj->getGoodsInfoByNid ($nid);
}
}//end class
如果 controller 类需要使用另一个 MODEL，例如 forest,ha3什么的就要声明多个类内元素变量。如果利用 PHP 的变量传导特性，建立一个资源调度类，来统一加载和调度需要的类并声明，使用起来就会方便很多。下面我们来详细的分解下这个资源调度类的设计
;
getObj (( = }
} }
self::_showErr (_createObj (_showErr (}
}//end class
改用 Box 资源调度类，加载类程序
文件:similar.controller.php
functio do_opensearch (= Box::getObj ('similar','model')->getGoodsInfoByNid (=
这样在一个响应进程内 “similar.model.php”; 文件只会被加载一次，similarMODEL 也只会被创建一次，
随使随调用。不用提前声明，不用考虑重复加载，重复创建。
Box 解决了类与类间资源的调用和创建。
那如何让一个 controller 类文件中的 function 运行呢？我们需要一个请求调度类 Bin。
之前我们的请求响应都市通过 websearch 的 io model 来完成。吧请求的 path 映射到实际文件中。
例如:
xxxx.taobao.com/similar/opensearch/index.php 或者是 xxx.etao.com/similar/opensearch.php 这样的文件，websearch 将 host 替换成实际文件系统的 path。
这样外部程序可以各种扫描我们的目录，一旦疏忽就会把一些常用方法暴露出来，ex:xxxx.taobao.com/tools/info.php 什么的，有风险隐患。
当然加一些过滤条件是可以屏蔽这样的问题，但会增减 webserver 的逻辑，一旦有改动就（来自：湖北教育网www.edu-hb.com）会改动 webserver 的 conf。麻烦。索性我们就 webserver 踏踏实实的做好 io 和 http 打包解包，
让 app server 来过滤和灵活配置请求调用。再 webserver 中将所有的访问都映射(rewitre)到 host/dispatch.php，由 Bin 类来实现调度和分配。实现应用逻辑单一入口调用结构。
dispatch.php 完成一个平台分配，性能监控，配置加载，应用启动，分类型输入(同步，异步，PC，mobile)，等平台级功能。
Bin 类就需要如下功能: 解析请求，将 webserver 传递的环境变量传递到响应的实际处理应用来完成分解，提出 similar 应用名称，opensearch 方法名称，
还有 GET,POST 请求参数，组装成请求参数数组，
$this->_paramArr = explode( '/', trim(strtok( urldecode($_SERVER["REQUEST_URI"]),'?'),'/'));
$this->_paramArr = array_merge($this->_paramArr,$_GET);
这样$this->_paramArr[0]就是 appname 应用名称
这样$this->_paramArr[1]就是 function 方法名称
平台流程就可以装载 appname.class.php 文件并执行 appname->do_function ($this->_paramArr);方法。
这样也支持/similar/opensearch/sort/这样的传参,sort 是$this->_paramArr[2]的一个参数
如果$this->_paramArr[0]等于 ajax 也就是对于的这是一个 js 发起的异步请求，
要装载的就是 appname.ajax.php,并执行 appnameAJAX->ajax_function ();
将同步和异步请求分文件。减少加载大文件对内存的占用。
同时也可以将可访问目录跟应用目录物理上分类，让扫描程序无用。
例如:
/home/website/host/ 这个目录只放 index.php 一个文件，和 css,js,images 一些没有加入 cdn 的呈现渲染文件。将 webserver 的 docmentroot 或者 laction 设置在这个目录
/home/website/app/ 这个目录来存放编写的类程序文件，配置，由/host/index.php 程序加载 app 目录下的类程序文件
一个应用好办，一堆应用我们怎么办呢？下面我们来说说多应用的目录结构。
3,目录结构 (抗衰老很重要)
PHP 的设计理念这是少又少，连个包的概念都没有。只好我们自己用目录来包装包概念。从访问结构，开发结构，部署结构上来分别介绍目录结构的作用.
3a.访问结构
将访问目录 host,和应用程序目录 app 可以看成是一个 website，这个 site 下面的应用可以这样的
可以这样建立
/website/host
/website/app/similaer
/website/app/cmp
/website/app/srp
/website/app/…..
假如管理工具也可以再 website 下同另起一个目录
/website/admin/firebox
/website/admin/seoAny
这样，所有的请求都会到/website/host/index.php 由 index.php 在根据请求规则，加载响应的逻辑程序。
跟/webiste/host 并行的有一个 system 目录，/website/system/，将 box.class.php,bin.class.php,base.class.php 等平台文件存放其中。
一个响应的执行流程就是
webserver query ->[ /website/host/index.php include /website/system/box,bin,base （应用架构）] 平台-> [ /website/app/ (应用流程) /website/admin/]页面
3b.开发结构
在开发和维护过程中，会有一些同样地 php 库文件，如 curl 通信，xml 解析,log,timer,template (appview)，等自己开发的类程序，也有像 smarty,big2gb 等第三方类库。
各个项目都通用，比价，主搜，我的一淘，那就可以统一建立一个 PHPLIBS 目录与 website 平级
/website/host/
/website/app/
/website/system/
/PHPlibs/etao/ 自己的类库
/PHPlibs/other/ 第三方类库
每一个 website 一个 svn
PHPlibs/独立一个 svn 专人维护，多快好省精深专
将 template 文件从 website/中分离出来建立一个
webtemplate/目录跟 ued 同学共享一个 svn, 让 ued 同学按前段 template 类的规则书写模板文件。按应用分目录存储。
如:
webtemplate/srp
webtemplate/cmp
webtemplate/opensearch
webtemplate/frame 统一呈现模板，页头尾
webtemplate/…..
website/app 中的程序通过 template 类方法来调用以上模板文件。
同时在开发和维护过程中也会遇到需要 shell 来执行的 php script ，如定时生成公共页头尾，定时取 mysql 库中的 epid 数据等。或者临时做一个算法的程序。
那我们就可以在
/website/app/的相关应用中加入 app.sh.php 程序文件，
如
/website/app/similar/similar.sh.php 这个文件的类程序 similarSH 是通过
/website/script/run.php 来执行的。 script/run.php 是一个 shell 端的控制器响应 CLI 请求，host/index.php 是一个 web 端的控制器响应 CGI 请求
还可以在 script/run.php 外包装一个 debug.bat 的文件，可已经在 dos,或者包装一个 debug.sh 程序再 shell 下直接交互调试。
具体参考代码（来自：湖北教育网www.edu-hb.com）
还有一些程序处理文件，如由 vm 文件转换成的 php 模板的公共页头尾文件，会有一个跟 website 平行的 webdata 文件，
/website/….
/webdata/pageframe 等目录中，在 app 中直接调用
3c.部署结构
通过上线脚本分别 checkout
/website/
/PHPlibs/
/webtemplate/ svn 资源库
然后打包 rpm，推送上线。
单独上线，也是使用上线脚本配置检查出相应文件，推送到前段生产机。
4,代码规范
关于代码格式规范，看之前大家也都积极的讨论了很久了。
代码格式规范，我们在 IDE 中配置一下，自动使用，并通过不断的 review 和提醒中培养好的书写易读代码的习惯就好了。
代码设计规范，是需要根据架构指定，并坚持执行的。
下面谈到代码设计都是基于刚刚谈到的，资源调用，请求分配来制定的。
4a,关于目录
//应用程序
/website/app/….
//对外访问目录
/website/host/index.php
/website/host/css
/website/host/js
/website/host/images
//平台系统文件
/website/host/images
//调试，维护脚本
/website/script/
//模板库对应/website/app/下的目录
/webtemplate/….
//程序类库
/PHPlibs/
//数据文件目录
/webdata
没什么好说的，大家体会。
4b,关于文件
文件的命名规范主要是指定内部调用，和请求调用
website/app/appname/appname.apptype.php
apptype: class,model,view,ajax,api,sh ，….
调用:
Box::getObj (appname,apptype)->function ();
appname.class.php 文件为 controller 文件，类中的方法做同步请求响应。
appname.ajax.php 文件也是 controller 文件，类中的方法做异步请求响应。
appname.sh.php 文件也是 controller 文件，类中的方法做 CLI 响应。
appname.api.php 文件可以看成是 controller 文件，类中的方法是对一个公共，或通用逻辑的封装，如获取图片完整路径。
4c,关于类和方法
类命名：
除 class 文件中的直接以 appname 命名，其他的类文件都是 appname+APPTYPE 命名，APPTYPE 需要大写。好做语法区分。
方法命名：
在方法声明中加前缀，说明方法的作用，如 view 类中的方法加 html_getSimilarList ()， model 方法中加入 db_getData ()从数据库取，file_getData ()从文件取,url_getData ()从引擎或者远端取
4d,关于变量和注释
类内变量， 参数入口变量加_前缀， 跟过程中使用的局部变量，加以区分，增加可读性。
方法注释
= DEFAULT_APP_NAME;
$this->_className = $appName;
$this->_appFile = APP_PATH . "{$appName}/{$appName}.controller.php";
$this->_method = empty($this->_paramArr[0]) ? DEFAULT_APP_METHOD : $this->_paramArr[0];
$this->_method = "do_{$this->_method}";
}
类结尾注释
class Bin{
}//end class
为主要过程，算法，加入注释，方便维护和阅读。
在上线前会通过上线脚本对文件进行 php -w 去注释过程，所以注释写的长不占用程序执行过程中的加载内存。
5,代码监测
专门的代码扫描脚本。
扫描/website/app/下的目录，文件，方法，注释量。
出报告，多少应用目录； 多少同步响应类；多少异步响应类；多少同步页面；多少异步接口；多少逻辑接口；多少 model 接口；多少模板；各个文件的代码注释率；等等。
基于以上设计思想建立了从文件夹-》分段类文件-》功能模块方法的树形结构设计程序架构，最大化实现 CAP 原则 consistency (一致性)，availability (可复用),Partition (有效划分)让 PHP 代码更好的积累。
模板(纯 html 文件，呈现配置)，程序数据配置文件是被加载到程序中，而不是现在将程序加载到 html 中一段段解释执行。
[责任编辑：Admin]
【】【】
