[Translate] add an intl MessageFormatter interpolator

[challet]

Hello!

• Type: new feature

In raising this pull request, I confirm the following (please check boxes):

• I have read and understood the Contributing Guidelines?
• I have checked that another pull request for this purpose does not exist.
• I wrote some tests for this PR.

Small description of change:

• add an Intl MessageFormatter interpolator, see formating guide and ICU documentation.
• remove direct usage of MessageFormatter (and other interpolators core mechanism) from inside adapter implementations.
  • Breaking change : see list below, interpolators can be used instead.
  • Note : no tests were provided for the existing adapters.

Exemples :

• direct usage :

use Phalcon\Translate\Interpolator\Intl;

$interpolator = new Intl('en_US'); // this interpolator must be locale aware
$stringFrom = 'I have {number_apples, plural, =0{no apples} =1{one apple} other{# apples}} and my name is {name}.';
echo $interpolator->replacePlaceholders($stringFrom, ['number_apples' => 1000,'name' => 'John']));
// I have 1,000 apples and my name is John.

• through an adapter, with the interpolator option :

<?php
use Phalcon\Translate\Adapter\NativeArray;
use Phalcon\Translate\Interpolator\Intl;

$translate = new NativeArray([
    'interpolator' => new Intl('en_US'), // this interpolator must be locale aware
    'content' => ['hi-name' => 'Hello {name}, it\'s {time, number, integer} o\'clock'],
]);

$name = 'Henry';
$translate->_('hi-name', ['name' => $name, 'time' => 8]); // Hello Henry, it's 8 o'clock

Deprecations

• Library/Phalcon/Translate/Adapter/Database useIcuMessageFormatter option
• Library/Phalcon/Translate/Adapter/Mongo formatter option
• Library/Phalcon/Translate/Adapter/Mongo setFormatter and format protected methods
• Library/Phalcon/Translate/Adapter/ResourceBundle automatic use of MessageFormatter
• Library/Phalcon/Translate/Adapter/Base setPlaceholders public function

[challet]

Notifying contributors about parts being deprecated in this PR : @iGusev @YerlenZhubangaliyev @iborodikhin

[sergeyklay]

Thank yoy