如何在HTML中安全地显示PHP代码片段而不执行

或<code>标签无法阻止php解释器的解析行为，因为这些标签仅影响浏览器如何渲染文本，而php解释器在将内容发送到浏览器之前就已经完成了其解析和执行工作。</p><h3>理解PHP解析机制</h3><p>PHP解释器在处理.php文件时，会扫描文件内容寻找特定的起始标记（如<?php或<?）。一旦发现这些标记，它就会开始执行其后的代码，直到遇到结束标记（?>）。因此，要阻止代码执行，核心在于阻止解释器识别这些起始标记，或者通过专门的函数让解释器知道这部分内容是用来显示的。</p><h3>方法一：手动编码与htmlentities()函数</h3><p>最直接的方法是将PHP的起始和结束标记进行HTML实体编码，例如将<?php编码为<?php，将?>编码为?>。这样，浏览器会将其显示为字面量，而PHP解释器在解析文件时也不会将其识别为可执行代码的开始。</p><p>然而，手动编码不仅繁琐，而且如果代码片段中包含其他HTML特殊字符（如<、>、&、"、'），它们也可能被浏览器误解，导致显示异常。PHP提供了htmlentities()函数，可以自动将字符串中所有适用的字符转换为HTML实体。这是显示任何可能包含HTML或PHP特殊字符的文本的通用且推荐的方法。</p><p><strong>示例：使用htmlentities()</strong></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><pre class="brush:php;toolbar:false;"><?php
$phpCodeSnippet = '<?php
echo "<h2>PHP is Fun!</h2>";
echo "Hello world!<br>";
echo "I\'m about to learn PHP!<br>";
echo "This ", "string ", "was ", "made ", "with multiple parameters.";
?>';

echo "<pre class="brush:php;toolbar:false;">";
echo htmlentities($phpCodeSnippet);
echo "

标签保持格式，从而在浏览器中显示为纯文本。</p><h3>方法二：利用PHP内置的代码高亮函数（推荐）</h3><p>为了更专业地展示代码，PHP提供了两个专门用于代码高亮显示的内置函数：highlight_string()和highlight_file()。这些函数不仅会自动进行必要的HTML实体编码，还会为代码应用语法高亮，使其更具可读性。</p><h4>highlight_string(string $string, bool $return = false): string|bool</h4><p>此函数接受一个字符串作为参数，该字符串就是要显示并高亮的PHP代码。它会返回带有HTML高亮标记的字符串，或者如果$return参数设置为true，则返回高亮后的字符串而不直接输出。</p><p><strong>示例：使用highlight_string()</strong></p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1375">
                            <img src="https://img.php.cn/upload/ai_manual/001/431/639/68b6d37f49a7e251.png" alt="ChatPDF">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1375">ChatPDF</a>
                            <p>使用ChatPDF，您的文档将变得智能!跟你的PDF文件对话，就好像它是一个完全理解内容的人一样。</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="ChatPDF">
                                <span>327</span>
                            </div>
                        </div>
                        <a href="/ai/1375" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="ChatPDF">
                        </a>
                    </div>
                <pre class="brush:php;toolbar:false;"><?php
$phpCodeSnippet = '<?php
echo "<h2>PHP is Fun!</h2>";
echo "Hello world!<br>";
echo "I\'m about to learn PHP!<br>";
echo "This ", "string ", "was ", "made ", "with multiple parameters.";
?>';

highlight_string($phpCodeSnippet);
?>

// example.php
<?php
function greet($name) {
    echo "Hello, " . $name . "!";
}
greet("World");
?>

<?php
echo "<h3>显示 example.php 文件内容:</h3>";
highlight_file("example.php");
?>

标签是有效的。然而，为了实现专业的代码高亮效果，PHP提供的highlight_string()和highlight_file()函数是最佳选择，它们简化了编码和样式化的过程，并有助于提升代码的可读性。通过遵循将展示代码与执行代码分离的最佳实践，可以构建出清晰、专业的教程或文档页面。