We are thrilled to share this early snapshot of Mago, a PHP toolchain inspired by the Rust ecosystem’s ergonomics, reliability, and developer experience. However, please note that this is a non-production, pre-1.0.0 release. The tool is still under heavy development, and many features are incomplete or subject to change. We’re working diligently to refine Mago and eventually reach a stable 1.0.0 milestone.
Important Note:
This is a non-production release. Features may be incomplete, change rapidly, or break unexpectedly as we continue to evolve Mago. Your feedback and insights are invaluable during this phase!
New in this Release:
- mago lint: Run our evolving set of linter rules against your PHP project. It’s early days, but we’re adding new rules regularly to help you catch common issues and improve your code quality.
- mago fmt: A fast, smart formatter inspired by Prettier.js. It adheres to PSR-12 standards by default, but also offers various options to customize formatting behavior to your liking.
- mago ast --file path/to/php-file.php: View the Abstract Syntax Tree (AST) for a given PHP file. While primarily an internal debugging tool, it can help advanced users understand how Mago interprets PHP code under the hood.
How to Get Mago:
-
Option 1: Download the Binary: Choose the binary for your platform from the release artifacts below.
-
Option 2: Use Cargo:
cargo install mago
for macOS Users: If you download the binary directly, you’ll need to open System Preferences > Security & Privacy and approve the binary before running it, since it’s not from a recognized developer.
Known Limitations:
- The tool’s behavior and features may change frequently.
- Not all planned features are implemented yet.
- Expect incomplete documentation and limited testing at this stage.
A Glimpse of the Future:
Mago is destined to become a comprehensive toolchain, offering linting, formatting, static analysis, refactoring, and more. We’re working hard toward 1.0.0, where you can expect greater stability, a richer feature set, and a smoother experience.
Your Input Matters:
This project is being developed in public to foster a community-driven process. We invite you to try Mago, share feedback, report bugs, and contribute. Together, we’ll shape Mago into a reliable, production-ready PHP toolchain.
Thank you for joining us early on this journey!