heyjordanparker / mago-sharp

0.2.0 2026-10-09 02:32 UTC

Requires

• php: ~8.1 || ~8.2 || ~8.3 || ~8.4 || ~8.5 || ~8.6
• revolt/event-loop: ^1.0.9

Requires (Dev)

• phpunit/phpunit: ^10.5

Suggests

• ext-curl: To show binary download progress

MIT OR Apache-2.0

• Seifeddine Gmati

• dev

Published on Packagist.org on 2026-10-09 03:44 UTC

README

An extremely fast PHP linter, formatter, and static analyzer, written in Rust.

Mago is a comprehensive toolchain for PHP that helps developers write better code. Inspired by the Rust ecosystem, Mago brings speed, reliability, and an exceptional developer experience to PHP projects of all sizes.

Table of Contents

• Installation
• Getting Started
• Features
• Contributing
• Inspiration & Acknowledgements
• License

Installation

The most common way to install Mago on macOS and Linux is by using our shell script:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/heyJordanParker/mago-sharp/master/scripts/install.sh | bash

To install a specific version:

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/heyJordanParker/mago-sharp/master/scripts/install.sh | bash -s -- --version=0.2.0

For all other installation methods, including Composer, please refer to the Installation Guide.

Getting Started

To get started with Mago and learn how to configure your project, please visit the Getting Started Guide.

Features

• ⚡️ Extremely Fast: Built in Rust for maximum performance.
• 🔍 Lint: Identify issues in your codebase with customizable rules.
• 🔬 Static Analysis: Perform deep analysis of your codebase to catch potential type errors and bugs.
• 🛠️ Automated Fixes: Apply fixes for many lint issues automatically.
• 📜 Formatting: Automatically format your code to adhere to best practices and style guides.
• 🧠 Semantic Checks: Ensure code correctness with robust semantic analysis.
• 🌳 CST Visualization: Explore your code’s structure with Concrete Syntax Tree (CST) parsing.

Contributing

Contributions are welcome.

• See our Contributing Guide to get started.

Inspiration & Acknowledgements

Mago stands on the shoulders of giants. Our design and functionality are heavily inspired by pioneering tools in both the Rust and PHP ecosystems.

Inspirations:

• Clippy: For its comprehensive linting approach.
• OXC: A major inspiration for building a high-performance toolchain in Rust.
• Hakana: For its deep static analysis capabilities.

Acknowledgements:

We deeply respect the foundational work of tools like PHP-CS-Fixer, Psalm, PHPStan, and PHP_CodeSniffer. While Mago aims to offer a unified and faster alternative, these tools paved the way for modern PHP development.

License

Mago is dual-licensed under your choice of the following:

• MIT License (LICENSE-MIT)
• Apache License, Version 2.0 (LICENSE-APACHE)