萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 呼叫有道翻譯 API 實作範例

前言

有道翻譯開放 API 免費額度每小時 1000 次,適合中小型專案整合翻譯功能。本文示範 PHP 串接 JSON 介面的完整流程。

申請流程

  1. 訪問 https://fanyi.youdao.com/openapi?path=data-mode 註冊應用,取得 keyfrom 與 key。
  2. 記錄申請時綁定的伺服器 IP(生產環境需一致)。

API 介面規格

GET https://fanyi.youdao.com/openapi.do
參數:
  keyfrom=你的keyfrom
  key=你的key
  type=data
  doctype=json|xml|jsonp
  version=1.1
  q=待翻譯文字(UTF-8,不超過 200 字元)

回傳碼對照

errorCode含義
0正常
20文字過長
30無法翻譯
40不支援語言
50無效 key

PHP 實作範例

<?php
function youdaoTranslate($content, $keyfrom, $key) {
    $url = "https://fanyi.youdao.com/openapi.do?keyfrom={$keyfrom}&key={$key}&type=data&doctype=json&version=1.1&q=" . urlencode($content);
    $response = file_get_contents($url);
    if ($response === false) {
        return ['error' => '網路請求失敗'];
    }
    $data = json_decode($response, true);
    if (!isset($data['errorCode'])) {
        return ['error' => 'API 回傳格式異常'];
    }
    if ($data['errorCode'] !== 0) {
        return ['error' => '翻譯失敗,錯誤碼:' . $data['errorCode']];
    }
    // 正常回傳結構:translation(陣列)、basic(詞典)、web(網路釋義)
    return $data;
}

// 使用
$keyfrom = 'your_keyfrom';
$key     = 'your_key';
$result  = youdaoTranslate('Hello world', $keyfrom, $key);
print_r($result);

進階建議

  • 使用 cURL 替代 file_get_contents,可控制超時、重試、代理。
  • 快取常用翻譯結果(Redis key: trans:{md5(text)}),減少 API 呼叫與延遲。
  • 超過免費額度請官方申請提額,郵件需說明應用名稱、功能、網址、預估 QPS、伺服器 IP、是否商業用途。
  • 生產環境建議改用付費版或自建翻譯模型(如 LibreTranslate、Argos Translate)。
copyright © 萬盛學電腦網 all rights reserved