PHP

Halaman ini diterjemahkan dari bahasa Inggris. Jika keduanya berbeda, halaman bahasa Inggris yang benar. Baca halaman bahasa Inggris

Pustaka PHP adalah spinningcatstudios/lingara di Packagist. Pustaka ini membutuhkan PHP 8.2 atau lebih baru dan berkomunikasi lewat HTTP melalui PSR-18, sehingga bisa dipakai dengan Symfony HttpClient, Guzzle, atau klien buatan Anda sendiri.

Cara pemakaiannya

Panggilan bersifat sinkron. Satu-satunya cara membatalkan adalah berhenti membaca: keluar dari foreach, atau panggil close() pada stream.
Stream dibaca dengan foreach, satu kali. Cocokkan setiap event dengan instanceof.
Error mengimplementasikan Lingara\Exception\LingaraException. Pada error API, errorCode() adalah kode yang stabil dan getCode() adalah status HTTP; retryAfter() adalah jumlah detik, atau null.
Pilih stack HTTP dengan argumen http. Dengan Guzzle, stream membutuhkan allow_url_fopen diaktifkan. Dengan klien PSR-18 buatan Anda sendiri, streaming dan batas waktu menjadi tanggung jawab Anda untuk dikonfigurasi.
Di bawah PHP-FPM setiap worker mulai dalam keadaan kosong, jadi berikan tokenCache PSR-16 kepada klien. Tanpanya, setiap worker menukar token sendiri, dan batas per jam endpoint token dipakai bersama oleh semuanya.

Contoh di bawah ini memasang paket, membuat klien, men-stream daftar kosakata, dan menangani error.

PHP

composer require spinningcatstudios/lingara:0.1.0-alpha.6

PHP

use Lingara\Client;

$client = new Client(clientId: $clientId, clientSecret: $clientSecret);

PHP

use Lingara\Model\VocabRequest;
use Lingara\Stream\GenerateVocabularyEvent;

$request = new VocabRequest(['level' => 2, 'source_lang' => 'en', 'target_lang' => 'zh', 'count' => 8]);
foreach ($client->generateVocabulary($request) as $event) {
    if ($event instanceof GenerateVocabularyEvent\Item) {
        echo $event->data->getWord(), ': ', $event->data->getTranslation(), "\n";
    }
}

PHP

use Lingara\Exception\ApiException;
use Lingara\Exception\LingaraException;
use Lingara\Exception\MaintenanceException;
use Lingara\Exception\OAuthException;
use Lingara\Exception\TransportException;

try {
    $client->getUsage();
} catch (LingaraException $e) {
    if ($e instanceof ApiException) {
        // A refusal from the API: status, errorCode (stable) and message (localised).
        echo $e->status(), ' ', $e->errorCode(), ': ', $e->getMessage(), "\n";
        echo 'retry after: ', $e->retryAfter() ?? 'not given', "\n";
    } elseif ($e instanceof OAuthException) {
        // The token endpoint refused the credentials or the scopes.
        echo $e->status(), ' ', $e->error(), ': ', $e->description(), "\n";
    } elseif ($e instanceof MaintenanceException) {
        echo 'under maintenance; retry after: ', $e->retryAfter() ?? 'not given', "\n";
    } elseif ($e instanceof TransportException) {
        // No usable answer: connect, tls, reset, timeout, and so on.
        echo 'transport: ', $e->kind()->value, "\n";
    }
}

PHP

Cara pemakaiannya

Yang dibungkus halaman ini