PHP：将HTML内容转换为可显示的纯文本代码-php教程-PHP中文网

PHP：将HTML内容转换为可显示的纯文本代码

聖光之護

发布： 2025-11-04 13:13:40

原创

341人浏览过

php：将html内容转换为可显示的纯文本代码

本文详细介绍了如何将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代码解释为可渲染的标签。例如，zuojiankuohaophpcn 符号会被转义为。

PHP的 htmlspecialchars() 函数是完成此任务的理想工具。

$escapedHtml = htmlspecialchars($htmlContent);

登录后复制

htmlspecialchars() 默认会转义以下字符：

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

查看详情

& (和号) 变为 &
" (双引号) 变为 "
' (单引号) 变为 ' (当 ENT_QUOTES 或 ENT_HTML5 被设置时)
< (小于号) 变为
> (大于号) 变为 >

通过这一步，您的HTML代码将不再被浏览器解析，而是作为纯文本显示。

3. 处理换行符

htmlspecialchars() 函数不会处理换行符（）。在HTML环境中，多个连续的空格会被折叠成一个，而换行符则会被忽略，除非它们出现在 <pre> 标签内。为了在HTML渲染环境中（例如HTML格式的邮件体或网页上的 div 元素）正确显示代码的换行结构，我们需要将换行符转换为HTML的 标签。

您可以使用 preg_replace() 函数来完成这个转换：

$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 style='background-color: #f4f4f4; padding: 10px; border: 1px solid #ddd;'>";
echo $finalContent;
echo "</pre>";

// 如果您想在没有<pre>标签的情况下直接在HTML页面中显示，
// 那么 $finalContent 已经包含了 <br> 标签，可以直接输出。
// echo $finalContent;

?>

登录后复制

运行上述代码，您将在浏览器中看到 myFile.html 的原始代码，而不是渲染后的页面。

注意事项与最佳实践

邮件发送场景：
- HTML格式邮件： 如果您通过邮件发送，并且邮件内容类型设置为 text/html，那么上述方法（htmlspecialchars() + 转 ）是正确的。邮件客户端会渲染HTML，从而正确显示代码的换行和特殊字符。
- 纯文本格式邮件： 如果您需要发送纯文本邮件（邮件内容类型为 text/plain），则不应该将转换为 。在这种情况下，只需使用 htmlspecialchars() 转义内容，并确保邮件客户端以等宽字体显示，这样原始的就能保留换行效果。某些邮件客户端可能会对纯文本内容做一些自动换行处理，但通常不会影响代码的可读性。
pre 标签的使用： 在网页中显示代码时，通常会将处理后的内容放在 <pre> 标签内。<pre> 标签会保留文本的空白符（包括空格和换行符）并以等宽字体显示，这对于代码展示非常有用。如果您使用了 <pre> 标签，那么将转换为 就不再是必需的，因为 <pre> 会自动处理换行。然而，如果您的目标是发送HTML邮件，并且不确定邮件客户端如何处理 <pre> 标签，那么转换为 会更保险。
安全性： htmlspecialchars() 不仅用于显示代码，它也是防止跨站脚本攻击（XSS）的关键函数。当您在网页上显示任何来自用户或外部源的数据时，都应该使用 htmlspecialchars() 进行转义，以防止恶意脚本注入。
正则表达式引号： 在PHP中，正则表达式模式可以使用单引号或双引号定义。当模式中包含反斜杠时，例如 "/\n/"，在双引号字符串中反斜杠需要自身转义。使用单引号 ' ' 则不需要额外转义，因为PHP不会解析单引号字符串中的反斜杠序列（除了 ' 和 \）。在性能上，这种差异微乎其微，但使用单引号有时可以避免不必要的反斜杠混淆。

总结

将HTML内容作为纯文本显示，关键在于两步：首先使用 htmlspecialchars() 转义所有HTML特殊字符，防止内容被浏览器或邮件客户端解析；其次，根据输出环境（网页或HTML邮件），选择性地将换行符替换为 标签，以确保代码的格式和可读性。掌握这些技巧，您就能有效地在各种场景下展示HTML代码本身。

以上就是PHP：将HTML内容转换为可显示的纯文本代码的详细内容，更多请关注php中文网其它相关文章！