PackageGenerator

مولد الحزمة

يقوم Package Generator بإنشاء PHP SDK من أي WSDL.

يقوم Package Generator بإنشاء PHP SDK من أي WSDL حتى تتمكن بسهولة من استهلاك أي خدمة ويب SOAP دون التساؤل عن كيفية استخدام SOAP تحت الغطاء.

يوفر Package Generator العديد من الخيارات لإنشاء الحزمة الخاصة بك حتى لو كان بعضها مطلوبًا. تم اختبار هذا المشروع مع العديد من WSDL ويستخدم حاليًا على النظام الأساسي Providr.IO.

يقوم منشئ الحزم بإنشاء ملفات مفصلة في ملف MANIFEST. ننصحك بقراءته لفهم كيف ولماذا يتم إنشاء الملفات بالإضافة إلى الطريقة التي من المفترض أن يتم بها استخدام الفئات التي تم إنشاؤها.

تثبيت

في المشروع:

PackageGenerator --dev">

composer require wsdltophp/ PackageGenerator --dev

مع سطر الأوامر:

$ wget https://phar.wsdltophp.com/wsdltophp-php7.phar
$ chmod +x wsdltophp-php7.phar
$ mv wsdltophp-php7.phar /usr/local/bin/wsdltophp

مع عامل الميناء:

$ docker run --rm -it mikaelcom/wsdltophp:tagname

الاستخدام

هناك طريقتان لإنشاء الحزمة الخاصة بك (بصرف النظر عن وجودك في مشروع وإنشائها من خلال سطر الأوامر):

• مستقل ( السلوك الافتراضي ): هذا يعني أنه تم إنشاء الحزمة كمشروع مستقل بملف composer.json الخاص به. في نهاية عملية الإنشاء، سيحتوي الدليل الجذر الذي تم إنشاء الحزمة فيه على ملف composer.json وملف composer.lock ودليل vendor .
• ليست مستقلة : هذا يعني أنه تم إنشاء الحزمة كجزء من مشروع موجود باستخدام ملف composer.json .json الخاص بها.

تم تفصيل الخيار standalone بالكامل في القسم المستقل.

جميع الخيارات مفصلة بالكامل في صفحة الخيارات.

في المشروع:

PackageGeneratorConfigurationReaderGeneratorOptions; use WsdlToPhp PackageGenerator GeneratorGenerator; // Options definition: the configuration file parameter is optional $options = GeneratorOptions::instance(/* '/path/file.yml' */); $options ->setOrigin('http://developer.ebay.com/webservices/latest/ebaySvc.wsdl') ->setDestination('./MySdk') ->setComposerName('myproject/mysdk'); // Generator instantiation $generator = new Generator($options); // Package generation $generator->generatePackage();">

 use WsdlToPhp  PackageGenerator  ConfigurationReader  GeneratorOptions ;
use WsdlToPhp  PackageGenerator  Generator  Generator ;

// Options definition: the configuration file parameter is optional
$ options = GeneratorOptions:: instance ( /* '/path/file.yml' */ );
$ options
    -> setOrigin ( ' http://developer.ebay.com/webservices/latest/ebaySvc.wsdl ' )
    -> setDestination ( ' ./MySdk ' )
    -> setComposerName ( ' myproject/mysdk ' );
// Generator instantiation
$ generator = new Generator ( $ options );
// Package generation
$ generator -> generatePackage ();

مع سطر الأوامر:

سطر الأوامر هو:

$ wsdltophp generate:package 
    --urlorpath= " http://developer.ebay.com/webservices/latest/ebaySvc.wsdl " 
    --destination= " ./MySdk " 
    --composer-name= " myproject/mysdk " 
    --force

لكي تتمكن من رؤية جميع الخيارات المستخدمة، ما عليك سوى إزالة وسيطة --force .

مع عامل الميناء:

كما هو الحال مع سطر الأوامر أعلاه، ما عليك سوى استخدام سطر أوامر docker run قبل:

