Главная страница>Исходный код JSP>Другие категории
Скачать

MAGO: Окисленный набор инструментов PHP

Маго (полученная от Маго (Пуник: ???, MGN), известная карфагенская фигура) является инструментом для PHP, целью которого является предоставление набора инструментов, чтобы помочь разработчикам писать лучший код. Mago черпает вдохновение из языка программирования Rust и его экосистемы, стремясь принести аналогичный удобство, надежность и отличный опыт разработчика в мире PHP.

Примечание: этот проект ранее был назван «Fennec», прежде чем был переименован из -за конфликта именования.

Отказ от ответственности

Предупреждение

Маго находится на ранней стадии развития. Многие функции еще не реализованы, и существующая функциональность может измениться, разорвать или прекратить работу без предварительного уведомления. Хотя мы не активно продвигаем и не рекламируем проект, мы работаем в обществе, чтобы поделиться своим прогрессом с сообществом.

Установка

Установка с одной линией (рекомендуется)

Чтобы быстро установить последний выпуск MAGO для MacOS или Linux, используйте следующую команду:

Используя curl : 

curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bash

Используя wget : 

wget -qO- https://carthage.software/mago.sh | bash

Пользовательский каталог установки

Чтобы указать пользовательский каталог для двоичного, используйте опцию--Install-DIR: 

curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bash -s -- --install-dir= " /.bin "

Если каталог не находится на вашем PATH , сценарий предоставит инструкции, чтобы добавить его.

Установка с sudo

Если вам нужно установить MAGO по всей системе, вы можете использовать sudo с командой установки: 

curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | sudo bash

Предварительно скомпилированные двоичные файлы

Вы можете найти предварительные двоичные файлы для различных платформ на нашей странице релизов. Просто загрузите архив для своей платформы, извлеките его и поместите бинарку Mago где -то на вашем PATH .

Установка через груз

Если у вас установлена ​​ржавчина, вы можете установить Mago с помощью груза: 

cargo install mago

Установка из источника

Чтобы установить MAGO из Source, вы можете клонировать репозиторий и создать проект, используя груз: 

git clone https://github.com/carthage-software/mago
cd mago
cargo install --path .

PHP версия совместимость

В настоящее время MAGO построен вокруг PHP 8.3, а также поддерживает PHP 8.4. В то время как Linter и Formatter могут работать с более ранними версиями PHP, мы не можем гарантировать совместимость . Они могут предложить исправления или написать код, который совместим только с PHP 8.3 и позже.

На этом этапе нет возможности выбрать цель PHP -версии, что означает, что Mago работает в предположении современных версий PHP. В будущем мы планируем ввести поддержку для выбора цели PHP версии. После реализации эта функция должна обеспечить лучшую совместимость с более ранними версиями PHP, потенциально вплоть до PHP 8.0 или даже раньше.

Если вы работаете с версиями PHP до 8.3, пожалуйста, приступите к осторожности и просмотрите предлагаемые исправления или форматированный код, чтобы обеспечить совместимость с вашей версией.

Использование

Для быстрого запуска вы можете обратиться к приведенным приведенным файлам конфигурации:

  • Простая конфигурация: examples/mago.toml
  • Полная конфигурация со всеми возможными параметрами: examples/mago-full.toml

Вы можете попробовать Mago, перейдя к каталогу examples и запустив Linter в образце PHP -файлов: 

 cd examples
mago lint
mago fmt

Это проанализирует файлы PHP, расположенные в examples/src/ Directory, и отобразит любые ошибки вкладки.

Как вы можете помочь

Mago-это проект, ориентированный на сообщество, и мы хотели бы, чтобы вы присоединились к нам! Вот несколько способов внести свой вклад:

  • Предложить идеи : есть идея для Маго? Мы открыты для предложений, которые могут сделать инструмент еще лучше!
  • Помощь в написании документации : Очистка, удобная документация является ключом к тому, чтобы MAGO доступным для всех. Если вам нравится писать или организовывать документы, мы хотели бы вашей помощи.
  • Внесите код : присоединяйтесь к нам в создании Mago! Пожалуйста, обсудите любую функцию или исправления ошибок в этих вопросах, чтобы убедиться, что мы эффективно координируем.
  • Спонсор проекта : если вы хотите поддержать MAGO в финансовом отношении, рассмотрите возможность спонсирования @azjezz. Каждый вклад помогает!
  • Помогите с искусством : Маго мог бы использовать логотип! Мы будем признателен за помощь опытного художника, чтобы создать оригинальный логотип для Mago. (Обратите внимание, что искусство, сгенерированное AI, не будет принято.)

Присоединяйтесь к сообществу Mago

Есть вопросы, обратная связь или идеи? Присоединяйтесь к сообществу MAGO на Discord, чтобы связаться с другими разработчиками и оставаться в курсе.

Присоединяйтесь сюда

Вдохновение

Маго вдохновлен несколькими инструментами и проектами, которые внесли значительный вклад в сообщество развития:

  • Clippy: коллекция линтов, чтобы поймать общие ошибки и улучшить ваш код ржавчины.
  • OXC: JavaScript Toolchain, написанный в Rust.
  • PHP-Rust-Tools/Palser: анализатор PHP, написанный в ржавчине, который повлиял на наш подход к анализу.
  • Slackhq/Hakana: статический инструмент анализа для Hacklang, написанный в Rust, создатель псалма.

Эти инструменты вдохновили нас и помогли сформировать дизайн и функциональность Маго.

Благодарности

Мы хотели бы отметить следующие инструменты PHP, которые очень помогли сотням тысяч разработчиков PHP в их путешествии, включая нас самих:

  • PHP CS Fixer: инструмент для автоматического исправления проблем стандартов кодирования PHP.
  • Псалом: инструмент статического анализа для поиска ошибок в приложениях PHP.
  • PHPSTAN: инструмент статического анализа PHP.
  • Php_codesniffer: обнаруживает нарушения определенного набора стандартов кодирования.

В то время как Mago предназначен для того, чтобы быть комплексным набором инструментов, который в конечном итоге может заменить некоторые из этих инструментов, мы глубоко ценим их вклад и основу, которую они создали для сообщества PHP.

Лицензия

Маго лицензирован под одним из

  • Лицензия MIT (MIT) - См. Файл MIT для получения подробной информации
  • Лицензия Apache, версия 2.0 (Apache-2.0)-См. Файл лицензии-аааааааааааааааааааааааааааааааааааааа

на вашем варианте.

Вклад

Если вы явно не заявляете иное, какой -либо вклад, преднамеренно предназначенный для включения в MAGO, должен быть двойным лицензией, как указано выше, без каких -либо дополнительных условий или условий.

Спасибо за ваш интерес к Маго. Мы с нетерпением ждем возможности поделиться нашим прогрессом и сотрудничать с сообществом по мере развития проекта.

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все