SpeedPHP/生成HTML的使用
|
SpeedPHP | 快速入门 | 访问交互 | 数据操作 | 框架概述 | 模板引擎 | 优化加速 | 开发指南 | 数据模型 | API参考 |
生成静态的HTML文件，不仅仅有利于SEO（搜索引擎优化），而且也是节约服务器资源，优化程序执行速度的方法之一。sp框架的spHtml正是PHP生成真实的HTML文件的最好方法之一。下面就来介绍一下spHtml的使用。
注意：SpeedPHP框架的spHtml并非是伪静态的程序，而是生成真实的HTML文件。
开启spHtml[ ]
首先我们要对应用程序进行一下简单的配置，令其开启HTML生成的功能。
<?php
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 "开始生成留言本内容页面...<br />";
$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( // 请注意这里数组的嵌套
array( // 第一个页面
array("main", "show", array('id'=>12)),
),
array( // 第二个页面
array("main", "show", array('id'=>12)),
),
.......
);
spClass('spHtml')->makeAll($urls);
make需要的格式：
$url = array("main", "show", array('id'=>12));
spClass("spHtml")->make($url);
当然我们要注意makeAll需要的是数组，请注意以上三者的相似与不同之处。
执行test_html方法。我们看到了：
开始生成留言本内容页面...
留言本内容页面生成完毕！
回到首页，我们发现好像没有什么改变的地方，不过看看那些留言内容的链接，都变成了类似“http://localhost/topic/2009/11/22/8852614170.html”的格式，点击进去是内容。然后看看我们的文件夹，根目录下多了个topic目录，里面有2009目录，一直下去我们可以找到很多个HTML文件。这些就是我们的静态文件。
同时我们也看到了，在其他页面（比如刚才的首页）里面，指向该页面的链接，都变成了指向静态页面的链接。这就是开启生成HTML后，spUrl函数会自动检查对应的地址是不是静态页面，如果是的话，将显示静态页面的地址，而不是显示动态的PHP页面地址。
这里我们还可以进行一下配置，让spUrl函数在检查目标链接是否静态页面的时候，同时检查静态文件是否已经生成，如果没有生成，那还是显示动态地址：
$spConfig = array( ... 'html' => array( // HTML生成配置 'enabled' => TRUE, // 开启HTML生成功能 'safe_check_file_exists' => TRUE, // 获取URL时，检查物理HTML文件是否存在，如文件不存在，则返回安全的动态地址 ), ... );
刚才生成的静态页面中，全部的页面都是放到了根目录的topic目录中，topic是默认静态页面生成根目录。这里我们还可以设置其为其他我们喜欢的目录，比如articles，那么在html设置里面就是：
$spConfig = array( ... 'html' => array( // HTML生成配置 'enabled' => TRUE, // 开启HTML生成功能 'safe_check_file_exists' => TRUE, 'file_root_name' => 'articles', // 静态文件生成的根目录名称，设置为空则是直接在入口文件的同级目录生成 ), ... );
那么在下次使用makeAll的时候，新的文件都将生成到articles目录中去了。
spHtml默认生成的文件是类似“/topic/2009/11/22/8852614170.html”的形式，按照年月日来进行目录的生成，然后文件名是随机的数字组成。这里我们也可以对生成的地址进行个性化的设置。比如说，我们希望第一个页面叫one.html，第二个页面叫two.html：
使用makeAll[ ]
$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)
这里的参数($controller, $action = null, $args = null, $anchor = null)类似spUrl的参数。但是也有些不同，按留言本的例子：
删除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文件
以上就是我们的spHtml生成静态HTML文件的方法，请细细体会和试用，spHtml将为您的应用程序带来质的提升。
参考来源[ ]
http://speedphp.com/manual.html
SpeedPHP使用手册导航 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|