用PHP制作靜態(tài)網(wǎng)站的模板框架

更新時間：2006年10月09日 00:00:00 作者：

模板能夠改善網(wǎng)站的結(jié)構(gòu)。本文闡述如何通過PHP 4的一個新功能和模板類，在由大量靜態(tài)HTML頁面構(gòu)成的網(wǎng)站中巧妙地運(yùn)用模板控制頁面布局。

提綱：

===================================

分離功能和布局

避免頁面元素重復(fù)

靜態(tài)網(wǎng)站的模板框架

===================================

分離功能和布局

首先我們來看看應(yīng)用模板的兩個主要目的：

分離功能（PHP）和布局（HTML）

避免頁面元素重復(fù)

第一個目的是談?wù)摰米疃嗟哪康?，它設(shè)想的情形是：一組程序員編寫用于生成頁面內(nèi)容的PHP腳本，同時另一組設(shè)計人員設(shè)計HTML和圖形以控制頁面的最終外觀。分離功能和布局的基本思想就是使得這兩組人能夠各自編寫和使用獨立的一組文件：程序員只需關(guān)心那些只包含PHP代碼的文件，無需關(guān)心頁面的外觀；而頁面設(shè)計人員可以用自己最熟悉的可視化編輯器設(shè)計頁面布局，無需擔(dān)心破壞任何嵌入到頁面的PHP代碼。

如果你曾經(jīng)看過幾個關(guān)于PHP模板的教程，那么你應(yīng)該已經(jīng)明白模板的工作機(jī)制?？紤]一個簡單的頁面局部：頁面的上方是頁頭，左邊是導(dǎo)航條，其余部分是內(nèi)容區(qū)域。這種網(wǎng)站可以擁有如下模板文件：


<html>
<head><title>模板示例</title></head>
<body>
<table><tr><td>{HEADER}</td></tr>
<tr><td>{LEFTNAV}</td><td>{CONTENT}</td></tr>
</table>
</body></html>


<img src="sitelogo.jpg">


<br><a href="foo">Foo</a>
<br><a href="bar">Bar</a>

可以看出頁面如何由這些模板構(gòu)造而成：main模板控制著整個頁面的布局；header模板和leftnav模板控制著頁面的公共元素?；ɡㄌ枴皗}”里面的標(biāo)識符是內(nèi)容占位符。使用模板最主要的好處在于界面設(shè)計者能夠按照自己的意愿編輯這些文件，比如設(shè)置字體、修改顏色和圖形，或者完全地改變頁面的布局。界面設(shè)計者可以用任何普通HTML編輯器或者可視化工具編輯這些頁面，因為這些文件都只包含HTML代碼，沒有任何PHP代碼。 PHP代碼全部保存到單獨的文件中，這個文件也就是由頁面URL實際調(diào)用的文件。Web服務(wù)器通過PHP引擎解析該文件，然后把結(jié)果返回給瀏覽器。一般地，PHP代碼總是動態(tài)地生成頁面內(nèi)容，比如查詢數(shù)據(jù)庫或者執(zhí)行某種計算等。下面是一個例子：
<?php

// example.php
require('class.FastTemplate.php');
$tpl = new FastTemplate('.');
$tpl->define( array( 'main' => 'main.htm',
'header' => 'header.htm',
'leftnav' => 'leftnav.htm' ) );

// 此處的PHP代碼設(shè)置$content使其包含合適的頁面內(nèi)容

$tpl->assign('CONTENT', $content);
$tpl->parse('HEADER', 'header');
$tpl->parse('LEFTNAV', 'leftnav');
$tpl->parse('MAIN', 'main');
$tpl->FastPrint('MAIN');

?>

這里我們使用的是流行的FastTemplate模板類，但其基本思路對于其他許多模板類來說都一樣。首先你實例化一個類，告訴它到哪里去尋找模板文件以及哪一個模板文件與頁面的哪部分對應(yīng)；接下來是生成頁面內(nèi)容，把結(jié)果賦予內(nèi)容的標(biāo)識符；然后，依次解析各個模板文件，模板類將執(zhí)行必要的替換操作；最后把解析結(jié)果輸出到瀏覽器。

這個文件完全由PHP代碼構(gòu)成，不包含任何HTML代碼，這是它最大的優(yōu)點?，F(xiàn)在，PHP程序員可以集中精力編寫生成頁面內(nèi)容的代碼，而不必為了如何生成HTML去正確地格式化最終頁面而擔(dān)心。

你可以使用這種方法和上面的文件構(gòu)造出一個完整的網(wǎng)站。如果PHP代碼是以URL中的查詢字符串為基礎(chǔ)生成頁面內(nèi)容，例如http://www.foo.com/example.php?article=099，你可以據(jù)此構(gòu)造出一個完整的雜志網(wǎng)站。

很容易看出采用模板還有第二個好處。如上例所示，頁面左邊的導(dǎo)航條單獨保存為一個文件，我們只需編輯這一個模板文件就可以改變網(wǎng)站所有頁面左邊的導(dǎo)航條。避免頁面元素重復(fù)
“這確實不錯”，你也許會想，“我的網(wǎng)站主要就是由大量的靜態(tài)頁面構(gòu)成?，F(xiàn)在我可以從所有頁面中刪除它們的公共部分，要更新這些公共部分實在太麻煩了。以后我就可以用模板制作出很容易維護(hù)的統(tǒng)一頁面布局?！钡虑椴⒎沁@么簡單，“大量的靜態(tài)頁面”道出了問題的所在。

請考慮上面的例子。這個例子實際上只有一個example.php頁面，它之所以能夠生成整個網(wǎng)站的所有頁面，是因為它利用了URL中的查詢字符串從數(shù)據(jù)庫之類的信息源動態(tài)地構(gòu)造出頁面。

