搜索symfony / phrase-translation-provider
Symfony 语句翻译提供程序桥接器
Requires
- php: >=8.2
- psr/cache: ^3.0
- symfony/http-client: ^6.4|^7.0
- symfony/mime: ^6.4|^7.0
- symfony/translation: ^6.4|^7.0
This package is auto-updated.
Last update: 2024-09-21 06:13:13 UTC
README
为 Symfony 翻译提供语句集成。
DSN 示例
// .env file
PHRASE_DSN=phrase://PROJECT_ID:API_TOKEN@default?userAgent=myProject
DSN 元素
PROJECT_ID：可以在 Phrase 的“项目设置 > API > 项目 ID”中检索到API_TOKEN：可以在您的 Phrase 个人资料设置 中创建default：端点，默认为api.phrase.com
必需的 DSN 查询参数
userAgent：请阅读 此内容 以获取一些示例。
有关更多 DSN 选项，请参阅 微调您的 Phrase API 调用。
Phrase 区域名称
使用 Symfony XLIFF 格式在 Phrase 中导入的翻译，区域将根据 Phrase 中的区域名称进行匹配。因此，区域名称应与在 RFC4646 中定义的名称一致（例如，pt-BR 而不是 pt_BR）。如果不这样做，Phrase 将为导入的键创建一个新的区域。
区域创建
如果您在 translation.yaml 中定义了一个未在您的 Phrase 项目中配置的区域，它将被自动创建。但是，区域的删除（目前）不由该提供程序管理。
将域名作为标签
翻译将根据它们所属的 Symfony 翻译域在 Phrase 中进行标记。如果您需要帮助管理 Phrase 中的标记，请检查 wickedone/phrase-translation-bundle。
缓存
从 Phrase 读取的响应被缓存以提高此提供程序的读取和删除方法的性能，并尽可能减少对速率限制的贡献。因此，应使用与 PSR-6 兼容的缓存适配器初始化工厂。
微调您的 Phrase API 调用
您可以通过向 dsn 配置中添加查询参数来微调此提供程序的读取和写入方法。通用用法是 read|write[option_name]=value
**示例：** phrase://PROJECT_ID:API_TOKEN@default?read[encoding]=UTF-8&write[update_descriptions]=0
读取
为了从 Phrase 读取翻译，将对 Phrase API 执行 下载区域 调用，支持的参数可以在他们的文档中找到。
一个额外的读取参数是 fallback_locale_enabled（默认为 0）。当设置为 1 时，此提供程序将使用 Phrase 中配置的回退区域。
❗启用回退区域将禁用条件获取请求的缓存
写入
为了将翻译写入 Phrase，将对 Phrase API 执行 上传 调用，支持的参数可以在他们的文档中找到。
默认值 此提供程序使用以下默认值进行读取和写入请求。除了 file_format 和 tags 之外，都可以通过配置您的 DSN 查询参数来覆盖。