如何解决多语言项目翻译管理难题，使用Composer配合mautic/transifex轻松搞定

可以通过一下地址学习composer：学习地址

告别繁琐：多语言项目翻译管理的痛点与挑战

作为一名 php 开发者，你是不是也曾为多语言项目的翻译管理而焦头烂额？

想象一下这样的场景：你的应用需要支持多种语言，每次有新功能上线或文案修改，你都需要：

1. 手动导出待翻译的字符串文件（可能是

   ini

   ,

   json

   ,

   po

   等格式）。
2. 将这些文件发送给翻译团队。
3. 等待翻译完成，接收翻译好的文件。
4. 手动将翻译文件导入到项目中，并确保路径、命名、编码都正确无误。
5. 如果翻译有更新，这个循环又将重来一遍。

这个过程不仅效率低下，容易出错，而且在团队协作中，版本控制和同步问题更是让人头大。当项目规模扩大，支持的语言增多时，这种手动管理方式简直是噩梦。我们渴望一种能够自动化、标准化、与代码紧密结合的翻译管理方案。

曙光乍现：

mautic/transifex

与 Composer 的完美结合

幸运的是，PHP 社区为我们提供了一个优雅的解决方案：

mautic/transifex

Transifex 是一个流行的本地化管理平台，它提供了强大的翻译协作功能。而

mautic/transifex

那么，如何将这个利器引入我们的项目呢？答案就是 PHP 的包管理工具——Composer。

1. 轻松安装：Composer 的力量

使用 Composer 安装

mautic/transifex

composer require mautic/transifex

Composer 会自动处理所有的依赖关系，并在

vendor

mautic/transifex

2. 配置与连接：打通 Transifex 渠道

安装完成后，我们首先需要配置

mautic/transifex

万知

万知: 你的个人AI工作站

下载

setApiToken('YOUR_TRANSIFEX_API_TOKEN'); // 从 Transifex 开发者设置中获取
$config->setOrganization('YOUR_ORGANIZATION_SLUG'); // 你的组织 ID 或 slug
$config->setProject('YOUR_PROJECT_SLUG');         // 你的项目 ID 或 slug

// 你也可以从环境变量中加载配置，更安全便捷
// putenv('TRANSIFEX_API_TOKEN=your_token');
// putenv('TRANSIFEX_ORGANIZATION=your_org');
// putenv('TRANSIFEX_PROJECT=your_project');
// $config = Config::fromEnv();

// 3. 创建 Transifex 客户端实例
$transifex = new Transifex($httpClient, $requestFactory, $streamFactory, $uriFactory, $config);

echo "Transifex 客户端初始化成功！\n";

通过上述代码，我们就成功地建立了一个与 Transifex API 交互的客户端实例。

3. 核心功能：自动化翻译流程

mautic/transifex

$transifex->getConnector()

3.1 管理翻译资源 (Resources)

资源是 Transifex 中待翻译的基本文件。你可以上传源文件、创建新资源、甚至删除资源。

use Mautic\Transifex\Connector\Resources;

/** @var Resources $resources */
$resources = $transifex->getConnector(Resources::class);

// 获取所有资源
$response = $resources->getAll();
$body     = json_decode($response->getBody()->__toString(), true);
echo "项目中的所有资源：\n";
print_r($body);

// 创建一个新资源（例如一个 INI 格式的翻译文件）
// $response = $resources->create('My New Resource', 'my-new-resource-slug', 'INI');
// $body     = json_decode($response->getBody()->__toString(), true);
// echo "新资源创建成功：\n";
// print_r($body);

// 上传资源内容 (这是一个异步操作)
$resourceSlug = 'my-new-resource-slug'; // 假设你已经创建了资源
$content = "greeting=\"Hello\"\nfarewell=\"Goodbye\"\n"; // 你的源语言内容

echo "开始上传资源内容...\n";
$response = $resources->uploadContent($resourceSlug, $content);

// Transifex 的异步操作会返回一个任务 ID，我们需要轮询其状态
use Mautic\Transifex\Promise;
use Mautic\Transifex\Exception\ResponseException;
use Psr\Http\Message\ResponseInterface;

$promise  = $transifex->getApiConnector()->createPromise($response);
$promises = new \SplQueue();
$promise->setFilePath('/path/to/my/resource.ini'); // 可选：关联本地文件路径
$promises->enqueue($promise);

// 给予 Transifex 少量时间处理，避免立即轮询
usleep(500000); // 0.5 秒

$transifex->getApiConnector()->fulfillPromises(
    $promises,
    function (ResponseInterface $response, Promise $promise) {
        echo "资源 {$promise->getFilePath()} 上传成功！\n";
    },
    function (ResponseException $exception, Promise $promise) {
        echo "资源 {$promise->getFilePath()} 上传失败：{$exception->getMessage()}\n";
    }
);

注意： 上传资源内容和下载翻译等操作是异步的。

mautic/transifex

Promise

fulfillPromises

3.2 管理翻译内容 (Translations)

一旦资源上传，翻译团队就可以在 Transifex 平台上进行翻译。当翻译完成后，你可以通过

Translations

use Mautic\Transifex\Connector\Translations;

/** @var Translations $translations */
$translations = $transifex->getConnector(Translations::class);

$resourceSlug = 'my-new-resource-slug';
$languageCode = 'zh_CN'; // 例如下载简体中文翻译

echo "开始下载 {$languageCode} 翻译...\n";
$response = $translations->download($resourceSlug, $languageCode);

$promise  = $transifex->getApiConnector()->createPromise($response);
$promises = new \SplQueue();
$promise->setFilePath("/path/to/my/translations/{$languageCode}.ini"); // 关联本地文件路径
$promises->enqueue($promise);

usleep(500000); // 0.5 秒

$transifex->getApiConnector()->fulfillPromises(
    $promises,
    function (ResponseInterface $response, Promise $promise) use ($languageCode) {
        $translationContent = $response->getBody()->__toString();
        echo "{$languageCode} 翻译下载成功！内容：\n{$translationContent}\n";
        // 你可以将 $translationContent 写入本地文件
        // file_put_contents($promise->getFilePath(), $translationContent);
    },
    function (ResponseException $exception, Promise $promise) use ($languageCode) {
        echo "{$languageCode} 翻译下载失败：{$exception->getMessage()}\n";
    }
);

4. 优势总结与实际应用效果

通过

mautic/transifex

• 自动化工作流： 告别手动导出导入，通过脚本即可完成资源上传和翻译下载，大大减少人工干预。
• 提高效率： 开发者可以专注于代码，翻译人员专注于翻译，通过 API 自动同步，提高整体开发和发布效率。
• 版本控制友好： 翻译文件可以作为代码的一部分，纳入版本控制，历史变更清晰可查。
• 减少错误： 避免了手动操作可能引入的格式、编码或文件放置错误。
• 可扩展性强： 轻松应对项目规模扩大、语言增多的需求，无需担心管理复杂度线性增长。
• 异步处理： 对于耗时的上传和下载任务，

  mautic/transifex

  提供了

  Promise

  机制，支持异步处理，不会阻塞你的应用。

从此，你的多语言项目将拥有一个高效、稳定、可维护的翻译管理系统。无论是持续集成/持续部署 (CI/CD) 流程中的自动化翻译更新，还是定时从 Transifex 同步最新翻译，

mautic/transifex

现在，就用 Composer 引入

mautic/transifex