创造世界上最简单的 PHP 开发模式第1/5页

/*************************************/
/* author:大龄青年
/* email :wenadmin@sina.com
/* from: http://blog.csdn.net/hahawen
/*************************************/

　　php 作为“最简单”的 Web 脚本语言, 在国内的市场越来越大，phper 越来越多，但是感觉大多数人好像没有考虑到模式问题，什么样的设计模式才是最优的，才是最适合自己目前工作的，毕竟效率是最重要的（用省下的时间打游戏，多美啊...）。MVC 应该是首选，www.sourceforge.net 上有好多优秀的基于 MVC 的开源项目，大家可以冲过去研究研究。

　　前几天给自己公司网站改版，主要还是文章发布系统，老板说后台我想怎么设计就怎么设计，唯一的前提就是快。于是自己搭建了一个简单的发布系统的框架。如果单纯从文章发布系统上讲，基本上可以满足“中小型”企业网站的文章发布系统的要求，后台的总共的php代码不超过800行，而且支持任意扩充和plugin功能。

　　废话不再说了，下面把我的架构讲一下，希望对您能有所帮助。

　　注意：在开始前，需要您下载一个模板处理工具类：“smarttemplate”，并了解一些模板的简单的使用。

　　我的测试环境：windows2k/apache2/php4.3.2/smarttemplate类库

　　先讲一下整个web站点的文件的分布，在后面的章节中将陆续创建并填充下面的目录和文件
　　我的服务器的web的根目录是 “C:/Apache2/htdocs/”
　　我在下面建立了一个文件夹“cmstest”作为我的网站的主文件夹
　　文件夹“cmstest”下面的子文件结构是：

