# highlight_string

(PHP 4, PHP 5, PHP 7)

highlight_string — 字符串的语法高亮

### 说明

highlight_string ( string `$str` [, bool `$return` = false ] ) : mixed

使用PHP内置的语法高亮器所定义的颜色，打印输出或者返回输出或者返回语法高亮版本的PHP代码。

### 参数

`str`

  需要高亮的PHP代码，应当包含开始标签。

`return`

  设置该参数为 `TRUE` 使函数返回高亮后的代码。

### 返回值

如果 `return` 设置为 `TRUE`，高亮后的代码不会被打印输出，而是以字符串的形式返回。 高亮成功返回 `TRUE`，否则返回 `FALSE`。

### 范例

Example #1 highlight_string() 例子

    <?php
    highlight_string('<?php phpinfo(); ?>');
    ?>

以上例程会输出：

    <code><span style="color: #000000">
    <span style="color: #0000BB">&lt;?php phpinfo</span><span style="color: #007700">(); </span><span style="color: #0000BB">?&gt;</span>
    </span>
    </code>

### 注释

> Note:

> 当使用了`return` 参数时，本函数使用其内部输出缓冲，因此不能在 ob_start() 回调函数的内部使用。

产生的 HTML 标记可能会有更改。

### 参见

- highlight_file() - 语法高亮一个文件
- 高亮 INI 指令