新闻列表页静态化需依次完成建表与数据插入、编写生成脚本、启用输出缓冲、集成模板引擎、配置URL重写五步；核心是确保数据库连通、HTML正确拼接并写入/html/news_list.html，且服务器能优先响应静态文件。
如果您正在使用 PHP 实现静态网页设计，但新闻列表页无法正常生成或访问，则可能是由于模板路径错误、HTML 文件未正确写入或数据库查询失败所致。以下是创建新闻列表页的具体操作步骤：
一、构建数据库与数据表结构
新闻列表页依赖于结构清晰的数据存储，需预先在 MySQL 中创建包含必要字段的 news 表，确保每条新闻记录可被准确提取并渲染为静态 HTML。
1、使用 phpMyAdmin 或命令行连接数据库，执行建表语句：
CREATE TABLE `news` (
`id` INT(11) PRIMARY KEY AUTO_INCREMENT,
`title` VARCHAR(255) NOT NULL,
`content` TEXT,
`inputtime` DATETIME DEFAULT CURRENT_TIMESTAMP,
`url` VARCHAR(255) DEFAULT ''
);
2、向 news 表中插入至少三条测试数据，确保 title 和 inputtime 字段非空。
立即学习“PHP免费学习笔记（深入）”；
3、确认数据库连接参数（主机、用户名、密码、库名）与 PHP 脚本中使用的配置完全一致。
二、编写动态新闻列表生成脚本
该脚本负责从数据库读取新闻数据、拼接 HTML 结构，并调用文件写入函数生成静态列表页，是整个静态化流程的核心执行单元。
1、新建文件 news_list_gen.php，顶部声明 UTF-8 编码与数据库连接：
$conn = mysqli_connect("localhost", "root", "root", "static_pages_news");
mysqli_set_charset($conn, "utf8");
2、执行查询语句获取全部新闻：
$sql = "SELECT id, title, inputtime FROM news ORDER BY inputtime DESC";
$result = mysqli_query($conn, $sql);
3、初始化 HTML 字符串变量，拼入标准 HTML5 文档结构及列表容器：
$html = '
最新新闻
- ';
- ' . htmlspecialchars($row['title']) . '（' . date('Y-m-d', strtotime($row['inputtime'])) . '） ';
4、循环结果集，为每条新闻生成带链接的 li 元素：
while ($row = mysqli_fetch_assoc($result)) {
$url = 'news_' . $row['id'] . '.html';
$html .= '
}
5、闭合 HTML 标签并写入文件：
$html .= '
file_put_contents('./html/news_list.html', $html);
三、采用输出缓冲机制自动生成静态页
通过 ob_start 配合回调函数捕获动态页面输出流，在不修改原有逻辑的前提下实现自动静态化，适用于已有动态列表页的快速改造。
1、在 news_list.php 顶部添加缓冲启动代码：
ob_start('callback_CreateShtml');
2、定义回调函数 callback_CreateShtml，指定生成路径为 ./html/news_list.htm：
function callback_CreateShtml($buffer) {
$fileName = $_SERVER['DOCUMENT_ROOT'] . '/html/news_list.htm';
$fp = fopen($fileName, 'wb');
fwrite($fp, $buffer);
fclose($fp);
return $buffer;
}
3、确保目标目录 ./html/ 已存在且 Web 服务器用户具有写入权限。
4、首次访问 news_list.php 后，检查 ./html/ 目录下是否生成 news_list.htm 文件，并验证其内容完整性。
四、使用模板引擎分离逻辑与展示
借助 Smarty 等轻量模板引擎，将新闻数据与 HTML 布局解耦，提升静态页生成的可维护性与复用性，尤其适合多栏目、多样式场景。
1、下载 Smarty 并解压至项目 vendor/smarty/ 目录，初始化引擎实例：
require_once './vendor/smarty/Smarty.class.php';
$smarty = new Smarty();
$smarty->setTemplateDir('./templates/');
$smarty->setCompileDir('./templates_c/');
2、创建模板文件 list.tpl，仅保留展示逻辑：
<h1>新闻列表</h1>
<ul>
{foreach from=$news item=n}
<li><a href="news_{$n.id}.html">{$n.title|escape}</a> {$n.inputtime|date_format:"%Y-%m-%d"}</li>
{/foreach}
</ul>
3、在 PHP 脚本中查询数据库后 assign 数据并 fetch 渲染：
$smarty->assign('news', $newsArray);
$output = $smarty->fetch('list.tpl');
file_put_contents('./html/news_list.html', $output);
五、设置静态列表页的 URL 映射与访问控制
为避免用户误访动态脚本，需通过服务器配置强制跳转至已生成的静态文件，同时屏蔽原始 PHP 页面的直接暴露。
1、在 Apache 的 .htaccess 文件中添加重写规则：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^news_list\.php$ /html/news_list.html [L,R=301]
2、在 Nginx 配置中加入 location 块：
location = /news_list.php {
return 301 /html/news_list.html;
}
3、对 news_list.php 文件添加访问限制：
if (basename($_SERVER['PHP_SELF']) === 'news_list.php') {
header('HTTP/1.0 403 Forbidden');
exit('此页面已被静态化，请访问 /html/news_list.html');
}
