mago

MAGO : 산화 된 PHP 툴체인

Mago (Mago (Punic : ???, MGN)에서 파생 된 유명한 Carthaginian 인물)는 PHP를위한 도구 체인으로 개발자가 더 나은 코드를 작성할 수 있도록 도구 세트를 제공하는 것을 목표로합니다. Mago는 Rust 프로그래밍 언어와 생태계에서 영감을 얻어 PHP 세계에 유사한 편의성, 신뢰성 및 훌륭한 개발자 경험을 제공하기 위해 노력합니다.

---

참고 :이 프로젝트는 이름 지정 충돌로 인해 브랜드가 변경되기 전에 이전에 "Fennec"으로 선정되었습니다.

부인 성명

경고

Mago는 개발 초기 단계에 있습니다. 많은 기능이 아직 구현되지 않았으며 기존 기능이 변경, 파괴 또는 통지없이 작동을 중단 할 수 있습니다. 우리는 프로젝트를 적극적으로 홍보하거나 광고하지는 않지만 공개적으로 커뮤니티와 진도를 공유하기 위해 노력하고 있습니다.

설치

단선 설치 (권장)

MAGO 용 MAGO 또는 Linux의 최신 릴리스를 빠르게 설치하려면 다음 명령을 사용하십시오.

curl 사용 :

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

wget 사용 :

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

사용자 정의 설치 디렉토리

바이너리에 대한 사용자 정의 디렉토리를 지정하려면-인스턴 디르 옵션을 사용하십시오.

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

미리 컴파일 된 이진

릴리스 페이지에서 다양한 플랫폼에 대한 사전 컴파일 된 바이너리를 찾을 수 있습니다. 플랫폼의 아카이브를 다운로드하여 추출하고 PATH 어딘가에 Mago Binary를 배치하기 만하면됩니다.

화물을 통한 설치

Rust를 설치 한 경우화물을 사용하여 Mago를 설치할 수 있습니다.

cargo install mago

소스에서 설치

소스에서 Mago를 설치하려면 저장소를 복제하고화물을 사용하여 프로젝트를 구축 할 수 있습니다.

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 또는 이전에 더 나은 호환성을 제공해야합니다.

8.3 이전에 PHP 버전으로 작업하는 경우주의를 기울이고 제안 된 수정 또는 형식 코드를 검토하여 버전과의 호환성을 보장하십시오.

용법

빠른 시작하려면 제공된 예제 구성 파일을 참조 할 수 있습니다.

• 간단한 구성 : examples/mago.toml
• 가능한 모든 옵션을 갖춘 전체 구성 : examples/mago-full.toml

examples 디렉토리를 탐색하고 샘플 PHP 파일에서 Linter를 실행하여 MAGO를 시도 할 수 있습니다.

 cd examples
mago lint
mago fmt

이렇게하면 examples/src/ 디렉토리에있는 PHP 파일을 분석하고 라인 오류가 표시됩니다.

당신이 도울 수있는 방법

Mago는 커뮤니티 중심의 프로젝트이며, 우리는 당신이 우리와 함께하기를 바랍니다! 기여할 수있는 몇 가지 방법은 다음과 같습니다.

• 아이디어 제안 : Mago에 대한 아이디어가 있습니까? 우리는 도구 체인을 더 좋게 만들 수있는 제안에 개방적입니다!
• 문서 작성을 도와주세요 : 명확하고 사용자 친화적 인 문서는 모든 사람이 MAGO에 액세스 할 수 있도록하는 핵심입니다. 문서 작성 또는 조직을 좋아한다면 우리는 당신의 도움을 좋아합니다.
• 기여 코드 : Mago를 구축하는 데 참여하십시오! 먼저 문제의 기능이나 버그 수정에 대해 논의하여 효과적으로 조정하십시오.
• 프로젝트 후원 : Mago를 재정적으로 지원하려면 @azjezz를 후원하는 것을 고려하십시오. 모든 기여가 도움이됩니다!
• 예술에 대한 도움 : Mago는 로고를 사용할 수 있습니다! 우리는 숙련 된 예술가의 도움을 받아 Mago의 독창적 인 로고를 만들어 주셔서 감사합니다. (AI 생성 예술은 받아 들여지지 않을 것입니다.)

Mago 커뮤니티에 가입하십시오

질문, 피드백 또는 아이디어가 있습니까? Discord의 Mago 커뮤니티에 가입하여 다른 개발자와 연결하고 최신 상태를 유지하십시오.

여기에 가입하십시오

영감

Mago는 개발 커뮤니티에 크게 기여한 몇 가지 도구와 프로젝트에서 영감을 얻었습니다.

• Clippy : 일반적인 실수를 저지르고 녹 코드를 개선하기위한 린트 모음.
• OXC : 녹로 쓰여진 JavaScript 툴체인.
• PHP-Rust-Tools/Parser : Rust로 작성된 PHP 파서는 구문 분석 방식에 영향을 미쳤습니다.
• Slackhq/Hakana : Psalm의 제작자가 Rust로 작성한 Hacklang의 정적 분석 도구.

이 도구는 우리에게 영감을 주었고 Mago의 디자인과 기능을 형성하는 데 도움이되었습니다.

감사의 말

우리는 수십만 명의 PHP 개발자가 여행에서 크게 도움이 된 다음 PHP 도구를 인정하고 싶습니다.

• PHP CS Fixer : PHP 코딩 표준 문제를 자동으로 수정하는 도구.
• 시편 : PHP 응용 프로그램에서 오류를 찾기위한 정적 분석 도구.
• PHPSTAN : PHP 정적 분석 도구.
• PHP_CODESNIFFER : 정의 된 코딩 표준 세트의 위반을 감지합니다.

Mago는 결국 이러한 도구 중 일부를 대체 할 수있는 포괄적 인 도구 체인이 되려고하지만 PHP 커뮤니티를 위해 구축 한 기여와 기반에 깊이 감사드립니다.

특허

Mago는 중 하나에 따라 라이센스가 부여됩니다

• MIT 라이센스 (MIT) - 자세한 내용은 라이센스 MIT 파일을 참조하십시오
• Apache License, Version 2.0 (Apache-2.0)-자세한 내용은 라이센스 아파치 파일을 참조하십시오.

귀하의 선택에.

기부금

귀하가 명시 적으로 명시 적으로 명시하지 않는 한, 귀하가 Mago에 포함시키기 위해 의도적으로 제출 된 모든 기부금은 추가 이용 약관이나 조건없이 위와 같이 이중 라이센스를받습니다.

---

Mago에 관심을 가져 주셔서 감사합니다. 우리는 프로젝트가 발전함에 따라 진행 상황을 공유하고 커뮤니티와 협력하기를 기대합니다.