萬盛學電腦網

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

PHP 簡易 Mock JSON API 伺服器腳本

前言

前後端分離開發中,後端 API 未就緒時,前端需要模擬資料。本腳本單一檔案即可提供:讀取 mock.json、支援 JSONP callback、CORS 跨域、自訂字元編碼,零配置部署。

完整腳本 mock.php

<?php
/**
 * Mock JSON API Server
 * 
 * 功能:
 * - 讀取同目錄 mock.json 作為回應資料
 * - 支援 JSONP callback 參數
 * - 支援 CORS 跨域
 * - 支援 charset 參數指定編碼 (utf-8/gbk/gb2312)
 * - 內建預設測試資料
 */

// 設定常數
define('PARAM_CHARSET', 'charset');
define('PARAM_CALLBACK', 'callback');
define('PARAM_CROSS_DOMAIN', 'cross-domain');

/**
 * 取得模擬資料
 */
function getMockData(): string
{
    $mockFile = __DIR__ . '/mock.json';
    if (file_exists($mockFile)) {
        $content = file_get_contents($mockFile);
        // 驗證 JSON 格式
        json_decode($content);
        if (json_last_error() === JSON_ERROR_NONE) {
            return $content;
        }
    }

    // 內建預設資料
    return json_encode([
        'code' => 200,
        'message' => 'Default mock data',
        'data' => [
            'users' => [
                ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'],
                ['id' => 2, 'name' => 'Bob', 'email' => 'bob@example.com'],
            ],
            'total' => 2,
        ],
    ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
}

/**
 * 解析 charset 參數
 */
function getCharset(): string
{
    $charset = strtolower($_GET[PARAM_CHARSET] ?? 'utf-8');
    return in_array($charset, ['utf-8', 'gbk', 'gb2312'], true) ? $charset : 'utf-8';
}

/**
 * 產生回應
 */
function generateResponse(): string
{
    $data = getMockData();
    $charset = getCharset();
    $callback = $_GET[PARAM_CALLBACK] ?? '';
    $crossDomain = isset($_GET[PARAM_CROSS_DOMAIN]);

    if ($callback) {
        // JSONP 回應
        header("Content-Type: application/javascript; charset={$charset}");
        return $callback . '(' . $data . ');';
    } else {
        // 標準 JSON
        if ($crossDomain) {
            header('Access-Control-Allow-Origin: *');
            header('Access-Control-Allow-Methods: GET, OPTIONS');
            header('Access-Control-Allow-Headers: Content-Type');
        }
        header("Content-Type: application/json; charset={$charset}");
        return $data;
    }
}

// 處理 OPTIONS 預檢請求
if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') {
    header('Access-Control-Allow-Origin: *');
    header('Access-Control-Allow-Methods: GET, OPTIONS');
    header('Access-Control-Allow-Headers: Content-Type');
    header('Access-Control-Max-Age: 86400');
    exit(0);
}

// 輸出
echo generateResponse();
?>

mock.json 範例

{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {"id": 1, "title": "第一篇文章", "author": "張三"},
      {"id": 2, "title": "第二篇文章", "author": "李四"}
    ],
    "pagination": {"page": 1, "per_page": 10, "total": 2}
  }
}

前端呼叫範例

<!-- 普通 JSON -->
<script>
fetch('mock.php')
  .then(r => r.json())
  .then(data => console.log(data));
</script>

<!-- JSONP (跨域舊瀏覽器) -->
<script>
function handleResponse(data) { console.log(data); }
</script>
<script src="mock.php?callback=handleResponse"></script>

<!-- CORS + 指定編碼 -->
<script>
fetch('mock.php?cross-domain=1&charset=utf-8')
  .then(r => r.json())
  .then(data => console.log(data));
</script>

進階擴充建議

  • 支援多個 mock 檔案:mock.php?file=users.json
  • 支援動態參數注入:mock.php?userId=123 替換模板變數
  • 加入隨機延遲模擬真實網路:usleep(rand(100000, 500000))
  • 整合 Faker 庫生成隨機測試資料
  • 加入簡單路由:mock.php/api/users 對應不同檔案

部署說明

  1. 將 mock.php 放入 Web 目錄
  2. 同目錄建立 mock.json (可選)
  3. 直接訪問 https://your-domain/mock.php

總結

單一檔案、零依賴、支援 JSONP/CORS/編碼切換,是前端開發階段快速 Mock API 的理想工具。

copyright © 萬盛學電腦網 all rights reserved