airtable sdk php

Airtable-Sdk-PHP

SDK Airtable ini untuk PHP memanfaatkan API Airtable yang memanfaatkan konvensi PHP populer.

Catatan: Proyek ini sedang dalam pengembangan aktif, dan tidak siap untuk digunakan.

Dokumentasi

Pergi ke: https://beachcasts.github.io/airtable-sdk-php/

Prasyarat

• Komposer dipasang secara global
• PHP V7.2+

Memasang

Melalui komposer

$ composer require beachcasts/airtable-sdk-php

Awal yang cepat

Penggunaan dasar membutuhkan instantiasi Airtableclient, seperti yang ditunjukkan di bawah ini:

 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>);

Catatan:

1. Perbarui <your_baseid> dan <your_table_name> sesuai kebutuhan.
2. The Config::fromEnvironment

Untuk detail lebih lanjut tentang cara menggunakan AirTableClient, lihat /dokumen, di mana contoh sorot menggunakan metode create() , read() , update() , delete() , dan list() pada /dengan data airtable.

Ubah log

Silakan lihat Changelog untuk informasi lebih lanjut tentang apa yang telah berubah baru -baru ini.

Pengujian

Airtable-SDK memiliki 3 suite uji: penuh, unit dan integrasi, kami menyertakan persyaratan dev terhadap phpunit. Pastikan Anda menjalankan instalasi komposer untuk mendapatkan semua dependensi.

$ composer install

Tes unit

Menjalankan Tes Unit hanya memberi tahu PhPunit untuk menjalankan testsuite "unit"

$ vendor/bin/phpunit --testsuite=unit

Tes integrasi

Menjalankan tes integrasi akan membutuhkan akun aktual dan detail dari Airtable.

1. Salin tests.env.default ke tests.env
2. Masuk ke akun Airtable Anda
3. Add a base menggunakan metode Start from scratch . Biarkan pembuatan basis baru mempertahankan nama Untitled Base default.
4. Kunjungi Airtable API Docs dan pilih Base Anda
5. Salin ID dasar dari bagian Pendahuluan. Cari The ID of this base is Tambahkan ini ke tests.env di bawah kunci TEST_BASE_ID
6. Buka akun Anda dan salin kunci API Anda. Tambahkan ini ke tests.env di bawah kunci AIRTABLE_API_KEY
7. Jika Anda telah mengubah nama tabel default jauh dari Table 1 - perbarui TEST_TABLE_NAME di tests.env

Setelah .Env dikonfigurasi, tes dapat dijalankan dengan perintah berikut:

$ vendor/bin/phpunit --testsuite=integration

Suite tes penuh

Untuk menjalankan suite tes lengkap, Anda harus mengikuti langkah -langkah yang diuraikan untuk pengujian integrasi. Untuk mengekspos, jalankan perintah berikut:

$ vendor/bin/phpunit --testsuite=full

atau

$ vendor/bin/phpunit

Kontrol kualitas

Untuk mempertahankan kontrol kualitas, kami mempertahankan penggunaan standar berikut:

• Standar pengkodean PSR-2,
• Standar PSR-4 untuk lokasi autoload (via Composer)
• Standar PSR-7 untuk Pesan HTTP (melalui Implementasi GuzzleHTTP)

Kami menyediakan phpcs.xml.dist di dalam basis kode untuk memvalidasi standar pengkodean menggunakan sniffer kode (termasuk sebagai ketergantungan dev dalam manifes komposer.json kami)

Untuk menjalankan CodeSniffer terhadap basis kode, gunakan perintah berikut.

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

Berkontribusi

Silakan lihat Kontribusi dan Code_OF_Conduct untuk detailnya.

Keamanan

Jika Anda menemukan masalah terkait keamanan, silakan kirim email ke [email protected] alih -alih menggunakan pelacak masalah.

Kredit

• Pantai
• Semua kontributor

Lisensi

Lisensi MIT (MIT). Silakan lihat file lisensi untuk informasi lebih lanjut.