mago
Mago 0.0.15
MAGO (dérivé de Mago (PUCIC: ???, MGN), une figure carthaginienne renommée) est une chaîne d'outils pour PHP qui vise à fournir un ensemble d'outils pour aider les développeurs à écrire un meilleur code. Mago s'inspire du langage de programmation de la rouille et de son écosystème, s'efforçant d'apporter une commodité, une fiabilité et une grande expérience de développeur au monde PHP.
Remarque: Ce projet a déjà été nommé «Fennec» avant d'être rebaptisé en raison d'un conflit de dénomination.
Avertissement
Mago est à un stade précoce du développement. De nombreuses fonctionnalités ne sont pas encore implémentées et les fonctionnalités existantes peuvent changer, casser ou cesser de travailler sans préavis. Bien que nous ne faisons pas activement promeubler ou annoncer le projet, nous travaillons en public pour partager nos progrès avec la communauté.
Pour installer rapidement la dernière version de MAGO pour macOS ou Linux, utilisez la commande suivante:
curl : curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bashwget : wget -qO- https://carthage.software/mago.sh | bashPour spécifier un répertoire personnalisé pour le binaire, utilisez l'option --install-diR:
curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bash -s -- --install-dir= " /.bin " Si le répertoire n'est pas sur votre PATH , le script fournira des instructions pour l'ajouter.
sudo Si vous devez installer à l'échelle du système MAGO, vous pouvez utiliser sudo avec la commande d'installation:
curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | sudo bash Vous pouvez trouver des binaires précompilés pour diverses plates-formes sur notre page de versions. Téléchargez simplement les archives de votre plate-forme, extraire-la et placez le binaire Mago quelque part sur votre PATH .
Si vous avez installé de la rouille, vous pouvez installer MAGO à l'aide de cargaison:
cargo install magoPour installer MAGO à partir de la source, vous pouvez cloner le référentiel et construire le projet à l'aide de la cargaison:
git clone https://github.com/carthage-software/mago
cd mago
cargo install --path . Actuellement, Mago est construit autour de PHP 8,3 et prend également en charge PHP 8.4. Bien que le linter et le formateur puissent fonctionner avec des versions antérieures de PHP, nous ne pouvons garantir la compatibilité . Ils pourraient suggérer des correctifs ou d'écrire du code qui n'est compatible qu'avec PHP 8.3 et plus tard.
À ce stade, il n'y a pas d'option pour sélectionner une cible de version PHP, ce qui signifie que Mago fonctionne sous l'hypothèse de versions PHP modernes. À l'avenir, nous prévoyons d'introduire la prise en charge de la sélection d'une cible de version PHP. Une fois implémenté, cette fonctionnalité devrait permettre une meilleure compatibilité avec les versions PHP antérieures, potentiellement à PHP 8.0 ou même plus tôt.
Si vous travaillez avec les versions PHP avant 8.3, veuillez procéder à la prudence et réviser les correctifs suggérés ou le code formaté pour assurer la compatibilité avec votre version.
Pour un démarrage rapide, vous pouvez vous référer à l'exemple de fichiers de configuration fournis:
examples/mago.tomlexamples/mago-full.toml Vous pouvez essayer MAGO en naviguant vers le répertoire examples et en exécutant le Linter sur les exemples de fichiers PHP:
cd examples
mago lint
mago fmt Cela analysera les fichiers PHP situés dans les examples/src/ répertoire et affichera toutes les erreurs de liaison.
Mago est un projet axé sur la communauté, et nous aimerions que vous vous joigniez à nous! Voici quelques façons de contribuer:
Vous avez des questions, des commentaires ou des idées? Rejoignez la communauté Mago sur Discord pour vous connecter avec d'autres développeurs et restez à jour.
Rejoindre ici
Mago est inspiré par plusieurs outils et projets qui ont considérablement contribué à la communauté du développement:
Ces outils nous ont inspirés et ont aidé à façonner la conception et la fonctionnalité de Mago.
Nous tenons à reconnaître les outils PHP suivants qui ont grandement aidé des centaines de milliers de développeurs PHP dans leur voyage, nous-mêmes comprenons:
Bien que Mago soit destiné à être une chaîne d'outils complète qui pourrait éventuellement remplacer certains de ces outils, nous apprécions profondément leurs contributions et les fondations qu'ils ont construites pour la communauté PHP.
Mago est sous licence sous l'un ou l'autre des
à votre option.
À moins que vous ne soyez explicitement indiqué autrement, toute contribution intentionnellement soumise pour inclusion dans MAGO par vous sera double licence comme ci-dessus, sans aucune condition ou conditions supplémentaires.
Merci pour votre intérêt pour Mago. Nous sommes impatients de partager nos progrès et de collaborer avec la communauté à mesure que le projet évolue.
