谷歌翻译 - PHP

谷歌翻译 - PHP 是一个基于 PHP 语言编写的谷歌翻译 API 封装类。它能够实现通过谷歌翻译 API 实现自然语言翻译的功能，支持多种语言互译，无需安装任何插件，简单易用。

功能特性

• 简单易用的 API 封装，保证了快速的开发效率；
• 支持多种语言互译，可以轻松实现文本、文章、邮件、即时消息等的翻译；
• 支持多种翻译选项，可以设置源语言、目标语言、请求方式等参数；
• 调用方式灵活多样，可以使用对象方式或静态方法方式实现调用；
• 充分考虑了异常处理机制，保证了程序的健壮性和安全性。

环境要求

• PHP 版本 >= 5.6
• cURL 扩展

安装方法

通过 Composer 安装：

composer require stichoza/google-translate-php

通过 GitHub 下载：

git clone https://github.com/Stichoza/google-translate-php.git

快速入门

1. 基本翻译

require_once 'vendor/autoload.php';

use Stichoza\GoogleTranslate\TranslateClient;

$tr = new TranslateClient('en', 'zh');
echo $tr->translate('Hello World!');

• translate() 方法接收一个字符串参数，返回一个翻译后的字符串。

2. 获取语言列表

require_once 'vendor/autoload.php';

use Stichoza\GoogleTranslate\TranslateClient;

$tr = new TranslateClient();
print_r($tr->getSupportedLanguages());

• getSupportedLanguages() 方法无需传入参数，返回包含语言代码与语言名称的关联数组。

3. 高级选项

require_once 'vendor/autoload.php';

use Stichoza\GoogleTranslate\TranslateClient;

$tr = new TranslateClient(null, 'en');
$tr->setUrlBase('https://translate.google.cn/translate_a/single');
$tr->setUrlParams([
    'client' => 'webapp',
    'sl' => 'zh-CN',
    'tl' => 'en',
    'dt' => [
        't',
        'at',
    ],
]);
echo $tr->translate('你好，世界！');

• setUrlBase() 方法可用于自定义谷歌翻译服务 URL，这对于使用代理服务器或自建翻译服务等情况非常有用。默认情况下，该 URL 为 https://translate.google.com/translate_a/single；
• setUrlParams() 方法可用于自定义请求参数，这包括了源语言、目标语言、请求方式等参数。

异常处理

本类库充分考虑了异常处理机制，保证了程序的健壮性和安全性。通过 try-catch 结构捕获异常信息，您可以根据错误类型来进行相应的异常处理：

require_once 'vendor/autoload.php';

use Stichoza\GoogleTranslate\TranslateClient;
use Stichoza\GoogleTranslate\TranslateException;

try {
    $tr = new TranslateClient('', 'zh');
    $tr->setOptions([
        'timeout' => 1.0,
    ]);
    echo $tr->translate('Hello World!');
} catch (TranslateException $e) {
    echo $e->getMessage();
}

• TranslateException 异常类是本封装类中的异常类，用于处理与谷歌翻译服务交互相关的异常信息；
• 如果您需要处理其他类型的异常信息，可以结合 PHP 标准库中的其他异常类来使用。

总结

谷歌翻译 - PHP 类库具有轻量级、开发便捷、稳定性高等特点，适用于各种自然语言翻译场景。如果您需要实现高效便利的自然语言翻译功能，本封装类库会是一个绝佳的选择。