# <img src="https://storage.yandexcloud.net/webazon/github/Yandex_Translate_icon.svg.png" style="zoom:5%;" /> yandex-translator

### Неофициальная API PHP библиотека  [Яндекс.Переводчика](https://yandex.cloud/ru/services/translate). **Версия 2**.

[![Latest Stable Version](http://poser.pugx.org/webazon/yandex-translator/v)](https://packagist.org/packages/webazon/yandex-translator) [![Total Downloads](http://poser.pugx.org/webazon/yandex-translator/downloads)](https://packagist.org/packages/webazon/yandex-translator) [![Latest Unstable Version](http://poser.pugx.org/webazon/yandex-translator/v/unstable)](https://packagist.org/packages/webazon/yandex-translator) [![License](http://poser.pugx.org/webazon/yandex-translator/license)](https://packagist.org/packages/webazon/yandex-translator) [![PHP Version Require](http://poser.pugx.org/webazon/yandex-translator/require/php)](https://packagist.org/packages/webazon/yandex-translator)

Для начала реализации необходимо настроить сервисный аккаунт на [Яндекс.Облаке](https://cloud.yandex.ru), определить ID каталога и получить сервисный API-ключ.

------

### Установка

Можно установить используя менеджер пакетов [Composer](https://getcomposer.org)

```bash
$ composer require webazon/yandex-translator
```

или скачать пакет с [GitHub](https://github.com/katsef/yandex-translator)

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

```php
require __DIR__ . '/vendor/autoload.php';
$translator = new Translator(["folder_id"=> "<ID каталога>", "ApiKey"=>'<API-ключ>']);
$translate = $translator->Translate('Hello, World','en-ru');
$text = $translate -> text;
```

------

Список поддерживаемых языков можно получить командой:

```php
$translate = $translator->listLanguages();
```

или в файле [JSON](https://github.com/katsef/yandex-translator/languages.json) в корне проекта.

------

------

### Unofficial PHP API library  [Yandex.Translate](https://yandex.cloud/ru/services/translate). **Version 2**.

To start the implementation, you need to set up a service account on [Yandex.Cloud](https://cloud.yandex.ru), determine the folder ID and get the service API key.

------

### Installation

Can be installed using the package manager [Composer](https://getcomposer.org)

```bash
$ composer require webazon/yandex-translator
```

or download the package from [GitHub](https://github.com/katsef/yandex-translator)

### Initialization and usage

```php
require __DIR__ . '/vendor/autoload.php';
$translator = new Translator(["folder_id"=> "<Catalog ID>", "ApiKey"=>'<API-key>']);
$translate = $translator->Translate('Hello, World','en-ru');
$text = $translate -> text;
```

------

The list of supported languages can be obtained using the command:

```php
$translate = $translator->listLanguages();
```

or in the file [JSON](https://github.com/katsef/yandex-translator/languages.json) at the root of the project.

------

------