الصفحة الرئيسية>PHP كود المصدر>فئات أخرى
تنزيل

Airtable-SDK-PHP

يجعل هذا SDK Airtable لـ PHP من السهل الاستفادة من واجهة برمجة تطبيقات Airtable للاستفادة من اتفاقيات PHP الشعبية.

ملاحظة: هذا المشروع يخضع للتطوير النشط ، وليس جاهزًا للاستخدام.

الوثائق

انتقل إلى: https://beachcasts.github.io/airtable-sdk-php/

المتطلبات الأساسية

  • الملحن مثبت عالميا
  • PHP V7.2+

ثَبَّتَ

عبر الملحن 

$ composer require beachcasts/airtable-sdk-php

بداية سريعة

يتطلب استخدام القاعدة تثبيت AirtableClient ، كما هو موضح أدناه: 

 require_once ( ' vendor/autoload.php ' );

use Beachcasts  Airtable  AirtableClient ;
use Beachcasts  Airtable  Config ;

// Add details to your environment - see documentation for recomendations

$ airtableClient = new AirtableClient (Config:: fromEnvironment (), <your_baseid>);
$ table = $ airtableClient -> getTable (<your_table_name>);
ملحوظات:
  1. تحديث <your_baseid> و <your_table_name> حسب الحاجة.
  2. Config::fromEnvironment

لمزيد من التفاصيل حول كيفية استخدام AirTableClient ، راجع /مستندات ، حيث تبرز الأمثلة باستخدام الأساليب create() و read() و update() و delete() و list() على /مع بيانات Airtable.

تغيير السجل

يرجى الاطلاع على Changelog لمزيد من المعلومات حول ما تغير مؤخرًا.

الاختبار

يحتوي Airtable-SDK على 3 أجنحة اختبار: كاملة ، الوحدة والتكامل ، نقوم بتضمين متطلبات ديف ضد Phpunit. يرجى التأكد من تشغيل التثبيت الملحن للحصول على جميع التبعيات. 

$ composer install

اختبارات الوحدة

إن تشغيل اختبارات الوحدة هو ببساطة إخبار Phpunit بتشغيل "الوحدة" TestSuite 

$ vendor/bin/phpunit --testsuite=unit

اختبارات التكامل

سيتطلب تشغيل اختبارات التكامل حسابًا فعليًا وتفاصيل من Airtable.

  1. انسخ tests.env.default إلى tests.env
  2. قم بتسجيل الدخول إلى حسابك الجوي
  3. Add a base باستخدام طريقة Start from scratch . دع إنشاء القاعدة الجديد يحتفظ بالاسم Untitled Base .
  4. قم بزيارة مستندات Airtable API وحدد Base
  5. انسخ المعرف الأساسي من قسم المقدمة. ابحث عن The ID of this base is إضافة هذا إلى tests.env تحت مفتاح TEST_BASE_ID
  6. انتقل إلى حسابك ونسخ مفتاح API الخاص بك. أضف هذا إلى tests.env تحت مفتاح AIRTABLE_API_KEY
  7. إذا قمت بتغيير اسم الجدول الافتراضي بعيدًا عن Table 1 - قم بتحديث TEST_TABLE_NAME في tests.env

بمجرد تكوين .env ، يمكن إجراء الاختبارات مع الأمر التالي: 

$ vendor/bin/phpunit --testsuite=integration

جناح الاختبار الكامل

لتشغيل جناح الاختبار الكامل ، ستحتاج إلى اتباع الخطوات الموضحة لاختبار التكامل. للتخلي عن الأمر ، قم بتشغيل الأمر التالي: 

$ vendor/bin/phpunit --testsuite=full

أو 

$ vendor/bin/phpunit

ضبط الجودة

للحفاظ على مراقبة الجودة ، نحافظ على استخدام المعايير التالية:

  • معيار ترميز PSR-2 ،
  • معيار PSR-4 لمواقع التحميل التلقائي (عبر الملحن)
  • معيار PSR-7 لرسائل HTTP (عبر تنفيذ GuzzleHTTP)

نحن نقدم phpcs.xml.dist ضمن قاعدة الشفرة للتحقق من صحة معيار الترميز باستخدام رمز sniffer (المدرجة على أنها تبعية dev في Composer.json بياننا)

لتشغيل CODESNIFFER مقابل قاعدة البيانات ، استخدم الأمر التالي. 

$ vendor/bin/phpcs --standard=phpcs.xml.dist src

المساهمة

يرجى الاطلاع على المساهمة و CODE_OF_CONDUCHUTION للحصول على التفاصيل.

حماية

إذا اكتشفت أي مشكلات متعلقة بالأمان ، فيرجى إرسال بريد إلكتروني إلى [email protected] بدلاً من استخدام متتبع المشكلات.

الاعتمادات

  • الشاطئ
  • جميع المساهمين

رخصة

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

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل