Mago 刚刚用 Rust 重写了所有 PHP 工具？

概述

最近在 PHP 开发社区中，工具链的性能和效率一直是个热门话题。最近 Mago 的新工具横空出世，它声称用 Rust 语言重写了 PHP 的核心工具链，包括代码格式化、Lint 检查和静态分析功能。这让我想起了 JavaScript 生态中那些用 Rust 优化的工具（如 SWC 或 Rome），现在 PHP 世界也迎来了类似变革。

PHP 工具链 Mago 1.0.0-alpha.1 发布！

Mago 是什么？

Mago 是一个多功能 PHP 工具链，它整合了三个主要功能：

• 代码格式化（Formatter）：类似于 Laravel 的 Pint 或 Prettier 的 PHP 版本，能自动调整代码风格，确保一致性。
• Lint 检查（Linter）：检测语法错误和潜在问题。
• 静态分析（Static Analyzer）：类似于 PHPStan 或 Rector，能深入检查代码逻辑、类型安全和最佳实践。

最引人注目的是，Mago 完全用 Rust 语言从头构建。这不是简单的包装，而是对 PHP 工具的彻底重写。Rust 以其高性能、安全性和并发能力闻名，在 Node.js 生态中已证明能大幅提升工具速度（如 Bun 或 Deno）。

为什么选择 Rust？传统 PHP 工具如 Pint（基于 PHPCS Fixer）和 PHPStan 都是用 PHP 写的，虽然功能强大，但处理大型项目时速度较慢。Rust 的编译型特性能让 Mago 在解析和处理 PHP 代码时更快，尤其在多线程场景下。

零依赖，简单上手

Mago 的安装非常简洁。通过 Composer 命令

composer require --dev carthage-software/mago

它会下载一个纯二进制文件，几乎零依赖。这意味着不需要额外安装 PHP 扩展或库，就能运行。配置过程也很友好。

“运行 mago init 后，它会引导你设置项目

• 自动检测 composer.json 中的 PHP 版本和框架（如 Laravel）。
• 默认兼容 PSR-12 标准，但你可以自定义规则。
• 配置文件使用 TOML 格式（Rust 生态常见），包括格式化定义、Lint 规则和分析选项。

性能测试

• 格式化速度：用 Pint 格式化 7 个文件需要 0.4 秒，而 Mago 只用了 20 毫秒——快了 20 倍！在更大项目上，Mago 的基准显示它比 Pint 快 45 倍，比 PHPCS Fixer 快更多。
• 静态分析：Mago 分析 30 个文件只需 240 毫秒，而 PHPStan（无缓存）需要 1300 毫秒。即使启用缓存，PHPStan 也仅为 300 毫秒，Mago 仍领先。

功能实测

格式化（FMT）

默认遵循 PSR-12，能移除多余空格、调整函数括号等。Nuno 注意到，它与 Pint 的 Laravel 预设略有差异（如匿名函数的空格处理）。用 --dry-run 可以预览变化，而不实际修改文件。

Lint 检查

运行 mago lint 能快速扫描语法问题。在几毫秒内完成，但输出不如 Pint 详细（缺少具体变更列表）。

静态分析（Analyze）

类似于 Rector，Mago 能自动修复一些代码问题，如移除不必要的 else 语句（因为前置返回已覆盖）。Mago 检测到多余的 else，并用 --fix 自动优化。但有时会生成“破损”代码（如空行或语法错误），这可能是早期版本的 Bug。

此外，Mago 支持忽略特定规则（如用注释 // mago:ignore），类似于 PHPStan 的 @phpstan-ignore-next-line。

总的来说，Mago 的 Lint 和格式化已很可靠，但分析功能不如 PHPStan 成熟，尤其在复杂框架集成上。

优势与挑战

优势

• 极致速度：Rust 的并行处理让 Mago 在大项目上闪耀，潜在地改变 CI/CD 流程。
• 一体化：一个工具取代 Pint、Rector 和 PHPStan，简化工作流。
• 创新潜力：作为 PHP 社区的首个 Rust 重写项目，它可能激发更多工具优化。

挑战

• 功能不全：目前规则较少，不支持所有框架特定模式（如 Laravel 的注解）。
• 集成问题：在真实项目中，可能报告过多无效问题，导致开发者疲于忽略。
• 成熟度：Mago 还需迭代。基准虽快，但不代表所有场景。

Mago 目前无法完全取代现有工具，但它证明了 Rust 在 PHP 生态的潜力。社区需要时间完善它，或许未来它能成为默认选择——不过这可能很遥远。