函數(shù)名稱：EventHttpRequest::addHeader() 

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

函數(shù)描述： EventHttpRequest::addHeader() 函數(shù)用于向事件請(qǐng)求對(duì)象（EventHttpRequest）添加一個(gè)HTTP頭。

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

參數(shù)：

• key: 頭名稱，例如 "Content-Type"、"User-Agent"。
• value: 頭的值。
• type（可選）: 頭的類型。默認(rèn)為 EventHttpRequest::OUTPUT_HEADER，也可以為 EventHttpRequest::OUTPUT_BODY 或 EventHttpRequest::OUTPUT_HEADER_SIZE。當(dāng) type 設(shè)置為 EventHttpRequest::OUTPUT_HEADER_SIZE 時(shí)，addHeader() 函數(shù)將返回頭的長(zhǎng)度而不是布爾值。

返回值： 添加成功時(shí)返回 true，否則返回 false。當(dāng) type 設(shè)置為 EventHttpRequest::OUTPUT_HEADER_SIZE 時(shí)，返回頭的長(zhǎng)度。

示例：

// 創(chuàng)建事件請(qǐng)求對(duì)象
$req = new EventHttpRequest();

// 向請(qǐng)求對(duì)象添加一個(gè)名為 "Content-Type"，值為 "application/json" 的頭
$req->addHeader("Content-Type", "application/json");

// 執(zhí)行請(qǐng)求
$req->send("http://example.com/");

// 當(dāng) type 設(shè)置為 EventHttpRequest::OUTPUT_HEADER_SIZE 時(shí)，返回頭的長(zhǎng)度
$headerSize = $req->addHeader("Content-Type", "application/json", EventHttpRequest::OUTPUT_HEADER_SIZE);
echo "Header size: " . $headerSize;

以上示例中，我們創(chuàng)建了一個(gè)事件請(qǐng)求對(duì)象 $req，然后使用 addHeader() 函數(shù)向請(qǐng)求對(duì)象的頭部添加了一個(gè)名為 "Content-Type"，值為 "application/json" 的頭。接下來(lái)，我們調(diào)用了 $req->send() 方法來(lái)發(fā)送請(qǐng)求。最后，我們展示了如何通過(guò)將 type 參數(shù)設(shè)置為 EventHttpRequest::OUTPUT_HEADER_SIZE 來(lái)獲取頭的長(zhǎng)度。

請(qǐng)注意，為了使用 EventHttpRequest，你需要先安裝并啟用 PECL 擴(kuò)展 event。