前後端分離開發中,後端 API 未就緒時,前端需要模擬資料。本腳本單一檔案即可提供:讀取 mock.json、支援 JSONP callback、CORS 跨域、自訂字元編碼,零配置部署。
<?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();
?>
{
"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.php?file=users.jsonmock.php?userId=123 替換模板變數usleep(rand(100000, 500000))Faker 庫生成隨機測試資料mock.php/api/users 對應不同檔案mock.php 放入 Web 目錄mock.json (可選)https://your-domain/mock.php單一檔案、零依賴、支援 JSONP/CORS/編碼切換,是前端開發階段快速 Mock API 的理想工具。