编辑“SpeedPHP/生成HTML的使用”

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

注意：[[SpeedPHP]]框架的spHtml并非是伪静态的程序，而是生成真实的HTML文件。

==开启spHtml==
首先我们要对[[应用程序]]进行一下简单的配置，令其开启HTML生成的功能。
<pre><?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新特性		
</pre>
在sp应用程序配置中如图加入'html' => array('enabled' => TRUE),就可以开启HTML功能，当然html生成还有其他更深入的配置，在本条目的后面会一一介绍。

==使用make及makeAll==
spHtml生成静态文件可以生成单个静态页面（make），同时也可以批量生成（makeAll）。

注意：批量生成并非单个生成的简单重复，比如在生成首页静态文件的时候，就可以用make来进行单独的生成。如果是批量生成某分类下的全部文章，那么就应该使用makeAll来进行批量的生成。

下面我们就留言本程序来进行介绍如果使用spHtml生成静态留言内容页面。

请打开源码，我们可以看到是快速入门文章的留言本程序。里面show方法是显示单个留言的内容的页面。上面已经设置了启用spHtml功能，那么我们加入以下的一个方法test_html：
<pre>...
	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 "留言本内容页面生成完毕！";
	}
...		
</pre>
上面我们看到了，spHtml的makeAll方法是通过输入与spUrl相同的参数数组来进行生成静态页面的。所以我们首先要获取到spUrl格式的地址，然后再使用makeAll来进行生成：

spUrl的格式：
 spUrl("main", "show", array('id'=>12));
makeAll需要的格式：
<pre>$urls = array( // 请注意这里数组的嵌套
array( // 第一个页面
array("main", "show", array('id'=>12)),
),
array( // 第二个页面
array("main", "show", array('id'=>12)),
),
.......
);
spClass('spHtml')->makeAll($urls);
</pre>
make需要的格式：
 $url = array("main", "show", array('id'=>12));
 spClass("spHtml")->make($url);
当然我们要注意makeAll需要的是数组，请注意以上三者的相似与不同之处。

执行test_html方法。我们看到了：

开始生成留言本内容页面...

留言本内容页面生成完毕！

回到首页，我们发现好像没有什么改变的地方，不过看看那些留言内容的[[链接]]，都变成了类似“<nowiki>http://localhost/topic/2009/11/22/8852614170.html</nowiki>”的格式，点击进去是内容。然后看看我们的文件夹，根目录下多了个topic目录，里面有2009目录，一直下去我们可以找到很多个HTML文件。这些就是我们的静态文件。

同时我们也看到了，在其他页面（比如刚才的首页）里面，指向该页面的链接，都变成了指向静态页面的链接。这就是开启生成HTML后，spUrl函数会自动检查对应的地址是不是静态页面，如果是的话，将显示静态页面的地址，而不是显示动态的PHP页面地址。

这里我们还可以进行一下配置，让spUrl函数在检查目标链接是否静态页面的时候，同时检查静态文件是否已经生成，如果没有生成，那还是显示动态地址：
<pre>$spConfig = array(
	...
	'html' => array(  // HTML生成配置
		'enabled' => TRUE, // 开启HTML生成功能
		'safe_check_file_exists' => TRUE, // 获取URL时，检查物理HTML文件是否存在，如文件不存在，则返回安全的动态地址
	),
	...
);		
</pre>
刚才生成的静态页面中，全部的页面都是放到了根目录的topic目录中，topic是默认静态页面生成根目录。这里我们还可以设置其为其他我们喜欢的目录，比如articles，那么在html设置里面就是：
<pre>$spConfig = array(
	...
	'html' => array(  // HTML生成配置
		'enabled' => TRUE, // 开启HTML生成功能
		'safe_check_file_exists' => TRUE, 
		'file_root_name' => 'articles', // 静态文件生成的根目录名称，设置为空则是直接在入口文件的同级目录生成
	),
	...
);		
</pre>
那么在下次使用makeAll的时候，新的文件都将生成到articles目录中去了。

spHtml默认生成的文件是类似“/topic/2009/11/22/8852614170.html”的形式，按照年月日来进行目录的生成，然后文件名是随机的数字组成。这里我们也可以对生成的地址进行个性化的设置。比如说，我们希望第一个页面叫one.html，第二个页面叫two.html：

===使用makeAll===
<pre>$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);		
</pre>
这样生成的页面，第一个页面的地址将会是“<nowiki>http://localhost/articles/myname/one.html</nowiki>”,第二个页面的地址是“<nowiki>http://localhost/articles/myname/two.html</nowiki>”。这里连同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}}

[[category:SpeedPHP|S]]