# 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** | 在連接建立以后，訪問<var class="filename">~/.netrc</var>文件獲取用戶名和密碼信息連接遠程站點。 | | **CURLOPT_NOBODY** | 啟用時將不對HTML中的BODY部分進行輸出。 | | **CURLOPT_NOPROGRESS** | 啟用時關閉curl傳輸的進度條，此項的默認設置為啟用。**Note**: PHP自動地設置這個選項為**TRUE**，這個選項僅僅應當在以調試為目的時被改變。| | **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。