jQuery 提供了 $.getJSON 方法,讓我們能實作跨域的 Ajax 請求。不過官方 API 文件的說明實在偏少——到底該怎麼呼叫?被請求的網站應該回傳什麼樣的資料,$.getJSON 才拿得到?下面用一個實際例子把整個流程走一遍,順便留著以後備用。
$.getJSON 之所以能跨域,靠的是 JSONP(JSON with Padding):與其用 XMLHttpRequest(受同一來源政策限制),不如動態插入一個 <script> 標籤去載入遠端資源——script 標籤不受跨域限制。而載入的內容不是純 JSON,而是一段包裹在你指定函式名稱中的 JavaScript 呼叫。
關鍵就在 URL 裡那個 callback=?:問號是告訴 jQuery「這裡請幫我填入一個臨時的 callback 函式名稱」。伺服器必須把這個名稱原封不動地讀出來,再包在回應外面。
以下實作一個預約登記介面,需要傳入的參數為姓名、聯絡電話與地址:
/* 預約登記執行介面 */
case "yuyue_interface":
$name = trim($_GET['name']);
$phone = trim($_GET['phone']);
$addr = trim($_GET['addr']);
$dt = date("Y-m-d H:i:s");
// 這個 callback 參數是 JSONP 的關鍵,必須原樣回傳
$cb = $_GET['callback'];
if ($name == "" || $name == NULL){
echo $cb . "({code:" . json_encode(1) . "})";
} elseif ($phone == "" || $phone == NULL){
echo $cb . "({code:" . json_encode(2) . "})";
} elseif ($addr == "" || $addr == NULL){
echo $cb . "({code:" . json_encode(3) . "})";
} else {
$db->execute("insert into tb_yuyue
(realname, telphone, danwei, dt, ischeck)
values ('$name', '$phone', '$addr', '$dt', 0)");
echo $cb . "({code:" . json_encode(0) . "})";
}
exit;
break;
回應的樣子會像這樣(假設 jQuery 產生的函式名為 jQuery1234567):
jQuery1234567({code:0})
伺服器端三個重點:一定要把傳進來的 callback 參數原樣輸出,否則前端收不到;回應內容必須是合法的 JavaScript 表達式;處理完畢立刻 exit,別讓後續輸出污染回應。
$(document).ready(function(){
// 以下三個為預約登記所需的參數
var name = "name"; // varchar,最長 8 位(4 個漢字)
var phone = "phone"; // varchar,長度 11 位
var addr = "addr"; // varchar,最長 500 位(250 個漢字)
$.getJSON("https://請求網站位址/data.php?ac=yuyue_interface"
+ "&name=" + name
+ "&phone=" + phone
+ "&addr=" + addr
+ "&callback=?",
function(data){
if (data.code == 1){
alert("姓名不能為空");
} else if (data.code == 2){
alert("手機不能為空");
} else if (data.code == 3){
alert("所在單位不能為空");
} else {
alert("預約成功");
}
});
});
回呼函式中拿到的 data 已經是解析好的物件,可以直接用 data.code 判斷。這正是 JSONP 的方便之處:你不必自己解析字串。
參數務必編碼:上面的範例直接把中文姓名與地址拼進 URL,實務上應改用 encodeURIComponent(),或更好的做法是使用 jQuery 的 $.ajax 搭配 dataType: 'jsonp',讓它替你處理:
$.ajax({
url : "https://請求網站位址/data.php",
dataType : "jsonp",
data : { ac : "yuyue_interface", name : name, phone : phone, addr : addr },
success : function(data){
// 依 data.code 處理
}
});
安全性要重新評估:JSONP 的本質是「執行遠端網站提供的 JavaScript」,因此你必須完全信任對方。若回應中包含使用者輸入而未妥善處理,等於主動引入跨站腳本風險。上面的 PHP 範例直接把變數拼進 SQL,應改用參數化查詢;回傳 JSON 前也應過濾特殊字元。
不要用 GET 傳送敏感資料:跨域請求的參數會完整出現在網址中,並可能被中介設備與日誌留存。這類介面若涉及個資,應改走同域 POST 並全程使用 HTTPS。
錯誤處理:JSONP 無法回傳標準的 HTTP 錯誤狀態,因此伺服器端的一致回應格式(例如永遠回傳 {code: ...})就顯得格外重要;前端也建議為 $.ajax 加上 error 與逾時設定。
做完這次實驗,你不但學會了 $.getJSON 的用法,也等於學會了如何提供一個让别人跨域呼叫的介面。若哪裡寫錯了,歡迎指正。