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

mautic/transifex

mautic/transifex

mautic/transifex

<pre class="brush:php;toolbar:false;">composer require mautic/transifex

vendor

mautic/transifex

mautic/transifex

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php';

use Mautic\Transifex\ApiFactory;
use Mautic\Transifex\Config;
use Mautic\Transifex\Transifex;
use GuzzleHttp\Client; // 示例：使用 Guzzle 作为 PSR-18 HTTP 客户端
use Nyholm\Psr7\Factory\Psr17Factory; // 示例：使用 Nyholm/PSR7 作为 PSR-17 工厂

// 1. 实例化 PSR-18 HTTP 客户端和 PSR-17 工厂
$httpClient     = new Client();
$requestFactory = new Psr17Factory();
$streamFactory  = new Psr17Factory();
$uriFactory     = new Psr17Factory();

// 2. 配置 Transifex 连接信息
$config = new Config();
$config->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";

mautic/transifex

$transifex->getConnector()

<pre class="brush:php;toolbar:false;">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

Translations

<pre class="brush:php;toolbar:false;">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";
    }
);

mautic/transifex

mautic/transifex

mautic/transifex