⚠️Warning! This package does not have active support, it exists only for the historical needs of the author.
This package helps you to deal with regions with different languages, currencies and countries. It could be helpful even if you have single region project.
The best way to install 68publishers/i18n is using Composer:
$ composer require 68publishers/i18n
then you can register extension into DIC:
extensions: 68publishers.i18n: SixtyEightPublishers\i18n\DI\I18nExtension(%debugMode%)
68publishers.i18n: profiles: europe: language: [ sk_SK, en_GB, de_DE, pl_PL ] currency: [ EUR, PLZ, GBP ] country: [ SK, GB, DE, PL ] domain: [ 'europe\.example\.com' ] # regex north_america: language: en_US currency: USD country: US domain: 'example\.com\/na' enabled: no # default is `yes` default: # If the default profile doesn't exists, the first profile is taken as default language: cs_CZ currency: CZK country: CZ lists: fallback_language: en # default default_language: null # default translation_bridge: locale_resolver: enabled: yes # registers custom TranslatorLocaleResolver through 68publishers/translation-bridge extension use_default: yes # use language of default's profile if profile is not detected, default is `no` priority: 15 # if you want to use custom profile storage or profile detector: storage: My\Custom\ProfileStorage detector: My\Custom\Detector
Integration with 68publishers/translation-bridge
Translator Locale Resolving
The Translator's locale can be resolved by the currently active profile.
That is done with custom
TranslatorLocaleResolver that is automatically registered if an option
translation_bridge.locale_resolver.enabled is set to
Synchronization Between Profile's Language and Translator's Locale
The Translator's locale is automatically changed when the active profile's language is changed.
<?php /** @var \SixtyEightPublishers\i18n\Profile\ActiveProfile $activeProfile */ /** @var \SixtyEightPublishers\TranslationBridge\Localization\TranslatorLocalizerInterface $localizer */ $activeProfile->changeLanguage('en_GB'); $localizer->getLocale(); # en_GB $activeProfile->changeLanguage('cs_CZ'); $localizer->getLocale(); # cs_CZ
Before committing any changes, don't forget to run
$ vendor/bin/php-cs-fixer fix --config=.php_cs.dist -v --dry-run
$ composer run tests