Internationalization and localization your app with a minimum effort.

v0.4.2 2024-08-06 00:27 UTC

This package is auto-updated.

Last update: 2024-11-06 01:38:06 UTC


README

⚠️ Warning! This package does not have active support, it exists only for the historical needs of the author.

i18n

Build Status Quality Score Coverage Status Total Downloads Latest Version on Packagist

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.

Installation

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%)

Configuration

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 TRUE.

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

Contributing

Before committing any changes, don't forget to run

$ vendor/bin/php-cs-fixer fix --config=.php_cs.dist -v --dry-run

and

$ composer run tests