萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 用函數封裝替代 require/include:模板佈局的現代化實踐

從 require 到函數封裝的演進

傳統 PHP 頁面佈局:

<?php require 'header.php'; ?>
<main>頁面內容</main>
<?php require 'footer.php'; ?>

缺點:變量作用域汙染、難以傳參、邏輯與視圖混雜、無法單元測試。

函數封裝模式

<?php
// layout.php
function renderHeader(string $title, array $meta = []): void {
    // 可在此處理 CSRF Token、SEO 標簽、資源版本號等
    <?php ob_start(); ?>
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title><?= htmlspecialchars($title) ?></title>
    <?php foreach ($meta as $name => $content): ?>
    <meta name="<?= $name ?>" content="<?= htmlspecialchars($content) ?>">
    <?php endforeach; ?>
    <link rel="stylesheet" href="/assets/app.css?v=<?= APP_VERSION ?>">
</head>
<body>
<header><h1><?= htmlspecialchars($title) ?></h1></header>
    <?php echo ob_get_clean(); ?>

 '...']);
?>
<article>...</article>

進階:模板引擎風格的渲染函數

<?php
/**
 * 簡易模板渲染器:提取變量到局部作用域,捕獲輸出
 */
function view(string $template, array $data = []): string {
    extract($data, EXTR_SKIP); // 將 $data['title'] 變為 $title
    
    $file = __DIR__ . "/templates/$template.php";
    if (!is_file($file)) {
        throw new RuntimeException("Template not found: $file");
    }
    
    ob_start();
    try {
        include $file;
    } catch (Throwable $e) {
        ob_end_clean();
        throw $e;
    }
    return ob_get_clean();
}

// templates/article.php
// 可直接使用 $title, $content, $tags
// <h1><?= htmlspecialchars($title) ?></h1>
// <div><?= $content ?></div>

// 控制器
echo view('layout', [
    'title'   => '文章標題',
    'content' => view('article', ['title' => '...', 'content' => '...']),
    'user'    => $currentUser,
]);

對比總結

維度require/include函數封裝模板渲染函數
變量傳遞全局作用域隱式共享顯式參數extract() 顯式注入
作用域隔離無函數作用域函數作用域 + extract
可測試性難易 (Mock 參數)易 (返回字符串斷言)
佈局嵌套手動 include 順序函數調用順序組合調用 view('layout', ['body' => view('child')])
輸出控制直接輸出ob_start 捕獲ob_start 捕獲返回
適用場景極簡頁面、歷史遷移中小項目、無框架中型項目、API 響應、郵件模板

現代框架的做法 (參考)

  • Laravel Blade: @extends('layout')、@section('content')、{{ $var }} 自動轉義、@component、@include。
  • Twig (Symfony): {% extends 'base.html.twig' %}、{{ var|escape }}、沙箱模式、繼承塊。
  • ThinkPHP 模板: {extend name="layout"}、{block name="content"}、{$var}。
  • 原生 PHP 模板 (PHP 8.1+): 使用 readonly class DTO + __invoke 渲染器,結合屬性掛載元數據。

最佳實踐清單

  1. 所有輸出經過 htmlspecialchars / 模板引擎自動轉義,防 XSS。
  2. 佈局與業務分離: 佈局文件只負責骨架,業務數據由控制器準備注入。
  3. 資源版本號: CSS/JS 引用帶 ?v=hash 或 ?v=版本號,解決緩存。
  4. 錯誤邊界: 渲染函數包裹 try-catch,友好降級。
  5. 類型聲明: PHP 7.4+ 類型屬性、PHP 8.0+ 聯合類型、#[Attribute] 元數據。
copyright © 萬盛學電腦網 all rights reserved