PHP

هذه الصفحة مترجمة من الإنجليزية. إذا اختلفت النسختان، فالصفحة الإنجليزية هي الصحيحة. اقرأ الصفحة الإنجليزية

مكتبة PHP هي spinningcatstudios/lingara على Packagist. تحتاج إلى PHP 8.2 أو أحدث وتتواصل عبر HTTP من خلال PSR-18، لذا تعمل مع Symfony HttpClient أو Guzzle أو عميل من صنعك.

كيف تبدو في الاستخدام

الاستدعاءات متزامنة. الطريقة الوحيدة للإلغاء هي التوقف عن القراءة: اخرج من foreach، أو استدعِ close() على التدفق.
يُقرأ التدفق باستخدام foreach، مرة واحدة. طابِق كل حدث باستخدام instanceof.
تنفّذ الأخطاء Lingara\Exception\LingaraException. في خطأ API، يكون errorCode() هو الرمز الثابت وgetCode() هو حالة HTTP؛ ويكون retryAfter() عددًا من الثواني، أو null.
اختر مكدّس HTTP باستخدام الوسيط http. مع Guzzle، تحتاج التدفقات إلى تفعيل allow_url_fopen. ومع عميل PSR-18 خاص بك، يقع عليك ضبط البث والمهل.
تحت PHP-FPM يبدأ كل عامل فارغًا، لذا أعطِ العميل tokenCache من نوع PSR-16. ومن دونه، يستبدل كل عامل رمزه الخاص، ويتشارك جميعهم الحد الساعي لنقطة نهاية الرموز.

تثبّت الأمثلة أدناه الحزمة، وتنشئ عميلًا، وتبث قائمة مفردات، وتعالج خطأً.

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

كيف تبدو في الاستخدام

ما تغلّفه هذه الصفحة