SQL 格式化工具 jdorn/sql-formatter 使用详解

工具概述

jdorn/sql-formatter 是一个强大的 PHP SQL 格式化工具，它能够将杂乱的 SQL 语句转换为格式良好、易于阅读的代码。该工具提供了多种功能，包括语法高亮、代码格式化、SQL 压缩、查询分割和注释移除等。

核心功能演示

1. SQL 格式化与语法高亮

格式化功能可以将杂乱的 SQL 语句转换为结构清晰的代码，同时语法高亮使不同 SQL 元素（如关键字、函数、字符串等）以不同颜色显示，大大提高可读性。

$formatted = SqlFormatter::format($sql);

示例效果：

• 复杂的嵌套查询会被合理缩进
• SQL 关键字（SELECT、FROM、WHERE等）会被突出显示
• 函数和变量会有不同的颜色区分
• 注释会以特殊样式显示

2. 纯格式化功能

如果只需要格式化而不需要高亮显示，可以关闭高亮选项：

$formatted = SqlFormatter::format($sql, false);

这种模式下，工具仅对 SQL 进行格式整理，不添加任何颜色样式。

3. 纯语法高亮功能

如果只需要高亮而不需要格式化：

$highlighted = SqlFormatter::highlight($sql);

这种模式会保留原始 SQL 的格式，仅添加颜色高亮。

4. SQL 压缩功能

压缩功能可以将格式化的 SQL 压缩为一行，去除不必要的空格和换行：

$compressed = SqlFormatter::compress($sql);

这在需要将 SQL 作为字符串传输或存储时非常有用。

高级功能

5. SQL 查询分割

对于包含多个 SQL 语句的字符串，可以使用分割功能将其拆分为独立的查询：

$queries = SqlFormatter::splitQuery($sql);

这个功能特别适用于：

• 分析 SQL 脚本文件
• 处理批量执行的 SQL 语句
• 调试复杂的多查询事务

6. 注释移除

可以移除 SQL 中的所有注释，包括单行注释(--)、多行注释(/* */)和内联注释(#)：

$nocomments = SqlFormatter::removeComments($sql);

这在需要清理生产环境 SQL 或进行安全检查时很有帮助。

实际应用场景

1. 开发调试：格式化复杂的 SQL 查询，便于理解和优化
2. 日志记录：将执行的 SQL 以整洁格式记录，方便后期分析
3. 教学演示：清晰展示 SQL 结构和语法
4. 代码生成：自动生成格式良好的 SQL 语句
5. SQL 美化工具：集成到数据库管理工具中提供更好的用户体验

技术实现特点

1. 智能缩进：能正确处理嵌套查询、JOIN 子句等复杂结构
2. 关键字识别：支持大多数 SQL 方言的关键字
3. 注释保留：格式化过程中保留原始注释内容
4. 安全处理：能正确处理包含特殊字符的字符串和标识符
5. 性能优化：处理大型 SQL 语句时仍保持良好性能

使用建议

1. 在开发环境中使用格式化+高亮功能，提高代码可读性
2. 在生产日志中使用压缩格式，节省存储空间
3. 处理用户输入的 SQL 时，先移除注释再记录或分析
4. 对于批处理 SQL 脚本，先分割再逐个执行或分析

这个工具特别适合数据库管理员、后端开发者和数据分析师使用，能显著提高 SQL 相关工作的效率和代码质量。