Class InternationalizedHelper

Responsibility - abstract class to process date, number or money formatting by Intl extension or by locale formatting conventions. - Formatting processed by Intl extension if installed or (automatically) configured system locale settings. - System locale settings automatically configured by request language and request locale. - Encoding result string to always return it in response encoding, in UTF-8 by default.

MvcCore\Ext\Views\Helpers\AbstractHelper implements MvcCore\Ext\Views\Helpers\IHelper

MvcCore\Ext\Views\Helpers\InternationalizedHelper

Direct known subclasses

MvcCore\Ext\Views\Helpers\FormatDateHelper, MvcCore\Ext\Views\Helpers\FormatNumberHelper

Indirect known subclasses

MvcCore\Ext\Views\Helpers\FormatMoneyHelper

Abstract
Namespace: MvcCore\Ext\Views\Helpers
Located at ext-view-helper-internationalized/src/MvcCore/Ext/Views/Helpers/InternationalizedHelper.php

Methods summary
`public`	# `__construct( )` Create new helper instance, set boolean about `Intl` extension formatting by loaded extension. Create new helper instance, set boolean about `Intl` extension formatting by loaded extension.
`public MvcCore\Ext\Views\Helpers\InternationalizedHelper`	# `SetIntlExtensionFormatting( boolean $intlExtensionFormatting = TRUE )` Set `TRUE` if you want to use explicitly `Intl` extension formatting (PHP Internationalization Functions) or set `FALSE` if you want to use explicitly `strftime()`, `number_format()`, `money_format()` etc... old fashion functions formatting. Set `TRUE` if you want to use explicitly `Intl` extension formatting (PHP Internationalization Functions) or set `FALSE` if you want to use explicitly `strftime()`, `number_format()`, `money_format()` etc... old fashion functions formatting. Parameters `$intlExtensionFormatting` `TRUE` by default. Returns `MvcCore\Ext\Views\Helpers\InternationalizedHelper` See http://php.net/manual/en/book.intl.php http://php.net/strftime http://php.net/number_format http://php.net/money_format
`public MvcCore\Ext\Views\Helpers\InternationalizedHelper`	# `SetLangAndLocale( string $lang = NULL, string $locale = NULL )` Set language code and locale (territory) code manually. Use this function only if there is no language and locale codes presented in request object. Set language code and locale (territory) code manually. Use this function only if there is no language and locale codes presented in request object. Parameters `$lang` `"en" \| "de" ...` `$locale` `"US" \| "GB" ...` Returns `MvcCore\Ext\Views\Helpers\InternationalizedHelper`
`public MvcCore\Ext\Views\Helpers\InternationalizedHelper`	# `SetDefaultEncoding( string $encoding = 'UTF-8' )` Set default encoding if there is no response encoding configured. Use this function is used only if `Intl` extension is not installed and if there is necessary to use `strftime()` or `number_format()` etc.. formatting as a fallback. Set default encoding if there is no response encoding configured. Use this function is used only if `Intl` extension is not installed and if there is necessary to use `strftime()` or `number_format()` etc.. formatting as a fallback. Parameters `$encoding` Returns `MvcCore\Ext\Views\Helpers\InternationalizedHelper`
`public MvcCore\Ext\Views\Helpers\InternationalizedHelper`	# `SetDefaultLangAndLocale( string[] $defaultLangAndLocale = ['en', 'US'] )` Set default language and locale used for `Intl` formatting fallback, when is not possible to configure system locale value and when there is necessary to define some default formatting rules. Set default language and locale used for `Intl` formatting fallback, when is not possible to configure system locale value and when there is necessary to define some default formatting rules. Parameters `$defaultLangAndLocale` Returns `MvcCore\Ext\Views\Helpers\InternationalizedHelper`
`public MvcCore\Ext\Views\Helpers\InternationalizedHelper`	# `SetView( MvcCore\IView $view )` Set up view properties and language and locale by request object in every view rendering change. Set up view properties and language and locale by request object in every view rendering change. Parameters `$view` Returns `MvcCore\Ext\Views\Helpers\InternationalizedHelper` Overrides `MvcCore\Ext\Views\Helpers\AbstractHelper::SetView()`
`protected`	# `setUpSystemLocaleAndEncodings( )` Try to define system locale and it's system locale conversion information. This function is used only if `Intl` extension is not installed and if there is necessary to use `strftime()` or `number_format()` etc.. formatting as a fallback. Try to define system locale and it's system locale conversion information. This function is used only if `Intl` extension is not installed and if there is necessary to use `strftime()` or `number_format()` etc.. formatting as a fallback.
`protected string`	# `encode( string $str = '' )` Encode given string from system encoding into response encoding if necessary. This function is used only if `Intl` extension is not installed and if there is necessary to use `strftime()` or `number_format()` etc.. formatting as a fallback. Encode given string from system encoding into response encoding if necessary. This function is used only if `Intl` extension is not installed and if there is necessary to use `strftime()` or `number_format()` etc.. formatting as a fallback. Parameters `$str` Returns string

