創造世界上最簡單的 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();
}

?>