php curl選項列表(超詳細)

本篇文章是對php中的curl選項列表進行了詳細的分析介紹需要的朋友參考下  

　　第一類
對於下面的這些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狀態碼默認行為是忽略編號小於等於的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 開始可用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 時被加入

CURLOPT_POST
啟用時會發送一個常規的POST請求類型為application/xwwwformurlencoded就像表單提交的一樣
CURLOPT_PUT
啟用時允許HTTP發送文件必須同時設置CURLOPT_INFILE和CURLOPT_INFILESIZE
CURLOPT_RETURNTRANSFER
將 curl_exec()獲取的信息以文件流的形式返回而不是直接輸出
CURLOPT_SSL_VERIFYPEER
禁 用後cURL將終止從服務端進行驗證使用CURLOPT_CAINFO選項設置證書使用CURLOPT_CAPATH選項設置證書目錄 如果CURLOPT_SSL_VERIFYPEER(默認值為)被啟用CURLOPT_SSL_VERIFYHOST需要被設置成TRUE否則設置為 FALSE
自cURL 開始默認為TRUE從cURL 開始默認綁定安裝

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 中被加入

CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST還存在另外三個CURLCLOSEPOLICY_但是cURL暫時還不支持
CURLOPT_CONNECTTIMEOUT
在發起連接前等待的時間如果設置為則無限等待
CURLOPT_CONNECTTIMEOUT_MS
嘗試連接等待的時間以毫秒為單位如果設置為則無限等待
在cURL 中被加入從PHP 開始可用

CURLOPT_DNS_CACHE_TIMEOUT
設置在內存中保存DNS信息的時間默認為秒
CURLOPT_FTPSSLAUTH
FTP驗證方式CURLFTPAUTH_SSL (首先嘗試SSL)CURLFTPAUTH_TLS (首先嘗試TLS)或CURLFTPAUTH_DEFAULT (讓cURL自動決定)
在cURL 中被加入

CURLOPT_HTTP_VERSION
CURL_HTTP_VERSION_NONE (默認值讓cURL自己判斷使用哪個版本)CURL_HTTP_VERSION__ (強制使用 HTTP/)或CURL_HTTP_VERSION__ (強制使用 HTTP/)
CURLOPT_HTTPAUTH
使用的HTTP驗證方法可選的值有CURLAUTH_BASICCURLAUTH_DIGESTCURLAUTH_GSSNEGOTIATECURLAUTH_NTLMCURLAUTH_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_HTTPCURLPROTO_HTTPSCURLPROTO_FTPCURLPROTO_FTPS CURLPROTO_SCPCURLPROTO_SFTPCURLPROTO_TELNETCURLPROTO_LDAP CURLPROTO_LDAPSCURLPROTO_DICTCURLPROTO_FILECURLPROTO_TFTP CURLPROTO_ALL
在cURL 中被加入

CURLOPT_PROXYAUTH
HTTP代理連接的驗證方式使用在CURLOPT_HTTPAUTH中的位域標志來設置相應選項對於代理驗證只有CURLAUTH_BASIC和CURLAUTH_NTLM當前被支持
在cURL 中被加入

CURLOPT_PROXYPORT
代理服務器的端口端口也可以在CURLOPT_PROXY中進行設置
CURLOPT_PROXYTYPE
不是CURLPROXY_HTTP (默認值) 就是CURLPROXY_SOCKS
在cURL 中被加入

CURLOPT_REDIR_PROTOCOLS
CURLPROTO_* 中的位域值如果被啟用位域值將會限制傳輸線程在CURLOPT_FOLLOWLOCATION開啟時跟隨某個重定向時可使用的協議這將使你對重定向 時限制傳輸線程使用被允許的協議子集默認libcurl將會允許除FILE和SCP之外的全部協議這個和預發布版本種無條件地跟隨所有支持 的協議有一些不同關於協議常量請參照CURLOPT_PROTOCOLS
在cURL 中被加入

