Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 2.99 KB

MIGRATION.md

File metadata and controls

102 lines (70 loc) · 2.99 KB

Migration

v3.x to v4.x

New Requirements

Requires PHP 7.1+

New features

None

Backward Incompatible Changes

  • Numbers symbols are now represented by a Symbols instance instead of an array. Methods using numeric symbols have been updated. The currency symbol is no longer added to the numeric symbols, it is now a separated parameter.

     <?php

 /* @var ICanBoogie\CLDR\CurrencyFormatter $formatter */
 /* @var array $symbols */

 $formatter->format($number, $pattern, $symbols);
     <?php

 /* @var ICanBoogie\CLDR\CurrencyFormatter $formatter */
 /* @var ICanBoogie\CLDR\Numbers\Symbols $symbols */
 /* @var string $currencySymbol */

 $formatter->format($number, $pattern, $symbols, $currencySymbol);

  • List patterns are now represented by a ListPattern instance instead of an array. Methods using a list pattern have been updated.

     <?php

 /* @var ICanBoogie\CLDR\ListFormatter $formatter */
 /* @var array $list_pattern */

 $formatter->format([ 1, 2, 3 ], list_pattern);
     <?php

 /* @var ICanBoogie\CLDR\ListFormatter $formatter */
 /* @var ICanBoogie\CLDR\Locale\ListPattern $list_pattern */

 $formatter->format([ 1, 2, 3 ], list_pattern);

  • Removed NumberPattern:$format, it was never used.

  • Removed the localized() method on entities that don't naturally require access to the repository: NumberFormatter and ListFormatter. You can use $repository->locales['fr']->localize($formatter) to get a localized formatter, or the number_formatter and list_formater properties of the Locale object.

  • The fluent interface of units is now more on par with the rest of the API.

     <?php

 echo $units->duration_hour(23);
 echo $units->duration_hour(23, $units::LENGTH_SHORT);
 echo $units->volume_liter->per_unit(12.345, $units->duration_hour);
 echo $units->volume_liter->per_unit(12.345, $units->duration_hour, $units::LENGTH_SHORT);
     <?php

 echo $units->duration_hour(23);
 echo $units->duration_hour(23)->as_short;
 echo $units->volume_liter(12.345)->per($units->duration_hour);
 echo $units->volume_liter(12.345)->per($units->duration_hour)->as_short;

Deprecated Features

  • The localized currency formatter no longer supports a $symbols parameter. If you need to customize how a currency is formatted, create your own Symbols instance and use it with a non-localized formatter e.g. $repository->format_currency().

  • The localized list formatter no longer accepts a list pattern or a type, only a type. If you need to customize how a list is formatted, create you own ListPattern instance and use it with a non-localized formatter e.g. $repository->format_list().

Other Changes

  • Compatible with PHP 8.1+
  • Targets CLDR v36
  • Improved type annotations, including generics.