萬盛學電腦網

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

PHP 獲取 POST 資料完整指南:三種方法對比與 XML/JSON 實戰範例

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✗ 不支援

詳細說明

1. $_POST — 表單標準處理

<form method="post" enctype="application/x-www-form-urlencoded">
  <input name="username">
</form>

// PHP
$username = $_POST['username'] ?? '';

PHP 自動解析 key=value&key2=value2 格式,建立關聯陣列。僅限此 Content-Type。

2. php://input — 通用原始資料讀取(推薦)

$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 5.6+ 曾有單次讀取限制,7.0+ 已修復)

3. $HTTP_RAW_POST_DATA — 歷史遺留方案

// 需 php.ini: always_populate_raw_post_data = -1 (PHP 5.6+) 或 On (舊版)
$raw = $GLOBALS['HTTP_RAW_POST_DATA'];

缺點明顯:永久佔用記憶體、需配置、multipart/form-data 不可用、PHP 7.0 已移除。不建議新專案使用。

實戰案例:微信企業號 XML 回調處理

場景

用戶回覆訊息 → 微信伺服器 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://input)

<?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();

安全提醒

  • XML 解析必須禁用外部實體:libxml_disable_entity_loader(true)
  • 限制請求 Body 大小:post_max_size、Nginx client_max_body_size
  • 驗證簽名(如微信 msg_signature)防止偽造請求

掌握三種方法差異,根據 Content-Type 選擇正確讀取方式,是 PHP API 開發的基本功。

copyright © 萬盛學電腦網 all rights reserved