解析 PHP 使用 cURL 提交 JSON 格式數據

PHP cURL 發送 JSON POST 請求完整指南

現代 API 交互多採用 JSON 格式，PHP cURL 需正確設置 Header 與資料編碼才能成功提交。

標準實作代碼

<?php
// 1. 準備資料並編碼為 JSON
$data = array("name" => "Hagrid", "age" => "36");
$data_string = json_encode($data);

// 2. 初始化 cURL
$ch = curl_init('https://api.local/rest/users');

// 3. 設置關鍵選項
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");           // 請求方法
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);        // JSON 資料
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);            // 返回字串而非直接輸出
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',                      // 關鍵：聲明 JSON 格式
    'Content-Length: ' . strlen($data_string)              // 可選：聲明內容長度
));

// 4. 執行請求
$result = curl_exec($ch);

// 5. 錯誤處理
if (curl_errno($ch)) {
    echo 'cURL 錯誤: ' . curl_error($ch);
}

// 6. 關閉連線
curl_close($ch);

// 7. 處理回應
$response = json_decode($result, true);
print_r($response);

關鍵選項詳解

常見錯誤與修正

❌ 錯誤：未設置 Content-Type

// 伺服器無法識別資料格式，返回 400/415
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
// 缺少 CURLOPT_HTTPHEADER 設置

❌ 錯誤：使用陣列而非 JSON 字串

// 會以 multipart/form-data 發送，非 JSON
curl_setopt($ch, CURLOPT_POSTFIELDS, $data); // 錯誤
// 正確
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

進階：封裝為可復用函數

function curl_post_json($url, $data, $headers = []) {
    $ch = curl_init($url);
    $default_headers = [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($data)
    ];
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST => 'POST',
        CURLOPT_POSTFIELDS => $data,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => array_merge($default_headers, $headers),
        CURLOPT_TIMEOUT => 30,
        CURLOPT_SSL_VERIFYPEER => false, // 僅測試環境
    ]);
    $result = curl_exec($ch);
    $error = curl_error($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return ['code' => $code, 'data' => $result, 'error' => $error];
}

// 使用
$json = json_encode(['name' => 'Test']);
$response = curl_post_json('https://api.example.com/endpoint', $json);

掌握此模式，即可輕松對接各類 RESTful API 服務。

1. 上一篇文章： 基於 flush() 無法順序輸出的解決方案
2. 下一篇文章： PHP 過濾頁面中的 BOM (Byte Order Mark) 實現代碼

PHP 綜合知識

PHP批量檢測網站可用性實作：cURL模擬請求、HTTP狀態碼、超時控制

使用 cURL 模擬用戶訪問，批量檢測多個網站/頁面的 HT

PHP 異常處理全攻略：從核心類到進階模式實戰

PHP 內建兩大異常基類：Exception（通用）與 Er

PHP 智慧型分頁類別：Google 風格自適應頁碼實作

功能特色 自動計算顯示頁碼範圍，當前頁置中 首頁、末頁、上

源碼搭建 LNMP 環境實戰：Nginx + MySQL + PHP 高性能架構

LNMP（Linux + Nginx + MySQL + P