php怎么实现多语言实时翻译_ai翻译api调用【方法】-php教程-PHP中文网

调用AI翻译API前必须确认三件事：一是区分免费版与付费版的QPS及字符数限制；二是目标语言代码规范性，如zh与zh-CN差异及auto检测需显式传参；三是强制HTTPS，HTTP会报SSL错误。

php怎么实现多语言实时翻译_ai翻译api调用【方法】

PHP 调用 AI 翻译 API 前必须确认的三件事

直接调用 curl 发请求不难，但多数人卡在第一步：没选对 API、没处理好认证、或忽略了响应结构差异。主流服务（如 DeepL、Google Cloud Translation、腾讯翻译君、百度翻译）返回格式不同，json 字段名、错误码、是否需要 access_token 刷新机制，全都不一样。

实操前先确认：

你用的是免费版还是付费版？免费版常限制 qps（每秒请求数）和单次字符数，比如 DeepL 免费版单次最多 5000 字符，超了直接返回 413 Payload Too Large
目标语言代码是否规范？zh 和 zh-CN 在不同 API 中含义可能不同；auto 检测源语言时，部分 API（如百度）要求显式传 from=auto，否则报错 error_code: 58
是否已开启 HTTPS？所有主流翻译 API 强制 HTTPS，用 http:// 会直接返回 cURL error 35: SSL connect error

用 curl 调 Google Cloud Translation v3 实现实时翻译

Google 的 v3 版本强制使用 gRPC 或 REST + access_token，不支持简单 API Key。最轻量的可行路径是用 service account key 换取短期 access_token，再发 POST 请求。

关键步骤：

从 Google Cloud Console 下载 service-account-key.json，保存到项目目录（如 ./gcp-cred.json）
用 file_get_contents() 读取并解析 JSON，提取 private_key 和 client_email
构造 JWT 并用 openssl_sign() 签名，向 https://oauth2.googleapis.com/token 换取 access_token（有效期 3600 秒）
最终请求地址为：https://translation.googleapis.com/v3/projects/YOUR_PROJECT_ID:translateText，body 是 JSON，含 contents、targetLanguageCode、sourceLanguageCode（可空）

示例片段（省略 JWT 构造细节，重点看请求部分）：

$url = 'https://translation.googleapis.com/v3/projects/your-proj-id:translateText';
$token = 'ya29.c.b0Ab...'; // 从上一步获取
$data = json_encode([
    'contents' => ['你好世界'],
    'targetLanguageCode' => 'en',
    'sourceLanguageCode' => 'zh'
]);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $token,
    'Content-Type: application/json'
]);
$result = curl_exec($ch);
// 注意：Google v3 返回的是嵌套结构，译文在 $json['translations'][0]['translatedText']

用 file_get_contents() 调腾讯翻译君（更轻量）

腾讯云翻译 API 支持简单签名方式（HMAC-SHA256），且允许用 file_get_contents() + stream_context_create() 替代 curl，适合轻量后台或共享主机环境（禁用 curl 时）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

注意点：

签名字符串必须按文档拼接：HTTP 方法 + \n + URI + \n + 请求参数按字典序排序后的 query string
密钥需用 base64_decode() 解码后再参与 HMAC 计算，否则签名失败返回 1002: invalid sign
必传参数包括 Timestamp（秒级时间戳）、Nonce（随机字符串）、SecretId、Signature，缺一不可
翻译结果在 $json['Response']['TranslatedText']，不是顶层字段

常见错误现象：1003: timestamp expired —— 表示本地时间与腾讯服务器偏差超过 5 分钟，需校准系统时间或用 curl 先请求一次腾讯时间接口校正。

多语言切换时如何避免重复请求和缓存污染

用户频繁切语言（比如中→英→日→中），如果每次都在 PHP 层调 API，既慢又费配额。真正实用的做法是分层缓存：

第一层：用 apcu_cache 存「原文+目标语言」为 key 的短时结果（TTL 3600），适用于后台管理页等低频场景
第二层：前端用 localStorage 缓存最近 20 条翻译结果，键名为 trans:${sourceLang}:${targetLang}:${hash(text)}，命中则不发请求
第三层：对相同原文但不同目标语言的请求，不要合并成一个批量调用（如同时译成 en/ja/ko）—— 多数 API 不支持单次多目标，强行拼会导致 400 Bad Request

特别注意：不要用 $_SESSION 存翻译结果。session 数据随用户增长线性膨胀，且无法跨机器共享，在负载均衡下极易失效。