php wechaty

php-wechaty

قراءة التعليمات البرمجية

ربط روبوتات الدردشة

Wechaty عبارة عن SDK للمحادثة لصانعي Chatbot يمكنها مساعدتك في إنشاء روبوت في 8 أسطر من PHP

صوت المطورين

"يعد Wechaty حلاً رائعًا، وأعتقد أنه سيكون هناك عدد أكبر بكثير من المستخدمين الذين يتعرفون عليه."
— @Gcaufy، مهندس Tencent، مؤلف كتاب WePY

"إنه مفيد جدًا لدرجة أنني أريد البكاء."
- @xinbenlv، مهندس Google، مؤسس HaoShiYou.org

رابط "أفضل مكتبة تطوير WeChat".
- @ جارفيس، مهندس بايدو

رابط "Wechaty يمنح المشغلين مزيدًا من الوقت للتفكير في كيفية تخطيط الأحداث، والاحتفاظ بالمستخدمين، وتحقيق الدخل من الشركات".
— @lijiarui، المؤسس والرئيس التنفيذي لشركة Juzi.BOT.

"إذا كنت تعرف js... جرب Wechaty، فهو سهل الاستخدام."
— @Urinx Uri Lee، مؤلف WeixinBot(Python)

شاهد المزيد على ويكي: صوت المطور

انضم إلينا

يتم استخدام Wechaty في العديد من مشاريع ChatBot بواسطة الآلاف من المطورين. إذا كنت تريد التحدث مع مطورين آخرين، فما عليك سوى مسح رمز الاستجابة السريعة التالي في WeChat باستخدام الرمز السري php wechaty ، وانضم إلى صفحة مطوري Wechaty PHP الخاصة بنا.

قم بالمسح الآن، لأن مطوري Wechaty PHP الآخرين يريدون التحدث معك أيضًا (الرمز السري: php wechaty )

ابدء

1. عامل الميناء

• مستودع PHP Wechaty Starter لـ Docker - https://github.com/wechaty/docker-php-wechaty-getting-started

PHP Wechaty Docker يدعم PHP Script.

2.1. تشغيل سكريبت PHP

 # for php script
docker run -ti --volume= " $( pwd ) " :/bot --rm phpwechaty/php-wechaty:v1 docker/ding-dong-bot.php

تعرف على المزيد حول Wechaty Docker على Wiki:Docker.

متغيرات البيئة الجديدة

1. WECHATY_PUPPET_SERVICE_TLS_CA_CERT : يمكن الكتابة فوقها بواسطة options.tlsRootCert . قم بتعيين Root CA Cert للتحقق من الخادم أو العميل.

لخادم الدمية:

متغير البيئة	خيارات	وصف
WECHATY_PUPPET_SERVICE_TLS_SERVER_CERT	options.tls.serverCert	شهادة CA للخادم (بيانات السلسلة)
WECHATY_PUPPET_SERVICE_TLS_SERVER_KEY	options.tls.serverKey	مفتاح CA للخادم (بيانات السلسلة)
WECHATY_PUPPET_SERVICE_NO_TLS_INSECURE_SERVER	options.tls.disable	اضبط على true لتعطيل خادم TLS

للعميل الدمية:

متغير البيئة	خيارات	وصف
WECHATY_PUPPET_SERVICE_AUTHORITY	options.authority	مضيف اكتشاف الخدمة، الافتراضي: api.chatie.io
WECHATY_PUPPET_SERVICE_TLS_CA_CERT	options.caCert	شهادة الجذر لهيئة التصديق، الافتراضي هو استخدام شهادة الجذر لمجتمع Wechaty
WECHATY_PUPPET_SERVICE_TLS_SERVER_NAME	options.serverName	اسم الخادم (تطابق الصاري لـ SNI)
WECHATY_PUPPET_SERVICE_NO_TLS_INSECURE_CLIENT	options.tls.disable	اضبط على true لتعطيل عميل TLS

تعرف على المزيد حول TLS على https://github.com/wechaty/puppet-service

أقصر PHP ChatBot في العالم: 8 أسطر من التعليمات البرمجية

PHP

 $ wechaty =  IO  Github  Wechaty  Wechaty :: getInstance ( $ token , $ endPoint );
$ wechaty -> onScan ( function ( $ qrcode , $ status , $ data ) {
    $ qr =  IO  Github  Wechaty  Util  QrcodeUtils :: getQr ( $ qrcode );
    echo " $ qr nn Online Image: https://wechaty.github.io/qrcode/ $ qrcode n" ;
})-> onLogin ( function (  IO  Github  Wechaty  User  ContactSelf $ user ) {
})-> onMessage ( function (  IO  Github  Wechaty  User  Message $ message ) {
    $ message -> say ( " hello from PHP7.4 " );
})-> start ();

