本文详细介绍了如何将HTML文件的内容作为纯文本（即代码本身）进行获取、转义和显示，特别适用于通过邮件发送HTML代码或在网页上展示代码片段的场景。核心步骤包括读取HTML内容、使用`htmlspecialchars()`转义特殊字符，以及通过`preg_replace()`将换行符转换为`
`标签，以确保代码结构在HTML渲染环境中清晰可见。
在Web开发中，我们经常需要处理HTML内容。有时，我们的目标不是渲染这些HTML代码以显示其视觉效果，而是希望将其代码本身作为纯文本展示出来，例如在教程中展示代码示例，或者通过电子邮件发送一段HTML代码供他人查阅。直接将HTML内容嵌入到网页或邮件中，往往会被浏览器或邮件客户端解析并渲染，导致我们无法看到原始代码。本文将详细指导您如何正确地将HTML内容转换为可显示的纯文本。
核心步骤：将HTML内容转换为可显示纯文本
要将HTML内容作为纯文本显示，我们需要执行以下三个关键步骤：
1. 获取HTML内容
首先，您需要获取HTML文件的内容。PHP提供了多种方式来完成此操作。
立即学习“PHP免费学习笔记（深入）”；
-
使用 file_get_contents()： 这是最直接且推荐的方式，用于从文件中读取整个内容到一个字符串中。
$filePath = __DIR__ . '/myFile.html'; // 假设myFile.html在当前脚本的同级目录 $htmlContent = file_get_contents($filePath);
-
使用 ob_start() 和 include()： 如果您的HTML内容是动态生成的，或者是一个包含PHP逻辑的文件，可以使用输出缓冲来捕获其输出。
ob_start(); include("myFile.html"); // 假设myFile.html包含HTML及可能的PHP逻辑 $htmlContent = ob_get_contents(); ob_end_clean(); // 清除并关闭输出缓冲这种方法适用于需要执行HTML文件中的PHP代码以生成最终HTML内容的情况。
2. 转义HTML特殊字符
获取到HTML内容后，下一步是转义其中的HTML特殊字符。这是至关重要的一步，它能防止浏览器或邮件客户端将您的HTML代码解释为可渲染的标签。例如，phpcn，> 符号会被转义为 >。
PHP的 htmlspecialchars() 函数是完成此任务的理想工具。
$escapedHtml = htmlspecialchars($htmlContent);
htmlspecialchars() 默认会转义以下字符：
- & (和号) 变为 &
- " (双引号) 变为 "
- ' (单引号) 变为 ' (当 ENT_QUOTES 或 ENT_HTML5 被设置时)
- > (大于号) 变为 >
通过这一步，您的HTML代码将不再被浏览器解析，而是作为纯文本显示。
LANUX V1.0 蓝脑商务网站系统 适用于网店、公司宣传自己的品牌和产品。 系统在代码、页面方面设计简约，浏览和后台管理操作效率高。 此版本带可见即可得的html编辑器, 方便直观添加和编辑要发布的内容。 安装： 1.解压后，更换logo、分类名称、幻灯片的图片及名称和链接、联系我们等等页面。 2.将dbconfig.php里面的数据库配置更改为你的mysql数据库配置 3.将整个文件夹上传至
3. 处理换行符
htmlspecialchars() 函数不会处理换行符（ ）。在HTML环境中，多个连续的空格会被折叠成一个，而换行符则会被忽略，除非它们出现在
标签内。为了在HTML渲染环境中（例如HTML格式的邮件体或网页上的 div 元素）正确显示代码的换行结构，我们需要将换行符转换为HTML的 <br> 标签。</p><p>您可以使用 preg_replace() 函数来完成这个转换：</p><pre class="brush:php;toolbar:false;">$finalContent = preg_replace('/
/', '<br>' . PHP_EOL, $escapedHtml);
- / / 是一个正则表达式，匹配换行符。
- '
' . PHP_EOL 是替换字符串。PHP_EOL 是一个PHP常量，代表当前操作系统的换行符，它有助于保持源文件的可读性，尽管在HTML输出中，
才是关键。
完整示例代码：
<?php
// 假设有一个名为 myFile.html 的文件，内容如下：
// <!-- myFile.html -->
// <!DOCTYPE html>
// <html>
// <head>
// <title>My Page</title>
// </head>
// <body>
// <h1>Hello World!</h1>
// <p>This is a paragraph with <strong>bold</strong> text.</p>
// <script>alert('Hello');</script>
// </body>
// </html>
// 1. 获取HTML内容
$filePath = __DIR__ . '/myFile.html';
if (!file_exists($filePath)) {
// 创建一个示例HTML文件用于演示
file_put_contents($filePath, '<!DOCTYPE html>
<html>
<head>
<title>My Page</title>
</head>
<body>
<h1>Hello World!</h1>
<p>This is a paragraph with <strong>bold</strong> text.</p>
<script>alert('Hello');</script>
</body>
</html>');
}
$htmlContent = file_get_contents($filePath);
// 2. 转义HTML特殊字符
$escapedHtml = htmlspecialchars($htmlContent);
// 3. 处理换行符，转换为<br>标签
$finalContent = preg_replace('/
/', '<br>' . PHP_EOL, $escapedHtml);
// 输出到浏览器或作为HTML邮件体发送
echo "<pre class="brush:php;toolbar:false;" style='background-color: #f4f4f4; padding: 10px; border: 1px solid #ddd;'>";
echo $finalContent;
echo "";
// 如果您想在没有标签的情况下直接在HTML页面中显示， // 那么 $finalContent 已经包含了 <br> 标签，可以直接输出。 // echo $finalContent; ?>
运行上述代码，您将在浏览器中看到 myFile.html 的原始代码，而不是渲染后的页面。
注意事项与最佳实践
-
邮件发送场景：
-
HTML格式邮件： 如果您通过邮件发送，并且邮件内容类型设置为 text/html，那么上述方法（htmlspecialchars() +
转
）是正确的。邮件客户端会渲染HTML，从而正确显示代码的换行和特殊字符。 -
纯文本格式邮件： 如果您需要发送纯文本邮件（邮件内容类型为 text/plain），则不应该将
转换为
。在这种情况下，只需使用 htmlspecialchars() 转义内容，并确保邮件客户端以等宽字体显示，这样原始的 就能保留换行效果。某些邮件客户端可能会对纯文本内容做一些自动换行处理，但通常不会影响代码的可读性。
-
HTML格式邮件： 如果您通过邮件发送，并且邮件内容类型设置为 text/html，那么上述方法（htmlspecialchars() +
转
-
pre 标签的使用： 在网页中显示代码时，通常会将处理后的内容放在
标签内。<pre class="brush:php;toolbar:false;"> 标签会保留文本的空白符（包括空格和换行符）并以等宽字体显示，这对于代码展示非常有用。如果您使用了 <pre class="brush:php;toolbar:false;"> 标签，那么将 转换为 <br> 就不再是必需的，因为 <pre class="brush:php;toolbar:false;"> 会自动处理换行。然而，如果您的目标是发送HTML邮件，并且不确定邮件客户端如何处理 <pre class="brush:php;toolbar:false;"> 标签，那么转换为 <br> 会更保险。
安全性： htmlspecialchars() 不仅用于显示代码，它也是防止跨站脚本攻击（XSS）的关键函数。当您在网页上显示任何来自用户或外部源的数据时，都应该使用 htmlspecialchars() 进行转义，以防止恶意脚本注入。
正则表达式引号： 在PHP中，正则表达式模式可以使用单引号或双引号定义。当模式中包含反斜杠时，例如 "/\n/"，在双引号字符串中反斜杠需要自身转义。使用单引号 ' ' 则不需要额外转义，因为PHP不会解析单引号字符串中的反斜杠序列（除了 ' 和 \）。在性能上，这种差异微乎其微，但使用单引号有时可以避免不必要的反斜杠混淆。
总结
将HTML内容作为纯文本显示，关键在于两步：首先使用 htmlspecialchars() 转义所有HTML特殊字符，防止内容被浏览器或邮件客户端解析；其次，根据输出环境（网页或HTML邮件），选择性地将换行符
替换为
标签，以确保代码的格式和可读性。掌握这些技巧，您就能有效地在各种场景下展示HTML代码本身。
