(PHP 5 >= 5.5.0)
curl_multi_setopt — 設(shè)置一個(gè)批處理CURL傳輸選項(xiàng)。
bool curl_multi_setopt ( resource $mh , int $option , mixed $value )
設(shè)置一個(gè)批處理CURL傳輸選項(xiàng)。
ch
由 curl_init() 返回的 CURL 句柄。
option
需要設(shè)置的CURLOPT_XXX選項(xiàng)。
value
將設(shè)置在option選項(xiàng)上的值。
對(duì)于下面的這些option的可選參數(shù)，value應(yīng)該被設(shè)置一個(gè)bool類型的值：
| 選項(xiàng) | 可選value值 | 備注 |
|---|---|---|
| CURLOPT_AUTOREFERER | 當(dāng)根據(jù)Location:重定向時(shí)，自動(dòng)設(shè)置header中的Referer:信息。 | |
| CURLOPT_BINARYTRANSFER | 在啟用CURLOPT_RETURNTRANSFER的時(shí)候，返回原生的(Raw)輸出。 | |
| CURLOPT_COOKIESESSION | 啟用時(shí)curl會(huì)僅僅傳遞一個(gè)session cookie，忽略其他的cookie，默認(rèn)狀況下CURL會(huì)將所有的cookie返回給服務(wù)端。session cookie是指那些用來判斷服務(wù)器端的session是否有效而存在的cookie。 | |
| CURLOPT_CRLF | 啟用時(shí)將Unix的換行符轉(zhuǎn)換成回車換行符。 | |
| CURLOPT_DNS_USE_GLOBAL_CACHE | 啟用時(shí)會(huì)啟用一個(gè)全局的DNS緩存，此項(xiàng)為線程安全的，并且默認(rèn)啟用。 | |
| CURLOPT_FAILONERROR | 顯示HTTP狀態(tài)碼，默認(rèn)行為是忽略編號(hào)小于等于400的HTTP信息。 | |
| CURLOPT_FILETIME | 啟用時(shí)會(huì)嘗試修改遠(yuǎn)程文檔中的信息。結(jié)果信息會(huì)通過curl_getinfo()函數(shù)的CURLINFO_FILETIME選項(xiàng)返回。 curl_getinfo(). | |
| CURLOPT_FOLLOWLOCATION | 啟用時(shí)會(huì)將服務(wù)器服務(wù)器返回的"Location: "放在header中遞歸的返回給服務(wù)器，使用CURLOPT_MAXREDIRS可以限定遞歸返回的數(shù)量。 | |
| CURLOPT_FORBID_REUSE | 在完成交互以后強(qiáng)迫斷開連接，不能重用。 | |
| CURLOPT_FRESH_CONNECT | 強(qiáng)制獲取一個(gè)新的連接，代替緩存中的連接。 | |
| CURLOPT_FTP_USE_EPRT | 啟用時(shí)當(dāng)FTP下載時(shí)，使用EPRT (或 LPRT)命令。設(shè)置為FALSE時(shí)禁用EPRT和LPRT，使用PORT命令 only. | |
| CURLOPT_FTP_USE_EPSV | 啟用時(shí)，在FTP傳輸過程中回復(fù)到PASV模式前首先嘗試EPSV命令。設(shè)置為FALSE時(shí)禁用EPSV命令。 | |
| CURLOPT_FTPAPPEND | 啟用時(shí)追加寫入文件而不是覆蓋它。 | |
| CURLOPT_FTPASCII | CURLOPT_TRANSFERTEXT的別名。 | |
| CURLOPT_FTPLISTONLY | 啟用時(shí)只列出FTP目錄的名字。 | |
| CURLOPT_HEADER | 啟用時(shí)會(huì)將頭文件的信息作為數(shù)據(jù)流輸出。 | |
| CURLINFO_HEADER_OUT | 啟用時(shí)追蹤句柄的請(qǐng)求字符串。 | 從 PHP 5.1.3 開始可用。CURLINFO_前綴是故意的(intentional)。 |
| CURLOPT_HTTPGET | 啟用時(shí)會(huì)設(shè)置HTTP的method為GET，因?yàn)镚ET是默認(rèn)是，所以只在被修改的情況下使用。 | |
| CURLOPT_HTTPPROXYTUNNEL | 啟用時(shí)會(huì)通過HTTP代理來傳輸。 | |
| CURLOPT_MUTE | 啟用時(shí)將CURL函數(shù)中所有修改過的參數(shù)恢復(fù)默認(rèn)值。 | |
| CURLOPT_NETRC | 在連接建立以后，訪問~/.netrc文件獲取用戶名和密碼信息連接遠(yuǎn)程站點(diǎn)。 | |
| CURLOPT_NOBODY | 啟用時(shí)將不對(duì)HTML中的BODY部分進(jìn)行輸出。 | |
| CURLOPT_NOPROGRESS | 啟用時(shí)關(guān)閉curl傳輸?shù)倪M(jìn)度條，此項(xiàng)的默認(rèn)設(shè)置為啟用。 Note: PHP自動(dòng)地設(shè)置這個(gè)選項(xiàng)為TRUE，這個(gè)選項(xiàng)僅僅應(yīng)當(dāng)在以調(diào)試為目的時(shí)被改變。 | |
| CURLOPT_NOSIGNAL | 啟用時(shí)忽略所有的curl傳遞給php進(jìn)行的信號(hào)。在SAPI多線程傳輸時(shí)此項(xiàng)被默認(rèn)啟用。 | CURL 7.10時(shí)被加入。 |
| CURLOPT_POST | 啟用時(shí)會(huì)發(fā)送一個(gè)常規(guī)的POST請(qǐng)求，類型為：application/x-www-form-urlencoded，就像表單提交的一樣。 | |
| CURLOPT_PUT | 啟用時(shí)允許HTTP發(fā)送文件，必須同時(shí)設(shè)置CURLOPT_INFILE和CURLOPT_INFILESIZE。 | |
| CURLOPT_RETURNTRANSFER | 將curl_exec()獲取的信息以文件流的形式返回，而不是直接輸出。 | |
| CURLOPT_SSL_VERIFYPEER | 禁用后CURL將終止從服務(wù)端進(jìn)行驗(yàn)證。使用CURLOPT_CAINFO選項(xiàng)設(shè)置證書使用CURLOPT_CAPATH選項(xiàng)設(shè)置證書目錄 如果CURLOPT_SSL_VERIFYPEER(默認(rèn)值為2)被啟用，CURLOPT_SSL_VERIFYHOST需要被設(shè)置成TRUE否則設(shè)置為FALSE。 | 自CURL 7.10開始默認(rèn)為TRUE。從CURL 7.10開始默認(rèn)綁定安裝。 |
| CURLOPT_TRANSFERTEXT | 啟用后對(duì)FTP傳輸使用ASCII模式。對(duì)于LDAP，它檢索純文本信息而非HTML。在Windows系統(tǒng)上，系統(tǒng)不會(huì)把STDOUT設(shè)置成binary模式。 | |
| CURLOPT_UNRESTRICTED_AUTH | 在使用CURLOPT_FOLLOWLOCATION產(chǎn)生的header中的多個(gè)locations中持續(xù)追加用戶名和密碼信息，即使域名已發(fā)生改變。 | |
| CURLOPT_UPLOAD | 啟用后允許文件上傳。 | |
| CURLOPT_VERBOSE | 啟用時(shí)會(huì)匯報(bào)所有的信息，存放在STDERR或指定的CURLOPT_STDERR中。 |
成功時(shí)返回 TRUE， 或者在失敗時(shí)返回 FALSE。