提交: 182 - nova.ext (svn)

PHPのフレームワークです。オートローディング、ルーティング、ORマッパ、フォームバリデータ、その他ユーティリティがセットになっています。

Commit MetaInfo

• 修订版: 182 (tree)
• 时间: 2022-08-22 10:35:03
• 作者: tantancode

Log Message

多言語ファイルについての対応

更改概述

• modified: docs/database.sql
• modified: lib/ArrayUtil.php
• modified: lib/Localizer.php
• modified: lib/RsetUtil.php
• modified: lib/UrlUtil.php
• added: lib/tables/TextMaster.php
• modified: resources/initialize.php

差异

--- docs/database.sql	(revision 181)
+++ docs/database.sql	(revision 182)
@@ -61,14 +61,14 @@
 -- ソースツリーの中に配置して静的管理するのがふさわしくない、運用次第で動的に追加される翻訳テキストを集中貯蔵する。
 -- ソースツリーの中に配置して静的管理するテキストは resources/locale の下にあるファイルで保持されている。
 CREATE TABLE text_master (
-    symbol_attr ENUM(                                               -- テキスト種別
-        'dev.dummy',                                                --      開発用.ダミー
+    text_group ENUM(                                                -- テキスト種別
+        'dev.dummy'                                                 --      開発用.ダミー
     ) NOT NULL,                                                     --
-    symbol_id INT NOT NULL,                                         -- テキスト主体のID。symbol_attr に従って何のIDかが決まる。
+    text_id INT NOT NULL,                                           -- テキストの持ち主のID。text_group に従って何のIDかが決まる。
     lang_code ENUM('ja', 'en') NOT NULL,                            -- 言語コード
     text_content VARCHAR(8192) COLLATE utf16_unicode_ci NOT NULL,   -- テキスト
-    PRIMARY KEY (symbol_attr, symbol_id, lang_code),
-    INDEX (lang_code, symbol_attr, symbol_id)                       -- 特定の言語で、特定の属性に対して検索をかける時に使用する。
+    PRIMARY KEY (text_group, text_id, lang_code),
+    INDEX (lang_code, text_group, text_id)                          -- 特定の言語で、特定の属性に対して検索をかける時に使用する。
 ) ENGINE=Aria COLLATE=ascii_bin;
 
 

--- lib/ArrayUtil.php	(revision 181)
+++ lib/ArrayUtil.php	(revision 182)
@@ -524,8 +524,7 @@
      *      // $r は $target['alpha'][1] への参照になる。
      *
      * 存在しない要素へのパスを指定した場合、その要素が null で作成される。
-     * ただし、第3引数に偽の値を含む変数を指定した場合、要素は作成されず、第3引数に指定した変数に要素の
-     * 有無が真偽値でセットされる。
+     * ただし、第3引数に偽の値を含む変数を指定した場合、要素は作成されず、第3引数に指定した変数に要素の有無が真偽値でセットされる。
      *
      * 例)
      *      $target = array(

--- lib/Localizer.php	(revision 181)
+++ lib/Localizer.php	(revision 182)
@@ -1,49 +1,82 @@
 <?php
 
 /**
- * テキストシンボルを各言語テキストに置き換えるためのユーティリティ。国際化対応で使う。
+ * テキストシンボルを各言語テキストに置き換えたり、言語別アセットへのアクセスを提供するためのユーティリティ。多言語対応で使う。
  *
  * ●このユーティリティにおける基本
  *
- *      ・まず言語ファイルを resources/locale/ja/ の下に配置する。ここでは sample.csv という名前で配置して、次のように記述する。
+ *      まずCSV形式の言語ファイルを resources/locale/ja/ の下に配置する。ここでは sample.csv という名前で配置して、次のように記述する。
  *
- *          これはフー,これはフーです。
+ *          これはフー,これは<フー>です。
  *          N個あるよ,[num]個ありますね。
  *          これはバー,これは[keyword]バー[/]です。
  *
- *      ・次に処理対象の文字列を準備する。ここでは次のような文字列とし、変数 $s に格納されているものとする。
+ *      次にビューテンプレートファイルで次のように呼び出す(SmartyRendererの場合)。
  *
- *          <div>{(sample:これはフー)}</div>
- *          <div>{(sample:N個あるよ num=`5`)}</div>
- *          <div>{(sample:これはバー keyword=`<span style="color:red">`)}</div>
+ *          <div>{[i18n _='sample:これはフー']}</div>
+ *          <div>{[i18n _='sample:N個あるよ' num=>5]}</div>
+ *          <div>{[i18n _='sample:これはバー' keyword=>'<span style="color:red">'}])</div>
  *
- *      ・次のように展開すると...
+ *      すると出力は次のようになる。
  *
- *          $localizer = new Localizer();
- *          $r = $localizer->processSymbolicText($s);
- *
- *      ・$r は次のような文字列になる。
- *
- *          <div>これはフーです。</div>
+ *          <div>これは&lt;フー&gt;です。</div>
  *          <div>5個ありますね。</div>
  *          <div>これは<span style="color:red">バー</span>です。</div>
  *
- * ●ただ...
+ * ●エンコードとヘルパ関数 i18n()
  *
- *      上記のように母体テキストと融合したシンボルを用いると、(ユーザが入力した文字列などで)意図しない展開を招く場合があるので考慮事項が多くなる。
- *      実質、使用できるのはそのような心配がない場合に限られるだろう。
+ *      {[i18n ...]} では "encode" パラメータでHTMLエンコードやJSエンコードを行うかを設定できる。次の値のいずれかとなる。
+ *          "html"  デフォルト。HTMLエンコード。HTML文字のエスケープとnl2brが行われるが、
+ *                  プレースホルダ nl2br が "off" になっているとnl2brだけは抑制される。
+ *          "js"    JSエンコード。シングルクォートとダブルクォート、改行のエスケープが行われる。
+ *          "plain" エンコードしない
+ *      HTMLエンコードがデフォルトなので留意されたい。
  *
- *      融合したシンボルを使わず、素直に関数を使って局所的に展開するほうが良いだろう。
+ *      ただ、エンコードされるのは翻訳文中の平テキスト部分のみ。プレースホルダはエンコードされないので注意されたい。
  *
- *          <div><?php echo $localizer->expandSymbol('sample:これはフー') ?></div>
- *          <div><?php echo $localizer->expandSymbol('sample:N個あるよ', ['num'=>5]) ?></div>
- *          <div><?php echo $localizer->expandSymbol('sample:これはバー', ['keyword'=>'<span style="color:red">'']) ?></div>
- *          <div><?php echo $user_data ?></div>
+ *          {[i18n _='sample:あなたの名前' name=>'ほ<げ>子']}
+ *          あなたの名前,あなたの<名前>は[name]です。
+ *              ↓
+ *          あなたの&lt;名前&gt;はほ<げ>子です。
  *
- *      こうすれば、シンボル展開をする場所としない場所を制御できる。
+ *      これは上述の例のように、プレースホルダにHTMLタグをセットできるようにするためにこうなっている。
  *
- * ●[/]について
+ *      smarty関数 {[i18n ...]} の他にヘルパ関数 i18n() というものがあって、引数定義もほぼ同じなのだが、第三引数の省略時が "plain" になる点が異なる。
+ *      これは、サーバ側のAPIレスポンスなどを実装する時に使用するものであるため。
  *
+ *          echo i18n('sample:これはフー');  // これは<フー>です。
+ *
+ * ●htdocs/ 下の .js や .html などの、PHPが動かないファイルでは...
+ *
+ *      たとえば、<script src="/js/foo.js"></script> などとリンクしており、この foo.js の中に翻訳の必要のあるテキストが含まれている場合は...
+ *
+ *      まず htdocs/js/foo.js は次のように {(...)} というデリミタを使ったシンボルでテキストを記述する。
+ *
+ *          var message1 = "{(sample:これはフー)}";
+ *          var message2 = "{(sample:N個あるよ num=`5`)}";
+ *          var message3 = "{(sample:これはバー keyword=`<span style=\"color:red\">`)}";
+ *
+ *      次に、HTML中に "/js/foo.js" のパスを出力する時に、{[asset_url ...]} を使って次のように記述する。
+ *
+ *          <script src="{[asset_url path='js/foo.js']}"></script>
+ *
+ *      すると、次のような内容の .js にリンクすることになる。
+ *
+ *          var message1 = "これは<フー>です。";
+ *          var message2 = "5個ありますね。";
+ *          var message3 = "これは<span style=\"color:red\">バー</span>です。";
+ *
+ *      プレースホルダの括りはバッククォートになっているので留意されたい。
+ *      この仕組みが働くのは、htdocs/ の下にある .txt, .js, .html, .htm の拡張子を持つファイルに対して、{[asset_url ...]} (や、それが呼び出す
+ *      UrlUtil::assetUrl() など) を使用した場合のみ。ただし .min.js は除く。
+ *
+ *      エンコードについては、.js がJSエンコード、.html, .htm がHTMLエンコード、.txt はエンコードなしになる。
+ *
+ *      翻訳後のファイルが var/cgm/translate/ の下に作られる。元ファイルの更新日時と比較して自動的に新しくするので普段は意識する必要はないが、
+ *      言語ファイルを更新した場合はキャッシュに反映できないので、元ファイルを空保存して新しくするか、キャッシュを削除する必要がある。
+ *
+ * ●プレースホルダ [/] について
+ *
  *      ・[/]は前方に現れたHTMLタグが格納されたプレースホルダを記憶している。
  *
  *          {(sample:フー１ link=`<a ...>`)}
@@ -79,44 +112,38 @@
  *            ↓
  *          これは<a ...>リンク<img ... /></a>です。
  *
- * ●エンコード
- *
- *      シンボルの展開は processSymbolicText() や expandSymbol() メソッドで行うが、このときにHTMLエンコードやJSエンコードを行うかを設定できる。
- *      次の値のいずれかとなる。
- *          (なし)  エンコードしない
- *          html    HTMLエンコード。HTML文字のエスケープとnl2brが行われるが、プレースホルダ nl2br が "off" になっているとnl2brだけは抑制される。
- *          js      JSエンコード。シングルクォートとダブルクォート、改行のエスケープが行われる。
- *
- *      ただ、エンコードされるのは翻訳テキスト中の平テキスト部分のみ。プレースホルダはエンコードされないので注意されたい。
- *
- *          {(sample:あなたの名前 name=`ほ<げ>子`)}
- *          あなたの名前,あなたの<名前>は[name]です。
- *              ↓
- *          あなたの&lt;名前&gt;はほ<げ>子です。
- *
- *      これは上述の例のように、属性値にHTMLタグをセットできるようにするため。
- *      また、属性の値は普通ビュー変数でセットされる場合がほとんどであるため、二重エンコードを避けるようにする意味もある。
- *
  * ●"!" で始まるシンボル。
  *
  *      ・!include:
  *          規約など、かなり長いテキストファイルをインクルードしたい場合は次のようなインクルード命令を書くことが出来る。
  *
- *              {(!include.sample)}
+ *              {[i18n _='!include:sample']}
  *
  *          この場合、sample.txt というファイルの内容が読み込まれて翻訳テキストとして展開される。プレースホルダも通常通り使える。
  *
  *      ・!db:
- *          テーブル text_info から翻訳テキストを読み込みたい場合に使用する。
+ *          テーブル text_master, text_info から翻訳テキストを読み込みたい場合に使用する。
+ *          例えば symbol_group='foo' AND symbol_id=5 のレコードを使いたい場合は次のようになる。
  *
- *              {(!db:foo)}
+ *              {[i18n _='!db:foo#5']}
  *
- *          text_info から symbol_code='foo' のレコードが読み込まれて、そのテキストが使用される。
+ *          text_master と text_info のどちらを使うのかは symbol_group の値によって自動的に求められる。
  *
- * ●対応する必要のあるファイルと各ファイルにおける対策
+ * ●画像などのアセット選択
  *
+ *      文字が含まれる画像など、言語によって切り替えなければならないアセットがある。
+ *
+ *      たとえば、/foo/bar.jpg で多言語対応の必要があるなら、/foo/bar.ja.jpg, /foo/bar.en.jpg, ... などと各国語版をあらかじめ用意して、
+ *      次のように参照すると...
+ *          <img src="{[asset_url path='foo/bar.jpg']}" />
+ *      日本語選択状態なら bar.ja.jpg が、英語選択状態なら bar.en.jpg が出力される。
+ *
+ *      /foo/bar.xxx.jpg などの言語対応版がない場合は /foo/bar.jpg がそのまま使われる。
+ *
+ * ●多言語対応のTips的まとめ
+ *
  *      .html
- *          基本的にはタグのようなプログラム要素はそのまま残し、翻訳テキストの部分をシンボルにするのだが...
+ *          基本的にはHTMLタグのようなプログラム的要素はそのまま残し、翻訳対象テキストの部分をシンボルにするのだが...
  *
  *              <table>
  *                <tr>
@@ -127,18 +154,17 @@
  *                ↓
  *              <table>
  *                <tr>
- *                  <th>{(sample:タイトル)}</th>
- *                  <td>{(sample:本文)}</td>
+ *                  <th>{[i18n _='sample:タイトル']}</th>
+ *                  <td>{[i18n _='sample:本文']}</td>
  *                </tr>
  *              </table>
  *
- *          次のようにタグが絡みこんだテキストなどもある。
+ *          次のようにタグが絡みこんだテキストもあるだろう。
  *              <div>この<span class="strong">名前</span>の意味を知りたいなら<a href="...">ここ</a>をクリック</div>
  *
  *          これをタグでぶつ切りにしてシンボルにすると翻訳側はやってられないので、次のようにして...
- *              <div>{(sample:この名前の意味 link=`<a href="...">` keyword=`<span class="strong">`)}</div>
- *
- *          翻訳テキストの中にある程度潜り込ませる。
+ *              <div>{[i18n _='sample:この名前の意味' link=>'<a href="...">' keyword=>'<span class="strong">']}</div>
+ *          翻訳テキストの中にプログラム的要素をある程度潜り込ませるしかない。
  *              この名前の意味,この[keyword]名前[/]の意味を知りたいなら[link]ここ[/]をクリック
  *
  *      .php
@@ -150,30 +176,31 @@
  *              <div><?php echo EXPLAIN ?></div>
  *                  ↓
  *              <?php
- *                  define('EXPLAIN', '{(sample:エラーメッセージ)}');
+ *                  define('EXPLAIN', 'sample:エラーメッセージ');
  *              ?>
- *              <div><?php echo EXPLAIN ?></div>
+ *              <div>{[i18n _=$smarty.constant.EXPLAIN]}</div>
  *
  *      マスタデータ
- *          翻訳テキストを locale 以下の .csv ファイルに用意して、マスタにはシンボルを格納するか、あるいは、
- *          マスタデータのテキストを text_info に集約して、主キー値などで参照するか、になるだろう。
+ *          マスタデータにテキストが含まれるなら、そのテキスト列を text_master に正規化するか、あるいは、シンボル名をテキスト列に格納するかの
+ *          いずかになるだろう。
  *
+ *          どちらにせよ、出力時にテキストシンボルとして翻訳するように記述することになる。
+ *
  *      ユーザデータ
- *          翻訳不能なので、そのまま出力すれば良い。ただ、"{(" などが含まれている場合にシンボル展開エンジンが作用しないように留意する必要はある。
+ *          そもそも翻訳できるものではないので、言語に関わらずそのまま出力するしか無い。
  *
  *      画像
- *          文字が含まれる画像も国際化対応の必要がある。
- *          たとえば、sample.jpg で国際化対応の必要があるなら、sample.ja.jpg, sample.en.jpg, ... などと各国語版をあらかじめ用意して、
- *          translateAsset() などで対応する。
+ *          上述の通り。
  *
  *      .js
- *          画像と同じように対応するのだが、「各国語版をあらかじめ用意して...」というのは面倒臭すぎる。
+ *          静的ファイルという意味では画像と同じように対応するのだが、「各国語版をあらかじめ用意して...」というのは面倒臭すぎる。
  *          テキスト部分をシンボル化した .js ファイルをひとつだけ用意して、各国語版が必要になったときにシンボル展開したjsファイルを
- *          自動作成＆キャッシュするような仕組みが必要になるだろう。
- *          translateAsset() で行われている。
+ *          自動作成＆キャッシュするような仕組みが必要になるだろう。上記の通り。
  *
- *      CSS
- *          contentプロパティにテキストが含まれている可能性があるが、国際化対応する必要がないようにルールを決めたほうが良いだろう。
+ *      .css
+ *          contentプロパティにテキストが含まれている可能性があるが、「使用しない」などのルールで回避できると思われる。
+ *          background-image: などで多言語対応の必要がある画像などを参照する可能性がある。sample.jpg などの固定化されたパスで言語に応じたアセットを
+ *          返せるような特殊なアクションを用意するか、あるいは、こういった画像に言語的要素を含めないという運用ルールで回避することになる。
  *
  *      日時出力
  *          タイムゾーン対応が必要になる…と言っても言語だけではタイムゾーンは絞れないので、その辺どうするかはプロジェクト次第。
@@ -207,7 +234,7 @@
         if( is_null($primaryLang) )
             $primaryLang = self::decidePrimaryLang();
 
-        // 指定されていない場合は自動で決定する。
+        // 言語参照順序を決定する。
         $this->langOrder = self::getLangOrder($primaryLang);
     }
 
@@ -248,9 +275,9 @@
      *
      * 第一引数を省略して、テキストシンボル名を第二引数に含めることも出来る。この場合はキー "0" で指定する。
      * 例えばこのような呼び出しなら...
-     *      Localizer::expandSymbol('name_of_file:kore_ha_sample', ['keyword'=>'foo']);
+     *      $localizer->expandSymbol('name_of_file:kore_ha_sample', ['keyword'=>'foo']);
      * こうすることも出来る。
-     *      Localizer::expandSymbol(['name_of_file:kore_ha_sample', 'keyword'=>'foo']);
+     *      $localizer->expandSymbol(['name_of_file:kore_ha_sample', 'keyword'=>'foo']);
      */
     public function expandSymbol($symbol, $places = [], $encode = null) {
 
@@ -299,8 +326,12 @@
                 return $this->getLangFileContent($key);
 
             case '!db':
-                return TextInfo::getLangText($key, $this->langOrder);
 
+                // キー文字列を "#" で区切って symbol_group, symbol_id とする。
+                [$group, $id] = str_snap($key, '#');
+
+                return TextMaster::getText($group, $id, $this->langOrder);
+
             // "!" で始まらないシンボルは言語ファイルにある。
             default:
 
@@ -375,8 +406,8 @@
         if(0 < strlen($basedir)  &&  !str_end($basedir, '/')  &&  !str_begin($path, '/'))
             $basedir .= '/';
 
-        // 末尾の拡張子部分に ".LANG" という文字列を挿入してパスルールとする。
-        $check = $basedir . preg_replace('/\.\w+$/', ".LANG$0", $path);
+        // 末尾の拡張子部分に ".:LANG:" という文字列を挿入してパスルールとする。
+        $check = $basedir . preg_replace('/\.\w+$/', ".:LANG:$0", $path);
 
         // 使用できる言語ファイルを探す。
         $find = $this->searchLangPath($check);
@@ -388,10 +419,10 @@
     //----------------------------------------------------------------------------------------------------------
     /**
      * 引数に指定されたパスルールで言語に適合する実在パスを返す。
-     * 文字列中の "LANG" と記述された部分を言語コードに置き換えて、フォールバックしながら実在するかを調べる。
+     * 文字列中の ":LANG:" と記述された部分を言語コードに置き換えて、フォールバックしながら実在するかを調べる。
      *
-     * param    調べたいパス。この文字列中の "LANG" と記述された部分が言語コードに置き換えられてチェックされる。
-     * return   "LANG" と記述された部分をフォールバックしながら言語コードに置き換えて、最初に見つけたパス。
+     * param    調べたいパス。この文字列中の ":LANG:" と記述された部分が言語コードに置き換えられてチェックされる。
+     * return   ":LANG:" と記述された部分をフォールバックしながら言語コードに置き換えて、最初に見つけたパス。
      *          いずれの言語でも見つからない場合は null。
      */
     public function searchLangPath($path) {
@@ -400,7 +431,7 @@
         foreach($this->langOrder as $lang) {
 
             // その言語の派生パスを取得。
-            $check = str_replace('LANG', $lang, $path);
+            $check = str_replace(':LANG:', $lang, $path);
 
             // そのパスにファイルがあるならそれ。
             if( file_exists($check) )
@@ -424,9 +455,9 @@
         $oldpath = $path;
         $path = $this->getSpecificFile($path, AppMojo::path('htdocs'));
 
-        // 言語派生版がなく、求められているパスが js ならば翻訳版を準備する。
-        // ただし、.min.js は多分違うし、Smarty展開すると誤爆する確率が高いので無視。
-        if($path == $oldpath  &&  pathinfo($path, PATHINFO_EXTENSION) == 'js'  &&  !str_end($path, '.min.js'))
+        // 言語派生版がなく、求められているパスが js, txt, html ならば翻訳版を準備する。
+        // ただし、.min.js は多分違うし、展開すると誤爆が心配になるので無視。
+        if($path == $oldpath  &&  in_array(strtolower(path_extension($path)), ['.js', '.txt', '.html', '.htm'])  &&  !str_end($path, '.min.js'))
             $path = $this->readyTranslatedScript($path);
 
         return $path;
@@ -499,20 +530,19 @@
      */
     public static function decidePrimaryLang() {
 
-        // URLで言語が指定されている場合はそれを使う。ただし、扱っていない場合は無視する。
-        if(@$_GET['lang']) {
-            $lang = self::languageExists($_GET['lang']);
-            if($lang)  return $lang;
-        }
+        // アクションの属性(つまりURL)で言語が指定されている場合はそれを使う。ただし、扱っていない場合は無視する。
+        $lang = Mojo::getRequestedAction()?->attributes['lang'] ?? null;
+        $lang = self::languageExists($lang);
+        if($lang)  return $lang;
 
+        // ユーザの言語設定などがあるならここで判定することになる。
+        // ...
+
         // HTTPリクエストヘッダに Accept-Language がある場合はそれを見て自動決定する。
         if( isset($_SERVER['HTTP_ACCEPT_LANGUAGE']) ) {
 
             // Accept-Language にリストされている言語コードを取得。Q値は…まあいいや。
-            $desires = array_each(explode(',', $_SERVER['HTTP_ACCEPT_LANGUAGE']), function($v){
-                [$ret] = str_snap($v, ';');
-                return $ret;
-            });
+            $desires = array_each(explode(',', $_SERVER['HTTP_ACCEPT_LANGUAGE']), fn($v)=>str_snap($v, ';')[0]);
 
             // リスト先頭からひとつひとつ見て、扱っている言語を見つけたらそれを返す。
             foreach($desires as $desire) {
@@ -529,7 +559,7 @@
     /**
      * フォールバックも考慮して参照する言語コードの序列を返す。
      *
-     * param    最優先して参照する言語。
+     * param    最優先して参照したい言語。
      * return   参照する言語コードの序列を表した配列。
      */
     public static function getLangOrder($primaryLang) {
@@ -546,6 +576,8 @@
      */
     private static function languageExists($lang) {
 
+        if( !$lang )  return null;
+
         // 言語コードのサブタグ("en-US" の "US" の部分)は無視するのだが...
         [$lang, $sub] = str_snap($lang, '-');
 
@@ -564,7 +596,7 @@
      */
     private static function getLangDir($lang) {
 
-        return AppMojo::path('resources') . pathf("/locale/%s", $lang);
+        return AppMojo::path(pathf("resources/locale/%s", $lang));
     }
 
     //----------------------------------------------------------------------------------------------------------

--- lib/RsetUtil.php	(revision 181)
+++ lib/RsetUtil.php	(revision 182)
@@ -73,34 +73,45 @@
      * 引数に指定された結果セット形式の配列から、特定のカラムの値をキーとする新しい配列を作成する。
      *
      * 例)
-     *     次のような配列を第一引数に指定し...
-     *         array(
-     *             array('alpha' => 5, 'beta' => 10, 'gamma' => 21),
-     *             array('alpha' => 6, 'beta' => 10, 'gamma' => 22),
-     *             array('alpha' => 7, 'beta' => 11, 'gamma' => 23),
-     *         );
+     *      次のような配列を第一引数に指定し...
+     *          array(
+     *              array('alpha' => 5, 'beta' => 10, 'gamma' => 21),
+     *              array('alpha' => 6, 'beta' => 10, 'gamma' => 22),
+     *              array('alpha' => 7, 'beta' => 11, 'gamma' => 23),
+     *          );
      *
-     *     第二引数に 'alpha' を指定すると、次のような配列を返す。
-     *         array(
-     *             5 => array('alpha' => 5, 'beta' => 10, 'gamma' => 21),
-     *             6 => array('alpha' => 6, 'beta' => 10, 'gamma' => 22),
-     *             7 => array('alpha' => 7, 'beta' => 11, 'gamma' => 23),
-     *         );
+     *      第二引数に 'alpha' を指定すると、次のような配列を返す。
+     *          array(
+     *              5 => array('alpha' => 5, 'beta' => 10, 'gamma' => 21),
+     *              6 => array('alpha' => 6, 'beta' => 10, 'gamma' => 22),
+     *              7 => array('alpha' => 7, 'beta' => 11, 'gamma' => 23),
+     *          );
      *
-     *     また、第二引数に配列 array('beta', 'alpha') を指定すると、次のような二次元配列を返す。
-     *         array(
-     *             10 => array(
-     *                 5 => array('alpha' => 5, 'beta' => 10, 'gamma' => 21),
-     *                 6 => array('alpha' => 6, 'beta' => 10, 'gamma' => 22),
-     *             ),
-     *             11 => array(
-     *                 7 => array('alpha' => 7, 'beta' => 11, 'gamma' => 23),
-     *             ),
-     *         )
+     *      また、第二引数に配列 array('beta', 'alpha') を指定すると、次のような二次元配列を返す。
+     *          array(
+     *              10 => array(
+     *                  5 => array('alpha' => 5, 'beta' => 10, 'gamma' => 21),
+     *                  6 => array('alpha' => 6, 'beta' => 10, 'gamma' => 22),
+     *              ),
+     *              11 => array(
+     *                  7 => array('alpha' => 7, 'beta' => 11, 'gamma' => 23),
+     *              ),
+     *          )
      *
-     * 第三引数にtrueを渡すと、キーに変換した列を削除するようになる。
+     *      第三引数にコールバック関数を渡すと、最終的に格納する値を制御できる。
+     *          $ret = RsetUtil::keyShift($source, array('beta', 'alpha'), fn($rec)=>$rec['gamma']);
+     *      次のようになる。
+     *          array(
+     *              10 => array(
+     *                  5 => 21,
+     *                  6 => 22,
+     *              ),
+     *              11 => array(
+     *                  7 => 23,
+     *              ),
+     *          )
      */
-    public static function keyShift($source, $keys, $unsetShift = false) {
+    public static function keyShift($source, $keys, $processor=null) {
 
         // キー変換列を正規化。
         $keys = (array)$keys;
@@ -111,28 +122,14 @@
         // 結果セットに含まれるレコードを一つずつ戻り値の該当箇所に振り分けていく。
         foreach($source as $row) {
 
-            // レコードがオブジェクトになっている場合は unset する前にクローンしておく。
-            if($unsetShift  &&  $row instanceof ArrayAccess)
-                $row = clone $row;
+            // キー変換列の値を取り出す。
+            $path = ArrayUtil::pick($row, $keys);
 
-            // レコードを格納するべき、戻り値の該当箇所を変数 $corsor で指し示すようにする。
-            $cursor = &$result;
-            foreach($keys as $key) {
+            // 戻り値の該当箇所を取得。
+            $cell = &ArrayUtil::dig($result, $path);
 
-                // 列の値を取得。
-                // ついでに、キー変換列を削除するならここで削除しておく。
-                $value = $row[$key];
-                if($unsetShift) unset($row[$key]);
-
-                // 戻り値に該当箇所がないなら作成しておく。
-                if( !array_key_exists($value, $cursor) )
-                    $cursor[$value] = array();
-
-                $cursor = &$cursor[$value];
-            }
-
-            // 格納するべき場所にレコードを格納。
-            $cursor = $row;
+            // そこにレコードを格納するのだが、第３引数が指定されているならコールバックして戻り地を格納する。
+            $cell = $processor ? $processor($row) : $row;
         }
 
         // リターン。

--- lib/UrlUtil.php	(revision 181)
+++ lib/UrlUtil.php	(revision 182)
@@ -221,7 +221,7 @@
     public static function versionStamp($path) {
 
         // 静的ファイルの更新時刻を取得。ファイルがなくてもエラーにならないようにする。
-        $mtime = (int)@filemtime( static::assetPhys($path) );
+        $mtime = (int)@filemtime( Mojo::path("htdocs/{$path}") );
 
         // "?"に続けて更新日時をつなげてリターン。
         return $mtime ? '?cache='.$mtime : '';

--- lib/tables/TextMaster.php	(nonexistent)
+++ lib/tables/TextMaster.php	(revision 182)
@@ -0,0 +1,68 @@
+<?php
+
+class TextMaster extends MojoRecord {
+
+    // // text_group の列挙。
+    // const GROUPS = array(
+    // );
+
+    //----------------------------------------------------------------------------------------------------------
+    /**
+     * 引数で指定されたテキストを、指定された言語順で探す。
+     *
+     * param    グループコード。text_group の値。
+     * param    テキストID。text_id の値。
+     * param    参照する言語順。
+     * return   指定されたテキストの内容。見つからない場合は null。
+     */
+    public static function getText($group, $id, $langOrder) {
+
+        // このクラスで定義されていないグループ名の場合は TextInfo のほうにあるかも。
+        // if( !array_key_exists($group, static::GROUPS) && static::class != 'TextInfo' )
+        //     return TextInfo::getText($group, $id, $langOrder);
+
+        // 使用言語順に従って取得。
+        foreach($langOrder as $lang) {
+            $record = static::getSolid($group, $id, $lang);
+            if($record)  return $record['text_content'];
+        }
+
+        return null;
+    }
+
+    //----------------------------------------------------------------------------------------------------------
+    /**
+     * 引数で指定されたテキストのグループを、指定された言語順で探す。
+     *
+     * param    グループコード。text_group の値。
+     * param    参照する言語順。
+     * return   テキストID => テキスト内容 の配列。優先言語でテキストIDが一部欠損している場合は、第2言語以降のテキストがマージされる。
+     */
+    public static function getTexts($group, $langOrder) {
+
+        // このクラスで定義されていないグループ名の場合は TextInfo のほうにあるかも。
+        // if( !array_key_exists($group, static::GROUPS) && static::class != 'TextInfo' )
+        //     return TextInfo::getTexts($group, $langOrder);
+
+        // 引数で指定されたグループのテキストを全て取得。
+        $records = static::recordsWhere(['text_group'=>$group]);
+
+        // 言語 => テキストID の二次元配列として、テキストの内容を取得する。
+        $texts = RsetUtil::keyShift($records, array('lang_code', 'text_id'), fn($rec)=>$rec['text_content']);
+
+        // 使用言語順に従って テキストID => テキスト内容 の配列を得るのだが、優先言語でテキストIDが一部欠損している場合にマージされるようにする。
+        $result = array();
+        foreach($langOrder as $lang)
+            $result += $texts[$lang] ?? array();
+
+        // テキストIDで並べ替えてリターン。
+        ksort($result, SORT_NUMERIC);
+        return $result;
+    }
+
+
+    // 基底メンバの上書き。
+    //==========================================================================================================
+
+    protected static $primaryColumn = array('text_group', 'text_id', 'lang_code');
+}

--- resources/initialize.php	(revision 181)
+++ resources/initialize.php	(revision 182)
@@ -832,3 +832,9 @@
     if( !$condition )
         throw new IrregularAccess( sprintf($errstr, ...$vals) );
 }
+
+// 多言語対応のヘルパ関数。Localizer::expandSymbol() のショートカット。
+function i18n($symbol, $places = [], $encode = null) {
+
+    return Localizer::getLocalizer()->expandSymbol($symbol, $places, $encode);
+}