HTML本身是静态标记语言，浏览器在解析页面时不会执行任何PHP代码。要让PHP逻辑在网页中生效，必须由服务器端的PHP解析器先处理包含PHP片段的文件，再把解析后的结果以纯HTML形式返回给浏览器。这个前提决定了我们不能直接在.html文件里写PHP代码然后双击打开，而是需要正确命名文件、配置服务器并使用PHP规定的嵌入标签。
一、基础混写：在HTML中直接嵌入PHP标签
在HTML中嵌入PHP代码最直接的方式，就是让文件以.php作为扩展名，并在需要输出动态内容的位置使用标准PHP标签。文件中大部分内容是普通HTML，只有<?php和?>之间的部分会被PHP解析器执行。执行完毕之后，echo输出的字符串会替换原来的PHP代码段，最终浏览器收到的是完整HTML。下面是一个最简单的混写实例。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>PHP嵌入示例</title>
</head>
<body>
<h1>欢迎来到我的网站</h1>
<p>
<?php
$user = "李雷";
echo "当前登录用户：" . $user;
?>
</p>
</body>
</html>
这个例子中，PHP代码被放在<?php ?>标签内部，变量$user的值通过echo输出，并与HTML中的其他部分自然拼接。除了标准标签，PHP还支持短回显语法<?= ?>，它相当于<?php echo ... ?>，适合在HTML属性中快速输出变量。例如可以写成<input value="<?= htmlspecialchars($name) ?>">，这样代码更简洁。
需要留意的是，PHP早期还支持短标签<? ?>，但该语法依赖php.ini中的short_open_tag=On，并且容易与XML声明冲突，因此不建议在新项目中使用。最佳实践是统一使用标准标签<?php ?>和短回显语法<?= ?>，这样代码兼容性最好，也能避免因服务器配置不同导致源码直接暴露给访客。
二、引入外部PHP文件：include与require的实践
当页面顶部、底部、导航栏等公共部分重复出现在多个页面时，直接在每个页面复制代码会造成维护困难。PHP提供include、include_once、require、require_once四个语句，可以把外部PHP文件加载到当前文件执行。这样做既能复用公共代码，又能把业务逻辑与页面结构分离开来。先创建一个header.php文件，用于输出网站头部和公共函数。
<?php
// header.php
function get_site_name() {
return "我的技术博客";
}
?>
<header>
<h1><?= get_site_name() ?></h1>
</header>
再创建一个footer.php，用来输出页面底部版权信息。使用include或require时，被引入的文件可以包含HTML和PHP混合代码，PHP解析器会照常执行其中的PHP片段。
<footer>
<p>版权信息 © 2024 我的技术博客</p>
</footer>
在主文件index.php中，通过require_once引入头部，再通过include引入底部，中间就可以专注写页面主体内容。
<?php
require_once 'header.php';
?>
<main>
<p>这里是页面主体内容，可以继续写HTML或PHP代码。</p>
</main>
<?php
include 'footer.php';
?>
include和require的主要区别在于错误处理：当文件不存在时，include只发出警告并继续执行后续代码，而require会抛出致命错误并停止脚本运行。如果引入的是库文件或配置文件，通常使用require保证程序完整性；如果是可选模板片段，则可以使用include。include_once和require_once进一步保证文件只被加载一次，避免函数重复定义导致致命错误。
路径方面，相对路径的基准是PHP当前工作目录，不一定是文件所在目录。建议使用__DIR__或$_SERVER['DOCUMENT_ROOT']来拼接绝对路径，例如require __DIR__ . '/header.php';，这样可以避免不同入口文件造成的路径错乱问题。
三、让.html文件也能执行PHP：Apache与Nginx配置
很多场景下希望保留.html后缀，同时享受PHP动态处理能力，例如为了保持旧链接不失效，或者满足SEO需求。默认情况下，Apache和Nginx只会把.php文件交给PHP解释器，.html文件被当作静态文件直接返回。要让.html中的PHP代码生效，必须修改服务器配置，让Web服务器把.html文件也交给PHP引擎处理。
在Apache环境中，可以在.htaccess文件或虚拟主机配置中添加一条AddType指令。保存配置后重启Apache，所有.html文件中的PHP代码就会被解析。如果希望更细粒度控制，也可以使用FilesMatch块来指定处理规则。
AddType application/x-httpd-php .html .htm
<FilesMatch "\.(html|htm)$">
SetHandler application/x-httpd-php
</FilesMatch>
需要提醒的是，让所有.html文件都经过PHP引擎会增加服务器开销，即使文件里没有任何PHP代码，也会占用PHP进程资源。因此生产环境建议仅在需要的目录开启该功能，或者使用伪静态规则把特定URL重写到PHP文件，而不是全局启用.html解析。
Nginx本身不内置PHP处理能力，必须通过FastCGI把请求转发给PHP-FPM。默认的location ~ \.php$规则只匹配.php文件，要让.html被PHP处理，可以额外添加一个location块。
location ~ \.html$ {
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_index index.html;
}
如果PHP-FPM使用Unix套接字，fastcgi_pass需要改成类似unix:/run/php/php8.1-fpm.sock的路径，具体根据环境调整。修改完成后执行nginx -t检查配置语法，再重载Nginx服务。测试时注意查看Nginx错误日志，确认.html请求确实被转发到了PHP-FPM。
四、常见问题与调试建议
在混合编写HTML和PHP时，文件编码很容易被忽视。如果PHP文件包含中文并且带有BOM，可能在输出HTML之前产生额外的空白字符，导致header()函数调用失败。建议统一使用UTF-8无BOM编码保存文件，并在编辑器中关闭自动添加BOM的选项。
另一个常见错误是短标签未开启。如果代码中使用了短标签<? ?>但服务器未开启short_open_tag，PHP代码会原样输出到浏览器，造成源码泄漏。因此在团队协作中应当强制使用标准标签，并在部署前检查php.ini配置。同时，所有输出到HTML的用户输入都应该使用htmlspecialchars()转义，防止跨站脚本攻击。
<?php $input = $_GET['name'] ?? ''; echo htmlspecialchars($input, ENT_QUOTES, 'UTF-8'); ?>
引入外部文件时，路径错误也是高频问题。相对路径的基准目录可能随入口文件变化，因此推荐使用__DIR__或dirname(__FILE__)来定位当前文件所在目录。最后，如果修改了服务器配置但PHP仍不生效，可以从服务器日志入手，依次检查PHP模块是否安装、配置是否被加载、文件扩展名是否匹配，以及Web服务器是否已经重启或重载配置。