CURLOPT_RESUME_FROM
在恢復傳輸時傳遞一個字節偏移量（用來斷點續傳）
CURLOPT_SSL_VERIFYHOST
檢查服務器SSL證書中是否存在一個公用名(common name)譯者注公用名(Common Name)一般來講就是填寫你將要申請SSL證書的域名 (domain)或子域名(sub domain) 檢查公用名是否存在並且是否與提供的主機名匹配
CURLOPT_SSLVERSION
使用的SSL版本( 或 )默認情況下PHP會自己檢測這個值盡管有些情況下需要手動地進行設置
CURLOPT_TIMECONDITION
如 果在CURLOPT_TIMEVALUE指定的某個時間以後被編輯過則使用CURL_TIMECOND_IFMODSINCE返回頁面如果沒有被修改 過並且CURLOPT_HEADER為true則返回一個" Not Modified"的header CURLOPT_HEADER為false則使用CURL_TIMECOND_IFUNMODSINCE默認值為 CURL_TIMECOND_IFUNMODSINCE
CURLOPT_TIMEOUT
設置cURL允許執行的最長秒數
CURLOPT_TIMEOUT_MS
設置cURL允許執行的最長毫秒數
在cURL 中被加入從PHP 起可使用

CURLOPT_TIMEVALUE
設置一個CURLOPT_TIMECONDITION使用的時間戳在默認狀態下使用的是CURL_TIMECOND_IFMODSINCE

第三類
對於下面的這些option的可選參數value應該被設置一個string類型的值
選項
可選value值
備注

CURLOPT_CAINFO
一個保存著個或多個用來讓服務端驗證的證書的文件名這個參數僅僅在和CURLOPT_SSL_VERIFYPEER一起使用時才有意義
CURLOPT_CAPATH
一個保存著多個CA證書的目錄這個選項是和CURLOPT_SSL_VERIFYPEER一起使用的
CURLOPT_COOKIE
設定HTTP請求中"Cookie: "部分的內容多個cookie用分號分隔分號後帶一個空格(例如 "fruit=apple; colour=red")
CURLOPT_COOKIEFILE
包含cookie數據的文件名cookie文件的格式可以是Netscape格式或者只是純HTTP頭部信息存入文件
CURLOPT_COOKIEJAR
連接結束後保存cookie信息的文件
CURLOPT_CUSTOMREQUEST
使 用一個自定義的請求信息來代替"GET"或"HEAD"作為HTTP請求這對於執行"DELETE" 或者其他更隱蔽的HTTP請求有效值如"GET""POST""CONNECT"等等也就是說不要在這裡輸入整個HTTP請求例如輸 入"GET /indexhtml HTTP/rnrn"是不正確的
Note:
在確定服務器支持這個自定義請求的方法前不要使用


CURLOPT_EGDSOCKET
類似CURLOPT_RANDOM_FILE除了一個Entropy Gathering Daemon套接字
CURLOPT_ENCODING
HTTP請求頭中"AcceptEncoding: "的值支持的編碼有"identity""deflate"和"gzip"如果為空字符串""請求頭會發送所有支持的編碼類型
在cURL 中被加入

CURLOPT_FTPPORT
這個值將被用來獲取供FTP"POST"指令所需要的IP地址"POST"指令告訴遠程服務器連接到我們指定的IP地址這個字符串可以是純文本的IP地址主機名一個網絡接口名（UNIX下）或者只是一個來使用默認的IP地址
CURLOPT_INTERFACE
網絡發送接口名可以是一個接口名IP地址或者是一個主機名
CURLOPT_KRBLEVEL
KRB (Kerberos ) 安全級別下面的任何值都是有效的(從低到高的順序)"clear""safe""confidential""private"如果字符串 和這些都不匹配將使用"private"這個選項設置為NULL時將禁用KRB 安全認證目前KRB 安全認證只能用於FTP傳輸
CURLOPT_POSTFIELDS
全 部數據使用HTTP協議中的"POST"操作來發送要發送文件在文件名前面加上@前綴並使用完整路徑這個參數可以通過urlencoded後的字符 串類似para=val¶=val&或使用一個以字段名為鍵值字段數據為值的數組如果value是一個數 組ContentType頭將會被設置成multipart/formdata
CURLOPT_PROXY
HTTP代理通道
CURLOPT_PROXYUSERPWD
一個用來連接到代理的"[username]:[password]"格式的字符串
CURLOPT_RANDOM_FILE
一個被用來生成SSL隨機數種子的文件名
CURLOPT_RANGE
以"XY"的形式其中X和Y都是可選項獲取數據的范圍以字節計HTTP傳輸線程也支持幾個這樣的重復項中間用逗號分隔如"XYNM"
CURLOPT_REFERER
在HTTP請求頭中"Referer: "的內容
CURLOPT_SSL_CIPHER_LIST
一個SSL的加密算法列表例如RCSHA和TLSv都是可用的加密列表
CURLOPT_SSLCERT
一個包含PEM格式證書的文件名
CURLOPT_SSLCERTPASSWD
使用CURLOPT_SSLCERT證書需要的密碼
CURLOPT_SSLCERTTYPE
證書的類型支持的格式有"PEM" (默認值) "DER"和"ENG"
在cURL 中被加入

