PHPackages                             leanku/multi-translator - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization &amp; i18n](/categories/localization)
4. /
5. leanku/multi-translator

ActiveLibrary[Localization &amp; i18n](/categories/localization)

leanku/multi-translator
=======================

支持多平台的 PHP 翻译组件

00PHP

Since Jun 20Pushed 11mo agoCompare

[ Source](https://github.com/leanku/translator)[ Packagist](https://packagist.org/packages/leanku/multi-translator)[ RSS](/packages/leanku-multi-translator/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

MultiTranslator
===============

[](#multitranslator)

一个轻量、可扩展的 PHP 多平台翻译组件，支持火山、有道、百度翻译接口，支持自动配置检测、CLI 命令行翻译、配置优先级选择。

---

🚀 安装
----

[](#-安装)

使用 Composer 安装本组件：

```
composer require leanku/multi-translator
```

---

📦 使用示例
------

[](#-使用示例)

```
use MultiTranslator\Translator;

$config = [
    'driver' => 'youdao',
    'youdao' => [
        'appKey' => '你的有道 appKey',
        'appSecret' => '你的有道 appSecret',
    ]
];

$translator = new Translator('youdao', $config['youdao']);
echo $translator->translate('你好世界', 'en'); // Hello World
```

---

🧪 CLI 命令行翻译
-----------

[](#-cli-命令行翻译)

```
php bin/translate "你好世界" en
```

支持 `.env` 或 `config.php` 自动读取配置。

---

🔧 配置说明
------

[](#-配置说明)

支持以下三种翻译平台：

### 有道翻译

[](#有道翻译)

```
YOUDAO_APP_KEY=xxx
YOUDAO_APP_SECRET=xxx
```

### 百度翻译

[](#百度翻译)

```
BAIDU_APP_ID=xxx
BAIDU_APP_KEY=xxx
```

### 火山翻译

[](#火山翻译)

```
VOLC_ACCESS_KEY=xxx
VOLC_ACCESS_SECRET=xxx
```

你也可以使用 `config.php`：

```
return [
    'driver' => 'youdao',
    'youdao' => [
        'appKey' => 'your-youdao-app-key',
        'appSecret' => 'your-youdao-app-secret',
    ],
];
```

---

✅ 异常处理
------

[](#-异常处理)

所有驱动均会在配置缺失或翻译失败时抛出 `MultiTranslator\Exceptions\ConfigException` 异常：

```
try {
    $translator->translate('你好', 'en');
} catch (\MultiTranslator\Exceptions\ConfigException $e) {
    echo "配置或调用错误：" . $e->getMessage();
}
```

---

🧪 测试
----

[](#-测试)

```
composer require --dev phpunit/phpunit
vendor/bin/phpunit tests
```

---

📁 项目结构
------

[](#-项目结构)

```
translator/
├── bin/translate           # CLI 命令行
├── config.php              # 配置示例
├── src/
│   ├── Contracts/
│   ├── Drivers/
│   ├── Exceptions/
│   ├── Factory/
│   └── Translator.php
├── tests/                  # PHPUnit 测试
└── README.md               # 使用说明

```

---

📜 License
---------

[](#-license)

MIT

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/7260353a977d5887dfb3dff160d53455a694d069a640bf7d3b6542a0a3abf068?d=identicon)[leanku](/maintainers/leanku)

---

Top Contributors

[![leanku](https://avatars.githubusercontent.com/u/81899539?v=4)](https://github.com/leanku "leanku (1 commits)")

### Embed Badge

![Health badge](/badges/leanku-multi-translator/health.svg)

```
[![Health](https://phpackages.com/badges/leanku-multi-translator/health.svg)](https://phpackages.com/packages/leanku-multi-translator)
```

###  Alternatives

[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M495](/packages/illuminate-translation)[lajax/yii2-translate-manager

Translation management extension for Yii 2

227578.8k13](/packages/lajax-yii2-translate-manager)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)[inpsyde/multilingual-press

Simply THE multisite-based free open source plugin for your multilingual websites.

2414.0k1](/packages/inpsyde-multilingual-press)[statikbe/laravel-chained-translator

The Laravel Chained Translator can combine several translators that can override each others translations.

36149.4k6](/packages/statikbe-laravel-chained-translator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
