Class: LanguageManager

Class for working with localization of texts.

Implements

\SmartFactory\Interfaces\ILanguageManager

Authors

Oleg Schildt

Package

System

Source code

SmartFactory/LanguageManager.php

Properties
$additional_localization_files protected	Internal variable for storing the paths of the additional localization files.
$context static protected	Internal variable for storing the current context.
$cookie_path protected	Internal variable for storing the cookie path.
$countries static protected	Internal array for storing the list of country name translations.
$current_language static protected	Internal variable for storing the current language.
$dictionary_loaded protected	Internal variable for storing the state whether the dictionary is loaded or not.
$languages static protected	Internal array for storing the list of language name translations.
$localization_path protected	Internal variable for storing the path with the localization files.
$supported_languages static protected	Internal array for storing the list of supported languages.
$texts static protected	Internal array for storing the list of text translations.
$use_apcu protected	Internal variable for storing the state whether the APCU should be used.
$use_cookie protected	Internal variable for storing the state whether the last selected language can be stored to cookie.
$use_fallback_language protected	Internal variable for storing the fallback language.
$warn_missing protected	Internal variable for storing the state whether the E_USER_NOTICE is triggered in the case of missing translations.

Methods
addLocalizationFile() public	Adds additional localization files to the dictionary.
detectLanguage() public	This function should detect the current language based on cookies, browser languages etc.
extendDictionary() public	Adds additional translations to the dictionary.
getContext() public	Returns the current context.
getCountryCode() public	Tries to find the country code by the given name.
getCountryList() public	Provides the list of countries for the given language in the form "code" => "translation".
getCountryName() public	Provides the text translation for the country name by the code for the given language.
getCurrentLanguage() public	Returns the current language.
getFallbackLanguage() public	Returns the fallback language. If set and a translation is missing on a language, the translation on this language will be used.
getLanguageCode() public	Tries to find the language code by the given name.
getLanguageList() public	Provides the list of languages for the given language in the form "code" => "translation".
getLanguageName() public	Provides the text translation for the language name by the code for the given language.
getSupportedLanguages() public	Returns the list of supported languages.
hasTranslation() public	Checks whether the text translation for the text ID for the given language exists.
init() public	Initializes the language manager with parameters.
loadDictionary() public	This is function for loading the translations from the source JSON file.
setContext() public	Sets the current context.
setCurrentLanguage() public	Sets the current language.
text() public	Provides the text translation for the text ID for the given language.
try_text() public	Provides the text translation for the text ID for the given language if the translation exists.
validateCountryCode() public	Checks whether the country code is valid (has translation).
validateLanguageCode() public	Checks whether the language code is valid (has translation).

Property: LanguageManager::$additional_localization_files

protected string|array $additional_localization_files = [];

Internal variable for storing the paths of the additional localization files.

Type

string|array

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$context

protected static string $context = "default";

Internal variable for storing the current context.

Type

string

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$cookie_path

protected string $cookie_path = "/";

Internal variable for storing the cookie path.

Type

string

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$countries

protected static array $countries = [];

Internal array for storing the list of country name translations.

Type

array

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$current_language

protected static array $current_language = [];

Internal variable for storing the current language.

Type

array

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$dictionary_loaded

protected bool $dictionary_loaded = false;

Internal variable for storing the state whether the dictionary is loaded or not.

Type

bool

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$languages

protected static array $languages = [];

Internal array for storing the list of language name translations.

Type

array

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$localization_path

protected string $localization_path = "";

Internal variable for storing the path with the localization files.

Type

string

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$supported_languages

protected static array $supported_languages = [];

Internal array for storing the list of supported languages.

Type

array

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$texts

protected static array $texts = [];

Internal array for storing the list of text translations.

Type

array

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$use_apcu

protected bool $use_apcu = false;

Internal variable for storing the state whether the APCU should be used.

Type

bool

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$use_cookie

protected bool $use_cookie = false;

Internal variable for storing the state whether the last selected language can be stored to cookie.

Type

bool

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$use_fallback_language

protected string $use_fallback_language = "";

Internal variable for storing the fallback language.

Details

If set and a translation is missing on a language, the translation on this language will be used.

Type

string

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Property: LanguageManager::$warn_missing

protected bool $warn_missing = true;

Internal variable for storing the state whether the E_USER_NOTICE is triggered in the case of missing translations.

Type

bool

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::addLocalizationFile()

public function addLocalizationFile(string $localization_file): void;

Adds additional localization files to the dictionary.

Parameters

Name	Pass type	Value type	Default value	Description
$localization_file	by value	string		The path of the additional localization file.

Returns

void

Throws

\Exception

It might throw an exception in the case of any errors.

Overrides

\SmartFactory\Interfaces\ILanguageManager::addLocalizationFile()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::detectLanguage()

public function detectLanguage(): void;

This function should detect the current language based on cookies, browser languages etc.

Details

Priority:

explicitly set by the request parameter language.
header 'Content-Language'.
last language in the cookie.
browser default language.
the first one from the supported list.
English.

Some applications may consist of two parts - administration console and public site. A usual example is a CMS system.

