README

提供一些命令和服务来帮助您在短语中管理翻译键。当您切换到使用 短语翻译提供者 时，这可能特别有用。

安装

请确保全局安装了Composer，如Composer文档中的安装章节所述。

使用Symfony Flex的应用程序

打开命令行，进入您的项目目录并执行

$ composer require wickedone/phrase-tag-bundle

未使用Symfony Flex的应用程序

步骤 1：下载Bundle

打开命令行，进入您的项目目录并执行以下命令以下载此Bundle的最新稳定版本

$ composer require wickedone/phrase-tag-bundle

步骤 2：启用Bundle

然后，通过将其添加到项目 config/bundles.php 文件中注册的Bundle列表中来启用Bundle

// config/bundles.php

return [
    // ...
    WickedOne\PhraseTagBundle\WickedOnePhraseTagBundle::class => ['all' => true],
];

步骤 3：配置

在您的 config/packages 目录中创建一个 wickedone.yaml 文件，内容如下

wicked_one_phrase_tag:
  dsn: '%env(PHRASE_DSN)%'

并在您的 .env 文件中定义短语dsn如下

PHRASE_DSN=phrase://PROJECT_ID:API_TOKEN@default?userAgent=myProject

dsn元素

• PROJECT_ID：可以在短语中从 项目设置 > API > 项目ID 获取
• API_TOKEN：可以在您的 短语配置文件设置 中创建
• default：端点，默认为 api.phrase.com

dsn查询参数

• userAgent：请阅读 此 了解一些示例。

命令

安装后，您的应用程序将可用两个新命令

phrase:keys:tag 命令

此命令帮助您通过查询现有标签和/或键名来批量标记短语中的键。您可以同时搜索多个标签，并使用 * 通配符进行键名的广泛搜索。请注意，查询是 AND 查询，意味着键必须匹配所有标准。

示例:

php bin/console phrase:keys:tag -k error.* -t ticket-15 -t ticket-13 --tag epic-5

这将搜索所有名称为 error.* 并带有标签 ticket-15 AND ticket-13 的键，并将标签 epic-5 添加到它们中。

当您向命令添加 --dry-run 选项时，它将列出查询的前100个匹配项。

phrase:keys:untag 命令

此命令帮助您通过查询现有标签和/或键名来批量从短语中的键中删除标签。您可以同时搜索多个标签，并使用 * 通配符进行键名的广泛搜索。请注意，查询是 AND 查询，意味着键必须匹配所有标准。

示例:

php bin/console phrase:keys:untag -k error.* -t ticket-15 -t ticket-13 --tag epic-5

这将搜索所有名称为 error.* 并带有标签 ticket-15 AND ticket-13 的键，并将标签 epic-5 从它们中删除。

当您向命令添加 --dry-run 选项时，它将列出查询的前100个匹配项。