在开发过程中，尤其是在编写教程或文档时，我们经常需要在网页上展示代码示例，而非执行它们。对于php代码，直接将其放入html文件（例如.php文件）中，php解释器会默认解析并执行<?php和?>标签之间的所有内容。这导致我们希望展示的代码片段被执行，而不是以纯文本形式显示。
理解问题根源
PHP解释器在处理.php文件时，会扫描文件内容，寻找<?php作为PHP代码块的起始标记，并寻找?>作为结束标记。一旦找到这些标记，其间的内容就会被作为PHP代码执行。因此，要阻止代码执行，核心在于阻止PHP解释器识别这些起始和结束标记，或将其视为普通文本。
方法一：手动编码特殊字符与通用HTML转义
最直接的方法是将PHP的起始和结束标记（<?php和?>）以及其他HTML特殊字符进行HTML实体编码。例如，<应编码为。
手动编码示例：
<pre> <?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."; ?> </pre>
这种方法虽然可行，但手动编码所有特殊字符既繁琐又容易出错。PHP提供了一个内置函数htmlentities()，它可以将字符串中所有适用的字符转换为HTML实体，包括<、>、&、"等，从而有效防止浏览器将其解析为HTML标签或PHP代码标记。
立即学习“PHP免费学习笔记（深入）”；
使用 htmlentities() 函数：
<?php $phpCode = '<?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($phpCode); echo '</pre>'; ?>
htmlentities()函数是一个通用的解决方案，适用于展示任何包含HTML或PHP特殊字符的文本。它确保了内容以纯文本形式呈现，但不会提供语法高亮。
方法二：使用PHP内置的代码高亮函数（推荐）
为了更专业地展示PHP代码，并提供语法高亮功能，PHP专门提供了两个内置函数：highlight_string()和highlight_file()。这两个函数不仅会自动进行字符转义以防止代码执行，还会为PHP代码应用默认的语法高亮样式，使其更具可读性。
1. highlight_string()：高亮显示字符串中的PHP代码
如果你想直接在脚本中嵌入要展示的PHP代码字符串，highlight_string()是理想的选择。它接收一个包含PHP代码的字符串作为参数，并输出带有语法高亮的HTML代码。
示例：使用 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() 会直接输出高亮后的HTML highlight_string($phpCodeSnippet); ?>
执行上述代码，你将看到一个带有不同颜色（取决于PHP默认配置）的PHP代码块，且不会被执行。
2. highlight_file()：高亮显示指定PHP文件的内容
如果你希望展示一个独立PHP文件的内容，highlight_file()函数则更为便捷。它接收文件路径作为参数，并读取该文件的内容，然后高亮显示其中的PHP代码。
示例：使用 highlight_file()
假设你有一个名为 example_code.php 的文件，内容如下：
// example_code.php <?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
// 假设 example_code.php 和当前文件在同一目录下
highlight_file('example_code.php');
?>highlight_file()函数同样会输出带有语法高亮的HTML，使得文件内容清晰可读。
注意事项与最佳实践
- 分离内容与逻辑： 强烈建议将要展示的代码内容与执行代码的逻辑分开。例如，将要展示的代码放在一个单独的文件中，然后使用 highlight_file() 来引用它。这有助于提高代码的可维护性和清晰度，避免混淆哪些是执行代码，哪些是展示内容。
- 安全性： highlight_string() 和 highlight_file() 已经处理了基本的HTML实体编码，所以通常是安全的。但如果涉及到从用户输入中获取代码并展示，仍需警惕其他潜在的安全问题（例如XSS），尽管在本场景下风险较低。
- 样式定制： highlight_string() 和 highlight_file() 输出的HTML包含特定的CSS类（例如 span.string, span.keyword）。你可以通过自定义CSS来改变这些代码块的颜色和样式，以符合你的网页设计。
- 第三方库： 对于更复杂的代码高亮需求，例如支持多种编程语言、更丰富的样式主题或更高级的配置选项，可以考虑使用第三方库，如GeSHi（Generic Syntax Highlighter）。然而，对于仅仅展示PHP代码而言，PHP内置的函数通常已足够。
总结
在HTML页面中安全且美观地展示PHP代码片段，关键在于阻止PHP解释器执行代码，并进行适当的HTML实体编码。虽然手动编码和htmlentities()函数可以实现基本功能，但PHP提供的highlight_string()和highlight_file()函数是更优的选择。它们不仅能自动处理字符转义，还能为代码提供语法高亮，极大地提升了代码示例的可读性和专业性。通过合理运用这些工具，我们可以轻松地在网页上呈现清晰、易懂的PHP代码教程或示例。