我們之中的大多數(shù)人所運(yùn)行的網(wǎng)站并不一定都有數(shù)據(jù)庫支持。我們的網(wǎng)站大多數(shù)由靜態(tài)頁面構(gòu)成，然后用PHP在這里、那里加上一些動態(tài)功能，比如搜索引擎、反饋表單等。那么，如何在這種網(wǎng)站上應(yīng)用模板呢？

最簡單的方法是為每一個頁面復(fù)制一份PHP文件，然后在每一個頁面中把PHP代碼里代表內(nèi)容的變量設(shè)置成合適的頁面內(nèi)容。例如，假設(shè)有三個頁面，它們分別是主頁（home）、關(guān)于（about）和產(chǎn)品（product），我們可以用三個文件分別生成它們。這三個文件的內(nèi)容都類如：

<?php

// home.php
require('class.FastTemplate.php');
$tpl = new FastTemplate('.');
$tpl->define( array( 'main' => 'main.htm',
'header' => 'header.htm',
'leftnav' => 'leftnav.htm' ) );

$content = "<p>歡迎訪問</p>
<img src=\"demo.jpg\">
<p>希望你能夠喜歡本網(wǎng)站</p>";
$tpl->assign('CONTENT', $content);
$tpl->parse('HEADER', 'header');
$tpl->parse('LEFTNAV', 'leftnav');
$tpl->parse('MAIN', 'main');
$tpl->FastPrint('MAIN');

?>

顯然，這種方法有三個問題：我們必須為每一個頁面復(fù)制這些復(fù)雜的、牽涉到模板的PHP代碼，這與重復(fù)公共頁面元素一樣使得頁面難以維護(hù)；現(xiàn)在文件又混合了HTML和PHP代碼；為內(nèi)容變量賦值將變得非常困難，因為我們必須處理好大量的特殊字符。

解決這個問題的關(guān)鍵就在于分離PHP代碼和HTML內(nèi)容，雖然我們不能從文件中刪除所有的HTML內(nèi)容，但可以移出絕大多數(shù)PHP代碼。靜態(tài)網(wǎng)站的模板框架

首先，我們象前面一樣為所有的頁面公用元素以及頁面整體布局編寫模板文件；然后從所有的頁面刪除公共部分，只留下頁面內(nèi)容；接下來再在每個頁面中加上三行PHP代碼，如下所示：

<?php


<?php require('prepend.php'); ?>
<?php pageStart('Home'); ?>

<h1>你好</h1>
<p>歡迎訪問</p>
<img src="demo.jpg">
<p>希望你能夠喜歡本網(wǎng)站</p>

<?php pageFinish(); ?>

?>

這種方法基本上解決了前面提到的各種問題?，F(xiàn)在文件里只有三行PHP代碼，而且沒有任何一行代碼直接涉及到模板，因此要改動這些代碼的可能性極小。此外，由于HTML內(nèi)容位于PHP標(biāo)記之外，所以也不存在特殊字符的處理問題。我們可以很容易地將這三行PHP代碼加入到所有靜態(tài)HTML頁面中。

require函數(shù)引入了一個PHP文件，這個文件包含了所有必需的與模板相關(guān)的PHP代碼。其中pageStart函數(shù)設(shè)置模板對象以及頁面標(biāo)題，pageFinish函數(shù)解析模板然后生成結(jié)果發(fā)送給瀏覽器。

這是如何實現(xiàn)的呢？為什么在調(diào)用pageFinish函數(shù)之前文件中的HTML不會發(fā)送給瀏覽器？答案就在于PHP 4的一個新功能，這個功能允許把輸出到瀏覽器的內(nèi)容截獲到緩沖區(qū)之中。讓我們來看看prepend.php的具體代碼：

<?php

require('class.FastTemplate.php');

function pageStart($title = '') {
GLOBAL $tpl;
$tpl = new FastTemplate('.');
$tpl->define( array( 'main' => 'main.htm',
'header' => 'header.htm',
'leftnav'=> 'leftnav.htm' ) );
$tpl->assign('TITLE', $title);
ob_start();
}

function pageFinish() {
GLOBAL $tpl;
$content = ob_get_contents();
ob_end_clean();
$tpl->assign('CONTENT', $content);
$tpl->parse('HEADER', 'header');
$tpl->parse('LEFTNAV', 'leftnav');
$tpl->parse('MAIN', 'main');
$tpl->FastPrint('MAIN');
}

?> pageStart函數(shù)首先創(chuàng)建并設(shè)置了一個模板實例，然后啟用輸出緩存。此后，所有來自頁面本身的HTML內(nèi)容都將進(jìn)入緩存。pageFinish函數(shù)取出緩存中的內(nèi)容，然后在模板對象中指定這些內(nèi)容，最后解析模板并輸出完成后的頁面。

這就是整個模板框架全部的工作過程了。首先編寫包含了網(wǎng)站各個頁面公共元素的模板，然后從所有頁面中刪除全部公共的頁面布局代碼，代之以三行永遠(yuǎn)無需改動的PHP代碼；再把FastTemplate類文件和prepend.php加入到包含路徑，這樣你就得到了一個頁面布局可以集中控制的網(wǎng)站，它有著更好的可靠性和可維護(hù)性，而且網(wǎng)站級的大范圍修改也變得相當(dāng)容易。

本文下載包包含了一個可運(yùn)行的示例網(wǎng)站，它的代碼注釋要比前面的代碼注釋更詳細(xì)一些。FastTemplate類可以在http://www.thewebmasters.net/找到，最新的版本號是1.1.0，那里還有一個用于保證該類在PHP 4中正確運(yùn)行的小補(bǔ)丁。本文下載代碼中的類已經(jīng)經(jīng)過該補(bǔ)丁的修正。