PHP 開發手機 App API 介面完整指南：架構、輸出格式、安全與效能

前言

PHP 是 Server 端首選：跨平台、低資源、高效能、MySQL 黃金搭檔、免費開源。本文針對 App API 開發（僅資料輸出，無視圖層）詳細說明流程、範例、最佳實務與陷阱。

API 開發核心流程

1. 接收參數：GET/POST 由客戶端約定，建議統一規範（如 a=action&uid=123）。
2. 業務邏輯處理：驗證、資料庫操作、第三方服務呼叫等。
3. 輸出資料：統一採用 JSON 格式，結構建議：{data:..., info:..., code:...}。
4. 客戶端解析與互動：App 端根據 code 判斷成功/失敗，info 可作彈窗提示。

簡易 API 範例

<?php
$output = array();
$a = isset($_GET['a']) ? $_GET['a'] : '';
$uid = isset($_GET['uid']) ? intval($_GET['uid']) : 0;

if (empty($a)) {
    exit(json_encode(array('data'=>NULL, 'info'=>'缺少參數', 'code'=>-201)));
}

if ($a == 'get_users') {
    if ($uid == 0) {
        exit(json_encode(array('data'=>NULL, 'info'=>'uid 不能為空', 'code'=>-401)));
    }
    // 模擬資料庫
    $mockDb = array(
        10001 => array('uid'=>10001, 'nickname'=>'Shine X', 'level'=>19),
        10002 => array('uid'=>10002, 'nickname'=>'elva', 'level'=>112),
    );
    if (!isset($mockDb[$uid])) {
        exit(json_encode(array('data'=>NULL, 'info'=>'用戶不存在', 'code'=>-402)));
    }
    $output = array(
        'data' => array('userInfo'=>$mockDb[$uid], 'isLogin'=>true, 'unread'=>4),
        'info' => '歡迎回來',
        'code' => 200
    );
    exit(json_encode($output));
}
// 其它 action...
?>

實戰注意事項（必讀）

關於框架的爭議

作者為 ThinkPHP 開發者，仍建議 API 使用原生 PHP：

「框架為 Web 誕生，API 只需 M 和 C，載入完整框架如夏天穿冬裝。若框架拋出例外或輸出 HTML 錯誤頁，App 直接 Crash。」

擴展閱讀

• 開放平台本質：提供標準化 API（JSON/XML），按文檔調用即可獲取 QQ、淘寶等資料。
• AJAX 其實也是一種 API 調用形式（前端 JS 呼叫後端介面）。