EventHttpRequest::addHeader()函式—用法及示例

函式名稱：EventHttpRequest::addHeader() 

適用版本：PHP 5 >= 5.4.0, PECL event >= 1.2.6

函式描述： EventHttpRequest::addHeader() 函式用於向事件請求物件（EventHttpRequest）新增一個HTTP頭。

語法： bool EventHttpRequest::addHeader ( string $key , string $value [, int $type = EventHttpRequest::OUTPUT_HEADER ] )

引數：

• key: 頭名稱，例如 "Content-Type"、"User-Agent"。
• value: 頭的值。
• type（可選）: 頭的型別。預設為 EventHttpRequest::OUTPUT_HEADER，也可以為 EventHttpRequest::OUTPUT_BODY 或 EventHttpRequest::OUTPUT_HEADER_SIZE。當 type 設定為 EventHttpRequest::OUTPUT_HEADER_SIZE 時，addHeader() 函式將返回頭的長度而不是布林值。

返回值： 新增成功時返回 true，否則返回 false。當 type 設定為 EventHttpRequest::OUTPUT_HEADER_SIZE 時，返回頭的長度。

示例：

// 建立事件請求物件
$req = new EventHttpRequest();

// 向請求物件新增一個名為 "Content-Type"，值為 "application/json" 的頭
$req->addHeader("Content-Type", "application/json");

// 執行請求
$req->send("http://example.com/");

// 當 type 設定為 EventHttpRequest::OUTPUT_HEADER_SIZE 時，返回頭的長度
$headerSize = $req->addHeader("Content-Type", "application/json", EventHttpRequest::OUTPUT_HEADER_SIZE);
echo "Header size: " . $headerSize;

以上示例中，我們建立了一個事件請求物件 $req，然後使用 addHeader() 函式向請求物件的頭部新增了一個名為 "Content-Type"，值為 "application/json" 的頭。接下來，我們呼叫了 $req->send() 方法來傳送請求。最後，我們展示瞭如何透過將 type 引數設定為 EventHttpRequest::OUTPUT_HEADER_SIZE 來獲取頭的長度。

請注意，為了使用 EventHttpRequest，你需要先安裝並啟用 PECL 擴充套件 event。