# QQTranslator

**Repository Path**: yvtang/QQTranslator

## Basic Information

- **Project Name**: QQTranslator
- **Description**: PHP 调用腾讯翻译 API。
- **Primary Language**: PHP
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2023-07-20
- **Last Updated**: 2023-07-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 1. 简介
PHP 调用腾讯翻译 API。  
  
有关如何申请腾讯翻译 API，参考：https://cloud.tencent.com/document/product/551  
  
查看完整语言列表：https://cloud.tencent.com/document/api/551/15619  
  
查看完整的请求响应服务器地域列表：https://cloud.tencent.com/document/api/551/15615

## 2. 使用方法

### 2.1 一次翻译一个句子

```php
<?php

include 'QQTranslator.php';

// -----------------------------------------------------------------------------

$qqtr = new QQTranslator();
$qqtr->setSecretId("替换成你的 id");
$qqtr->setSecretKey("替换成你的 key");
$qqtr->setProjectId(0); // 默认为 0，根据实际情况修改
$qqtr->setRegion("ap-hongkong"); // 设置请求响应服务器所在地区，默认为香港区域，根据自己需求改

// -----------------------------------------------------------------------------

// 指定要翻译的句子
$sourceText = 'hello';

// -----------------------------------------------------------------------------

// 方式一，不指定源语言和目标语言
// 源语言默认为 auto ，即自动识别；目标语言默认为简体中文
$targetText = $qqtr->translateString($sourceText);

// 方式二，仅指定目标语言
// 源语言默认为 auto ，即自动识别
//$targetText = $qqtr->translateString($sourceText, 'ja');

// 方式三，同时指定源语言与目标语言
//$targetText = $qqtr->translateString($sourceText, 'en', 'ja'); 

// -----------------------------------------------------------------------------

echo $targetText;
```

### 2.2 一次翻译多个句子
```php
<?php

include 'QQTranslator.php';

// -----------------------------------------------------------------------------

$qqtr = new QQTranslator();
$qqtr->setSecretId("替换成你的 id");
$qqtr->setSecretKey("替换成你的 key");
$qqtr->setProjectId(0); // 默认为 0，根据实际情况修改
$qqtr->setRegion("ap-hongkong"); // 设置请求响应服务器所在地区，默认为香港区域，根据自己需求改

// -----------------------------------------------------------------------------

$sourceTexts = array();
$sourceTexts[] = "Hello, world.";
$sourceTexts[] = "Here we are.";
$sourceTexts[] = "Good job!";
$sourceTexts[] = "That's all right.";
$sourceTexts[] = "Best wish to you.";

// -----------------------------------------------------------------------------

// 方式一，不指定源语言和目标语言
// 源语言默认为 auto ，即自动识别；目标语言默认为简体中文
$targetTexts = $qqtr->translateStrings($sourceTexts);

// 方式二，仅指定目标语言
// 源语言默认为 auto ，即自动识别
//$targetTexts = $qqtr->translateStrings($sourceTexts, 'ja');

// 方式三，同时指定源语言与目标语言
//$targetTexts = $qqtr->translateStrings($sourceTexts, 'en', 'ja');

// -----------------------------------------------------------------------------

// 获取释义失败时，返回的是字符串而不是数组
if (is_array($targetTexts)) {
    foreach ($targetTexts as $targetText) {
        echo $targetText;
        echo "<br />";
    }
} else {
    echo $targetTexts;
}
```

## 3. 项目地址
- https://gitee.com/uanaoeng/QQTranslator