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