你是否也遇到过这样的困扰？辛辛苦苦写了一篇技术博客，或者在项目文档中需要展示一段关键代码。你满怀期待地将代码复制粘贴进去，结果发现它和普通文本混在一起，既没有颜色区分，也没有清晰的格式。读者看一眼就觉得头大，更别提理解代码逻辑了。你尝试手动给关键词加粗、改色，但那简直是噩梦——耗时耗力，而且效果还不一定好，尤其当代码量大的时候，简直想放弃。
幸运的是，php 社区为我们提供了一个优雅的解决方案：GeSHi (Generic Syntax Highlighter)。正如其名，GeSHi 是一个通用的语法高亮器，完全用 PHP 编写。它的核心理念很简单：你只需要提供想要高亮的代码片段和对应的编程语言，GeSHi 就能为你生成符合 Xhtml 标准的、专业美观的语法高亮代码。想象一下，从此你的博客和文档中的代码将像 ide 里一样赏心悦目！
composer 让安装变得轻而易举
在过去，引入一个第三方库可能需要手动下载、解压、配置。但有了 Composer，这一切都变得无比简单。如果你还没有 Composer，可以通过上面的学习地址快速掌握。
要将 GeSHi 集成到你的项目中，只需在项目根目录运行一行命令：
<code class="bash">composer require geshi/geshi</code>
Composer 会自动下载 GeSHi 及其所有依赖，并帮你配置好自动加载。这意味着你无需关心文件的存放位置，直接在代码中使用 GeSHi 的类即可。这极大地简化了安装和后续的更新维护工作。
如何使用 GeSHi：一个实际的例子
使用 GeSHi 的过程非常直观。下面是一个简单的 PHP 示例，展示如何高亮一段 PHP 代码：
<pre class="brush:php;toolbar:false;"><?php require 'vendor/autoload.php'; // Composer 的自动加载 use GeSHiGeSHi; // 待高亮的代码 $code = <<<'CODE' <?php function greet($name) { echo "Hello, " . $name . "!"; } greet("World"); // 这是一个多行注释 /* * 另一段注释 */ CODE; // 创建 GeSHi 实例 $geshi = new GeSHi($code, 'php'); // 第一个参数是代码，第二个是语言 // 设置一些选项（可选） $geshi->enable_line_numbers(GESHI_NORMAL_LINE_NUMBERS); // 启用行号 $geshi->set_overall_class('my-code-block'); // 添加自定义 css 类 // 获取高亮后的 HTML $highlighted_code = $geshi->parse_code(); echo '<!DOCTYPE html> <html> <head> <title>GeSHi Code Highlight</title> <style> .my-code-block { background-color: #f5f5f5; border: 1px solid #ccc; padding: 10px; font-family: monospace; white-space: pre-wrap; word-wrap: break-word; } /* GeSHi 默认会生成一些 CSS 类，例如 .kw1 (keyword), .st0 (string) 等 */ .kw1 { color: #007020; } /* 示例：自定义关键字颜色 */ .st0 { color: #d14; } /* 示例：自定义字符串颜色 */ .co1 { color: #999; } /* 示例：自定义注释颜色 */ .lns { color: #aaa; } /* 示例：行号颜色 */ </style> </head> <body> <h1>我的高亮代码示例</h1> ' . $highlighted_code . ' </body> </html>';
运行这段代码，你将看到一段被漂亮高亮、带有行号的 PHP 代码。GeSHi 会自动识别代码中的关键字、字符串、注释等元素，并为它们添加相应的 CSS 类，你可以通过自定义 CSS 来完全控制代码的显示风格。
优势与实际应用效果
使用 GeSHi 带来的好处是显而易见的：
- 提升可读性与专业度： 告别纯文本代码块，你的内容瞬间变得高大上，读者也能更轻松地理解代码逻辑。
- 节省大量时间： 无需手动格式化，GeSHi 自动完成高亮工作，让你专注于内容创作本身。
- 广泛的语言支持： GeSHi 支持数百种编程语言，无论是 PHP、javascript、python 还是 C++，它都能轻松应对。
- 高度可定制： 通过简单的配置和自定义 CSS，你可以让代码高亮风格与你的网站或文档主题完美融合。
- 易于集成与维护： 借助 Composer，GeSHi 的安装和更新都非常方便，降低了项目维护成本。
无论是个人博客、技术文档平台，还是内容管理系统（cms），GeSHi 都是一个不可多得的代码展示利器。它不仅优化了用户体验，也大大提升了内容创作者的工作效率。
总结
代码高亮不再是繁琐的任务，通过 Composer 和 GeSHi 的强强联合，我们可以轻松地将代码片段以专业、美观的方式呈现出来。如果你还在为代码展示而烦恼，不妨现在就尝试一下 GeSHi 吧！它将让你的技术内容焕然一新，更具吸引力。