无需模板引擎，如何用PHP函数实现母版模板内容嵌入？

你的思路完全找对方向啦！这种用PHP原生函数实现的轻量模板机制，刚好适合小型项目的需求，我给你把细节补全并优化下：

1. 完善母版页（layout.template.php） #

先把母版页的结构理清楚，给内容区域的函数加个默认实现，避免子页面没定义函数时直接报错：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <!-- 支持子页面自定义标题 -->
    <title><?php echo isset($pageTitle) ? $pageTitle : 'Default Page'; ?></title>
    <!-- 全局公共资源，比如全局CSS、JS都放这里 -->
</head>
<body>
    <!-- 全局头部，比如导航栏 -->
    <header>
        <nav>
            <a href="index.php">Home</a> | 
            <a href="about.php">About</a> | 
            <a href="contact.php">Contact</a>
        </nav>
    </header>

    <!-- 核心内容区域，调用子页面的内容函数 -->
    <main class="content-container">
        <?php 
        // 如果子页面没定义show_content，就显示默认内容
        if (!function_exists('show_content')) {
            function show_content() {
                echo '<p>⚠️ No content defined for this page.</p>';
            }
        }
        show_content(); 
        ?>
    </main>

    <!-- 全局底部 -->
    <footer>
        <p>© 2024 My Small Project</p>
    </footer>
</body>
</html>

2. 子页面的正确写法（index.php） #

这里要注意一个关键顺序：先定义内容函数，再引入母版页——因为PHP是从上到下执行的，母版页加载时得能找到show_content()函数才行：

<?php
// 子页面自定义变量，传给母版页用
$pageTitle = 'Home Page';

// 定义当前页面的专属内容
function show_content() {
?>
    <div class="home-content">
        <h1>Welcome to My Project!</h1>
        <p>This is the main content of the index page.</p>
        <div class="feature-list">
            <h3>Key Features</h3>
            <ul>
                <li>Lightweight & No Template Engine</li>
                <li>Native PHP Implementation</li>
                <li>Easy to Maintain</li>
            </ul>
        </div>
    </div>
<?php
}

// 最后引入母版页，母版页会自动渲染内容
require_once 'layout.template.php';
?>

3. 其他子页面示例（比如about.php） #

只需要替换show_content()里的内容和自定义变量，逻辑完全一致：

<?php
$pageTitle = 'About Us';

function show_content() {
?>
    <div class="about-content">
        <h1>About This Project</h1>
        <p>We're building a small PHP application without relying on any template engines, using native PHP features to keep things simple.</p>
    </div>
<?php
}

require_once 'layout.template.php';
?>

核心原理说明 #

• 利用PHP的函数作用域特性：子页面先定义函数，再引入母版页，母版页就能访问并执行这个函数。
• 通过全局变量（比如$pageTitle）可以让子页面给母版页传递自定义数据，实现页面标题、meta信息等个性化配置。
• 给show_content()加默认实现，能避免子页面遗漏定义函数导致的致命错误，提升稳定性。

这种方案完全依赖原生PHP，轻量无依赖，非常适合小型项目快速搭建页面结构。

内容的提问来源于stack exchange，提问作者Joshua