在学习PHP时，开发者常常会遇到一个需求：如何在网页上展示PHP代码示例，而不是让服务器执行这些代码。当PHP文件被访问时，PHP解释器会查找特定的起始标签（如zuojiankuohaophpcn?php）并执行其后的代码。为了避免这种情况，我们需要对这些特殊字符进行编码，使其在浏览器中显示为文本而非指令。
1. 理解问题核心：PHP解释器的识别
PHP解释器通过识别<?php（或其变体）作为代码块的开始，?>作为代码块的结束。如果这些字符串出现在HTML文件中，并且该文件由PHP解释器处理（例如，文件扩展名为.php），那么解释器就会尝试执行其中的内容。因此，关键在于阻止解释器识别这些“魔法字符串”。
最直接的方法是对<?php和?>中的特殊字符进行HTML实体编码。例如，<应该编码为。
<?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."; ?>
或者，你可以在PHP代码中通过字符串拼接的方式来“迷惑”解释器，但这通常不如直接编码或使用专门函数来得优雅和安全。
立即学习“PHP免费学习笔记（深入）”；
// 这种方式可以避免PHP解释器识别 <?php 标签，但仍需处理其他HTML特殊字符 echo "<?" . "php"; echo "\n"; echo "echo \"<h2>PHP is Fun!</h2>\";\n"; echo "?>";
2. 使用htmlentities()进行通用HTML编码
手动编码所有特殊字符既繁琐又容易出错。PHP提供了一个强大的内置函数htmlentities()，它可以将所有适用的字符转换为HTML实体，包括<、>、&、"等。这不仅可以防止PHP标签被执行，还能确保代码片段中的其他HTML或特殊字符不会被浏览器误解析为指令。
示例：
<?php $php_code_to_display = '<?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."; ?>'; // 使用 htmlentities() 对代码进行编码 $encoded_code = htmlentities($php_code_to_display); echo "<pre>"; // 使用 <pre> 标签保留代码的格式和空白 echo $encoded_code; echo "</pre>"; ?>
这段PHP代码会将 $php_code_to_display 变量中的内容进行编码，然后将其输出在一个<pre>标签中，确保在浏览器中显示为格式化的纯文本。
3. 利用highlight_file()和highlight_string()实现代码高亮
PHP还提供了两个专门用于显示源代码的函数：highlight_file()和highlight_string()。这两个函数不仅会自动对代码进行HTML实体编码，还会为代码添加语法高亮，使其更具可读性，这对于教程和文档来说非常有用。
- highlight_file(string $filename): 用于高亮显示指定PHP文件的内容。
- highlight_string(string $string): 用于高亮显示作为字符串提供的PHP代码。
示例 1: 使用 highlight_string() 显示字符串中的PHP代码
<?php $php_code_to_display = '<?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 "<h3>使用 highlight_string() 显示代码:</h3>"; highlight_string($php_code_to_display); ?>
highlight_string()函数会直接输出HTML格式的代码，包括颜色样式。
示例 2: 使用 highlight_file() 显示文件中的PHP代码
假设你有一个名为 my_example.php 的文件，内容如下：
// my_example.php
<?php
function greet($name) {
echo "Hello, " . $name . "!";
}
greet("World");
?>你可以在另一个PHP文件中这样显示它的内容：
<?php
// display_code.php
echo "<h3>使用 highlight_file() 显示文件内容:</h3>";
highlight_file('my_example.php');
?>highlight_file()函数会读取 my_example.php 的内容并将其以语法高亮的形式输出。
注意事项：
- highlight_file()和highlight_string()默认输出带有内联样式的HTML。如果你想自定义样式，可以捕获其输出（例如，使用输出缓冲 ob_start() 和 ob_get_clean()）并修改生成的HTML。
- 这些函数主要用于显示PHP代码。如果你需要高亮显示其他语言的代码，可能需要考虑使用第三方库，如GeSHi（Generic Syntax Highlighter）。
总结与最佳实践
在HTML中安全地显示PHP代码而不执行它，核心在于对特殊字符进行HTML实体编码。
- 基础编码：手动编码<?php和?>适用于极简单的情况，但容易出错。
- 通用编码：htmlentities()函数提供了一个全面的解决方案，可以编码所有HTML特殊字符，确保代码安全显示。
- 专业高亮：对于需要展示PHP代码示例的教程或文档，highlight_file()和highlight_string()是最佳选择。它们不仅处理了编码问题，还提供了语法高亮，极大地提升了代码的可读性和专业性。
强烈建议在需要展示代码时，优先使用highlight_file()或highlight_string()。这不仅能有效分离“要执行的代码”和“要展示的代码”，还能通过语法高亮提高用户体验。通过这些方法，你可以清晰、安全地在网页上展示你的PHP代码片段。
