PHP Academy · 课时

模板模式：分离逻辑与视图

Q: 「模板模式：分离逻辑与视图」这节课中我会学到什么？

将业务逻辑移入 PHP 文件，并保持 HTML 模板整洁。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将业务逻辑移入 PHP 文件，并保持 HTML 模板整洁。

模板模式：分离逻辑与视图 是 CoddyKit 上的免费 PHP Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

为何要将逻辑与视图分离？

将数据库查询、业务逻辑和 HTML 混在同一个文件中，会导致：

代码杂乱且难以阅读
逻辑难以测试和复用
跳过验证时容易出现安全问题

解决方案是：将每项关注点分别放在自己的层中。

简单模板模式

先运行所有 PHP 逻辑，然后输出 HTML：

<?php
// --- LOGIC (top) ---
require 'config.php';
$userId = (int) ($_GET['id'] ?? 0);
$user   = getUserById($userId);
if (!$user) {
    http_response_code(404);
    require '404.php';
    exit;
}
$pageTitle = 'Profile: ' . $user['name'];

// --- VIEW (bottom) ---
require 'layout/header.php';
?>
<main>
    <h1><?= htmlspecialchars($user['name']) ?></h1>
</main>
<?php require 'layout/footer.php'; ?>

分离控制器和视图文件

请将代码拆分为控制器文件和视图文件：

// profile.php (controller)
<?php
require 'config.php';
$userId = (int) ($_GET['id'] ?? 0);
$user   = getUserById($userId);
$posts  = getPostsByUser($userId);

if (!$user) { require '404.php'; exit; }

require 'views/profile.view.php';

// views/profile.view.php (view) — only HTML and echoes
// No DB calls allowed here!

准备视图数据

请在将数据发送到视图之前，在逻辑层中格式化所有数据：

<?php
$user = getUserById($id);

$viewData = [
    'userName'   => htmlspecialchars($user['name']),
    'avatarUrl'  => $user['avatar'] ?? '/default.png',
    'joinedDate' => date('F Y', strtotime($user['created_at'])),
    'isAdmin'    => in_array('admin', $user['roles']),
];

extract($viewData);  // Makes $userName, $avatarUrl, etc.
require 'views/profile.view.php';

模板函数模式

请将视图渲染封装在函数中，以便更清晰地复用：

<?php
function render(string $view, array $data = []): void {
    extract($data);  // Create variables from array
    require __DIR__ . '/views/' . $view . '.php';
}

// Usage:
render('profile', [
    'name'   => $user['name'],
    'email'  => $user['email'],
]);

输出缓冲模板引擎

请渲染模板并将其作为字符串返回：

<?php
function renderToString(string $view, array $data = []): string {
    extract($data);
    ob_start();
    require __DIR__ . '/views/' . $view . '.php';
    return ob_get_clean();
}

$html = renderToString('email/welcome', ['name' => 'Alice']);
mail($to, 'Welcome!', $html, 'Content-Type: text/html');

何时使用模板引擎

对于简单网站，PHP 的原生模板功能已经足够。出现以下情况时，请考虑使用 Twig 或 Blade：

您希望默认自动转义
设计人员需要在不了解 PHP 的情况下编辑模板
您需要模板继承和宏
项目包含许多视图并且规模不断扩大

Twig 示例

Twig（Symfony 使用的模板引擎）提供了带自动转义功能的简洁语法：

<?php
// After: composer require twig/twig
$loader = new Twig\Loader\FilesystemLoader('/templates');
$twig   = new Twig\Environment($loader, ['cache' => '/tmp/twig']);

echo $twig->render('profile.html.twig', [
    'user'  => $user,
    'posts' => $posts,
]);

// profile.html.twig:
// <h1>{{ user.name }}</h1>  -- auto-escaped by default

MVC 目录结构

适用于纯 PHP 项目的最小 MVC 布局：

project/
  controllers/
    UserController.php   -- handles request, calls model
  models/
    User.php             -- database queries
  views/
    users/
      profile.php        -- display only, no logic
  public/
    index.php            -- front controller (router)

前端控制器模式

请通过单一入口点处理所有请求：

<?php
// public/index.php (front controller)
require __DIR__ . '/../vendor/autoload.php';

$uri    = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$routes = require '../routes.php';

if (isset($routes[$uri])) {
    [$controller, $action] = $routes[$uri];
    (new $controller)->$action();
} else {
    http_response_code(404);
    require '../views/404.php';
}

单一职责原则

每个文件都应该只有一个需要修改的原因：

模型：只有在数据结构或查询逻辑发生变化时才修改
控制器：只有在请求处理逻辑发生变化时才修改
视图：只有在界面或布局发生变化时才修改

这样可以更轻松地独立测试和维护每个部分。

快速检查

将 PHP 逻辑与 HTML 视图代码分离的主要好处是什么？

回顾：模板模式

关键要点：

先运行所有逻辑，然后输出 HTML
将代码拆分为控制器文件和视图文件
使用带有 extract() 的 render() 函数
使用输出缓冲捕获渲染后的 HTML
对于较大的项目，请考虑使用 Twig/Blade
前端控制器将所有请求路由到处理程序

常见问题解答

「模板模式：分离逻辑与视图」课时是免费的吗？

是的 — 「模板模式：分离逻辑与视图」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「模板模式：分离逻辑与视图」这节课中我会学到什么？

将业务逻辑移入 PHP 文件，并保持 HTML 模板整洁。你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「模板模式：分离逻辑与视图」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 PHP Academy