codecollab/i18n

CodeCollab项目的国际化包

1.0.1 2016-07-16 13:48 UTC

This package is auto-updated.

Last update: 2024-09-06 08:47:14 UTC


README

CodeCollab项目的国际化包

Build Status MIT License Latest Stable Version Total Downloads Latest Unstable Version

要求

PHP7+

安装

使用composer将库包含到您的项目中

{
    "require-dev": {
        "codecollab/i18n": "^1"
    }
}

用法

此库使用包含基于键/值对的翻译数组的简单PHP文件。数组应命名为$texts

翻译文件的名称应根据目标语言进行命名,例如en_US.php。一个简单的文件翻译示例

<?php

$texts = [
    'translation.title'        => 'Translation',
    'translation.description'  => 'This is an example translation.',
    'translation.variable.%'   => 'Copyright %d Some Company',
];

要在您的应用程序中使用翻译,首先通过传递包含翻译文件的目录和要翻译的语言创建翻译类的实例

<?php

$translator = new \CodeCollab\I18n\FileTranslator('/path/to/translations', 'en_US');

echo $translator->translate('translation.title'); // Translation
echo $translator->translate('translation.variable.%', [2015]); // Copyright 2015 Some Company

异常

当找不到翻译文件时,将抛出\CodeCollab\I18n\UnsupportedLanguageException

加载翻译文件时,将检查其格式是否正确。如果文件不是有效的翻译文件,则将抛出\CodeCollab\I18n\InvalidFileException

接口

在您的应用程序中使用翻译器时,始终针对\CodeCollab\I18n\Translator接口进行提示,而不是具体的实现。这允许您在不更改类的情况下,以后使用不同的翻译实现。

贡献

如何贡献

许可协议

MIT

安全问题

如果您发现安全问题,请通过电子邮件直接联系,而不是使用codecollab-security@pieterhordijk.com邮箱的问题跟踪器