PHP最佳实践

admin

今天下午，我在读下面这篇文章。
                                                                                                                虽然名字叫《PHP最佳实践》，但是它主要谈的不是编程规则，而是PHP应用程序的合理架构。
它提供了一种逻辑和数据分离的架构模式，属于MVC模式的一种实践。我觉得，这是很有参考价值的学习资料，类似的文章网上并不多，所以一边学习，一边就把它翻译了出来。
根据自己的理解，我总结了它的MVC模式的实现方式（详细解释见译文）：

　　*  视图层（View）：前端网页；
　　* 逻辑层（Controller）：先是页逻辑（Page Controller），负责处理页面请求；然后，调用业务逻辑（Business Controller），实现具体功能；
　　*  数据层（Model）：数据保存在数据库之中，上面有一个数据库抽象层，再上面则是一个"数据访问对象"（DAO），它生成"值对象"（Value Object）。业务逻辑通过DAO，操作值对象。

=======================================
PHP最佳实践
原载：http://www.odi.ch/prog/design/php/guide.php
译者：阮一峰

本文给出了PHP程序设计常见问题的解决方法，同时简单描述了PHP应用程序的架构。
1. php.ini设置
php.ini控制了解释器的行为，下面的一些设置保证了你的程序有最大的可移植性。
i. short_open_tag
设为0，即永远使用PHP的长标签形式：，不用短标签形式。
ii. asp_tags
设为0，不使用ASP标签。
iii. magic_quotes_gpc
建议在脚本中包含一个全局文件，负责在读取$_GET、$_POST、$_COOKIE变量之前，首先检查这个设置是否打开，如果打开了，这对这些变量应用stripslashes函数。（注：该设置已经在PHP 5.3中被废除。）
iv. register_globals
不要依赖这个设置，永远通过全局变量$_GET、$_POST、$_COOKIE去读取GET、POST和COOKIE的值。为了方便起见，建议声明$PHP_SELF = $_SERVER['PHP_SELF']。
v. file_uploads
上传文件的最大大小，由下面的设置决定：

　　*  file_uploads必须设为1（默认值），表示允许上传。
　　*  memory_limit必须略大于post_max_size和upload_max_filesize。
　　*  post_max_size和upload_max_filesize要足够大，能满足上传的需要。

2.  配置文件（configuration file）
你应该把与应用程序相关的所有配置，写在一个文件里。这样你就能很方便地适应开发环境的变化。配置文件通常包含以下信息：数据库参数、email地址、各类选项、debug和logging输出开关、应用程序常数。
3. 名称空间（namespace）
选择类和函数名的时候，必须很小心，避免出现重名。尽可能不要在类以外，放置全局性函数，类对内部的属性和方法，相当于有一层名称空间保护。如果你确实有必要声明全局性函数，那么使用一个前缀，比如dao_factory()、 db_getConnection()、text_parseDate()等等。
4. 数据库抽象层
PHP不提供数据库操作的通用函数，每种数据库都有一套自己的函数。你不应该直接使用这些函数，否则一旦改用其他数据库（比如从MySQL 转为Oracle），你就有大麻烦了。而且，数据库抽象层通常比系统本身的数据库函数，更易用一些。
5. "值对象"（Value Object, VO）
值对象（VO）在形式上，就像C语言的struct结构。它是一个只包含属性、不包含任何方法（或只包含很少方法）的类。一个值对象，就对应一个实体。它的属性，通常应该与数据库的字段名保持相同。此外，还应该有一个ID属性。

　　class Person {
　　　　var $id, $first_name, $last_name, $email;
　　}

6. 数据访问对象（Data Access Object, DAO）
数据访问对象（DAO）的作用，主要是将数据库访问与其他代码相隔离。DAO应该是可以叠加（stacked）的，这样就有利于将来你再添加数据库缓存。每一个值对象的类，都应该有自己的DAO。