Methods inherited from MvcCore\Ext\Views\Helpers\AbstractHelper
`GetInstance()`

Magic methods summary
`public MvcCore\Ext\Views\Helpers\InternationalizedHelper`	# `GetInstance( )` Returns `MvcCore\Ext\Views\Helpers\InternationalizedHelper` Overrides `MvcCore\Ext\Views\Helpers\AbstractHelper::GetInstance()`

Constants inherited from MvcCore\Ext\Views\Helpers\AbstractHelper
`VERSION`

Properties summary
`protected boolean\|null`	`$intlExtensionFormatting` Boolean about if `Intl` (PHP Internationalization Functions) has installed. Boolean about if `Intl` (PHP Internationalization Functions) has installed. See http://php.net/manual/en/book.intl.php	# `NULL`
`protected string\|null`	`$lang` Automatically assigned language from controller request object. Automatically assigned language from controller request object.	# `NULL`
`protected string\|null`	`$locale` Automatically assigned locale from controller request object. Automatically assigned locale from controller request object.	# `NULL`
`protected string\|null`	`$langAndLocale` Automatically assigned lang and locale combination from controller request object. Automatically assigned lang and locale combination from controller request object.	# `NULL`
`protected IntlDateFormatter[]\|NumberFormatter[]`	`$intlFormatters` Storage with `Intl` datetime and number formatter instances. Storage with `Intl` datetime and number formatter instances.	# `[]`
`protected string`	`$defaultEncoding` Default encoding to use if there is no response encoding configured. Default encoding to use if there is no response encoding configured.	# `'UTF-8'`
`protected int[]`	`$localeCategories` System `setlocale()` category to set up system locale automatically in `SetView()` method. System `setlocale()` category to set up system locale automatically in `SetView()` method.	# `[LC_ALL]`
`protected boolean\|null`	`$encodingConversion` `TRUE` if there necessary to process any `iconv()` conversion from `strftime()` or from `number_format()` etc... results into view helper result rendered into application response. This variable is automatically resolved in every `SetView()` call. `TRUE` if there necessary to process any `iconv()` conversion from `strftime()` or from `number_format()` etc... results into view helper result rendered into application response. This variable is automatically resolved in every `SetView()` call.	# `NULL`
`protected string\|null`	`$systemEncoding` System `setlocale()` encoding, automatically configured by application request object. If there is no language and locale in request object, there is set UTF-8 by default. This variable is automatically resolved in every `SetView()` call. System `setlocale()` encoding, automatically configured by application request object. If there is no language and locale in request object, there is set UTF-8 by default. This variable is automatically resolved in every `SetView()` call.	# `NULL`
`protected string\|null`	`$responseEncoding` Target encoding, automatically assigned from application response. If there is no response encoding, there is set UTF-8 by default. This variable is automatically resolved in every `SetView()` call. Target encoding, automatically assigned from application response. If there is no response encoding, there is set UTF-8 by default. This variable is automatically resolved in every `SetView()` call.	# `NULL`
`protected string[]`	`$defaultLangAndLocale` Default language and locale used for `Intl` formatting fallback, when is not possible to configure system locale value and when there is necessary to define some default formatting rules. Default language and locale used for `Intl` formatting fallback, when is not possible to configure system locale value and when there is necessary to define some default formatting rules.	# `['en', 'US']`

Properties inherited from MvcCore\Ext\Views\Helpers\AbstractHelper
`$controller, $instance, $request, $response, $view`

Classes

Interfaces

Traits

Exceptions

Functions

Class InternationalizedHelper

Direct known subclasses

Indirect known subclasses

Parameters

Returns

See

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Overrides

Parameters

Returns

Returns

Overrides

See