README

免费Google Translate API PHP包。完全免费翻译。

安装
基本用法
高级用法
已知限制
免责声明
捐赠

安装

通过 Composer 安装此包。

composer require stichoza/google-translate-php

注意：需要 PHP 7.1 或更高版本。对于旧版本，请使用此包的 ^3.2 版本（请参阅旧文档）。

基本用法

创建GoogleTranslate对象

use Stichoza\GoogleTranslate\GoogleTranslate;

$tr = new GoogleTranslate('en'); // Translates into English

或者您稍后可以更改语言

$tr = new GoogleTranslate(); // Translates to 'en' from auto-detected language by default
$tr->setSource('en'); // Translate from English
$tr->setSource(); // Detect language automatically
$tr->setTarget('ka'); // Translate to Georgian

翻译句子

echo $tr->translate('Hello World!');

您还可以使用方法链

echo $tr->setSource('en')->setTarget('ka')->translate('Goodbye');

或者调用简写静态方法 trans

echo GoogleTranslate::trans('Hello again', 'ka', 'en');

高级用法

语言检测

要自动检测语言，只需将源语言设置为 null

$tr = new GoogleTranslate('es', null); // Or simply do not pass the second parameter

$tr->setSource(); // Another way

使用 getLastDetectedSource() 获取检测到的语言

$tr = new GoogleTranslate('fr');

$text = $tr->translate('Hello World!');

echo $tr->getLastDetectedSource(); // Output: en

如果无法检测到语言，返回值将是 null

支持的语言列表请参阅 Google API 文档。

使用原始响应

对于高级用法，您可能需要Google Translate提供的原始结果。您可以使用 getResponse 方法来实现。

$responseArray = $tr->getResponse('Hello world!');

自定义URL

您可以通过 setUrl 方法覆盖默认的Google Translate URL。这对于某些国家很有用。

$tr->setUrl('http://translate.google.cn/translate_a/single');

HTTP客户端配置

此包使用 Guzzle 进行HTTP请求。您可以将一个包含 Guzzle客户端配置选项的数组作为第三个参数传递给 GoogleTranslate 构造函数，或者直接使用 setOptions 方法。

您可以使用这些选项配置代理、用户代理、默认头信息、连接超时等。

$tr = new GoogleTranslate('en', 'ka', [
    'timeout' => 10,
    'proxy' => [
        'http'  => 'tcp://:8125',
        'https' => 'tcp://:9124'
    ],
    'headers' => [
        'User-Agent' => 'Foo/5.0 Lorem Ipsum Browser'
    ]
]);

// Set proxy to tcp://:8090
$tr->setOptions(['proxy' => 'tcp://:8090'])->translate('Hello');

// Set proxy to socks5://:1080
$tr->setOptions(['proxy' => 'socks5://:1080'])->translate('World');

有关更多信息，请参阅Guzzle文档中的创建客户端部分（6.x版本）。

自定义令牌生成器

您可以通过将生成器对象作为构造函数的第四个参数传递或直接使用 setTokenProvider 方法来覆盖令牌生成器类。

生成器必须实现 Stichoza\GoogleTranslate\Tokens\TokenProviderInterface。

use Stichoza\GoogleTranslate\Tokens\TokenProviderInterface;

class MyTokenGenerator implements TokenProviderInterface
{
    public function generateToken(string $source, string $target, string $text) : string
    {
        // Your code here
    }
}

并且使用

$tr->setTokenProvider(new MyTokenGenerator);

错误和异常处理

静态方法 trans() 和非静态的 translate() 以及 getResponse() 将抛出以下异常

ErrorException 如果由于某些原因HTTP请求失败。
UnexpectedValueException 如果从Google接收的数据无法解码。

此外，如果不可用，translate() 和 trans() 方法将返回 null。

已知限制

503 服务不可用 响应
如果您遇到此错误，最可能的原因是谷歌禁止了您的外部IP地址，或者需要您解决验证码。这不是本包的bug。谷歌变得更加严格，他们似乎在不断地降低每个IP在一定时间内的允许请求次数。尝试减少请求次数以保持在监控之下，或者经常更换IP（例如使用代理）。请注意，一旦某个IP被禁止，即使只是暂时性的，禁令可能持续几分钟到12-24小时不等，具体情况各不相同。
413 请求实体过大响应
此错误表示您的输入字符串太长。谷歌一次最多允许翻译5000个字符。如果您想要翻译更长的文本，可以将其分成较短的段落，然后逐个翻译。

免责声明

本包仅用于教育目的开发。不要依赖此包，因为它可能随时崩溃，因为它基于爬取谷歌翻译网站。考虑购买官方谷歌翻译API以用于其他类型的用途。

捐赠

如果此包帮助您减少了开发时间，或者解决了您遇到的主要问题，请随意给我一杯咖啡：）

donsa/google-translate-php

维护者

详细信息