castor

castor هو برنامج تشغيل مهام موجه نحو DX ومبني بلغة PHP ويضم مجموعة من الوظائف لمعالجة المهام الشائعة.

يمكن اعتباره بديلاً للبرامج النصية Makefile وFabric وInvoc وShell وما إلى ذلك، ولكنه يستفيد من إمكانات البرمجة النصية لـ PHP والنظام البيئي الشامل للمكتبة.

يأتي مزودًا بالعديد من الميزات لتسهيل حياتك:

• تحليل سلس للوسائط والخيارات ، وتبسيط معالجة المدخلات
• دعم الإكمال التلقائي لكتابة أسرع وخالية من الأخطاء
• قائمة مدمجة من الوظائف المفيدة:
  • run() : تشغيل العمليات الخارجية، مما يتيح التكامل السلس مع الأدوات الخارجية
  • io() : عرض مخرجات جميلة والتفاعل مع الجهاز
  • watch() : مشاهدة الملفات وتفعيل الإجراءات تلقائيًا عند تعديل الملفات
  • fs() : إنشاء الملفات والأدلة وإزالتها ومعالجتها
  • وحتى وظائف أكثر تقدما

ملحوظة

لا يزال castor في مرحلة التطوير المبكرة، وواجهة برمجة التطبيقات (API) ليست مستقرة بعد. وحتى لو كان ذلك غير مرجح، فلا يزال من الممكن أن يتغير في المستقبل.

الاستخدام

في castor ، يتم إعداد المهام كوظائف PHP نموذجية مميزة بالسمة #[AsTask()] في ملف castor .php .

يمكن لهذه المهام تشغيل أي كود PHP ولكنها أيضًا تستفيد من وظائف متنوعة للعمليات القياسية التي تأتي معبأة مسبقًا مع castor .

على سبيل المثال:

castorAttributeAsTask; use function castor io; #[AsTask()] function hello(): void { io()->writeln('Hello from castor '); }">

 <?php

namespace greetings ;

use castor  Attribute  AsTask ;
use function castor  io ;

#[AsTask()]
function hello (): void
{
    io ()-> writeln ( ' Hello from castor ' );
}

سيتم الكشف عن مهمة greetings:hello التي يمكنك تشغيلها باستخدام castor greetings:hello :

castor greetings:hello Hello from castor ">

$ castor greetings:hello
Hello from castor

بعد ذلك، يمكنك الانطلاق وإنشاء مهام أكثر تعقيدًا:

#[AsTask(description: ' Clean the infrastructure (remove container, volume, networks) ' )]
function destroy ( bool $ force = false )
{
    if (! $ force ) {
        io ()-> warning ( ' This will permanently remove all containers, volumes, networks... created for this project. ' );
        io ()-> comment ( ' You can use the --force option to avoid this confirmation. ' );

        if (! io ()-> confirm ( ' Are you sure? ' , false )) {
            io ()-> comment ( ' Aborted. ' );

            return ;
        }
    }

    run ( ' docker-compose down -v --remove-orphans --volumes --rmi=local ' );

    notify ( ' The infrastructure has been destroyed. ' )
}

إذا كنت تريد قراءة المزيد عن الاستخدام، يمكنك قراءة وثائق الاستخدام الأساسية، أو مشاهدة بعض الأمثلة.

تثبيت

مع المثبت

نصيحة

هذه هي الطريقة الموصى بها لتثبيت castor على Linux وmacOS. يتطلب PHP >= 8.1.

curl " https://castor.jolicode.com/install " | bash

هناك طرق أخرى لتثبيت castor ، يرجى الرجوع إلى الوثائق.

مزيد من الوثائق

اكتشف المزيد من خلال قراءة المستندات:

• الشروع في العمل مع castor
  • التثبيت والإكمال التلقائي
  • الاستخدام الأساسي
  • تنفيذ العمليات باستخدام run()
  • حجج المهمة
  • استخدام السياق
• المضي قدما مع castor
• مرجع castor
• أمثلة
• الأسئلة المتداولة