خطة تطوير PHP Wechaty

لدينا بالفعل Wechaty في TypeScript، ولن يكون من الصعب جدًا ترجمة TypeScript(TS) إلى PHP لأن wechaty يحتوي على 3000 سطر فقط من كود TS، وهي مصممة جيدًا ومفصولة عن طريق تجريد دمية wechaty لقد قمنا بترجمة هذه الأسطر الثلاثة آلاف من كود TypeScript، وسننتهي تقريبًا.

نظرًا لأن لدينا بالفعل نظامًا بيئيًا لـ Wechaty في TypeScript، لذلك لن نضطر إلى تنفيذ كل شيء في PHP، خاصة، في فبراير 2020، انتهينا من وحدة تجريد خدمة @chatie/grpc مع تنفيذ خدمة wechaty-puppet-service.

يوضح الرسم البياني التالي أنه يمكننا إعادة استخدام كل شيء تقريبًا في TypeScript، وما يتعين علينا القيام به هو فقط الكتلة الموجودة في أعلى يمين الرسم التخطيطي: Wechaty (PHP) .

  +--------------------------+ +--------------------------+
  |                          | |                          |
  |   Wechaty (TypeScript)   | |      Wechaty (PHP)        |
  |                          | |                          |
  +--------------------------+ +--------------------------+

  +-------------------------------------------------------+
  |                 Wechaty Puppet Service                 |
  |                                                       |
  |                (wechaty-puppet-service)                |
  +-------------------------------------------------------+

+---------------------  @chatie/grpc  ----------------------+

  +-------------------------------------------------------+
  |                Wechaty Puppet Abstract                |
  |                                                       |
  |                   (wechaty-puppet)                    |
  +-------------------------------------------------------+

  +--------------------------+ +--------------------------+
  |      Pad Protocol        | |      Web Protocol        |
  |                          | |                          |
  | wechaty-puppet-padplus   | |(wechaty-puppet-puppeteer)|
  +--------------------------+ +--------------------------+
  +--------------------------+ +--------------------------+
  |    Windows Protocol      | |       Mac Protocol       |
  |                          | |                          |
  | (wechaty-puppet-windows) | | (wechaty-puppet-macpro)  |
  +--------------------------+ +--------------------------+

مثال: كيفية ترجمة TypeScript إلى PHP

هناك فئة مكونة من 100 سطر تسمى Image مسؤولة عن تنزيل صورة WeChat بأحجام مختلفة.

إنه مثال رائع لتوضيح كيفية ترجمة TypeScript إلى PHP بطريقة Wechaty:

رمز مصدر فئة الصورة

• تايب سكريبت: https://github.com/wechaty/wechaty/blob/master/src/user/image.ts
• PHP: https://github.com/wechaty/php-wechaty/blob/master/wechaty/IO/Github/Wechaty/User/Image.php

إذا كنت مهتمًا بالترجمة وترغب في الاطلاع على كيفية عملها، فستكون بداية جيدة من قراءة ومقارنة هذين الملفين من فئة Image في TypeScript وPHP في نفس الوقت.

قائمة المهام

• TS: تايب سكريبت
• SLOC: خطوط المصدر من التعليمات البرمجية

وحدات Wechaty الداخلية

1. فئة ويتشاتي
   • TS SLOC(1160): https://github.com/wechaty/wechaty/blob/master/src/wechaty.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
2. الاتصال الصف
   • TS SLOC(804): https://github.com/wechaty/wechaty/blob/master/src/user/contact.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
3. ClassContactSelf
   • TS SLOC(199): https://github.com/wechaty/wechaty/blob/master/src/user/contact-self.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
4. رسالة الصف
   • TS SLOC(1054): https://github.com/wechaty/wechaty/blob/master/src/user/message.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
5. غرفة الصف
   • TS SLOC(1194): https://github.com/wechaty/wechaty/blob/master/src/user/room.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
6. صورة الفصل
   • TS SLOC(60): https://github.com/wechaty/wechaty/blob/master/src/user/image.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
7. ملحق الصف
   • TS SLOC(179): https://github.com/wechaty/wechaty/blob/master/src/accessory.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
8. تكوين الفئة
   • TS SLOC(187): https://github.com/wechaty/wechaty/blob/master/src/config.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
9. الفئة المفضلة
   • TS SLOC(52): https://github.com/wechaty/wechaty/blob/master/src/user/favorite.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
10. الصداقة الصفية
    • TS SLOC(417): https://github.com/wechaty/wechaty/blob/master/src/user/friendship.ts
    • شفرة
    • اختبارات الوحدة
    • التوثيق
