Mago PHP Tools (VS Code Extension)

A Visual Studio Code extension that integrates mago into your PHP workflow.

It provides formatting, linting, and analysis with accurate ranges, safe auto-fix support, and a dedicated Analyze panel similar to VS Code’s Problems / Source Control views.

Features

✅ Format PHP (mago fmt)

Supports:
- Format on Save
- Format Document command
- Right-click → Format Document

✅ Lint PHP (mago lint)

Supports:
- On save linting
- Manual lint command
Diagnostics appear in:
- Editor gutter
- Problems panel
Detects safe fixes from mago output

✅ Auto-Fix Support

Safe fixes are detected from mago’s output

✅ Analyze View (mago analyze)

A dedicated Analyze panel (Activity Bar view), similar to Source Control:

Groups issues by file
Files are displayed relative to mago root

Badges

E = Error
W = Warning
I = Info / Note
H = Help
E*, W*, etc. = safe fix available

Configuration

{
  "magoPhpTools.magoPath": "mago",
  "magoPhpTools.formatOnSave": true,
  "magoPhpTools.lintOnSave": true
}

Setting	Description
`magoPhpTools.magoPath`	Path to the `mago` binary
`magoPhpTools.formatOnSave`	Format PHP files on save
`magoPhpTools.lintOnSave`	Lint PHP files on save

How mago Root Is Resolved

For every operation (format / lint / analyze):

Start from the current file’s directory
Walk up parent folders
Stop at the first folder containing mago.toml
Run mago with that folder as cwd

This allows:

Monorepos
Nested PHP projects
Multiple mago configs in one workspace

Supported File Types

.php

Requirements

mago installed and accessible in PATH
PHP project with mago.toml

License

MIT

Mago PHP Tools

Jack Conway