/config.inc.php
/list1.php
/list2.php
/new.php
/add.php
/view.php
/page.js
/src/MysqlUtil.php
/src/ArticleUtil.php
/src/CoreUtil.php
/src/ParseTpl.php
/src/lib/smarttemplate/*.* 这个目录用来存放smarttemplate的类库的
/smart/template/list1.htm
/smart/template/list2.htm
/smart/template/new.htm
/smart/template/add.htm
/smart/template/view.htm
/smart/cache/
/smart/temp/


设计步骤：

考虑自己公司的网站的特点和已经设计的模板的结构，总结要实现的功能，列出清单。 
分析功能清单，把功能分类。每一类的功能都是有共同点的，可以通过相同的方法实现的。 
根据功能，设计数据库的表结构 
设计一个配置文件config.inc.php, 用来记录网站的一些基本的信息,包括数据库名........ 
为每一类功能设计数据库查询的接口函数，这样以后相似的操作只要调用这个接口就可以了。这样避免了以后可能发生的大量的代码重复的操作，也就达到了代码复用的目的。 
定义自己对模板工具的包装函数，以后调用的时候就不用管模板工具的使用问题了，只有往自己的包装函数里面塞数就可以了。 
基础函数已经ok了，开始轻松的页面实现和模板的处理了。

　　我们现在就开始设计一个简单的系统，看看我是怎么一步一步地实现一个“最简单的文章的发布系统”的，当然只是我模拟的一个简单的项目，实际中一个项目可能比这要复杂的多。


一、分析我的案例：

呵呵，这个客户项目好简单的啊，幸福ing..........

list1.php：有三个文章列表和一个按钮，“php开发文章列表”“php开发热点文章列表”“asp开发最新文章”“添加新文章”
list2.php：有2个文章列表“asp开发文章列表”“asp开发热点文章列表”
new.php：一个添加文章的表单的页面
add.php： 处理new.php的表单的页面
view.php： 文章察看的页面

二、分析功能 

“php开发文章列表”“asp开发文章列表”-------按文章的发布顺序，倒序排列显示，每页显示5篇文章
“php开发热点文章列表”“asp开发热点文章列表”-------按文章的点击察看次数排序显示文章，显示3篇文章
“asp开发最新文章”按文章的发布顺序，倒序排列显示，显示3篇文章
“添加新文章”------一个文章的发布功能, 包括文章标题/作者/内容
“文章察看”---------显示某篇文章内容

综合的看一下,对功能进行分类包括:
1、文章列表：正常的分页列表、按点击数列表、按发布顺序的列表
2、文章发布：一个表单的输入和处理
3、文章察看：读取显示文章内容

呵呵，功能的确是太简单了些。

三、设计数据库：

数据库名：cmstest

数据表：

CREATE TABLE `article` (
`id` INT NOT NULL AUTO_INCREMENT,
`title` VARCHAR( 100 ) NOT NULL ,
`content` TEXT NOT NULL ,
`datetime` DATETIME NOT NULL ,
`clicks` INT( 11 ) ,
`pid` TINYINT( 2 ) NOT NULL ,
PRIMARY KEY ( `id` ) 
);

CREATE TABLE `cat` (
`cid` TINYINT( 2 ) NOT NULL ,
`cname` VARCHAR( 20 ) NOT NULL ,
PRIMARY KEY ( `cid` ) 
);

------------------------------
article表是文章内容表，
----------------------------
`id` 文章编号
`title` 文章标题
`content` 文章内容
`datetime` 发布时间
`clicks` 点击数
`pid` 分类表号
------------------------------
cat表是文章的类别表
----------------------------
`cid` 分类表号
`cname` 分类名称
----------------------------

上面是表的数据库结构，光有了这些还不够，还要有数据
INSERT INTO `cat` VALUES(1, "php开发"),(2, "asp开发");
INSERT INTO `article` VALUES(1, "php开发1", "php开发1内容", "2004-8-1 1:1:1", 0, 1);
INSERT INTO `article` VALUES(2, "php开发2", "php开发2内容", "2004-8-2 1:1:1", 0, 1);
INSERT INTO `article` VALUES(3, "php开发3", "php开发3内容", "2004-8-3 1:1:1", 4, 1);
INSERT INTO `article` VALUES(4, "php开发4", "php开发4内容", "2004-8-4 1:1:1", 3, 1);
INSERT INTO `article` VALUES(5, "php开发5", "php开发5内容", "2004-8-5 1:1:1", 2, 1);
INSERT INTO `article` VALUES(6, "php开发6", "php开发6内容", "2004-8-6 1:1:1", 1, 1);
INSERT INTO `article` VALUES(7, "php开发7", "php开发7内容", "2004-8-7 1:1:1", 0, 1);
INSERT INTO `article` VALUES(8, "jsp开发1", "jsp开发1内容", "2004-8-1 1:1:1", 0, 2);
INSERT INTO `article` VALUES(9, "jsp开发2", "jsp开发2内容", "2004-8-2 1:1:1", 0, 2);
INSERT INTO `article` VALUES(10, "jsp开发3", "jsp开发3内容", "2004-8-3 1:1:1", 4, 2);
INSERT INTO `article` VALUES(11, "jsp开发4", "jsp开发4内容", "2004-8-4 1:1:1", 3, 2);
INSERT INTO `article` VALUES(12, "jsp开发5", "jsp开发5内容", "2004-8-5 1:1:1", 2, 2);
INSERT INTO `article` VALUES(13, "jsp开发6", "jsp开发6内容", "2004-8-6 1:1:1", 1, 2);
INSERT INTO `article` VALUES(14, "jsp开发7", "jsp开发7内容", "2004-8-7 1:1:1", 0, 2);


这样我们的数据库就设计完了。接下来就开始涉及到具体的实现了。

四、设计config.inc.php文件

这个文件用来设置一些web上通用的数据信息和一些参数，其他的具体的实现页面都通过这个页面获取需要的数据，下面是配置的清单

<?php 

//数据库设置 
define('DB_USERNAME', 'root'); 
define('DB_PASSWORD', ''); 
define('DB_HOST', 'localhost'); 
define('DB_NAME', 'cmstest'); 
define('DB_PCONNECT', true); 

// web的基本路经设置 
define('CMS_ROOT', 'C:/Apache2/htdocs/cmstest/'); 
define('CMS_SRCPATH', CMS_ROOT.'src/'); 

//smarttemplate 模板解析工具的设置 
define('SMART_REUSE_CODE', false); 
define('SMART_TEMPLATE_DIR', CMS_ROOT.'smart/template/'); 
define('SMART_TEMP_DIR', CMS_ROOT.'smart/temp/'); 
define('SMART_CACHE_DIR', CMS_ROOT.'smart/cache/'); 
define('SMART_CACHE_LIFETIME', 100); 
require_once(CMS_SRCPATH . 'lib/smarttemplate/class.smarttemplate.php'); 

//要包含的基础文件,里面都是一些基本的函数 
require_once CMS_SRCPATH.'MysqlUtil.php'; 
require_once CMS_SRCPATH.'ArticleUtil.php'; 
require_once CMS_SRCPATH.'CoreUtil.php'; 
require_once CMS_SRCPATH.'ParseTpl.php'; 

//session 控制 
session_cache_limiter('private_no_expire'); 
session_start(); 

?> 


　　其中的 define('CMS_ROOT', 'C:/Apache2/htdocs/cmstest/'); 路经根据自己apach的web路经来改（参照最开始介绍文件夹结构的地方改）。


五、制作功能接口（1）

　　首先对  mysql 数据库函数进行包装，简化对数据库操作，网上有很多这样的开源的类。但是这里我个人根据自己的需求和习惯，自己对 mysql 的函数进行了包装，写得好坏就先不管了。这个地方简单的看一下就可以了，不同的包装的类操作是不同的，而且这里的主要目的是理解这套“架构”，不用太扣代码。

-------MysqlUtil.php--------
<?php 

function dbConnect(){ 
    global $cnn; 
    $cnn = (DB_PCONNECT? mysql_pconnect(DB_HOST, DB_NAME, DB_PASSWORD): 
    mysql_connect(DB_HOST, DB_NAME, DB_PASSWORD)) or 
    die('数据库连接错误'); 
    mysql_select_db(DB_NAME, $cnn) or die('数据库选择错误'); 
    mysql_query("SET AUTOCOMMIT=1"); 
} 

function &dbQuery($sql){ 
    global $cnn; 
    $rs = &mysql_query($sql, $cnn); 
    while($item=mysql_fetch_assoc($rs)){ 
        $data[] = $item; 
    } 
    return $data; 
} 

function &dbGetRow($sql){ 
    global $cnn; 
    $rs = mysql_query($sql) or die('sql语句执行错误'); 
    if(mysql_num_rows($rs)>0) 
    return mysql_fetch_assoc($rs); 
    else 
    return null; 
} 

function dbGetOne($sql, $fildName){ 
    $rs = dbGetRow($sql); 
    return sizeof($rs)==null? null: (isset($rs[$fildName])? $rs[$fildName]: null); 
} 

function &dbPageQuery($sql, $page=1, $pageSize=20){ 
    if($page===null) return dbQuery($sql); 
    $countSql = preg_replace('|SELECT.*FROM|i','SELECT COUNT(*) count FROM', $sql); 
    $n = (int)dbGetOne($countSql, 'count'); 
    $data['pageSize'] = (int)$pageSize<1? 20: (int)$pageSize; 
    $data['recordCount'] = $n; 
    $data['pageCount'] = ceil($data['recordCount']/$data['pageSize']); 
    $data['page'] = $data['pageCount']==0? 0: ((int)$page<1? 1: (int)$page); 
    $data['page'] = $data['page']>$data['pageCount']? $data['pageCount']:$data['page']; 
    $data['isFirst'] = $data['page']>1? false: true; 
    $data['isLast'] = $data['page']<$data['pageCount']? false: true; 
    $data['start'] = ($data['page']==0)? 0: ($data['page']-1)*$data['pageSize']+1; 
    $data['end'] = ($data['start']+$data['pageSize']-1); 
    $data['end'] = $data['end']>$data['recordCount']? $data['recordCount']: $data['end']; 
    $data['sql'] = $sql.' LIMIT '.($data['start']-1).','.$data['pageSize']; 
    $data['data'] = &dbQuery($data['sql']); 
    return $data; 
} 

function dbExecute($sql){ 
    global $cnn; 
    mysql_query($sql, $cnn) or die('sql语句执行错误'); 
    return mysql_affected_rows($cnn); 
} 

function dbDisconnect(){ 
    global $cnn; 
    mysql_close($cnn); 
} 

function sqlGetOneById($table, $field, $id){ 
    return "SELECT * FROM $table WHERE $field=$id"; 
} 

function sqlMakeInsert($table, $data){ 
    $t1 = $t2 = array(); 
    foreach($data as $key=>$value){ 
        $t1[] = $key; 
        $t2[] = "'".addslashes($value)."'"; 
    } 
    return "INSERT INTO $table (".implode(",",$t1).") VALUES(".implode(",",$t2).")"; 
} 

function sqlMakeUpdateById($table, $field, $id, $data){ 
    $t1 = array(); 
    foreach($data as $key=>$value){ 
        $t1[] = "$key='".addslashes($value)."'"; 
    } 
    return "UPDATE $table SET ".implode(",", $t1)." WHERE $field=$id"; 
} 

function sqlMakeDelById($table, $field, $id){ 
    return "DELETE FROM $table WHERE $field=$id"; 
} 

?> 

五、制作功能接口（2）

下面来正式的看看，我们共要实现的功能进行的包装

------------ArticleUtil.php----------------
<?php 
//显示文章列表的函数 
//getArticleList(文章类别, 排序方法, 当前显示第几页, 每页显示几条) 
function getArticleList($catId, $order, $page, $pageSize){ 
    $sql = "SELECT * FROM article WHERE pid=$catId ORDER BY $order"; 
    return dbPageQuery($sql, $page, $pageSize); 
} 
//查询某个文章的内容 
//getArticle(文章编号) 
function getArticle($id){ 
    $sqlUpdate = "UPDATE article SET clicks=clicks+1 WHERE id=$id"; 
    dbExecute($sqlUpdate); 
    $sql = "SELECT * FROM article WHERE art_id=$id"; 
    return dbGetRow($sql); 
} 
//添加文章 
//addArticle(文章内容数组) 
function addArticle($data){ 
    $sql = sqlMakeInsert('article', $data); 
    return dbExecute($sql); 
} 
?> 

这段代码是不是就简单多了啊？这就是自己对mysql函数进行包装的好处！
下面来研究一下他们是怎么实现我们的功能的呢。
“php开发文章列表”--------getArticleList(1, "id DESC", $page, 5) 
“asp开发文章列表”--------getArticleList(2, "id DESC", $page, 5)
“php开发热点文章列表”----getArticleList(1, "clicks DESC, id DESC", 1, 3)
“asp开发热点文章列表”----getArticleList(2, "clicks DESC, id DESC", 1, 3)
“asp开发最新文章”--------getArticleList(2, "id DESC", 1, 3)
“添加新文章”-------------addArticle($data)
“察看文章”---------------getArticle($id)


六、对smarttemplate类进行包装（革命尚未成功，同志仍须努力）

具体的smarttemplate的使用这里就不讲了，不然口水讲没了，都讲不完。下面这个是具体的对包装函数

-------------ParseTpl.php----------------
<?php 

function renderTpl($viewFile, $data){ 
    $page = new SmartTemplate($viewFile); 
    foreach($data as $key=>$value){ 
        if(isset($value[data])){ 
            $page->assign($key, $value[data]); 
            unset($value[data]); 
            $page->assign($key."_page", $value); 
        } else { 
            $page->assign($key, $value); 
        } 
    } 
    $page->output(); 
} 

?>