PHP
无需执行应用代码,即可翻译静态 PHP 语言区域数组中的字符串字面量。
PHP 应用通常会从返回数组的文件中加载消息。php 文件处理器会翻译数组中的字符串字面量,同时保留查找键、注释、数字及周围的语法。整个扫描过程无需运行 PHP。
支持的源文件结构 #
例如:
<?php
return [
'checkout' => [
'title' => 'Complete your order',
'delivery' => 'Delivery within :days days',
],
];文本路径为 checkout.title 和 checkout.delivery。支持嵌套的方括号数组和 array(...) 语法。字符串键保持不变,应用仍可使用原有标识进行查找。
请将消息值存储在静态数组中。字符串拼接、函数调用和由变量生成的字符串都需要求值,而此扫描器不会执行求值。表达式附近找到的字面量并不是该表达式的计算结果。在依赖文件翻译功能选取这些消息之前,请先将它们改为以字面量形式存储的资源值。
引号与现有译文 #
处理器会保留每个源字符串使用的单引号或双引号,并按相应引号的要求对替换内容进行转义。双引号输出会保留源文本中已有的插值标记,例如 {$name},并对新引入的美元符号序列进行转义。请使用调用方提供的值检查应用占位符,例如 :days。
增量比较以每个字面量在返回数组中的路径为依据。源消息未发生变化时,可以保留已接受的译文值。即使英文文本不变,更改键也会改变用于比较的标识。CLI 的键控制功能支持锁定源值、保留译文值,以及移除 PHP 文件中被忽略的条目。
按键重建时,可能会移除尚未解决且没有译文值的关联数组条目。不要默认部分运行就能生成完整的语言区域文件。请审核嵌套结构,以及应用所需的所有按位置索引的值。
配置并验证文件 #
CLI 会根据 .php 推断 php。使用 CLI 配置或 GitHub 选择源语言区域文件及其目标位置。
对目标文件运行 php -l,然后在应用中加载其中的消息。使用调用方提供的值渲染带参数的文案。对于 Laravel,请求的语言区域选择和回退行为仍由应用配置;本地化 Web 应用介绍了如何将翻译后的资源与这些步骤衔接。