PHP 模擬處理 HTTP PUT 請求：$_PUT 實作與 multipart/form-data 限制說明

PHP 原生提供 $_GET、$_POST 超全域變數，但沒有 $_PUT。處理 RESTful API 的 PUT 請求時，需自行解析原始輸入流。

基本實作：解析 application/x-www-form-urlencoded

<?php
$_PUT = [];
if ($_SERVER['REQUEST_METHOD'] === 'PUT') {
    parse_str(file_get_contents('php://input'), $_PUT);
}
// 使用：$_PUT['id'], $_PUT['title']

• php://input 讀取原始請求主體
• parse_str() 解析查詢字串格式

關鍵限制：multipart/form-data 無法取得原始資料

當 Content-Type: multipart/form-data（檔案上傳）時：

• PHP 自動解析並填入 $_FILES、$_POST
• php://input 為空，無法讀取原始資料
• 此時無法用上述方法模擬 $_PUT

變通方案（僅供測試/示範）

Apache mod_headers 強制改寫 Content-Type：

<Location "/demo.php">
    RequestHeader set Content-Type foobar
</Location>

將 Content-Type 改為非 multipart/form-data，php://input 即會有資料，但 $_FILES 會消失。生產環境不可用。

正規解決方案

cURL 測試 PUT 請求

# 表單格式
curl -X PUT https://domain.com/api/item -d "id=1" -d "title=test"

# JSON 格式
curl -X PUT https://domain.com/api/item \
  -H "Content-Type: application/json" \
  -d '{"id":1,"title":"test"}'

現代框架支援

• Laravel：Request::input() 自動處理 PUT/PATCH/DELETE
• Symfony：Request::createFromGlobals() 內建支援
• Slim/ThinkPHP 5+：內建 Request::put() 方法

若維護舊專案需自行實作，建議封裝為 Middleware/Filter 統一處理，並明確文檔說明不支援 multipart PUT。