　　class PersonDAO {
　　　　var $conn;
　　　　function PersonDAO(&$conn) {
　　　　　　$this->conn =& $conn;
　　　　}
　　　　function save(&$vo) {
　　　　　　if ($v->id == 0) {
　　　　　　　　$this->insert($vo);
　　　　　　} else {
　　　　　　　　$this->update($vo);
　　　　　　}
　　　　}

　　　　function get($id) {
　　　　　　#execute select statement
　　　　　　#create new vo and call getFromResult
　　　　　　#return vo
　　　　}
　　　　function delete(&$vo) {
　　　　　　#execute delete statement
　　　　　　#set id on vo to 0
　　　　}
　　　　#-- private functions
　　　　function getFromResult(&vo, $result) {
　　　　　　#fill vo from the database result set
　　　　}
　　　　function update(&$vo) {
　　　　　　#execute update statement here
　　　　}
　　　　function insert(&$vo) {
　　　　　　#generate id (from Oracle sequence or automatically)
　　　　　　#insert record into db
　　　　　　#set id on vo
　　　　}
　　}

DAO通常应该部署以下方法：

　　*  save：插入或更新一条记录
　　*  get：取出一条记录
　　*  delete：删除一条记录

你可以根据自己的需要，添加其他DAO方法，常见的例子有isUsed()、getTop($n)、find($criteria)。
但是，所有的DAO方法都应该与数据库操作有关，不应该执行其他操作。DAO只应该对一张表进行基本的select / insert / update，不应该包含业务逻辑。举例来说，PersonDAO就不应该包含向某人发送Email的代码。
你可以写一个工厂函数，根据不同的类名，返回相应的DAO。

　　function dao_getDAO($vo_class) {
　　　　$conn = db_conn('default'); #get a connection from the pool
　　　　switch ($vo_class) {
　　　　　　case "person": return new PersonDAO($conn);
　　　　　　case "newsletter": return new NewsletterDAO($conn);
　　　　　　...
　　　　}
　　}

7. 自动生成代码
99%的值对象和DAO代码，可以根据数据库模式（schema）自动生成，前提是你的表和列使用约定的方式进行命名。如果你修改数据库模式，一个自动生成代码的脚本将大大节省你的时间。
8. 业务逻辑
业务逻辑直接反映使用者的需要。它们处理值对象，根据业务需要修改值对象的属性，使用DAO与数据库层交互。

　　class NewsletterLogic {
　　　　function NewsletterLogic() {
　　　　　　...
　　　　}
　　　　function subscribePerson(&$person) {
　　　　　　...
　　　　}
　　　　function unsubscribePerson(&$person) {
　　　　　　...
　　　　}
　　　　function sendNewsletter(&$newsletter) {
　　　　　　...
　　　　}
　　}

9. 页逻辑（控制器）
当一个网页被请求时，页控制器（page controller）就会运行，然后产生输出。控制器的任务，就是将HTTP请求转化成业务对象（business object），然后调用相应的业务逻辑，最后生成一个"展示输出"的对象。
页逻辑依次执行以下步骤（请参照后面的PageController类的代码）：

　　i. 假定页面请求之中，包含一个cmd参数。
　　ii. 根据cmd参数的值，执行相应的动作。
　　iii. 验证页面返回的值，生成一个值对象。
　　iv. 针对值对象，执行业务逻辑。
　　v. 如果有必要，可以导向另一个页面。
　　vi. 收集必要的数据，输出结果。

注意：可以编写一个工具函数（utility function），处理GET或POST值，当有的变量没有赋值时，提供一个默认值。页逻辑不包含HTML代码。

　　class PageController {
　　　　var $person; #$person is used by the HTML page
　　　　var $errs;
　　　　function PageController() {
　　　　　　$action = Form::getParameter('cmd');
　　　　　　$this->person = new Person();
　　　　　　$this->errs = array();
　　　　　　if ($action == 'save') {
　　　　　　　　$this->parseForm();
　　　　　　　　if (!this->validate()) return;
　　　　　　　　NewsletterLogic::subscribe($this->person);
　　　　　　　　header('Location: confirmation.php');
　　　　　　　　exit;
　　　　　　}
　　　　}

　　　　function parseForm() {
　　　　　　$this->person->name = Form::getParameter('name');
　　　　　　$this->person->birthdate = Util::parseDate(Form::getParameter('birthdate');
　　　　　　...
　　　　}
　　　　function validate() {
　　　　　　if ($this->person->name == '') $this->errs['name'] = FORM_MISSING;
　　　　　　#FORM_MISSING is a constant
　　　　　　...
　　　　　　return (sizeof($this->errs) == 0);
　　　　}
　　}

10. 表现层（Presentation Layer）
最顶层的页面包含实际的HTML代码。这个页面需要的所有业务对象（business object），由页逻辑提供。
这个页面先读取业务对象的属性，然后将它们转换成HTML格式。
<blockquote>