PHP 接收 POST 資料的方式取決於 Content-Type。本文系統整理 $_POST、php://input、$HTTP_RAW_POST_DATA 三大方法的適用場景、限制與最佳實踐,並以微信企業號 XML 回調為實戰案例演示。
| 方法 | 適用 Content-Type | 資料型態 | 記憶體效率 | php.ini 依賴 | multipart/form-data |
|---|---|---|---|---|---|
$_POST['field'] | application/x-www-form-urlencoded | 關聯陣列 | 高 | 無 | ✓ 支援 |
file_get_contents('php://input') | 任意(除 multipart) | 原始字串 | 高 | 無 | ✗ 不支援 |
$GLOBALS['HTTP_RAW_POST_DATA'] | 未識別 MIME 類型 | 原始字串 | 低(永久佔用) | always_populate_raw_post_data=-1 | ✗ 不支援 |
<form method="post" enctype="application/x-www-form-urlencoded">
<input name="username">
</form>
// PHP
$username = $_POST['username'] ?? '';
PHP 自動解析 key=value&key2=value2 格式,建立關聯陣列。僅限此 Content-Type。
$raw = file_get_contents('php://input');
// $raw 為原始 POST Body 字串
// JSON API 範例
$data = json_decode($raw, true);
// XML API 範例
$xml = simplexml_load_string($raw);
優點:
application/json、text/xml、application/octet-stream 等任意類型$HTTP_RAW_POST_DATA 全域變數記憶體php.ini// 需 php.ini: always_populate_raw_post_data = -1 (PHP 5.6+) 或 On (舊版)
$raw = $GLOBALS['HTTP_RAW_POST_DATA'];
缺點明顯:永久佔用記憶體、需配置、multipart/form-data 不可用、PHP 7.0 已移除。不建議新專案使用。
用戶回覆訊息 → 微信伺服器 POST XML 到回調 URL
POST /callback?msg_signature=xxx×tamp=123&nonce=456
Content-Type: application/xml (或無 Content-Type)
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[測試內容]]></Content>
<MsgId>1234567890123456</MsgId>
<AgentID>1</AgentID>
</xml>
<?php
// 1. 讀取原始 XML
$xmlString = file_get_contents('php://input');
// 2. 解析 XML(禁用外部實體防止 XXE 攻擊)
libxml_disable_entity_loader(true);
$xml = simplexml_load_string($xmlString, 'SimpleXMLElement', LIBXML_NOCDATA);
// 3. 提取欄位
$toUser = (string)$xml->ToUserName;
$fromUser = (string)$xml->FromUserName;
$msgType = (string)$xml->MsgType;
$content = (string)$xml->Content;
// 4. 業務邏輯處理...
// 5. 回覆 XML(微信要求 5 秒內回應)
$reply = "<xml>
<ToUserName><![CDATA[{$fromUser}]></ToUserName>
<FromUserName><![CDATA[{$toUser}]></FromUserName>
<CreateTime>" . time() . "</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[收到: {$content}]]></Content>
</xml>";
echo $reply;
?>
class RequestInput {
public static function all() {
$contentType = $_SERVER['CONTENT_TYPE'] ?? '';
if (strpos($contentType, 'application/json') === 0) {
return json_decode(file_get_contents('php://input'), true) ?? [];
}
if (strpos($contentType, 'application/xml') === 0 ||
strpos($contentType, 'text/xml') === 0) {
libxml_disable_entity_loader(true);
$xml = simplexml_load_string(file_get_contents('php://input'), 'SimpleXMLElement', LIBXML_NOCDATA);
return json_decode(json_encode($xml), true); // XML 轉陣列
}
// 預設表單
return $_POST;
}
}
// 控制器中統一使用
$data = RequestInput::all();
libxml_disable_entity_loader(true)post_max_size、Nginx client_max_body_sizemsg_signature)防止偽造請求掌握三種方法差異,根據 Content-Type 選擇正確讀取方式,是 PHP API 開發的基本功。