matthiasnoback / microsoft-translator
Library for making calls to the Microsoft Translator V2 API
Installs: 227 996
Dependents: 2
Suggesters: 0
Security: 0
Stars: 39
Watchers: 6
Forks: 26
Open Issues: 0
Requires
- doctrine/cache: ^1.11
- kriswallsmith/buzz: ^1.2
Requires (Dev)
- cache/array-adapter: ^1.1
- nyholm/psr7: ^1.4
- phpunit/phpunit: 9.5
README
By Matthias Noback (maintained by Alayn Gortazar)
Installation
Using Composer, add to composer.json
:
{
"require": {
"matthiasnoback/microsoft-translator": "dev-master"
}
}
Then using the Composer binary:
php composer.phar install
Usage
This library uses the Buzz browser to make calls to the Microsoft Translator Text API 3.0.
You need to obtain a Microsoft Azure Cognitive Services subscription Key. This can be used to instantiate the AzureTokenProvider
:
<?php use MatthiasNoback\MicrosoftOAuth\AzureTokenProvider; use MatthiasNoback\MicrosoftTranslator\MicrosoftTranslator; use Buzz\Browser; use Buzz\Client\Curl; use Nyholm\Psr7\Factory\Psr17Factory; $client = new Curl(new Psr17Factory()); $browser = new Browser($client, new Psr17Factory()); $azureKey = '[YOUR-AZURE-SUBSCRIPTION-KEY]'; $accessTokenProvider = new AzureTokenProvider($browser, $azureKey); $translator = new MicrosoftTranslator($browser, $accessTokenProvider);
Selecting azure token provider url
By default the acesstoken will be retrieved from https://api.cognitive.microsoft.com/sts/v1.0/issueToken , a third parameter can be passed to the AzureTokenProvider to choose another source.
<?php // Some code $accessTokenProvider = new AzureTokenProvider($browser, $azureKey, 'https://westus.api.cognitive.microsoft.com/sts/v1.0/issueToken');
Optional: enable the access token cache
Each call to the translator service is preceded by a call to Microsoft's OAuth server. Each access token however, may be
cached for 10 minutes, so you should also use the built-in AccessTokenCache
:
<?php use MatthiasNoback\MicrosoftOAuth\AccessTokenCache; use Cache\Adapter\PHPArray\ArrayCachePool; $cache = new ArrayCachePool(); $accessTokenCache = new AccessTokenCache($cache); $accessTokenProvider->setCache($accessTokenCache);
The actual cache provider can be anything, as long as it implements the CachePoolInterface
interface from FIG-PSR6
Making calls
Translate a string
<?php // Some code $translatedString = $translator->translate('This is a test', 'nl', 'en'); // $translatedString will be 'Dit is een test', which is Dutch for...
Translate a string and get multiple translations
<?php // Some code $matches = $translator->getTranslations('This is a test', 'nl', 'en'); foreach ($matches as $match) { // $match is an instance of MatthiasNoback\MicrosoftTranslator\ApiCall\TranslationMatch $degree = $match->getDegree(); $translatedText = $match->getTranslatedText(); }
Detect the language of a string
<?php // Some code $text = 'This is a test'; $detectedLanguage = $translator->detect($text); // $detectedLanguage will be 'en'
Tests
Take a look at the tests to find out what else you can do with the API.
To fully enable the test suite, you need to copy phpunit.xml.dist
to phpunit.xml
and replace the placeholder
values with their real values (i.e. client id, client secret and a location for storing spoken text files).
TODO
- There are some more calls to be implemented, and also some more tests to be added.