DIV CSS 佈局教程網

用 jQuery 的 getJSON 實作跨網域請求
編輯:JavaScript綜合知識     

jQuery 常用 getJSON 呼叫並取得遠端的 JSON 字串,轉為物件後執行回呼。透過它也能做到跨網域請求。原型如下:

jQuery.getJSON(url [, data ] [, callback ] )
  • url:請求的目的地。
  • data:(選用)要送出的 key/value 參數。
  • callback:(選用)載入成功時的回呼函式。

一、最簡單的例子

伺服器端腳本回傳 JSON:

<?php
// $.getJSON.php
$arr = array("name" => "zhangsan", "age" => 20);
echo json_encode($arr);

兩個重點:第一,回傳前必須用 json_encode 編碼;第二,用 echo 輸出而非 return。

前端:

<script language="javascript" type="text/javascript" src="./js/jquery.js"></script>
<script language="javascript" type="text/javascript">
function getjs() {
  $.getJSON("$.getJSON.php", {}, function (response) {
    alert(response.age);
  });
}
</script>

<input type="button" name="btn" id="btn" value="test" onclick="javascript:getjs();" />

因為 PHP 端是用 JSON 編碼輸出,所以前端必須用 getJSON 呼叫。取得的資料已經是物件,可以直接用 response.name、response.age 取值。

二、跨網域的原理:JSONP

$.getJSON 能跨網域,靠的是 JSONP(JSON with Padding):動態建立一個 <script> 標籤指向遠端網址,而 script 標籤不受同源政策限制。伺服器回傳的不是純 JSON,而是「回呼函式名 + 括號包住 JSON」的形式:

myCallback({"code":0, "msg":"ok"});

瀏覽器執行這段腳本時,就等於呼叫了頁面上已定義的 myCallback,資料於是傳了回來。jQuery 會自動在網址後補上一個 callback=? 參數,並產生對應的暫時函式。

三、完整的預約登記範例

後端提供一個預約登記介面,需傳入姓名、聯絡電話與地址:

<?php
/* 預約登記 執行 介面 */
case "yuyue_interface":
  $name  = trim($_GET['name']);
  $phone = trim($_GET['phone']);
  $addr  = trim($_GET['addr']);
  $dt    = date("Y-m-d H:i:s");
  $cb    = $_GET['callback'];            // JSONP 回呼函式名

  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 {
    // 正式環境請改用 prepared statement 綁參數,避免 SQL 注入
    $stmt = $db->prepare("insert into tb_yuyue
      (realname, telphone, danwei, dt, ischeck) values (?, ?, ?, ?, 0)");
    $stmt->execute(array($name, $phone, $addr, $dt));
    echo $cb . "({code:" . json_encode(0) . "})";
  }
  exit;
  break;

原範例把 $_GET 的值直接串進 SQL,這是可以被利用的 SQL 注入漏洞,務必改用綁定參數。

前端處理:

$(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=" + encodeURIComponent(name)
          + "&phone=" + encodeURIComponent(phone)
          + "&addr=" + encodeURIComponent(addr)
          + "&callback=?",
    function (data) {
      if (data.code == 1) {
        alert("姓名不能為空");
      } else if (data.code == 2) {
        alert("手機不能為空");
      } else if (data.code == 3) {
        alert("所屬單位不能為空");
      } else {
        alert("預約成功");
      }
    });
});

四、關鍵注意事項

  • 後端必須把 callback 參數原樣輸出:
    $cb = $_GET['callback'];
    echo $cb . "({code:" . json_encode(4) . "})";
    少了這一步,回傳的就只是一段無法執行的純文字。
  • 參數要編碼:中文或含特殊字元的參數務必用 encodeURIComponent。
  • JSONP 本質上是執行遠端程式碼:因此只能請求你完全信任的來源。若目標網站被入侵,它能透過你的頁面執行任意 JS。
  • 只支援 GET:JSONP 無法送 POST,資料會出現在網址列與伺服器日誌中,不要用來傳送密碼或敏感資料。

五、現代做法:改用 CORS

JSONP 已是歷史產物。現在主流做法是伺服器端設定 CORS 標頭,前端直接用一般的 Ajax:

// 伺服器端(PHP)加上標頭
header('Access-Control-Allow-Origin: https://your-domain.com');
header('Content-Type: application/json; charset=utf-8');

// 前端用標準寫法
fetch('https://api.example.com/data.php?ac=yuyue_interface', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: name, phone: phone, addr: addr })
})
  .then(r => r.json())
  .then(data => {
    if (data.code === 0) { alert('預約成功'); }
  });

CORS 支援所有 HTTP 方法、錯誤處理更完整、也不需要在頁面裡注入 script 標籤。只有在你必須對接一個只提供 JSONP 的老舊服務時,才需要回頭用 $.getJSON 這條路。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved