PHP：如何在网页或邮件中以纯文本形式显示HTML代码

本文详细介绍了在php中获取html文件内容并将其以纯文本（代码）形式展示的方法。核心在于使用`htmlspecialchars`函数转义html特殊字符，并结合换行符处理，确保html标签不被浏览器解析，而是作为可读代码呈现，适用于网页展示或邮件发送场景。

在许多开发场景中，我们可能需要获取一个HTML文件的内容，但目的不是将其渲染为网页，而是将其作为纯文本或代码块展示出来，例如在教程中展示代码示例，或者通过邮件发送HTML文件的源代码。直接输出HTML内容会导致浏览器或邮件客户端将其解析并渲染，而不是显示其原始标签。为了解决这个问题，我们需要对HTML内容进行适当的处理。

获取HTML内容并进行转义

首先，我们需要从文件中读取HTML内容。PHP提供了多种方式，其中file_get_contents()函数是最直接和推荐的方法。获取内容后，关键步骤是使用htmlspecialchars()函数对内容进行转义。htmlspecialchars()函数会将HTML中的特殊字符（如、&、"、'）转换为对应的HTML实体（如<、>、&等），从而阻止浏览器将其解析为HTML标签。

以下是获取文件内容并进行转义的基本示例：

<?php

// 定义HTML文件路径
$filePath = __DIR__ . '/myFile.html';

// 检查文件是否存在
if (!file_exists($filePath)) {
    die("错误：文件 'myFile.html' 不存在。");
}

// 1. 获取HTML文件的原始内容
$htmlContent = file_get_contents($filePath);

// 2. 转义HTML特殊字符，使其作为纯文本显示
// ENT_QUOTES 参数确保双引号和单引号都被转义
// 'UTF-8' 指定字符编码，防止乱码
$escapedHtml = htmlspecialchars($htmlContent, ENT_QUOTES, 'UTF-8');

// 现在 $escapedHtml 包含了可以安全显示的HTML代码
// echo $escapedHtml;

?>

处理换行符以增强可读性

在将HTML代码作为纯文本显示时，原始的换行符 在浏览器中通常会被忽略，导致所有内容显示在同一行。为了保持代码的结构和可读性，我们需要将这些换行符转换为HTML的
标签，或者将其包裹在

标签中。</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/xiazai/code/10910" title="名品购物网店系统"><img
                                                                                src="https://img.php.cn/upload/webcode/000/000/013/176425560799149.jpg" alt="名品购物网店系统"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/xiazai/code/10910" title="名品购物网店系统">名品购物网店系统</a>
                                                                        <p>适合品牌专卖店专用，从前台的美工设计就开始强调视觉形象，有助于提升商品的档次，打造网店品牌!后台及程序核心比较简洁，着重在线购物，去掉了繁琐的代码及垃圾程式，在结构上更适合一些中高档的时尚品牌商品展示. 率先引入语言包机制，可在1小时内制作出任何语言版本，程序所有应用文字皆引自LANG目录下的语言包文件，独特的套图更换功能，三级物品分类，购物车帖心设计，在国内率先将购物车与商品显示页面完美结合，完</p>
                                                                </div>
                                                                <a href="/xiazai/code/10910" title="名品购物网店系统" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><h4>方法一：转换为<br>标签</h4><p>如果希望内容在普通段落中显示并保留换行，可以将
替换为<br>标签。</p><pre class="brush:php;toolbar:false;"><?php
// 承接上一步的 $escapedHtml

// 3. 将换行符 '
' 替换为 '<br>' 标签，以便在HTML中显示换行
// PHP_EOL 是一个预定义常量，代表当前操作系统的换行符，通常是 '
'
$formattedHtml = preg_replace('/
/', '<br>' . PHP_EOL, $escapedHtml);

// 输出最终格式化的HTML代码
echo $formattedHtml;
?>

方法二：使用

标签</h4><p>另一种更常见且推荐的方法是将转义后的内容包裹在HTML的<pre class="brush:php;toolbar:false;">标签中。<pre class="brush:php;toolbar:false;">标签会保留文本中的空格和换行符，并通常使用等宽字体显示，非常适合展示代码块。</p><pre class="brush:php;toolbar:false;"><?php
// 承接上一步的 $escapedHtml

// 将转义后的HTML内容包裹在 <pre class="brush:php;toolbar:false;"> 标签中
echo '<pre class="brush:php;toolbar:false;">' . $escapedHtml . '

'; ?>

使用

标签通常是更好的选择，因为它不仅保留了换行，还保留了原始的空白字符（如缩进），使得代码的显示效果更接近其原始格式。</p><h3>完整示例代码</h3><p>结合上述步骤，一个完整的解决方案如下：</p><pre class="brush:php;toolbar:false;"><?php

// 定义HTML文件路径
$filePath = __DIR__ . '/myFile.html';

// 检查文件是否存在
if (!file_exists($filePath)) {
    die("错误：文件 'myFile.html' 不存在。请确保 'myFile.html' 在与当前PHP文件相同的目录下。");
}

// 1. 获取HTML文件的原始内容
$htmlContent = file_get_contents($filePath);

// 2. 转义HTML特殊字符，使其作为纯文本显示
// ENT_QUOTES: 同时转义双引号和单引号
// 'UTF-8': 指定字符编码
$escapedHtml = htmlspecialchars($htmlContent, ENT_QUOTES, 'UTF-8');

// 3. 将转义后的内容包裹在 <pre class="brush:php;toolbar:false;"> 标签中，以保留格式和换行
echo '<pre class="brush:php;toolbar:false;">' . $escapedHtml . '

 标签，而是希望在普通HTML流中显示换行，可以使用以下方法：
// $formattedHtmlWithBr = preg_replace('/
/', '<br>' . PHP_EOL, $escapedHtml);
// echo $formattedHtmlWithBr;

?>

注意事项

1. htmlspecialchars() 的重要性：这是将HTML内容转换为可显示代码的关键。如果没有这一步，浏览器会将内容解析为HTML元素，而不是显示其源代码。
2. 字符编码：在使用htmlspecialchars()时，务必指定正确的字符编码（例如'UTF-8'），以避免出现乱码。
3. 换行符处理：
   • 对于网页显示，最推荐的方式是使用

     标签包裹转义后的内容，因为它能完整保留原始格式（包括空格和换行）。

   • 如果出于特定布局需求不能使用

     ，则需要手动将
     替换为<br>。

4. 通过邮件发送：
   • 如果通过邮件发送，你需要确保邮件客户端能够正确解析HTML内容。通常，你需要设置邮件的Content-Type为text/html，然后将包裹在

     标签中的转义HTML代码作为邮件正文发送。

   • 某些纯文本邮件客户端可能无法正确显示HTML标签，即使是

     标签。在这种情况下，可能需要发送纯文本版本，其中换行符是直接的
     ，并且没有HTML标签。

5. 性能考虑：在正则表达式中，使用单引号字符串（如'/ /'）通常比双引号（如"/\n/"）略微高效，因为PHP无需解析其中的转义字符。但在大多数应用中，这种性能差异微乎其微。

总结

在PHP中将HTML文件内容以纯文本或代码形式展示的核心流程是：首先使用file_get_contents()读取文件内容，然后通过htmlspecialchars()函数对HTML特殊字符进行转义，最后选择将转义后的内容包裹在

标签中，或者将换行符替换为<br>标签，以确保在网页或邮件中正确显示其原始代码结构。理解这些步骤和注意事项，可以帮助开发者有效地展示HTML源代码，满足教程、调试或代码分享等多种需求。