##CURL參數詳解
|參數|說明|備注|
|-|-|-|
|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傳輸的進度條,此項的默認設置為啟用。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中。 ||
**對于下面的這些option的可選參數,value應該被設置一個integer類型的值:**
|選項 |可選value值|
|-|-|
|CURLOPT_BUFFERSIZE |每次獲取的數據中讀入緩存的大小,但是不保證這個值每次都會被填滿。 在cURL 7.10中被加入。|
|CURLOPT_CLOSEPOLICY |不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,還存在另外三個CURLCLOSEPOLICY_,但是cURL暫時還不支持。|
|CURLOPT_CONNECTTIMEOUT |在發起連接前等待的時間,如果設置為0,則無限等待。|
|CURLOPT_CONNECTTIMEOUT_MS |嘗試連接等待的時間,以毫秒為單位。如果設置為0,則無限等待。 在cURL 7.16.2中被加入。從PHP 5.2.3開始可用。|
|CURLOPT_DNS_CACHE_TIMEOUT |設置在內存中保存DNS信息的時間,默認為120秒。|
|CURLOPT_FTPSSLAUTH |FTP驗證方式:CURLFTPAUTH_SSL (首先嘗試SSL),CURLFTPAUTH_TLS (首先嘗試TLS)或CURLFTPAUTH_DEFAULT (讓cURL自動決定)。 在cURL 7.12.2中被加入。|
|CURLOPT_HTTP_VERSION |CURL_HTTP_VERSION_NONE (默認值,讓cURL自己判斷使用哪個版本),CURL_HTTP_VERSION_1_0 (強制使用 HTTP/1.0)或CURL_HTTP_VERSION_1_1 (強制使用 HTTP/1.1)。 |
|CURLOPT_HTTPAUTH |使用的HTTP驗證方法,可選的值有:CURLAUTH_BASIC、CURLAUTH_DIGEST、CURLAUTH_GSSNEGOTIATE、CURLAUTH_NTLM、CURLAUTH_ANY和CURLAUTH_ANYSAFE。 可以使用\|位域(或)操作符分隔多個值,cURL讓服務器選擇一個支持最好的值。CURLAUTH_ANY等價于CURLAUTH_BASIC \| CURLAUTH_DIGEST \| CURLAUTH_GSSNEGOTIATE \| CURLAUTH_NTLM. CURLAUTH_ANYSAFE等價于CURLAUTH_DIGEST \| CURLAUTH_GSSNEGOTIATE \| CURLAUTH_NTLM.|
|CURLOPT_INFILESIZE| 設定上傳文件的大小限制,字節(byte)為單位。 |
|CURLOPT_LOW_SPEED_LIMIT| 當傳輸速度小于CURLOPT_LOW_SPEED_LIMIT時(bytes/sec),PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。 |
|CURLOPT_LOW_SPEED_TIME| 當傳輸速度小于CURLOPT_LOW_SPEED_LIMIT時(bytes/sec),PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。 |
|CURLOPT_MAXCONNECTS| 允許的最大連接數量,超過是會通過CURLOPT_CLOSEPOLICY決定應該停止哪些連接。 |
|CURLOPT_MAXREDIRS| 指定最多的HTTP重定向的數量,這個選項是和CURLOPT_FOLLOWLOCATION一起使用的。 |
|CURLOPT_PORT| 用來指定連接端口。(可選項)|
|CURLOPT_PROTOCOLS |CURLPROTO_*的位域指。如果被啟用,位域值會限定libcurl在傳輸過程中有哪些可使用的協議。這將允許你在編譯libcurl時支持眾多協議,但是限制只是用它們中被允許使用的一個子集。默認libcurl將會使用全部它支持的協議。參見CURLOPT_REDIR_PROTOCOLS. 可用的協議選項為:CURLPROTO_HTTP、CURLPROTO_HTTPS、CURLPROTO_FTP、CURLPROTO_FTPS、CURLPROTO_SCP、CURLPROTO_SFTP、CURLPROTO_TELNET、CURLPROTO_LDAP、CURLPROTO_LDAPS、CURLPROTO_DICT、CURLPROTO_FILE、CURLPROTO_TFTP、CURLPROTO_ALL|
|CURLOPT_PROXYAUTH| HTTP代理連接的驗證方式。使用在CURLOPT_HTTPAUTH中的位域標志來設置相應選項。對于代理驗證只有CURLAUTH_BASIC和CURLAUTH_NTLM當前被支持。 |
|CURLOPT_PROXYPORT| 代理服務器的端口。端口也可以在CURLOPT_PROXY中進行設置。 |
|CURLOPT_PROXYTYPE| 不是CURLPROXY_HTTP (默認值) 就是CURLPROXY_SOCKS5。|
|CURLOPT_REDIR_PROTOCOLS| CURLPROTO_*中的位域值。如果被啟用,位域值將會限制傳輸線程在CURLOPT_FOLLOWLOCATION開啟時跟隨某個重定向時可使用的協議。這將使你對重定向時限制傳輸線程使用被允許的協議子集默認libcurl將會允許除FILE和SCP之外的全部協議。這個和7.19.4預發布版本種無條件地跟隨所有支持的協議有一些不同。關于協議常量,請參照CURLOPT_PROTOCOLS。|
|CURLOPT_RESUME_FROM| 在恢復傳輸時傳遞一個字節偏移量(用來斷點續傳)。|
|CURLOPT_SSL_VERIFYHOST| 1 檢查服務器SSL證書中是否存在一個公用名(common name)。譯者注:公用名(Common Name)一般來講就是填寫你將要申請SSL證書的域名 (domain)或子域名(sub domain)。2 檢查公用名是否存在,并且是否與提供的主機名匹配。 |
|CURLOPT_SSLVERSION| 使用的SSL版本(2 或 3)。默認情況下PHP會自己檢測這個值,盡管有些情況下需要手動地進行設置。|
|CURLOPT_TIMECONDITION| 如果在CURLOPT_TIMEVALUE指定的某個時間以后被編輯過,則使用CURL_TIMECOND_IFMODSINCE返回頁面,如果沒有被修改過,并且CURLOPT_HEADER為true,則返回一個"304 Not Modified"的header, CURLOPT_HEADER為false,則使用CURL_TIMECOND_IFUNMODSINCE,默認值為CURL_TIMECOND_IFUNMODSINCE。|
|CURLOPT_TIMEOUT| 設置cURL允許執行的最長秒數。|
|CURLOPT_TIMEOUT_MS| 設置cURL允許執行的最長毫秒數。 在cURL 7.16.2中被加入。從PHP 5.2.3起可使用。|
|CURLOPT_TIMEVALUE| 設置一個CURLOPT_TIMECONDITION使用的時間戳,在默認狀態下使用的是CURL_TIMECOND_IFMODSINCE。|