README

Библиотека для интеграции с сервисом машинного перевода "Yandex Translate"

Ссылки

• Разработка
• О проекте (Yandex Cloud)
• О проекте (Yandex Identity and Access Management)
• О проекте (Yandex Translate)
• Документация (Yandex Cloud)
• Документация (Yandex Identity and Access Management)
• Документация (Yandex Translate)

Возможности

• Аутентификация в API "Yandex Cloud"
• Определение языка текста
• Получение списка поддерживаемых языков
• Перевод текста

Требования

• PHP >= 7.2
• cURL
• JSON
• mbstring

Установка

composer require itpanda-llc/yandex-translate-sdk

Подключение

require_once 'vendor/autoload.php';

Использование

Создание сервиса / Аутентификация

• С аккаунтом на Яндексе (OAuth-токен)

use Panda\Yandex\TranslateSdk; try { /*  * OAuth-токен  * ID каталога  */ $cloud = new TranslateSdk\Cloud('oAuthToken', 'folderId'); } catch (TranslateSdk\Exception\ClientException | TypeError $e) { echo $e->getMessage(); }

• С использованием сервисного аккаунта / федеративного пользователя (IAM-токен)

use Panda\Yandex\TranslateSdk; try { // IAM-токен $cloud = new TranslateSdk\Cloud('iamToken'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

• С использованием сервисного аккаунта (API-ключ)

use Panda\Yandex\TranslateSdk; try { // API-ключ $cloud = TranslateSdk\Cloud::createApi('apiKey'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

Определение языка текста

• Создание запроса

use Panda\Yandex\TranslateSdk; try { // Текст, язык которого требуется определить $detect = new TranslateSdk\Detect('Привет, разработчик!'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

• Установка параметров

use Panda\Yandex\TranslateSdk; try { // Текст, язык которого требуется определить $detect->setText('Привет, разработчик!') // Наиболее вероятный язык ->addHint('ru') ->addHint('uk') ->addHint('be'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

• Выполнение запроса

use Panda\Yandex\TranslateSdk; try { print_r($cloud->request($detect)); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

Получение списка поддерживаемых языков

use Panda\Yandex\TranslateSdk; try { print_r($cloud->request(new TranslateSdk\Languages)); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

Перевод текста

• Создание запроса

use Panda\Yandex\TranslateSdk; try { /*  * Строка для перевода  * Язык, на который переводится текст  */ $translate = new TranslateSdk\Translate('Привет, разработчик!', 'en'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

• Установка параметров

use Panda\Yandex\TranslateSdk; try { // Язык, на котором написан исходный текст $translate->setSourceLang('ru') // Язык, на который переводится текст ->setTargetLang('en'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); } // Формат текста $translate->setFormat(TranslateSdk\Format::PLAIN_TEXT); try { // Строка для перевода $translate->addText('Сейчас ты увидишь, как работает перевод текста!') ->addText('Это удивительно!') ->addText('Технологии не стоят на месте..') /*  * Текст на языке оригинала  * Текст на языке перевода  */ ->addGlossary('текста', 'greeting text') ->addGlossary('удивительно', 'super') ->addGlossary('технологии', 'services'); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }

• Выполнение запроса

use Panda\Yandex\TranslateSdk; try { print_r($cloud->request($translate)); } catch (TranslateSdk\Exception\ClientException $e) { echo $e->getMessage(); }