README

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

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

安装

通过Composer安装此包。

composer require icai/google-translate-php-one

注意：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翻译提供的原始结果。您可以使用getResponse方法。

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

自定义URL

您可以通过setUrl方法覆盖默认的Google翻译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 服务不可用响应
如果您遇到此错误，这很可能是由于Google禁止了您的外部IP地址和/或需要您解决CAPTCHA。这不是本包的bug。Google变得更为严格，并且似乎他们持续降低每个IP在一段时间内允许的请求数量。尝试减少请求量以保持不被发现，或者频繁更改IP（例如使用代理）。请注意，一旦IP被禁止，即使只是临时的，禁止可能会持续几分钟到12-24小时以上，具体案例具体分析。
429 请求过多 响应：这个错误基本上与上面解释的一样。
413 请求实体过大 响应
这个错误意味着您的输入字符串过长。Google 只允许一次翻译最多 5000 个字符。如果您想要翻译更长的文本，可以将它分成更短的部分，并逐一进行翻译。

免责声明

此软件包仅用于教育目的开发。不要依赖此软件包，因为它可能会随时中断，因为它基于爬取 Google 翻译网站。考虑购买官方 Google 翻译 API 用于其他类型的用途。

捐赠

如果这个软件包帮助您减少了开发时间，或者解决了您遇到的任何重大问题，请随意请我喝杯咖啡 :)

icai / google-translate-php-one

维护者

详细信息