google/cloud-translate

PHP 的云翻译客户端

v1.18.1 2024-08-19 16:20 UTC

README

针对 翻译 的 PHP 习惯用语客户端。

Latest Stable Version Packagist

注意: 此存储库是 Google Cloud PHP 的一部分。任何支持请求、错误报告或开发贡献应直接发送到该项目。

动态翻译数千种语言对之间的文本。云翻译 API 允许网站和程序以编程方式集成翻译服务。Google 翻译 API 是更大的云机器学习 API 家族的一部分。

安装

首先,安装 PHP 首选依赖项管理器 Composer

现在安装此组件

$ composer require google/cloud-translate

身份验证

有关如何身份验证客户端的更多信息,请参阅我们的 身份验证指南。身份验证后,您即可开始发送请求。

使用手写客户端的示例(与 V2 API 交互)

require 'vendor/autoload.php';

use Google\Cloud\Translate\V2\TranslateClient;

$translate = new TranslateClient([
    'key' => 'your_key'
]);

// Translate text from english to french.
$result = $translate->translate('Hello world!', [
    'target' => 'fr'
]);

echo $result['text'] . "\n";

// Detect the language of a string.
$result = $translate->detectLanguage('Greetings from Michigan!');

echo $result['languageCode'] . "\n";

// Get the languages supported for translation specifically for your target language.
$languages = $translate->localizedLanguages([
    'target' => 'en'
]);

foreach ($languages as $language) {
    echo $language['name'] . "\n";
    echo $language['code'] . "\n";
}

// Get all languages supported for translation.
$languages = $translate->languages();

foreach ($languages as $language) {
    echo $language . "\n";
}

使用生成的客户端的示例(与 V3 API 交互)

require 'vendor/autoload.php';

use Google\Cloud\Translate\V3\TranslationServiceClient;

$translationClient = new TranslationServiceClient();
$content = ['one', 'two', 'three'];
$targetLanguage = 'es';
$response = $translationClient->translateText(
    $content,
    $targetLanguage,
    TranslationServiceClient::locationName('[PROJECT_ID]', 'global')
);

foreach ($response->getTranslations() as $key => $translation) {
    $separator = $key === 2
        ? '!'
        : ', ';
    echo $translation->getTranslatedText() . $separator;
}

为您选择正确的客户端

此组件提供手写客户端和生成客户端,分别用于访问 V2 和 V3 翻译 API。两个客户端都将获得持续的支持和功能添加,但需要注意的是,生成客户端的精简性质意味着它将更频繁地更新。此外,生成客户端能够利用 gRPC 进行其传输(通过安装 gRPC 扩展),而手写客户端仅通过 REST & HTTP/1.1 进行交互。

手写客户端位于 Google\Cloud\Translate\TranslateClient 之下,而生成客户端位于 Google\Cloud\Translate\V3\TranslationServiceClient 之下。

版本

此组件被认为是 GA(一般可用)。因此,它不会在任何次要或补丁版本中引入不兼容的更改。我们将优先处理问题和请求。

下一步

  1. 了解 官方文档
  2. 查看 深入使用示例