生成静态HTML文件教程

#1 jake

生成静态的HTML文件,不仅仅有利于SEO(搜索引擎优化),而且也是节约服务器资源,优化程序执行速度的方法之一。sp框架的spHtml正是PHP生成真实的HTML文件的最好方法之一。下面就来介绍一下spHtml的使用。
请注意,SpeedPHP框架的spHtml并非是伪静态的程序,而是生成真实的HTML文件。
一、开启spHtml

首先我们要对应用程序进行一下简单的配置,令其开启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( // 请注意这里数组的嵌套
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将为您的应用程序带来质的提升。

2012-08-04 23:14:54

#2 Angelia

Jake,我有个问题想问你,就是我已经有一个静态页面了,比如是一个添加页面,我想通过在管理页面点击一个按钮调转到添加页面,同时我还需要传值给添加页面,这个应该怎么做呢?

2012-08-17 14:52:15

#3 jake

Angelia 发表于 2012-8-17 14:52
Jake,我有个问题想问你,就是我已经有一个静态页面了,比如是一个添加页面,我想通过在管理页面点击一个按 ...
真实静态文件HTML,是没办法接收参数并进行处理的。只有伪静态的HTML,实际上是PHP所以才能接受参数。

本文介绍的是真实静态文件HTML。

2012-08-17 14:57:06

#4 Angelia

Jake,我还有个问题,就是我一个html页面中,有一部分是一些分类,就是带有chekebox框的那种,因为分类可能不同,所以要由后台生成,我想问一下,这个可以用静态html生成吗?

2012-08-20 11:14:46

#5 jake

可以生成,不过一般这种应用都是通过javascript,尤其是ajax方式来做的。

2012-08-20 15:38:32

#6 ray

遇到问题,例如我生成了HTML,在文章列表里面如何显示文章的链接为静态的链接?

2012-08-30 01:39:31

#7 ray

已经解决,用spUrl没错,调试的时候弄错了。

2012-08-30 01:52:51

#8 ray

新问题,如果生成静态文件数目到了几十万甚至百万级,效率上会不会很低呢?
要实现完全静态,要生成两次,这个机制有没有办法优化呢?

2012-08-30 11:45:33

#9 jake

ray 发表于 2012-8-30 11:45
新问题,如果生成静态文件数目到了几十万甚至百万级,效率上会不会很低呢?
要实现完全静态,要生成两次, ...
分开多次生成

2012-08-30 12:59:21