curl引數及命令
阿新 • • 發佈:2018-12-09
curl_close — 關閉一個cURL會話 curl_copy_handle — 複製一個cURL控制代碼和它的所有選項 curl_errno — 返回最後一次的錯誤號 curl_error — 返回一個保護當前會話最近一次錯誤的字串 curl_escape — 使用 URL 編碼給定的字串 curl_exec — 執行一個cURL會話 curl_file_create — 建立一個 CURLFile 物件 curl_getinfo — 獲取一個cURL連線資源控制代碼的資訊 curl_init — 初始化一個cURL會話 curl_multi_add_handle — 向curl批處理會話中新增單獨的curl控制代碼 curl_multi_close — 關閉一組cURL控制代碼 curl_multi_exec — 運行當前 cURL 控制代碼的子連線 curl_multi_getcontent — 如果設定了CURLOPT_RETURNTRANSFER,則返回獲取的輸出的文字流 curl_multi_info_read — 獲取當前解析的cURL的相關傳輸資訊 curl_multi_init — 返回一個新cURL批處理控制代碼 curl_multi_remove_handle — 移除curl批處理控制代碼資源中的某個控制代碼資源 curl_multi_select — 等待所有cURL批處理中的活動連線 curl_multi_setopt — 為 cURL 並行處理設定一個選項 curl_multi_strerror — Return string describing error code curl_pause — Pause and unpause a connection curl_reset — Reset all options of a libcurl session handle curl_setopt_array — 為cURL傳輸會話批量設定選項 curl_setopt — 設定一個cURL傳輸選項 curl_share_close — Close a cURL share handle curl_share_init — Initialize a cURL share handle curl_share_setopt — Set an option for a cURL share handle. curl_strerror — Return string describing the given error code curl_unescape — 解碼給定的 URL 編碼的字串 curl_version — 獲取cURL版本資訊 在實際的使用當中,使用得最多的函式是curl_setopt — 設定一個cURL傳輸選項 說明: bool curl_setopt ( resource $ch , int $option , mixed $value ) 其中, ch 由 curl_init() 返回的 cURL 控制代碼 option 表示的是需要設定的CURLOPT_XXX選項 value 表示的是將設定在option選項上的值 對於下面的這些option的可選引數,value應該被設定一個bool型別的值: 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型別的值: 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 在cURL 7.19.4中被加入。 CURLOPT_PROXYAUTH HTTP代理連線的驗證方式。使用在CURLOPT_HTTPAUTH中的位域標誌來設定相應選項。對於代理驗證只有CURLAUTH_BASIC和CURLAUTH_NTLM當前被支援。在cURL 7.10.7中被加入。 CURLOPT_PROXYPORT 代理伺服器的埠。埠也可以在CURLOPT_PROXY中進行設定。 CURLOPT_PROXYTYPE 不是CURLPROXY_HTTP (預設值) 就是CURLPROXY_SOCKS5。在cURL 7.10中被加入。 CURLOPT_REDIR_PROTOCOLS CURLPROTO_*中的位域值。如果被啟用,位域值將會限制傳輸執行緒在CURLOPT_FOLLOWLOCATION開啟時跟隨某個重定向時可使用的協議。這將使你對重定向時限制傳輸執行緒使用被允許的協議子集預設libcurl將會允許除FILE和SCP之外的全部協議。這個和7.19.4預釋出版本種無條件地跟隨所有支援的協議有一些不同。關於協議常量,請參照CURLOPT_PROTOCOLS。在cURL 7.19.4中被加入。 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。 對於下面的這些option的可選引數,value應該被設定一個string型別的值: CURLOPT_CAINFO 一個儲存著1個或多個用來讓服務端驗證的證書的檔名。這個引數僅僅在和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 /index.html HTTP/1.0\r\n\r\n"是不正確的。 Note: 在確定伺服器支援這個自定義請求的方法前不要使用。 CURLOPT_EGDSOCKET 類似CURLOPT_RANDOM_FILE,除了一個Entropy Gathering Daemon套接字。 CURLOPT_ENCODING HTTP請求頭中"Accept-Encoding: "的值。支援的編碼有"identity","deflate"和"gzip"。如果為空字串"",請求頭會發送所有支援的編碼型別。在cURL 7.10中被加入。 CURLOPT_FTPPORT 這個值將被用來獲取供FTP"POST"指令所需要的IP地址。"POST"指令告訴遠端伺服器連線到我們指定的IP地址。這個字串可以是純文字的IP地址、主機名、一個網路介面名(UNIX下)或者只是一個'-'來使用預設的IP地址。 CURLOPT_INTERFACE 網路傳送介面名,可以是一個介面名、IP地址或者是一個主機名。 CURLOPT_KRB4LEVEL KRB4 (Kerberos 4) 安全級別。下面的任何值都是有效的(從低到高的順序):"clear"、"safe"、"confidential"、"private".。如果字串和這些都不匹配,將使用"private"。這個選項設定為NULL時將禁用KRB4 安全認證。目前KRB4 安全認證只能用於FTP傳輸。 CURLOPT_POSTFIELDS 全部資料使用HTTP協議中的"POST"操作來發送。要傳送檔案,在檔名前面加上@字首並使用完整路徑。這個引數可以通過urlencoded後的字串類似'para1=val1¶2=val2&...'或使用一個以欄位名為鍵值,欄位資料為值的陣列。如果value是一個數組,Content-Type頭將會被設定成multipart/form-data。 CURLOPT_PROXY HTTP代理通道。 CURLOPT_PROXYUSERPWD 一個用來連線到代理的"[username]:[password]"格式的字串。 CURLOPT_RANDOM_FILE 一個被用來生成SSL隨機數種子的檔名。 CURLOPT_RANGE 以"X-Y"的形式,其中X和Y都是可選項獲取資料的範圍,以位元組計。HTTP傳輸執行緒也支援幾個這樣的重複項中間用逗號分隔如"X-Y,N-M"。 CURLOPT_REFERER 在HTTP請求頭中"Referer: "的內容。 CURLOPT_SSL_CIPHER_LIST 一個SSL的加密演算法列表。例如RC4-SHA和TLSv1都是可用的加密列表。 CURLOPT_SSLCERT 一個包含PEM格式證書的檔名。 CURLOPT_SSLCERTPASSWD 使用CURLOPT_SSLCERT證書需要的密碼。 CURLOPT_SSLCERTTYPE 證書的型別。支援的格式有"PEM" (預設值), "DER"和"ENG"。在cURL 7.9.3中被加入。 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請求中包含一個"User-Agent: "頭的字串。 CURLOPT_USERPWD 傳遞一個連線中需要的使用者名稱和密碼,格式為:"[username]:[password]"。 對於下面的這些option的可選引數,value應該被設定一個數組: CURLOPT_HTTP200ALIASES 200響應碼陣列,陣列中的響應嗎被認為是正確的響應,否則被認為是錯誤的。在cURL 7.10.3中被加入。 CURLOPT_HTTPHEADER 一個用來設定HTTP頭欄位的陣列。使用如下的形式的陣列進行設定: array('Content-type: text/plain', 'Content-length: 100') CURLOPT_POSTQUOTE 在FTP請求執行完成後,在伺服器上執行的一組FTP命令。 CURLOPT_QUOTE 一組先於FTP請求的在伺服器上執行的FTP命令。 對於下面的這些option的可選引數,value應該被設定一個流資源 (例如使用fopen()): CURLOPT_FILE 設定輸出檔案的位置,值是一個資源型別,預設為STDOUT (瀏覽器)。 CURLOPT_INFILE 在上傳檔案的時候需要讀取的檔案地址,值是一個資源型別。 CURLOPT_STDERR 設定一個錯誤輸出地址,值是一個資源型別,取代預設的STDERR。 CURLOPT_WRITEHEADER 設定header部分內容的寫入的檔案地址,值是一個資源型別。 對於下面的這些option的可選引數,value應該被設定為一個回撥函式名: CURLOPT_HEADERFUNCTION 設定一個回撥函式,這個函式有兩個引數,第一個是cURL的資源控制代碼,第二個是輸出的header資料。header資料的輸出必須依賴這個函式,返回已寫入的資料大小。 CURLOPT_PASSWDFUNCTION 設定一個回撥函式,有三個引數,第一個是cURL的資源控制代碼,第二個是一個密碼提示符,第三個引數是密碼長度允許的最大值。返回密碼的值。 CURLOPT_PROGRESSFUNCTION 設定一個回撥函式,有三個引數,第一個是cURL的資源控制代碼,第二個是一個檔案描述符資源,第三個是長度。返回包含的資料。 CURLOPT_READFUNCTION 回撥函式名。該函式應接受三個引數。第一個是 cURL resource;第二個是通過選項 CURLOPT_INFILE 傳給 cURL 的 stream resource;第三個引數是最大可以讀取的資料的數量。回 調函式必須返回一個字串,長度小於或等於請求的資料量(第三個引數)。一般從傳入的 stream resource 讀取。返回空字串作為 EOF(檔案結束) 訊號。 CURLOPT_WRITEFUNCTION 回撥函式名。該函式應接受兩個引數。第一個是 cURL resource;第二個是要寫入的資料字串。數 據必須在函式中被儲存。函式必須返回準確的傳入的要寫入資料的位元組數,否則傳輸會被一個錯誤所中 斷。 這個函式成功時返回 TRUE, 或者在失敗時返回 FALSE。