11. برنامج كلاس ميني
    • TS SLOC(70): https://github.com/wechaty/wechaty/blob/master/src/user/mini-program.ts
    • شفرة
    • اختبارات الوحدة
    • التوثيق
12. دعوة لغرفة الصف
    • TS SLOC(317): https://github.com/wechaty/wechaty/blob/master/src/user/room-invitation.ts
    • شفرة
    • اختبارات الوحدة
    • التوثيق
13. علامة الفئة
    • TS SLOC(190): https://github.com/wechaty/wechaty/blob/master/src/user/tag.ts
    • شفرة
    • اختبارات الوحدة
    • التوثيق
14. رابط الفئة
    • TS SLOC(107): https://github.com/wechaty/wechaty/blob/master/src/user/url-link.ts
    • شفرة
    • اختبارات الوحدة
    • التوثيق

وحدات Wechaty الخارجية

1. صندوق ملفات الفئة
   • TS SLOC(638): https://github.com/huan/file-box/blob/master/src/file-box.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
2. فئة بطاقة الذاكرة
   • TS SLOC(376): https://github.com/huan/memory-card/blob/master/src/memory-card.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
3. فئة WechatyPuppet
   • TS SLOC(1115): https://github.com/wechaty/wechaty-puppet/blob/master/src/puppet.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق
4. فئة WechatyPuppetService
   • TS SLOC(909): https://github.com/wechaty/wechaty-puppet-service/blob/master/src/client/puppet-service.ts
   • شفرة
   • اختبارات الوحدة
   • التوثيق

الاستخدام

قيد التنفيذ...

عامل ميناء

docker build -t php-wechaty:v1 .
docker run -ti --volume= " $( pwd ) " :/bot --rm php-wechaty:v1 docker/ding-dong-bot.php

متطلبات

1. PHP 7.4+

ثَبَّتَ

تثبيت pecl

pecl install grpc
pecl install protobuf
pecl install yac

تثبيت CentOS يم

 # php make sure is 7.4+
sudo yum install php-pecl-grpc
sudo yum install php-pecl-protobuf
sudo yum install php-pecl-yac
sudo yum install php-xml

# php74
sudo yum install php74-php-pecl-grpc
sudo yum install php74-php-pecl-protobuf
sudo yum install php74-php-pecl-yac
sudo yum install php74-php-xml

# php[x]
sudo yum install php[x]-php-pecl-grpc
sudo yum install php[x]-php-pecl-protobuf
sudo yum install php[x]-php-pecl-yac
sudo yum install php[x]-php-xml

تمكين ياك

yac.enable=1
yac.enable_cli=1

الملحن

composer config repo.packagist composer https://mirrors.aliyun.com/composer/
# https://packagist.org/packages/wechaty/php-wechaty
composer require wechaty/php-wechaty

امتحان

php examples/bot.php

تطوير

انظر أيضا

PHP لمطور Node.js

تاريخ

يتقن

الإصدار 0.0.1 (09 يوليو 2020)

1. تم إنشاء المشروع.
2. مرحبًا بمساهمنا الأول في PHP Wechaty:
   • تشونشينج تشانغ (张春生) https://github.com/zhangchunsheng (https://github.com/wechaty/php-wechaty)

المشاريع ذات الصلة

• Wechaty - Conversatioanl AI Chatot SDK لحسابات Wechaty الفردية (TypeScript)
• Python Wechaty - Python WeChaty للمحادثة AI Chatbot SDK لحسابات Wechat الفردية (Python)
• Go Wechaty - Go WeChaty للمحادثة AI Chatbot SDK لحسابات Wechat الفردية (Go)
• Java Wechaty - Java WeChaty للمحادثة AI Chatbot SDK لحسابات Wechat الفردية (Java)
• Scala Wechaty - Scala WeChaty للمحادثة AI Chatbot SDK لحسابات WechatyIndividual (Scala)
• PHP Wechaty - PHP WeChaty للمحادثة AI Chatbot SDK لحسابات WechatyIndividual (PHP)
• .NET(C#) Wechaty - .NET(C#) WeChaty للمحادثة AI Chatbot SDK لحسابات WechatyIndividual (.NET/C#)

شارة

 [ ![ Wechaty in PHP ] ( https://img.shields.io/badge/Wechaty-PHP-7de )] ( https://github.com/wechaty/php-wechaty ) 

المساهمين

1. @zhangchunsheng - تشونشينج تشانغ (张春生)

الخالق

• @zhangchunsheng - تشونشينج تشانغ (张春生)

حقوق الطبع والنشر والترخيص

• الكود والمستندات © 2020 مساهمو Wechaty https://github.com/wechaty
• تم إصدار الكود بموجب ترخيص Apache-2.0
• تم إصدار المستندات تحت المشاع الإبداعي