使用 Homebrew, Nix, winget 安装 mago

项目链接

• 主页

命令和别名

• mago

项目历史

The public GitHub repository was created in October 2024. The documentation brands Mago as an oxidized PHP toolchain and describes three core tools in one binary: analyzer, linter, and formatter.

By 2025 the project had a long beta release train toward 1.0, and by mid-2026 the documentation showed a latest 1.42.0 version. The docs also show configuration discovery, schema publishing for editors, project version pinning, self-update behavior, and WebAssembly playground support.

采用历史

Mago's adoption is still young, but its packaging story is already broad for a PHP developer tool. Official docs list installation through the Carthage shell installer, Composer, Homebrew, Cargo, and Docker, while the supplied Homebrew input also lists Nix and winget packages.

The project has several thousand GitHub stars and more than a hundred forks, which is notable for a relatively new PHP toolchain and reflects interest in Rust-based replacements or complements for PHPStan, Psalm, PHP-CS-Fixer, and formatters.

使用方式

The standard workflow is to install Mago, run `mago init` in a PHP project, and then run `mago analyze`, `mago lint`, or `mago fmt`. The official docs say initialization detects project layout and writes `mago.toml`.

Mago discovers configuration from the workspace, `$XDG_CONFIG_HOME`, `~/.config`, and the home directory, looking for `mago` and `mago.dist` files in TOML, YAML, YML, or JSON formats. It also publishes JSON schemas so editors and CI can validate configuration.

为什么软件包爱好者会关心

Mago is package-nerd significant because it compresses several familiar PHP QA tools into one Rust binary. That changes packaging ergonomics: package managers can offer static analysis, linting, formatting, shell completions, schemas, and update workflows as a single install.

Its version-pinning and schema model are especially relevant to maintainers because code-formatting and lint behavior must be reproducible across local machines, CI, and editor integrations.

时间线

• 2024: Public GitHub repository created.
• 2025: 1.0.0 beta releases published.
• 2026: Documentation shows the 1.42.0 stable line.
• 2026: Benchmarks and playground are promoted in official docs.

Related projects

• PHPStan, Psalm, Phan, PHP-CS-Fixer, and Pretty PHP are adjacent PHP analysis, linting, and formatting tools referenced or benchmarked against in Mago's documentation.
• Composer, Homebrew, Cargo, Docker, Nix, and winget are relevant distribution channels for the toolchain.

来源

• https://github.com/carthage-software/mago
• https://github.com/carthage-software/mago/releases
• https://mago.carthage.software/latest/en/
• https://mago.carthage.software/latest/en/guide/configuration/
• source_facts.package-manager
• source_facts.repo