用 AJAX 送 POST 是再日常不過的需求,AngularJS 和 jQuery 都各自封裝好了。表面看起來寫法幾乎一樣,但只要後端是 PHP,就會遇到一個讓人找半天的問題:參數收不到。
AngularJS:
$http.post('do-submit.php', myData)
.success(function(){
// some code
});
jQuery:
$.post('do-submit.php', myData, function() {
// some code
});
看起來沒什麼差別吧?jQuery 的版本甚至更精簡一點,回呼直接寫在第三個參數。
用 AngularJS 的 $http 送出去的資料,在 PHP 端卻無法用 $_REQUEST 或 $_POST 取得,必須改寫成:
$params = json_decode(file_get_contents('php://input'), true);
才能讀到內容。
jQuery 在送出前,會把當成 JSON 物件寫法的 myData 序列化成查詢字串格式:
var myData = { a : 1, b : 2 };
// jQuery 送出前會把它轉成字串:"a=1&b=2"
並搭配 application/x-www-form-urlencoded 的標頭,這正是 PHP 自動解析並填入 $_POST 的格式。而 AngularJS 的 $http 預設會直接把物件以 application/json 送出,PHP 不會自動解析 JSON 到 $_POST,所以要自己開 php://input 讀原始 body。
$http 的行為與 jQuery 的 AJAX 一致(把物件序列化成表單格式並調整標頭)。這麼做之後所有呼叫端都不用動,是長期維護最好的做法。相關做法可參考 Make AngularJS $http Service Behave Like jQuery AJAX。這個案例的價值不只在於解法,更在於提醒我們:跨框架搬移程式碼時,真正容易出問題的往往不是語法,而是「資料格式」與「標頭」這些沒寫在教學文件開頭的約定。