curl_close — 關閉一個curl會話
curl_copy_handle — 拷貝一個curl連接資源的所有內容和參數
curl_errno — 傳回一個包含目前會話錯誤訊息的數字編號
curl_error — 傳回一個包含目前會話錯誤訊息的字串
curl_exec — 執行一個curl會話
curl_getinfo — 取得一個curl連線資源句柄的信息
curl_init — 初始化一個curl會話
curl_multi_add_handle — 在curl批次會話中新增單獨的curl句柄資源
curl_multi_close — 關閉一個批次句柄資源
curl_multi_exec — 解析一個curl批次句柄
curl_multi_getcontent — 傳回所取得的輸出的文字流
curl_multi_info_read — 取得目前解析的curl的相關傳輸訊息
curl_multi_init — 初始化一個curl批次句柄資源
curl_multi_remove_handle — 移除curl批次處理句柄資源中的某個句柄資源
curl_multi_select — Get all the sockets associated with the cURL extension, which can then be "selected"
curl_setopt_array — 以陣列的形式為一個curl設定會話參數
curl_setopt — 為一個curl設定會話參數
curl_version — 獲取curl相關的版本信息
curl_init()函數的作用初始化一個curl會話,curl_init()函數唯一的參數是可選的,表示一個url位址。
curl_exec()函數的作用是執行一個curl會話,唯一的參數是curl_init()函數傳回的句柄。
curl_close()函數的作用是關閉一個curl會話,唯一的參數是curl_init()函數傳回的句柄。
<?php
$ch = curl_init(" http://www.baidu.com/ ");
curl_exec($ch);
curl_close($ch);
?>
curl_version()函數的作用是取得curl相關的版本訊息,curl_version()函數有一個參數,不清楚是做什麼的
<?php
print_r(curl_version())
?>
curl_getinfo()函數的作用是取得一個curl連接資源句柄的信息,curl_getinfo()函數有兩個參數,第一個參數是curl的資源句柄,第二個參數是下面一些常數:
<?php
$ch = curl_init(" http://www.baidu.com/ ");
print_r(curl_getinfo($ch));
?>
可選的常數包括:
CURLINFO_EFFECTIVE_URL
最後一個有效的url位址
CURLINFO_HTTP_CODE
最後一個收到的HTTP程式碼
CURLINFO_FILETIME
遠端取得文件的時間,如果無法取得,則傳回值為“-1”
CURLINFO_TOTAL_TIME
最後一次傳輸所消耗的時間
CURLINFO_NAMELOOKUP_TIME
名稱解析所消耗的時間
CURLINFO_CONNECT_TIME
建立連線所消耗的時間
CURLINFO_PRETRANSFER_TIME
從建立連線到準備傳輸所使用的時間
CURLINFO_STARTTRANSFER_TIME
從建立連線到傳輸開始所使用的時間
CURLINFO_REDIRECT_TIME
在交易傳輸開始前重定向所使用的時間
CURLINFO_SIZE_UPLOAD
上傳資料量的總值
CURLINFO_SIZE_DOWNLOAD
下載資料量的總值
CURLINFO_SPEED_DOWNLOAD
平均下載速度
CURLINFO_SPEED_UPLOAD
平均上傳速度
CURLINFO_HEADER_SIZE
header部分的大小
CURLINFO_HEADER_OUT
發送請求的字串
CURLINFO_REQUEST_SIZE
在HTTP請求中有問題的請求的大小
CURLINFO_SSL_VERIFYRESULT
Result of SSL certification verification requested by setting CURLOPT_SSL_VERIFYPEER
CURLINFO_CONTENT_LENGTH_DOWNLOAD
從Content-Length: field讀取的下載內容長度
CURLINFO_CONTENT_LENGTH_UPLOAD
上傳內容大小的說明
CURLINFO_CONTENT_TYPE
下載內容的“Content-type”值,NULL表示伺服器沒有發送有效的“Content-Type: header”
curl_setopt()函數的作用是為一個curl設定會話參數。 curl_setopt_array()函數的作用是以陣列的形式為一個curl設定會話參數。
<?php
$ch = curl_init();
$fp = fopen("example_homepage.txt", "w");
curl_setopt($ch, CURLOPT_FILE, $fp);
$options = array(
CURLOPT_URL => 'http://www.baidu.com/',
CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
curl_exec($ch);
curl_close($ch);
fclose($fp);
?>
可設定的參數有:
CURLOPT_AUTOREFERER
自動設定header中的referer訊息
CURLOPT_BINARYTRANSFER
在啟用CURLOPT_RETURNTRANSFER時候將取得資料傳回
CURLOPT_COOKIESESSION
啟用時curl會只是傳遞一個session cookie,忽略其他的cookie,預設狀況下curl會將所有的cookie回傳給服務端。 session cookie是指那些用來判斷伺服器端的session是否有效而存在的cookie。
CURLOPT_CRLF
啟用時將Unix的換行符號轉換成回車換行符。
CURLOPT_DNS_USE_GLOBAL_CACHE
啟用時會啟用一個全域的DNS緩存,此項目為線程安全的,並且預設為true。
CURLOPT_FAILONERROR
顯示HTTP狀態碼,預設行為是忽略編號小於等於400的HTTP訊息
CURLOPT_FILETIME
啟用時會嘗試修改遠端文檔中的資訊。結果資訊會透過curl_getinfo()函數的CURLINFO_FILETIME選項傳回。
CURLOPT_FOLLOWLOCATION
啟用時會將伺服器伺服器傳回的「Location:」放在header中遞迴的傳回給伺服器,使用CURLOPT_MAXREDIRS可以限定遞迴回傳的數量。
CURLOPT_FORBID_REUSE
在完成交互以後強迫斷開連接,不能重複使用。
CURLOPT_FRESH_CONNECT
強制取得一個新的連接,取代快取中的連接。
CURLOPT_FTP_USE_EPRT
TRUE to use EPRT (and LPRT) when doing active FTP downloads. Use FALSE to disable EPRT and LPRT and use PORT only.
Added in PHP 5.0.0.
CURLOPT_FTP_USE_EPSV
TRUE to first try an EPSV command for FTP transfers before reverting back to PASV. Set to FALSE to disable EPSV.
CURLOPT_FTPAPPEND
TRUE to append to the remote file instead of overwriting it.
CURLOPT_FTPASCII
An alias of CURLOPT_TRANSFERTEXT. Use that instead.
CURLOPT_FTPLISTONLY
TRUE to only list the names of an FTP directory.
CURLOPT_HEADER
啟用時會將頭檔的資訊作為資料流輸出。
CURLOPT_HTTPGET
啟用時會設定HTTP的method為GET,因為GET是預設是,所以只在被修改的情況下使用。
CURLOPT_HTTPPROXYTUNNEL
啟用時會透過HTTP代理來傳輸。
CURLOPT_MUTE
講curl函數中所有修改過的參數恢復預設值。
CURLOPT_NETRC
在連接建立以後,訪問~/.netrc檔案取得使用者名稱和密碼資訊連接遠端站點。
CURLOPT_NOBODY
啟用時將不對HTML中的body部分進行輸出。
CURLOPT_NOPROGRESS
啟用時關閉curl傳輸的進度條,此項目的預設為true
CURLOPT_NOSIGNAL
啟用時忽略所有的curl傳遞給php進行的訊號。在SAPI多執行緒傳輸時此項目被預設為開啟。
CURLOPT_POST
啟用時會傳送一個常規的POST請求,類型為:application/x-www-form-urlencoded,就像表單提交的一樣。
CURLOPT_PUT
啟用時允許HTTP傳送文件,必須同時設定CURLOPT_INFILE和CURLOPT_INFILESIZE
CURLOPT_RETURNTRANSFER
講curl_exec()取得的資訊以檔案流的形式傳回,而不是直接輸出。
CURLOPT_SSL_VERIFYPEER
FALSE to stop cURL from verifying the peer's certificate. Alternate certificates to verify against can be specified with the CURLOPT_CAINFO option or a certificate directory can be specified with the CURPT_CAPUEATH option CURPTSwid AURS 707f fWwid TRPTPT_CAPATH option URf nV 7P. PT_SSL_VERIFYPEER is disabled (it defaults至 2). TRUE by default as of cURL 7.10. Default bundle installed as of cURL 7.10.
CURLOPT_TRANSFERTEXT
TRUE to use ASCII mode for FTP transfers. For LDAP, it retrieves data in plain text instead of HTML. On Windows systems, it will not set STDOUT to binary mode.
CURLOPT_UNRESTRICTED_AUTH
在使用CURLOPT_FOLLOWLOCATION產生的header中的多個locations中持續追加使用者名稱和密碼信息,即使網域已改變。
CURLOPT_UPLOAD
啟用時允許檔案傳輸
CURLOPT_VERBOSE
啟用時會報告所有的信息,存放在STDERR或指定的CURLOPT_STDERR中
CURLOPT_BUFFERSIZE
每次取得的資料中讀入快取的大小,這個值每次都會被填滿。
CURLOPT_CLOSEPOLICY
不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,還有另外三個,但curl暫時還不支援。 .
CURLOPT_CONNECTTIMEOUT
在發起連線前等待的時間,如果設定為0,則不等待。
CURLOPT_DNS_CACHE_TIMEOUT
設定在記憶體中保存DNS資訊的時間,預設為120秒。
CURLOPT_FTPSSLAUTH
The FTP authentication method (when is activated): CURLFTPAUTH_SSL (try SSL first), CURLFTPAUTH_TLS (try TLS first), or CURLFTPAUTH_DEFAULT (let cURL decide).
CURLOPT_HTTP_VERSION
設定curl使用的HTTP協議,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讓伺服器選擇一個支援最好的值,CURL於CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM,CURLAUTH_ANYSAFE等價於CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM
CURLOPT_INFILESIZE
設定上傳檔案的大小
CURLOPT_LOW_SPEED_LIMIT
當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時,PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_LOW_SPEED_TIME
The number of seconds the transfer should be below CURLOPT_LOW_SPEED_LIMIT for PHP to consider the transfer too slow and abort.
當傳輸速度小於CURLOPT_LOW_SPEED_LIMIT時,PHP會根據CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_MAXCONNECTS
允許的最大連接數量,超過是會透過CURLOPT_CLOSEPOLICY決定應該停止哪些連接
CURLOPT_MAXREDIRS
指定最多的HTTP重定向的數量,這個選項是和CURLOPT_FOLLOWLOCATION一起使用的。
CURLOPT_PORT
一個可選的用來指定連接埠的量
CURLOPT_PROXYAUTH
The HTTP authentication method(s) to use for the proxy connection. Use the same bitmasks as described in CURLOPT_HTTPAUTH. For proxy authentication, only CURLAUTH_BASIC and CURLAUTH_NTLM are currently supported.
CURLOPT_PROXYPORT
The port number of the proxy to connect to. This port number can also be set in CURLOPT_PROXY.
CURLOPT_PROXYTYPE
Either CURLPROXY_HTTP (default) or CURLPROXY_SOCKS5.
CURLOPT_RESUME_FROM
在恢復傳輸時傳遞一個位元組偏移量(用來斷點續傳)
CURLOPT_SSL_VERIFYHOST
1 to check the existence of a common name in the SSL peer certificate.
2 to check the existence of a common name and also verify that it matches the hostname provided.
CURLOPT_SSLVERSION
The SSL version (2 或 3) to use. By default PHP will try to determine this itself, although in some cases this must be set manually.
CURLOPT_TIMECONDITION
如果在CURLOPT_TIMEVALUE指定的某個時間以後被編輯過,則使用CURL_TIMECOND_IFMODSINCE返回頁面,如果沒有被修改過,並且CURLOPT_HEADER為true,則傳回一個"304 Not Modified"的header,CURLOPT_HEADER為false,則使用CU_RL_TIME值為CURL_TIMECOND_IFMODSINCE
CURLOPT_TIMEOUT
設定curl允許執行的最長秒數
CURLOPT_TIMEVALUE
設定一個CURLOPT_TIMECONDITION使用的時間戳,在預設狀態下使用的是CURL_TIMECOND_IFMODSINCE
CURLOPT_CAINFO
The name of a file holding one or more certificates to verify the peer with. This only makes sense when used in combination with CURLOPT_SSL_VERIFYPEER.
CURLOPT_CAPATH
A directory that holds multiple CA certificates. Use this option alongside CURLOPT_SSL_VERIFYPEER.
CURLOPT_COOKIE
設定HTTP請求中「Set-Cookie:」部分的內容。
CURLOPT_COOKIEFILE
包含cookie資訊的檔案名稱,這個cookie檔案可以是Netscape格式或是HTTP風格的header資訊。
CURLOPT_COOKIEJAR
連線關閉以後,存放cookie資訊的檔案名稱
CURLOPT_CUSTOMREQUEST
A custom request method to use instead of "GET" or "HEAD" when doing a HTTP request. This is useful for doing "DELETE" or other, more obscure HTTP requests. Valid values are things like "GET", " "CONNECT" and so on; ie Do not enter a whole HTTP request line here. For instance, entering "GET /index.html HTTP/1.0rnrn" would be incorrect.
Note: Don't do this without making sure the server supports the custom request method first.
CURLOPT_EGBSOCKET
Like CURLOPT_RANDOM_FILE, except a filename to an Entropy Gathering Daemon socket.
CURLOPT_ENCODING
header中「Accept-Encoding: 」部分的內容,支援的編碼格式為:"identity","deflate","gzip"。如果設定為空字串,則表示支援所有的編碼格式
CURLOPT_FTPPORT
The value which will be used to get the IP address to use for the FTP "POST" instruction. The "POST" instruction tells the remote server to connect to our specified IP address. The string may be a plain IP address, a hostname, IP address. The string may be a plain IP address, a hostname, IP address. The string may be a plain IP address, a hostname, IP address. a network interface name (under Unix), or just a plain '-' to use the systems default IP address.
CURLOPT_INTERFACE
在外部網路介面中使用的名稱,可以是一個介面名,IP或是主機名。
CURLOPT_KRB4LEVEL
KRB4(Kerberos 4)安全等級的設置,可以是一下幾個值之一:"clear","safe","confidential","private"。預設的值為"private",設定為null的時候表示禁用KRB4,現在KRB4安全只能在FTP傳輸中使用。
CURLOPT_POSTFIELDS
在HTTP中的「POST」操作。如果要傳送一個文件,需要一個@開頭的文件名
CURLOPT_PROXY
設定通過的HTTP代理伺服器
CURLOPT_PROXYUSERPWD
連接到代理伺服器的,格式為「[username]:[password]」的使用者名稱和密碼。
CURLOPT_RANDOM_FILE
設定存放SSL用到的隨機數種子的檔案名稱
CURLOPT_RANGE
設定HTTP傳輸範圍,可以用「XY」的形式設定一個傳輸區間,如果有多個HTTP傳輸,則使用逗號分隔多個值,形狀如:"XY,NM"。
CURLOPT_REFERER
設定header中"Referer: " 部分的值。
CURLOPT_SSL_CIPHER_LIST
A list of ciphers to use for SSL. For example, RC4-SHA and TLSv1 are valid cipher lists.
CURLOPT_SSLCERT
傳遞一個包含PEM格式憑證的字串。
CURLOPT_SSLCERTPASSWD
傳遞一個包含使用CURLOPT_SSLCERT憑證必需的密碼。
CURLOPT_SSLCERTTYPE
The format of the certificate. Supported formats are "PEM" (default), "DER", and "ENG".
CURLOPT_SSLENGINE
The identifier for the crypto engine of the private SSL key specified in CURLOPT_SSLKEY.
CURLOPT_SSLENGINE_DEFAULT
The identifier for the crypto engine used for asymmetric crypto operations.
CURLOPT_SSLKEY
The name of a file containing a private SSL key.
CURLOPT_SSLKEYPASSWD
The secret password needed to use the private SSL key specified in CURLOPT_SSLKEY.
Note: Since this option contains a sensitive password, remember to keep the PHP script it is contained within safe.
CURLOPT_SSLKEYTYPE
The key type of the private SSL key specified in CURLOPT_SSLKEY. Supported key types are "PEM" (default), "DER", and "ENG".
CURLOPT_URL
需要取得的URL位址,也可以在PHP的curl_init()函數中設定。
CURLOPT_USERAGENT
在HTTP請求中包含一個”user-agent”頭的字串。
CURLOPT_USERPWD
傳遞一個連線中所需的使用者名稱和密碼,格式為:「[username]:[password]」。
CURLOPT_HTTP200ALIASES
設定不再以error的形式來處理HTTP 200的回應,格式為一個陣列。
CURLOPT_HTTPHEADER
設定一個header中傳輸內容的陣列。
CURLOPT_POSTQUOTE
An array of FTP commands to execute on the server after the FTP request 有 been performed.
CURLOPT_QUOTE
An array of FTP commands to execute on the server prior to the FTP request.
CURLOPT_FILE
設定輸出檔案的位置,值是一個資源類型,預設為STDOUT (瀏覽器)。
CURLOPT_INFILE
在上傳檔案的時候需要讀取的檔案位址,值是一個資源型別。
CURLOPT_STDERR
設定一個錯誤輸出位址,值是資源類型,取代預設的STDERR。
CURLOPT_WRITEHEADER
設定header部分內容的寫入的檔案位址,值是一個資源類型。
CURLOPT_HEADERFUNCTION
設定一個回呼函數,這個函數有兩個參數,第一個是curl的資源句柄,第二個是輸出的header資料。 header資料的輸出必須依賴這個函數,傳回已寫入的資料大小。
CURLOPT_PASSWDFUNCTION
設定一個回呼函數,有三個參數,第一個是curl的資源句柄,第二個是一個密碼提示符,第三個參數是密碼長度允許的最大值。傳回密碼的值。
CURLOPT_READFUNCTION
設定一個回呼函數,有兩個參數,第一個是curl的資源句柄,第二個是讀取的資料。資料讀取必須依賴這個函數。傳回讀取資料的大小,例如0或EOF。
CURLOPT_WRITEFUNCTION
設定一個回呼函數,有兩個參數,第一個是curl的資源句柄,第二個是寫入的資料。資料寫入必須依賴這個函數。傳回精確的已寫入資料的大小
curl_copy_handle()函數的作用是拷貝一個curl連接資源的所有內容和參數
<?php
$ch = curl_init(" http://www.baidu.com/ ");
$another = curl_copy_handle($ch);
curl_exec($another);
curl_close($another);
?>
curl_error()函數的作用是傳回一個包含目前會話錯誤訊息的字串。
curl_errno()函數的作用是傳回一個包含目前會話錯誤訊息的數字編號。
curl_multi_init()函數的作用是初始化一個curl批次句柄資源。
curl_multi_add_handle()函數的作用是向curl批次會話中新增單獨的curl句柄資源。 curl_multi_add_handle()函數有兩個參數,第一個參數表示一個curl批次句柄資源,第二個參數表示一個單獨的curl句柄資源。
curl_multi_exec()函數的作用是解析一個curl批次句柄,curl_multi_exec()函數有兩個參數,第一個參數表示一個批次句柄資源,第二個參數是一個引用值的參數,表示剩餘需要處理的單一的curl句柄資源數量。
curl_multi_remove_handle() 函數表示移除curl批次處理句柄資源中的某個句柄資源,curl_multi_remove_handle()函數有兩個參數,第一個參數表示一個curl批次句柄資源,第二個參數表示一個單獨的curl句柄資源。
curl_multi_close()函數的作用是關閉一個批次句柄資源。
<?php
$ch1 = curl_init();
$ch2 = curl_init();
curl_setopt($ch1, CURLOPT_URL, " http://www.baidu.com/ ");
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, " http://www.google.com/ ");
curl_setopt($ch2, CURLOPT_HEADER, 0);
$mh = curl_multi_init();
curl_multi_add_handle($mh,$ch1);
curl_multi_add_handle($mh,$ch2);
do {
curl_multi_exec($mh,$flag);
} while ($flag > 0);
curl_multi_remove_handle($mh,$ch1);
curl_multi_remove_handle($mh,$ch2);
curl_multi_close($mh);
?>
curl_multi_getcontent()函數的作用是在設定了CURLOPT_RETURNTRANSFER的情況下,傳回所取得的輸出的文字流。
curl_multi_info_read()函數的作用是取得目前解析的curl的相關傳輸資訊。
curl_multi_select()
Get all the sockets associated with the cURL extension, which can then be "selected"