Mago (abgeleitet von Mago (punisch: ???, MGN), eine renommierte karthagische Figur) ist eine Toolchain für PHP, die darauf abzielt, eine Reihe von Tools bereitzustellen, mit denen Entwickler einen besseren Code schreiben können. Mago lässt sich von der Rost -Programmiersprache und ihrem Ökosystem inspirieren und bemüht sich, der PHP -Welt ähnliche Komfort, Zuverlässigkeit und eine großartige Erfahrung im Entwickler zu verleihen.
Hinweis: Dieses Projekt wurde zuvor als „Fennec“ bezeichnet, bevor er aufgrund eines Namenskonflikts umbenannt wurde.
Warnung
Mago befindet sich in einem frühen Entwicklungsstadium. Viele Merkmale werden noch nicht implementiert, und die vorhandene Funktionalität kann sich ohne vorherige Ankündigung ändern, brechen oder aufhören zu arbeiten. Obwohl wir das Projekt nicht aktiv fördern oder bewerben, arbeiten wir in der Öffentlichkeit, um unsere Fortschritte mit der Community zu teilen.
Verwenden Sie den folgenden Befehl, um die neueste Version von Mago für MacOS oder Linux schnell zu installieren:
curl : curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bashwget : wget -qO- https://carthage.software/mago.sh | bashUm ein benutzerdefiniertes Verzeichnis für die Binärdatei anzugeben, verwenden Sie die Option-Installieren Sie die Option:
curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bash -s -- --install-dir= " /.bin " Wenn sich das Verzeichnis nicht auf Ihrem PATH befindet, gibt das Skript Anweisungen zum Hinzufügen.
sudo Wenn Sie Mago Systemwide installieren müssen, können Sie sudo mit dem Installationsbefehl verwenden:
curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | sudo bash Auf unserer Releases -Seite finden Sie vorkompilierte Binärdateien für verschiedene Plattformen. Laden Sie einfach das Archiv für Ihre Plattform herunter, extrahieren Sie es und platzieren Sie den Mago -Binäran irgendwo in Ihrem PATH .
Wenn Sie Rost installiert haben, können Sie Mago mit Fracht installieren:
cargo install magoUm Mago von Source zu installieren, können Sie das Repository klonen und das Projekt mit Fracht erstellen:
git clone https://github.com/carthage-software/mago
cd mago
cargo install --path . Derzeit basiert Mago um PHP 8.3 und unterstützt auch PHP 8.4. Während der Linter und der Formatierer möglicherweise mit früheren Versionen von PHP funktionieren, können wir die Kompatibilität nicht garantieren . Sie können vorschlagen, dass Korrekturen oder Schreibcode geschrieben werden, die nur mit PHP 8.3 und später kompatibel sind.
In dieser Phase gibt es keine Möglichkeit, ein PHP -Versionsziel auszuwählen, was bedeutet, dass Mago unter der Annahme moderner PHP -Versionen arbeitet. In Zukunft planen wir die Unterstützung für die Auswahl eines PHP -Versionsziels. Nach der Implementierung sollte diese Funktion eine bessere Kompatibilität mit früheren PHP -Versionen ermöglichen, möglicherweise bis zu PHP 8.0 oder sogar früher.
Wenn Sie vor 8.3 mit PHP -Versionen arbeiten, gehen Sie bitte mit Vorsicht vor und überprüfen Sie vorgeschlagene Korrekturen oder formatierten Code, um die Kompatibilität mit Ihrer Version sicherzustellen.
Für einen kurzen Start können Sie sich auf die angegebenen Beispielkonfigurationsdateien beziehen:
examples/mago.tomlexamples/mago-full.toml Sie können Mago ausprobieren, indem Sie zum examples navigieren und den Linter in den Beispiel -PHP -Dateien ausführen:
cd examples
mago lint
mago fmt Dadurch werden die PHP -Dateien in den examples/src/ Verzeichnis analysiert und alle Linkerfehler angezeigt.
Mago ist ein Community-betriebenes Projekt, und wir würden uns freuen, wenn Sie sich uns anschließen! Hier sind einige Möglichkeiten, wie Sie einen Beitrag leisten können:
Haben Sie Fragen, Feedback oder Ideen? Schließen Sie sich der Mago Community on Discord an, um sich mit anderen Entwicklern zu verbinden und auf dem neuesten Stand zu bleiben.
Mach mit
Mago ist von mehreren Tools und Projekten inspiriert, die erheblich zur Entwicklungsgemeinschaft beigetragen haben:
Diese Tools haben uns inspiriert und die Gestaltung und Funktionalität von Mago gestaltet.
Wir möchten die folgenden PHP -Tools anerkennen, die Hunderttausende von PHP -Entwicklern auf ihrer Reise stark geholfen haben, einschließlich:
Während Mago eine umfassende Toolchain sein soll, die möglicherweise einige dieser Tools ersetzt, schätzen wir ihre Beiträge und die Grundlage, die sie für die PHP -Community aufgebaut haben, zutiefst.
Mago ist unter einem von lizenziert
nach Ihrer Option.
Sofern Sie nicht ausdrücklich etwas anderes angeben, ist ein Beitrag, der von Ihnen absichtlich zur Aufnahme in Mago eingereicht wird, ohne zusätzliche Bedingungen doppelt lizenziert wie oben.
Vielen Dank für Ihr Interesse an Mago. Wir freuen uns darauf, unsere Fortschritte zu teilen und mit der Community zusammenzuarbeiten, während sich das Projekt entwickelt.