(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。