README

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

Ссылки

• Yandex Cloud
• Документация (Yandex Cloud)
• Документация (Yandex Identity and Access Management)
• Документация (Yandex Translate)

Требования

• PHP >= 7.2
• Guzzle
• JSON
• mbstring

Установка

composer require tsyvkunov/yandex-cloud-translate

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

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

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

use Tsyvkunov\YandexCloudTranslate\Translate;

$translate = new Translate('oAuthToken', 'folderId');

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

use Tsyvkunov\YandexCloudTranslate\Translate;

$translate = new Translate('iamToken');

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

use Tsyvkunov\YandexCloudTranslate\Translate;

$translate = new Translate();
$translate->makeApi('apiKey');

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

use Tsyvkunov\YandexCloudTranslate\Translate;

/*
 * Получение текущего формата для перевода
 */
echo $translate->getFormat();

/*
 * Выбор формата для перевода, по умолчанию PLAIN_TEXT
 */
$translate->setHtmlFormat();
$translate->setPlaintTextFormat();

/*
 * Строка/массив строк для перевода
 * Язык, на который переводится текст
 * Язык, с которого переводится текст (необязательный параметр)
 */
print_r($translate->translate('Hello world', 'en'));
// ИЛИ
print_r($translate->translate(['Hello world', 'Well done'], 'en'));