PHP使用模板制作静态页面

封面图 • 2025-10-08 • PHP

在 PHP 中使用模板来制作静态页面，通常指的是将 HTML 与 PHP 逻辑分离，通过模板引擎（如 Smarty、Twig）或原生的 PHP 模板系统来实现动态内容的生成。最终可以将这些动态页面渲染成静态 HTML 文件，用于提高性能和 SEO。

下面我将介绍几种常见的方法：

---

## ✅ 方法一：使用原生 PHP 模板（不依赖第三方库）

### 1. 创建模板文件（`.php`）

例如，创建一个 `header.php`：

```php

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <title><?php echo $pageTitle; ?></title>
</head>
<body>
```

再创建一个 `footer.php`：

```php

</body>
</html>
```

### 2. 创建内容页面（例如 `index.php`）

```php
<?php
$pageTitle = "首页";
include 'header.php';
?>

<h1>欢迎来到首页</h1>

<?php include 'footer.php'; ?>
```

### 3. 生成静态页面

你可以用 PHP 脚本将动态页面输出为静态 HTML 文件：

```php
<?php
ob_start(); // 启动输出缓冲
include 'index.php'; // 包含你的动态页面
$content = ob_get_clean(); // 获取缓冲区内容并清除

// 写入静态文件
file_put_contents('index.html', $content);
echo "静态页面已生成！";
?>
```

运行这个脚本后，会生成一个 `index.html` 文件，内容与 `index.php` 相同。

---

## ✅ 方法二：使用模板引擎（如 Twig）

### 安装 Twig（使用 Composer）

```bash
composer require twig/twig
```

### 示例代码

#### 1. 创建模板文件 `templates/index.twig`

```twig
{# templates/index.twig #}
<!DOCTYPE html>
<html>
<head>
    <title>{{ pageTitle }}</title>
</head>
<body>
    <h1>{{ heading }}</h1>
</body>
</html>
```

#### 2. PHP 脚本生成静态页面

```php
<?php
require_once 'vendor/autoload.php';

$loader = new \Twig\Loader\FilesystemLoader('templates');
$twig = new \Twig\Environment($loader);

// 渲染模板
$template = $twig->render('index.twig', [
    'pageTitle' => '首页',
    'heading'   => '欢迎访问我的网站'
]);

// 保存为静态 HTML
file_put_contents('index.html', $template);
echo "静态页面已生成！";
?>
```

---

## ✅ 方法三：使用 PHP 模板 + 静态化工具（如 PHP-CMS 或自定义脚本）

如果你是做一个 CMS 系统，也可以写一个后台程序，根据数据库内容生成多个静态页面。

---

## ✅ 总结

| 方法 | 优点 | 缺点 |
|------|------|------|
| 原生 PHP 模板 | 简单易用，无需额外依赖 | 功能有限 |
| Twig / Smarty | 功能强大，语法清晰 | 需要学习模板语言 |
| 自定义脚本 | 可灵活控制生成逻辑 | 开发成本高 |

---

## ✅ 小贴士

- 如果你希望完全静态化网站，可以考虑使用 **静态站点生成器**（如 Jekyll、Hugo、VuePress），它们支持模板系统并能生成纯 HTML。
- 如果只是部分页面需要静态化，可以用 PHP 脚本动态生成 HTML 文件。

---

如果你有具体需求（比如：生成多个页面、使用数据库数据等），我可以提供更详细的示例。