simplecomplex / locale
地区和语言工具,基于.ini配置的本地化。
2.1.3
2019-04-08 08:18 UTC
Requires
- php: >=7.0
- simplecomplex/config: ^2.1 || dev-develop
- simplecomplex/utils: ^1.8 || ^2.0 || dev-develop
Suggests
- simplecomplex/inspect: CLI features do NOT work without Inspect. And great for logging; better variable dumps and traces.
This package is auto-updated.
Last update: 2024-09-08 20:05:07 UTC
README
本地化,主要针对文本
文本通过(自由格式)ID引用。
基于.ini文件。
在以下方面优于gettext (.po)
- 文本(翻译)在更改源文本时不会变成孤儿
- 编辑器/翻译员使用标准纯文本编辑器工作
- 文本可以按组和子组组织。
- 无需复杂解析器和导入/导出功能,数据库等。
- 极小的资源占用
.ini文件示例
[some-group] meeting = reunión some-sub-group[start] = ¡Hola! some-sub-group[continue] = ¿Cómo estás? some-sub-group[end] = Hasta luego...
依赖注入容器ID:locale
建议:通过DI容器ID 'locale'访问(从而实例化)locale。
参见 SimpleComplex Utils Dependency。
CLI命令
# List all locale-text commands and their help. php cli.php locale-text -h # One command's help. php cli.php locale-text-xxx -h # Display/get value of a locale-text item. php cli.php locale-text-get language section key # Set a locale-text item. php cli.php locale-text-set language section key value # Delete a locale-text item. php cli.php locale-text-delete language section key # Refresh a locale-text store from .locale-text.[language].ini file sources. php cli.php locale-text-refresh language # Export a locale-text store as JSON to a file. php cli.php locale-text-export language target-path-and-file
安装
复制'global'配置.ini文件(见 SimpleComplex Config)
[locale package dir]/config-ini/locale.global.ini
并将其放置在'config'的'base'或'override'路径中。
按照该文件内的说明进行操作,
并根据当前系统的结构和功能进行修改。
要求
- PHP >=7.0
- SimpleComplex Config
- SimpleComplex Utils