#1 jake
请注意,SpeedPHP框架的spHtml并非是伪静态的程序,而是生成真实的HTML文件。
首先我们要对应用程序进行一下简单的配置,令其开启HTML生成的功能。
define("SP_PATH",dirname(__FILE__)."/SpeedPHP");
define("APP_PATH",dirname(__FILE__));
$spConfig = array(
...
'html' => array( // HTML生成配置
'enabled' => TRUE, // 开启HTML生成功能
),
...
);
require(SP_PATH."/SpeedPHP.php");
spRun(); // SpeedPHP 3新特性
在sp应用程序配置中如图加入'html' => array('enabled' => TRUE),就可以开启HTML功能,当然html生成还有其他更深入的配置,在本文的后面会一一介绍。
二、使用make及makeAll
spHtml生成静态文件可以生成单个静态页面(make),同时也可以批量生成(makeAll)。
请注意,批量生成并非单个生成的简单重复,比如在生成首页静态文件的时候,就可以用make来进行单独的生成。如果是批量生成某分类下的全部文章,那么就应该使用makeAll来进行批量的生成。
下面我们就留言本程序来进行介绍如果使用spHtml生成静态留言内容页面。
请打开源码,我们可以看到是快速入门文章的留言本程序。里面show方法是显示单个留言的内容的页面。上面已经设置了启用spHtml功能,那么我们加入以下的一个方法test_html:
...
function test_html(){ // 测试spHtml生成静态页面的方法
echo "开始生成留言本内容页面...
";
$urls = array();
$guestbook = spClass("guestbook");
if( $result = $guestbook->findAll() ){ // 获取到全部的留言来进行spUrl的构造
foreach($result as $value){ // 循环
$urls[] = array(
array('main','show',array('id'=>$value['id'])) // 这里和spUrl的参数是相同的
);
}
}
spClass('spHtml')->makeAll($urls); // 使用makeAll来制作
echo "留言本内容页面生成完毕!";
}
...
上面我们看到了,spHtml的makeAll方法是通过输入与spUrl相同的参数数组来进行生成静态页面的。所以我们首先要获取到spUrl格式的地址,然后再使用makeAll来进行生成:
spUrl的格式:
spUrl("main", "show", array('id'=>12));makeAll
$urls = array( // 请注意这里数组的嵌套make
array( // 第一个页面
array("main", "show", array('id'=>12)),
),
array( // 第二个页面
array("main", "show", array('id'=>12)),
),
.......
);
spClass('spHtml')->makeAll($urls);
$url = array("main", "show", array('id'=>12));
spClass("spHtml")->make($url);
当然我们要注意makeAll需要的是数组,请注意以上三者的相似与不同之处。
执行test_html方法。我们看到了:
开始生成留言本内容页面...
同时我们也看到了,在其他页面(比如刚才的首页)里面,指向该页面的链接,都变成了指向静态页面的链接。这就是开启生成HTML后,spUrl函数会自动检查对应的地址是不是静态页面,如果是的话,将显示静态页面的地址,而不是显示动态的PHP页面地址。
$spConfig = array(
...
'html' => array( // HTML生成配置
'enabled' => TRUE, // 开启HTML生成功能
'safe_check_file_exists' => TRUE, // 获取URL时,检查物理HTML文件是否存在,如文件不存在,则返回安全的动态地址
),
...
);
$spConfig = array(
...
'html' => array( // HTML生成配置
'enabled' => TRUE, // 开启HTML生成功能
'safe_check_file_exists' => TRUE,
'file_root_name' => 'articles', // 静态文件生成的根目录名称,设置为空则是直接在入口文件的同级目录生成
),
...
);
spHtml默认生成的文件是类似“/topic/2009/11/22/8852614170.html”的形式,按照年月日来进行目录的生成,然后文件名是随机的数字组成。这里我们也可以对生成的地址进行个性化的设置。比如说,我们希望第一个页面叫one.html,第二个页面叫two.html:
$urls = array( // 请注意这里数组的嵌套
array( // 第一个页面
array("main", "show", array('id'=>12)), 'myname/one.html'
),
array( // 第二个页面
array("main", "show", array('id'=>12)), 'myname/two.html'
),
.......
);
spClass('spHtml')->makeAll($urls);
这样生成的页面,第一个页面的地址将会是“http://localhost/articles/myname/one.html”,第二个页面的地址是“http://localhost/articles/myname/two.html”。这里连同myname这个目录也一起生成了。
这种个性化的静态文件地址,非常受搜索引擎的欢迎,尤其是我们使用文件的中文拼音作为文件名的时候。生成汉字的中文拼音,可以使用sp框架的spPinyin扩展类哦。
三、重建静态HTML文件
下面我们来介绍如何清除这些已经生成的静态HTML文件,以便内容的更新。
clear,清除对应的html文件:
spClass('spHtml')->clear($controller, $action = null, $args = null, $anchor = null)
删除id为12的静态页面
spClass('spHtml')->clear("main", "show", array('id'=>12))
删除以show动作生成的全部静态页面
spClass('spHtml')->clear("main", "show")
删除main控制器内,所有生成html地址的动作的静态页面
spClass('spHtml')->clear("main")
clearAll,清除整个应用程序生成的静态页面
spClass("spHtml")->clearAll(); // 是删除文件索引,但不删除静态HTML文件
spClass("spHtml")->clearAll(TRUE); // 删除文件索引及静态HTML文件
2012-08-04 23:14:54