For example, you are using administration console in English and editing the public site for German and French. When you open the public site for preview in German or French, you want it to be open in the corresponding language, but the administration console should remain in English.

With the help of $context, you are able to maintain different languages for different parts of your application. If you do not need the $context, just do not specify it.

Returns

void

Overrides

\SmartFactory\Interfaces\ILanguageManager::detectLanguage()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::extendDictionary()

public function extendDictionary(array $dictionary): void;

Adds additional translations to the dictionary.

Parameters

Name	Pass type	Value type	Default value	Description
$dictionary	by value	array		The array with additional translations.

Returns

void

Throws

\Exception

It might throw an exception in the case of any errors.

Overrides

\SmartFactory\Interfaces\ILanguageManager::extendDictionary()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getContext()

public function getContext(): string;

Returns the current context.

Details

Some applications may consist of two parts - administration console and public site. A usual example is a CMS system.

With the help of $context, you are able to maintain different languages for different parts of your application. If you do not need the $context, just do not specify it.

Returns

string

Returns the current context.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getContext()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getCountryCode()

public function getCountryCode(string $country_name): string;

Tries to find the country code by the given name.

Parameters

Name	Pass type	Value type	Default value	Description
$country_name	by value	string		The name of the country in any supported language.

Returns

string

Returns the country code if it could be found, otherwise an empty string.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getCountryCode()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getCountryList()

public function getCountryList(array &$country_list, string $lng = "", array $display_first = []): bool;

Provides the list of countries for the given language in the form "code" => "translation".

Parameters

Name	Pass type	Value type	Default value	Description
$country_list	by reference	array		Target array where the country list should be loaded.
$lng	by value	string	""	The language. If it is not specified, the default language is used.
$display_first	by value	array	[]	List of the country codes to be displayed first in the order, they appear in the list.

Returns

bool

Returns true if the country list is successfully retrieved, otherwise false.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getCountryList()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getCountryName()

public function getCountryName(string $code, string $lng = ""): string;

Provides the text translation for the country name by the code for the given language.

Parameters

Name	Pass type	Value type	Default value	Description
$code	by value	string		Country ISO code (uppercase, e.g. US, DE, FR).
$lng	by value	string	""	The language. If it is not specified, the default language is used.

Returns

string

Returns the translation text for the country name or the $code if no translation is found.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getCountryName()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getCurrentLanguage()

public function getCurrentLanguage(): string;

Returns the current language.

Returns

string

Returns the current language ISO code.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getCurrentLanguage()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getFallbackLanguage()

public function getFallbackLanguage(): string;

Returns the fallback language. If set and a translation is missing on a language, the translation on this language will be used.

Returns

string

Returns the fallback language.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getFallbackLanguage()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getLanguageCode()

public function getLanguageCode(string $lang_name): string;

Tries to find the language code by the given name.

Parameters

Name	Pass type	Value type	Default value	Description
$lang_name	by value	string		The name of the language in any supported language.

Returns

string

Returns the language code if it could be found, otherwise an empty string.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getLanguageCode()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getLanguageList()

public function getLanguageList(array &$language_list, string $lng = "", array $display_first = []): bool;

Provides the list of languages for the given language in the form "code" => "translation".

Parameters

Name	Pass type	Value type	Default value	Description
$language_list	by reference	array		Target array where the language list should be loaded.
$lng	by value	string	""	The language. If it is not specified, the default language is used.
$display_first	by value	array	[]	List of the language codes to be displayed first in the order, they appear in the list.

Returns

bool

Returns true if the language list is successfully retrieved, otherwise false.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getLanguageList()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getLanguageName()

public function getLanguageName(string $code, string $lng = ""): string;

Provides the text translation for the language name by the code for the given language.

Parameters

Name	Pass type	Value type	Default value	Description
$code	by value	string		Language ISO code (lowercase, e.g. en, de, fr).
$lng	by value	string	""	The language. If it is not specified, the default language is used.

Returns

string

Returns the translation text for the language name or the $code if no translation is found.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getLanguageName()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::getSupportedLanguages()

public function getSupportedLanguages(): array;

Returns the list of supported languages.

Returns

array

Returns the list of supported languages.

Overrides

\SmartFactory\Interfaces\ILanguageManager::getSupportedLanguages()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::hasTranslation()

public function hasTranslation(string $text_id, string $lng = ""): bool;

Checks whether the text translation for the text ID for the given language exists.

Parameters

Name	Pass type	Value type	Default value	Description
$text_id	by value	string		Text ID
$lng	by value	string	""	The language. If it is not specified, the default language is used.

Returns

bool

Returns true if the translation exists, otherwise false.

Overrides

\SmartFactory\Interfaces\ILanguageManager::hasTranslation()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::init()

public function init(array $parameters): void;

Initializes the language manager with parameters.

Parameters

Name	Pass type	Value type	Default value	Description
$parameters	by value	array		Settings for logging as an associative array in the form key => value: $parameters["localization_path"] - the path where the localization files are stored. $parameters["use_cookie"] - if set to true, the last selected language is stored to cookie. $parameters["use_fallback_language"] - if set and a translation is missing on a language, the translation on this language will be used. $parameters["cookie_path"] - Cookie path. $parameters["use_apcu"] - if installed, apcu can be used to cache the translations in the memory. $parameters["warn_missing"] - If it is set to true, the E_USER_NOTICE is triggered in the case of missing translations.

