mago
Mago 0.0.15
Mago (المشتقة من Mago (Punic: ؟؟؟ ، MGN) ، شخصية قرطاجية مشهورة) هي مجموعة أدوات لـ PHP التي تهدف إلى توفير مجموعة من الأدوات لمساعدة المطورين على كتابة رمز أفضل. يستلهم ماجو الإلهام من لغة برمجة الصدأ ونظامها الإيكولوجي ، ويسعى جاهدين لجلب الراحة والموثوقية وتجربة مطور رائعة لعالم PHP.
ملاحظة: تم تسمية هذا المشروع سابقًا "Fennec" قبل إعادة تسمية العلامة التجارية بسبب تعارض التسمية.
تحذير
ماجو في مرحلة مبكرة من التنمية. لم يتم تنفيذ العديد من الميزات بعد ، وقد تتغير الوظائف الحالية أو تتوقف عن العمل أو التوقف عن العمل دون إشعار. على الرغم من أننا لا نروج للمشروع أو نعلنه بنشاط ، إلا أننا نعمل علنًا لتبادل تقدمنا مع المجتمع.
لتثبيت أحدث إصدار من Mago لـ MACOS أو Linux بسرعة ، استخدم الأمر التالي:
curl : curl --proto ' =https ' --tlsv1.2 -sSf https://carthage.software/mago.sh | bashwget : 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 Binary في مكان ما في PATH .
إذا قمت بتثبيت Rust ، فيمكنك تثبيت Mago باستخدام Cargo:
cargo install magoلتثبيت Mago من Source ، يمكنك استنساخ المستودع وبناء المشروع باستخدام البضائع:
git clone https://github.com/carthage-software/mago
cd mago
cargo install --path . حاليًا ، تم بناء 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.tomlexamples/mago-full.toml يمكنك تجربة Mago من خلال التنقل إلى دليل examples وتشغيل Linter على ملفات PHP العينة:
cd examples
mago lint
mago fmt سيؤدي ذلك إلى تحليل ملفات PHP الموجودة في examples/src/ الدليل وعرض أي أخطاء في وضعها.
Mago هو مشروع يحركه المجتمع ، ونود أن تنضم إلينا! فيما يلي بعض الطرق التي يمكنك المساهمة بها:
هل لديك أسئلة أو ردود فعل أو أفكار؟ انضم إلى مجتمع Mago على Discord للتواصل مع المطورين الآخرين والبقاء على اطلاع.
انضم هنا
Mago مستوحى من العديد من الأدوات والمشاريع التي ساهمت بشكل كبير في مجتمع التنمية:
ألهمتنا هذه الأدوات وساعدت في تشكيل تصميم Mago ووظائفه.
نود أن نعترف بأدوات PHP التالية التي ساعدت إلى حد كبير مئات الآلاف من مطوري PHP في رحلتهم ، بما في ذلك أنفسنا:
على الرغم من أن Mago يهدف إلى أن تكون مجموعة أدوات شاملة قد تحل محل بعض هذه الأدوات في النهاية ، إلا أننا نقدر بشدة مساهماتها والمؤسسة التي بنوها لمجتمع PHP.
ماجو مرخصة تحت أي من
في خيارك.
ما لم تقل صراحةً خلاف ذلك ، فإن أي مساهمة تم إرسالها عن عمد لإدراجها في Mago بواسطتك تكون مرخصة مزدوجة على النحو الوارد أعلاه ، دون أي شروط أو شروط إضافية.
شكرا لك على اهتمامك في ماجو. نتطلع إلى مشاركة تقدمنا والتعاون مع المجتمع مع تطور المشروع.
