一个非常简单的本地化库。T5o 的意思是 Tagengo,Tagengo 是日语,这和本地化是同义的。

v1.0.3 2023-06-14 02:29 UTC

This package is auto-updated.

Last update: 2024-09-14 05:14:00 UTC


README

T5o 是一个非常简单的 PHP 本地化库。T5o 的意思是 Tagengo,Tagengo 是日语,这和本地化是同义的。

安装

推荐通过 Composer 安装 T5o。

composer require hoku-lib/t5o

用法

有两种用法。

使用 define 关键字。

<?php
require_once 'vendor/autoload.php';

$lang = 'fr';
$csvFilePath = dirname(__FILE__) . '/T5o.csv';
\T5o\T5o::define($csvFilePath, $lang);
// \T5o\T5o::define($csvFilePath, $lang, null, true); // auto htmlspecialchars!
?>
<!DOCTYPE html>
<html lang="<?=$lang?>">
<head>
    <meta charset="utf-8">
    <title>T5o</title>
</head>
<body>
    <h1><?=SITE_TITLE?></h1>
</body>
</html>

使用 属性

<?php
require_once 'vendor/autoload.php';

$lang = 'fr';
$csvFilePath = dirname(__FILE__) . '/T5o.csv';
$T5o = new \T5o\T5o($csvFilePath);
$T5o->setLang($lang);
// $T5o->setLoggingUndefinedWordsMode(true); // logging!
// $T5o->setAutoHtmlspecialcharsMode(true); // auto htmlspecialchars!
?>
<!DOCTYPE html>
<html lang="<?=$lang?>">
<head>
    <meta charset="utf-8">
    <title>T5o</title>
</head>
<body>
    <h1><?=$T5o->SITE_TITLE?></h1>
</body>
</html>

CSV 格式

  • 第一行

    • 在左侧列中输入 T5o_LANG。
    • 在第二列及以后的列中输入语言。
  • 从第二行开始

    • 在左侧列中输入唯一的标识键。
    • 在第二列及以后的列中输入每种语言的单词。
T5o_LANG,en,ja,fr
HELLO,Hello,こんにちは,Bonjour
NAME,Name,名前,Nom
SITE_TITLE,T5o bulletin board,T5o掲示板,Tableau d'affichage T5o

记录未定义的单词

$T5o = new T5o('mydir/t5o_csvfile.csv');
$T5o->setLang('en');

// If an undefined word is accessed, log is output.
// Log file name is "CSV_FILE_NAME + .undefined.log".
// ex. mydir/t5o_csvfile.csv.undefined.log
$T5o->setLoggingUndefinedWordsMode(true);

许可证

T5o 采用 MIT 许可证发布。有关详细信息,请参阅 LICENSE 文件。