By Matthias Noback
Using Composer, add to composer.json
:
{
"require": {
"matthiasnoback/microsoft-translator": "dev-master"
}
}
Then using the Composer binary:
php composer.phar install
This library uses the Buzz browser to make calls to the Microsoft Translator V2 API.
You need to register your application at the Azure DataMarket and
thereby retrieve a "client id" and a "client secret". These kan be used to instantiate the AccessTokenProvider
on which
the MicrosoftTranslator
depends:
<?php
use Buzz\Browser;
use MatthiasNoback\MicrosoftOAuth\AccessTokenProvider;
use MatthiasNoback\MicrosoftTranslator\MicrosoftTranslator;
$browser = new Browser();
$clientId = '[YOUR-CLIENT-ID]';
$clientSecret = '[YOUR-CLIENT-SECRET]';
$accessTokenProvider = new AccessTokenProvider($browser, $clientId, $clientSecret);
$translator = new MicrosoftTranslator($browser, $accessTokenProvider);
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 Doctrine\Common\Cache\ArrayCache;
$cache = new ArrayCache();
$accessTokenCache = new AccessTokenCache($cache);
$accessTokenProvider->setCache($accessTokenCache);
The actual cache provider can be anything, as long as it implements the Cache
interface from the Doctrine Common library.
$translatedString = $translator->translate('This is a test', 'nl', 'en');
// $translatedString will be 'Dit is een test', which is Dutch for...
$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();
}
$text = 'This is a test';
$detectedLanguage = $translator->detect($text);
// $detectedLanguage will be 'en'
$text = 'My name is Matthias';
$spoken = $translator->speak($text, 'en', 'audio/mp3', 'MaxQuality');
// $spoken will be the raw MP3 data, which you can save for instance as a file
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).
There is a MicrosoftTranslatorBundle which makes the Microsoft translator available in a Symfony2 project.
There is also a MicrosoftTranslatorServiceProvider which registers the Microsoft translator and related services to a Silex application.
There are some more calls to be implemented, and also some more tests to be added.