使用spHtml生成静态HTML文件教程

生成静态的HTML文件，不仅仅有利于SEO（搜索引擎优化），而且也是节约服务器资源，优化程序执行速度的方法之一。sp框架的spHtml正是PHP生成真实的HTML文件的最好方法之一。下面就来介绍一下spHtml的使用。



一、开启spHtml
首先我们要对应用程序进行一下简单的配置，令其开启HTML生成的功能。

复制代码 <?php define("SP_PATH",dirname(__FILE__)."/SpeedPHP"); define("APP_PATH",dirname(__FILE__)); $spConfig = array( 　　　　... 　　　　'html' => array(　　// HTML生成配置 　　　　　　　　'enabled' => TRUE, // 开启HTML生成功能 　　　　), 　　　　... );

在sp应用程序配置中如图加入'html' => array('enabled' => TRUE),就可以开启HTML功能，当然html生成还有其他更深入的配置，在本文的后面会一一介绍。
二、使用make及makeAll
spHtml生成静态文件可以生成单个静态页面（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文件。这些就是我们的静态文件。

这里我们还可以进行一下配置，让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目录中去了。

使用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();
以上就是我们的spHtml生成静态HTML文件的方法，请细细体会和试用，spHtml将为您的应用程序带来质的提升。

本文地址：http://speedphp.com/post/sphtml-usage.html

代码好像有问题啊

我按这个添加到留言的例子中也是错误的 希望能有完整的文件例子下载

万网代理 万网主机 万网邮箱 万网空间 万网独享主机 域名注册 虚拟空间 COM域名 CN域名 万网100M空间90元/年

只在根目录下生成才能正常使用，建议官方修正一下，让其有更广泛的应用。