Returns

void

Throws

\Exception

It might throw an exception in the case of any errors.

Overrides

\SmartFactory\Interfaces\ILanguageManager::init()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::loadDictionary()

public function loadDictionary(): void;

This is function for loading the translations from the source JSON file.

Returns

void

Throws

\Exception

It might throw the following exceptions in the case of any errors:

if the translation file is invalid.

Overrides

\SmartFactory\Interfaces\ILanguageManager::loadDictionary()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::setContext()

public function setContext(string $context): void;

Sets the current context.

Details

Some applications may consist of two parts - administration console and public site. A usual example is a CMS system.

With the help of $context, you are able to maintain different languages for different parts of your application. If you do not need the $context, just do not specify it.

Parameters

Name	Pass type	Value type	Default value	Description
$context	by value	string		The name of the context.

Returns

void

Overrides

\SmartFactory\Interfaces\ILanguageManager::setContext()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::setCurrentLanguage()

public function setCurrentLanguage(string $language): void;

Sets the current language.

Parameters

Name	Pass type	Value type	Default value	Description
$language	by value	string		The language ISO code to be set.

Returns

void

Overrides

\SmartFactory\Interfaces\ILanguageManager::setCurrentLanguage()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::text()

public function text(string $text_id, string $lng = "", string $default_text = ""): string;

Provides the text translation for the text ID for the given language.

Parameters

Name	Pass type	Value type	Default value	Description
$text_id	by value	string		Text ID
$lng	by value	string	""	The language. If it is not specified, the default language is used.
$default_text	by value	string	""	The default text to be used if there is no translation.

Returns

string

Returns the translation text or the $default_text/$text_id if no translation is found.

Throws

\Exception

It might throw exceptions in the case of any errors.

Overrides

\SmartFactory\Interfaces\ILanguageManager::text()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::try_text()

public function try_text(string $text_id, string $lng = ""): string;

Provides the text translation for the text ID for the given language if the translation exists.

Details

Otherwise, it returns the text ID and emits no warning.

Parameters

Name	Pass type	Value type	Default value	Description
$text_id	by value	string		Text ID
$lng	by value	string	""	The language. If it is not specified, the default language is used.

Returns

string

Returns the translation text or the $default_text/$text_id if no translation is found.

Throws

\Exception

It might throw exceptions in the case of any errors.

Overrides

\SmartFactory\Interfaces\ILanguageManager::try_text()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::validateCountryCode()

public function validateCountryCode(string $code, string $lng = ""): bool;

Checks whether the country code is valid (has translation).

Parameters

Name	Pass type	Value type	Default value	Description
$code	by value	string		Country ISO code (uppercase, e.g. US, DE, FR).
$lng	by value	string	""	The language. If it is not specified, the default language is used.

Returns

bool

Returns true if the country code is valid (has translation), otherwise false.

Overrides

\SmartFactory\Interfaces\ILanguageManager::validateCountryCode()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Method: LanguageManager::validateLanguageCode()

public function validateLanguageCode(string $code, string $lng = ""): bool;

Checks whether the language code is valid (has translation).

Parameters

Name	Pass type	Value type	Default value	Description
$code	by value	string		Language ISO code (lowercase, e.g. en, de, fr).
$lng	by value	string	""	The language. If it is not specified, the default language is used.

Returns

bool

Returns true if the language code is valid (has translation), otherwise false.

Overrides

\SmartFactory\Interfaces\ILanguageManager::validateLanguageCode()

Authors

Oleg Schildt

Source code

SmartFactory/LanguageManager.php

Class: LanguageManager

Implements

Authors

Package

Source code

Property: LanguageManager::$additional_localization_files

Type

Authors

Source code

Property: LanguageManager::$context

Type

Authors

Source code

See also

Property: LanguageManager::$cookie_path

Type

Authors

Source code

Property: LanguageManager::$countries

Type

Authors

Source code

Property: LanguageManager::$current_language

Type

Authors

Source code

Property: LanguageManager::$dictionary_loaded

Type

Authors

Source code

Property: LanguageManager::$languages

Type

Authors

Source code

Property: LanguageManager::$localization_path

Type

Authors

Source code

Property: LanguageManager::$supported_languages

Type

Authors

Source code

Property: LanguageManager::$texts

Type

Authors

Source code

Property: LanguageManager::$use_apcu

Type

Authors

Source code

Property: LanguageManager::$use_cookie

Type

Authors

Source code

Property: LanguageManager::$use_fallback_language

Details

Type

Authors

Source code

Property: LanguageManager::$warn_missing

Type

Authors

Source code

Method: LanguageManager::addLocalizationFile()

Parameters

Returns

Throws

Overrides

Authors

Source code

Method: LanguageManager::detectLanguage()

Details

Returns

Overrides

Authors

Source code

Method: LanguageManager::extendDictionary()

Parameters

Returns

Throws