PHP 8 API 搬移批次測試
最後更新：2026-08-10
這裡提供 QA 與 reviewer 可以直接照著執行的批次測試文件。工程 parity、Legacy/New 行號、SQL 與完整 side effect 仍以 API migration detail doc 為準。
工程批次總表：PHP 8 API 搬移批次。
目前 B001 進行 Staging QA；B002 已開始補缺少的 PHP 8 endpoint。兩批進度分開記錄，不把「程式完成」當成「Staging QA 完成」。
測試順序
- 打開該批文件，確認測試身份與前置資料。
- 有 Web caller 時先照畫面操作，從 DevTools Network 確認 method、path、request 與完整 response。
- Web 沒有 caller 時再確認 App；App 也沒有才使用 curl 或原 external/internal caller。
- curl 不使用
jq隱藏內容，人工檢查 HTTP status、headers 與完整 body。 - 寫入型 API 必須查 DB、queue、activity、transaction 或 log；測後還原資料。
- Staging response header 必須確認
x-php-env: php82-staging-*。 - 把日期、測試人、結果與證據路徑寫回批次文件。
變數與機密
export STAGING_API_KEY='<從 Staging 前端 Network 或 Staging DB 取得>'
export STAGING_SESSION_TOKEN='<從同一個已登入使用者 request 取得>'文件不可保存 API key、session token、TapPay prime、card token、authorization 或 cookie 實際值。
批次索引
| 批次 | 狀態 | 文件 |
|---|---|---|
| B001 評價、評價標籤與回覆 | 已建立；待整組 Staging QA | B001-feedback-review.md |
| B002 分類樹與子分類 | 兩支低流量 API 已補；待 Staging，另剩一支待實作 | B002-category-tree.md |
| B003～B022 | 已完成範圍分組；caller／操作步驟逐批補齊 | 搬移批次總表 |
核心與其他測試
核心：QA 與切流後 smoke 必跑，通常每支 API 1 個主要成功案例，加上必要的資料確認。其他：invalid input、non-owner、重複呼叫、route negative、PHP 5.6／8.2 邊界，由 PHPUnit 或 endpoint detail doc 保存。- 付款、刪除、callback 等高風險 API 即使已有 PHPUnit，也必須保留至少一個受控 Staging side-effect 案例。