告别手动排版：如何使用Composer和GeSHi实现代码高亮自动化-composer-PHP中文网

告别手动排版：如何使用Composer和GeSHi实现代码高亮自动化

花韻仙語

发布： 2025-10-29 13:25:39

原创

378人浏览过

告别手动排版：如何使用composer和geshi实现代码高亮自动化

可以通过一下地址学习composer：学习地址

你是否也遇到过这样的困扰？辛辛苦苦写了一篇技术博客，或者在项目文档中需要展示一段关键代码。你满怀期待地将代码复制粘贴进去，结果发现它和普通文本混在一起，既没有颜色区分，也没有清晰的格式。读者看一眼就觉得头大，更别提理解代码逻辑了。你尝试手动给关键词加粗、改色，但那简直是噩梦——耗时耗力，而且效果还不一定好，尤其当代码量大的时候，简直想放弃。

幸运的是，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 代码：

简篇AI排版

AI排版工具，上传图文素材，秒出专业效果！

134

查看详情

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php'; // Composer 的自动加载

use GeSHi\GeSHi;

// 待高亮的代码
$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 来完全控制代码的显示风格。