1
0
mirror of https://github.com/flextype/flextype.git synced 2025-08-07 13:46:42 +02:00

feat(core): add i18n support into the core

This commit is contained in:
Awilum
2022-04-05 16:31:09 +03:00
parent 3acfba0733
commit 663369f817
4 changed files with 112 additions and 2 deletions

View File

@@ -24,8 +24,6 @@
"ext-mbstring": "*",
"ext-fileinfo": "*",
"flextype-components/i18n" : "1.3.0",
"glowy/session": "^3.0.0",
"glowy/filesystem": "^3.0.0",
"glowy/arrays": "^4.0.0",

View File

@@ -0,0 +1,79 @@
<?php
declare(strict_types=1);
/**
* Flextype (https://awilum.github.io/flextype)
* Founded by Sergey Romanenko and maintained by Flextype Community.
*/
namespace Flextype;
class I18n
{
/**
* Dictionary
*
* @var array
*/
public static $dictionary = [];
/**
* Default locale
*
* @var string
*/
public static $locale = 'en_US';
/**
* Add translation keys
*
* New translation keus for default locale
* I18n::add(['auth_login' => 'Login', 'auth_password' => 'Password']);
*
* New translation keys for `en_US` locale
* I18n::add(['auth_login' => 'Login', 'auth_password' => 'Password'], 'en_US');
*
* @param string $translates Translation keys and values to add
* @param string $locale Locale
* @return void
*/
public static function add(array $translates, string $locale = null) : void
{
$locale = ($locale === null) ? I18n::$locale : $locale;
if (isset(I18n::$dictionary[$locale])) {
I18n::$dictionary[$locale] += $translates;
} else {
I18n::$dictionary[$locale] = $translates;
}
}
/**
* Returns translation of a string. If no translation exists, the original
* string will be returned. No parameters are replaced.
*
* Get translated string for `auth_login` for default locale
* $translated_string = I18n::find('auth_login');
*
* @param string $translate Translate to find
* @param array $values Values to replace in the translated text
* @param string $locale Locale
* @return string
*/
public static function find(string $translate, array $values = [], string $locale = null) : string
{
$locale = ($locale === null) ? I18n::$locale : $locale;
// Search current string to translate in the Dictionary
if (isset(I18n::$dictionary[$locale][$translate])) {
$translate = I18n::$dictionary[$locale][$translate];
$translate = empty($values) ? $translate : strtr($translate, $values);
} else {
$translate = $translate;
}
// Return translation of a string
return $translate;
}
}

View File

@@ -2,6 +2,7 @@
declare(strict_types=1);
require_once __DIR__ . '/i18n.php';
require_once __DIR__ . '/services.php';
require_once __DIR__ . '/arrays.php';
require_once __DIR__ . '/finder.php';

View File

@@ -0,0 +1,32 @@
<?php
declare(strict_types=1);
use Flextype\I18n;
if ( ! function_exists('__')) {
/**
* Global Translation/Internationalization function.
* Accepts an translation key and returns its translation for selected language.
* If the given translation key is not available in the current dictionary the
* translation key will be returned.
*
* Dislay a translated message for default locale
* echo __('auth_login');
*
* // Display a translated message
* echo __('auth_login', [], 'en_US');
*
* // With parameter replacement
* echo __('auth_welcome_message', [':username' => $username], 'en_US');
*
* @param string $translate Translate to find
* @param array $values Values to replace in the translated text
* @param string $locale Locale
* @return string
*/
function __(string $translate, array $values = [], string $locale = null) : string
{
return I18n::find($translate, $values, $locale);
}
}