CURLOPT_SSLENGINE
用來在CURLOPT_SSLKEY中指定的SSL私鑰的加密引擎變量
CURLOPT_SSLENGINE_DEFAULT
用來做非對稱加密操作的變量
CURLOPT_SSLKEY
包含SSL私鑰的文件名
CURLOPT_SSLKEYPASSWD
在CURLOPT_SSLKEY中指定了的SSL私鑰的密碼
Note:
由於這個選項包含了敏感的密碼信息記得保證這個PHP腳本的安全

CURLOPT_SSLKEYTYPE
CURLOPT_SSLKEY中規定的私鑰的加密類型支持的密鑰類型為"PEM"(默認值)"DER"和"ENG"
CURLOPT_URL
需要獲取的URL地址也可以在 curl_init()函數中設置
CURLOPT_USERAGENT
在HTTP請求中包含一個"UserAgent: "頭的字符串
CURLOPT_USERPWD
傳遞一個連接中需要的用戶名和密碼格式為"[username]:[password]"


第四類
對於下面的這些option的可選參數value應該被設置一個數組
選項
可選value值
備注

CURLOPT_HTTPALIASES
響應碼數組數組中的響應嗎被認為是正確的響應否則被認為是錯誤的
在cURL 中被加入

CURLOPT_HTTPHEADER
一個用來設置HTTP頭字段的數組使用如下的形式的數組進行設置 array(Contenttype: text/plain Contentlength: )
CURLOPT_POSTQUOTE
在FTP請求執行完成後在服務器上執行的一組FTP命令
CURLOPT_QUOTE
一組先於FTP請求的在服務器上執行的FTP命令

　　對於下面的這些option的可選參數value應該被設置一個流資源 （例如使用 fopen()）
選項
可選value值

CURLOPT_FILE
設置輸出文件的位置值是一個資源類型默認為STDOUT (浏覽器)

CURLOPT_INFILE
在上傳文件的時候需要讀取的文件地址值是一個資源類型

CURLOPT_STDERR
設置一個錯誤輸出地址值是一個資源類型取代默認的STDERR

CURLOPT_WRITEHEADER
設置header部分內容的寫入的文件地址值是一個資源類型

對於下面的這些option的可選參數value應該被設置為一個回調函數名
選項
可選value值

CURLOPT_HEADERFUNCTION
設置一個回調函數這個函數有兩個參數第一個是cURL的資源句柄第二個是輸出的header數據header數據的輸出必須依賴這個函數返回已寫入的數據大小

CURLOPT_PASSWDFUNCTION
設置一個回調函數有三個參數第一個是cURL的資源句柄第二個是一個密碼提示符第三個參數是密碼長度允許的最大值返回密碼的值

CURLOPT_PROGRESSFUNCTION
設置一個回調函數有三個參數第一個是cURL的資源句柄第二個是一個文件描述符資源第三個是長度返回包含的數據

CURLOPT_READFUNCTION
擁有兩個參數的回調函數第一個是參數是會話句柄第二是HTTP響應頭信息的字符串使用此函數將自行處理返回的數據返回值為數據大小以字節計返回代表EOF信號

CURLOPT_WRITEFUNCTION
擁有兩個參數的回調函數第一個是參數是會話句柄第二是HTTP響應頭信息的字符串使用此回調函數將自行處理響應頭信息響應頭信息是整個字符串設置返回值為精確的已寫入字符串長度發生錯誤時傳輸線程終止

From:http://tw.wingwit.com/Article/program/PHP/201311/21090.html