当在.php文件中嵌入php代码时，php解释器会自动识别并执行以<?php和?>标记包围的代码。对于初学者而言，如果目标是展示代码本身而非其执行结果，这会带来困扰。简单地使用html的<pre>或<code>标签无法阻止php解释器的解析行为，因为这些标签仅影响浏览器如何渲染文本，而php解释器在将内容发送到浏览器之前就已经完成了其解析和执行工作。
理解PHP解析机制
PHP解释器在处理.php文件时，会扫描文件内容寻找特定的起始标记（如<?php或<?）。一旦发现这些标记，它就会开始执行其后的代码，直到遇到结束标记（?>）。因此，要阻止代码执行，核心在于阻止解释器识别这些起始标记，或者通过专门的函数让解释器知道这部分内容是用来显示的。
方法一：手动编码与htmlentities()函数
最直接的方法是将PHP的起始和结束标记进行HTML实体编码，例如将<?php编码为。这样，浏览器会将其显示为字面量，而PHP解释器在解析文件时也不会将其识别为可执行代码的开始。
然而，手动编码不仅繁琐，而且如果代码片段中包含其他HTML特殊字符（如<、>、&、"、'），它们也可能被浏览器误解，导致显示异常。PHP提供了htmlentities()函数，可以自动将字符串中所有适用的字符转换为HTML实体。这是显示任何可能包含HTML或PHP特殊字符的文本的通用且推荐的方法。
示例：使用htmlentities()
立即学习“PHP免费学习笔记（深入）”；
<?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>"; echo htmlentities($phpCodeSnippet); echo "</pre>"; ?>
上述代码将$phpCodeSnippet变量中的PHP代码字符串进行HTML实体编码，然后通过<pre>标签保持格式，从而在浏览器中显示为纯文本。
方法二：利用PHP内置的代码高亮函数（推荐）
为了更专业地展示代码，PHP提供了两个专门用于代码高亮显示的内置函数：highlight_string()和highlight_file()。这些函数不仅会自动进行必要的HTML实体编码，还会为代码应用语法高亮，使其更具可读性。
highlight_string(string $string, bool $return = false): string|bool
此函数接受一个字符串作为参数，该字符串就是要显示并高亮的PHP代码。它会返回带有HTML高亮标记的字符串，或者如果$return参数设置为true，则返回高亮后的字符串而不直接输出。
示例：使用highlight_string()
<?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); ?>
这段代码将直接输出一个带有语法高亮效果的HTML片段，展示$phpCodeSnippet中的PHP代码。
highlight_file(string $filename, bool $return = false): string|bool
此函数用于读取指定文件中的内容，并将其作为PHP代码进行高亮显示。它非常适合当你希望展示一个独立PHP文件的代码时。
示例：使用highlight_file()
假设你有一个名为example.php的文件，内容如下：
// example.php
<?php
function greet($name) {
echo "Hello, " . $name . "!";
}
greet("World");
?>在你的主.php文件中，你可以这样显示example.php的内容：
<?php
echo "<h3>显示 example.php 文件内容:</h3>";
highlight_file("example.php");
?>highlight_file()会自动读取example.php的内容，对其进行编码和高亮，然后输出到浏览器。
注意事项与最佳实践
- 分离代码与内容： 强烈建议将要展示的PHP代码内容与执行该展示逻辑的代码分离。例如，将要展示的代码放在一个单独的文件中，然后使用highlight_file()来引用它。这可以显著提高代码的可读性和维护性，避免混淆哪些是执行代码，哪些是展示内容。
- 安全性： highlight_string()和highlight_file()函数已经处理了HTML实体编码，因此它们是安全的。但在处理用户提供的内容时，始终要警惕潜在的XSS攻击，确保所有输出到浏览器的数据都经过适当的转义或编码。
- 自定义高亮： PHP的内置高亮函数使用预定义的颜色方案。如果需要更高级或自定义的高亮效果，可以考虑使用第三方库，如GeSHi (Generic Syntax Highlighter)，它支持多种编程语言，并提供更丰富的配置选项。
总结
在HTML中安全且美观地展示PHP代码片段，关键在于阻止PHP解释器的执行并正确处理HTML特殊字符。对于简单的文本显示，htmlentities()结合<pre>标签是有效的。然而，为了实现专业的代码高亮效果，PHP提供的highlight_string()和highlight_file()函数是最佳选择，它们简化了编码和样式化的过程，并有助于提升代码的可读性。通过遵循将展示代码与执行代码分离的最佳实践，可以构建出清晰、专业的教程或文档页面。