$ docker run --rm -it --volume $PWD :/var/www mikaelcom/wsdltophp:tagname generate:package 
    --urlorpath= " http://developer.ebay.com/webservices/latest/ebaySvc.wsdl " 
    --destination= " /var/www/MySdk " 
    --composer-name= " myproject/mysdk " 
    --force

لكي تتمكن من رؤية جميع الخيارات المستخدمة، ما عليك سوى إزالة وسيطة --force .

الإصدارات

4.0

تم إصداره لأول مرة في 03 أبريل 2021، وتم الحفاظ عليه حتى إصدار الإصدار 6.0. يرجى قراءة ملاحظة UPGRADE-4.0 للتعرف على التغييرات الرئيسية.

3.0

تم إصداره لأول مرة في 04 مايو 2018، وتم الحفاظ عليه حتى إصدار الإصدار 5.0. يرجى قراءة ملاحظة UPGRADE-3.0 للتعرف على التغييرات الرئيسية.

لم يتم صيانته بعد الآن : حتى لو لم يتم نشر الإصدار 5 ولم يكن متوقعًا قريبًا، فإن الاحتفاظ بإصدارين، خاصة بالنسبة لإصدار PHP القديم، يستغرق وقتًا طويلاً، آسف للأشخاص الذين ما زالوا يستخدمونه والذين سيواجهون مشكلات تم إصلاحها في الإصدار الأحدث .

2.0

لم تتم صيانته منذ 03 أبريل 2021.

تم إصداره لأول مرة في 29 أبريل 2016، وتم الحفاظ عليه حتى إصدار الإصدار 4.0.

1.0

لم تعد تتم صيانتها بعد الآن

اختبار

PackageGenerator $ phpunit --testsuite=model">

 # launch all tests
$ phpunit

# launch a testsuite: command, configuration, utils, model, container, parser, file, PackageGenerator
$ phpunit --testsuite=model

الاختبار باستخدام دوكر

بفضل صورة Docker الخاصة بـ phpfarm، يمكن إجراء الاختبارات محليًا تحت أي إصدار PHP باستخدام cli:

• فب-7.4

أولاً، تحتاج إلى إنشاء الحاوية الخاصة بك والتي يمكنك القيام بها باستخدام docker-compose عن طريق تشغيل سطر الأوامر أدناه من الدليل الجذر للمشروع:

$ docker-compose up -d --build

لديك بعد ذلك حاوية تسمى package_generator يمكنك من خلالها تشغيل أوامر composer وأوامر php cli مثل:

 # install deps in container (using update ensure it does use the composer.lock file if there is any)
$ docker exec -it package_generator php-7.4 /usr/bin/composer update
# run tests in container
$ docker exec -it package_generator php-7.4 -dmemory_limit=-1 vendor/bin/phpunit

المساهمة

يرجى الاطلاع على المساهمة للحصول على التفاصيل. بالإضافة إلى ذلك، توجد وثائق التعليمات البرمجية على doc.wsdltophp.com.

الاعتمادات

تم إدراج المطورين الذين ساعدوا في هذا المشروع في ملف Composer.json Contributor وهم:

• جمروج
• سيرام
• جورجي اوجانيسيان
• جان زيسكي
• توم موترام
• كاتيرو ميهايل
• ألكسندر إم توريك
• فاليريان جيرار
• hordijk
• أندرياس مولر
• أندرياس كينتزنجر
• هندريك لوب
• جاكوب دريسن
• كليفورد فيكري
• أرنود بوينتيت
• dypa
• tbreuss
• بول ميليخوف
• أليكس كراتكي

التعليمات

إذا كان لديك أي سؤال، يرجى قراءة صفحة الخيارات حول الخيارات المتاحة لإنشاء الحزمة.

هناك أيضًا الأسئلة الشائعة التي تحتوي على أسئلة متنوعة حول إنشاء الحزمة واستخدامها.

ثم إذا كان لا يزال لديك سؤال، فلا تتردد في إنشاء مشكلة.

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا (MIT). يرجى الاطلاع على ملف الترخيص لمزيد من المعلومات.