PHP 菜鳥教程

PHP 高級(jí)教程

PHP & MySQL

PHP 參考手冊

PHP curl_setopt() 函數(shù)用法及示例

PHP CURL參考手冊

(PHP 4 >= 4.0.2, PHP 5)

curl_setopt — 設(shè)置一個(gè)CURL傳輸選項(xiàng)。

語法

bool curl_setopt ( resource $ch , int $option , mixed $value )

為給定的CURL會(huì)話句柄設(shè)置一個(gè)選項(xiàng)。

參數(shù)

ch

由 curl_init() 返回的 CURL 句柄。

option

需要設(shè)置的CURLOPT_XXX選項(xiàng)。

value

將設(shè)置在option選項(xiàng)上的值。

對(duì)于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個(gè)bool類型的值:

選項(xiàng)可選value備注
CURLOPT_AUTOREFERER當(dāng)根據(jù)Location:重定向時(shí),自動(dòng)設(shè)置header中的Referer:信息。
CURLOPT_BINARYTRANSFER在啟用CURLOPT_RETURNTRANSFER的時(shí)候,返回原生的(Raw)輸出。
CURLOPT_COOKIESESSION啟用時(shí)curl會(huì)僅僅傳遞一個(gè)session cookie,忽略其他的cookie,默認(rèn)狀況下CURL會(huì)將所有的cookie返回給服務(wù)端。session cookie是指那些用來判斷服務(wù)器端的session是否有效而存在的cookie。
CURLOPT_CRLF啟用時(shí)將Unix的換行符轉(zhuǎn)換成回車換行符。
CURLOPT_DNS_USE_GLOBAL_CACHE啟用時(shí)會(huì)啟用一個(gè)全局的DNS緩存,此項(xiàng)為線程安全的,并且默認(rèn)啟用。
CURLOPT_FAILONERROR顯示HTTP狀態(tài)碼,默認(rèn)行為是忽略編號(hào)小于等于400的HTTP信息。
CURLOPT_FILETIME啟用時(shí)會(huì)嘗試修改遠(yuǎn)程文檔中的信息。結(jié)果信息會(huì)通過curl_getinfo()函數(shù)的CURLINFO_FILETIME選項(xiàng)返回。            curl_getinfo().
CURLOPT_FOLLOWLOCATION啟用時(shí)會(huì)將服務(wù)器服務(wù)器返回的"Location: "放在header中遞歸的返回給服務(wù)器,使用CURLOPT_MAXREDIRS可以限定遞歸返回的數(shù)量。
CURLOPT_FORBID_REUSE在完成交互以后強(qiáng)迫斷開連接,不能重用。
CURLOPT_FRESH_CONNECT強(qiáng)制獲取一個(gè)新的連接,代替緩存中的連接。
CURLOPT_FTP_USE_EPRT啟用時(shí)當(dāng)FTP下載時(shí),使用EPRT (或 LPRT)命令。設(shè)置為FALSE時(shí)禁用EPRT和LPRT,使用PORT命令            only.
CURLOPT_FTP_USE_EPSV啟用時(shí),在FTP傳輸過程中回復(fù)到PASV模式前首先嘗試EPSV命令。設(shè)置為FALSE時(shí)禁用EPSV命令。
CURLOPT_FTPAPPEND啟用時(shí)追加寫入文件而不是覆蓋它。
CURLOPT_FTPASCIICURLOPT_TRANSFERTEXT的別名。
CURLOPT_FTPLISTONLY啟用時(shí)只列出FTP目錄的名字。
CURLOPT_HEADER啟用時(shí)會(huì)將頭文件的信息作為數(shù)據(jù)流輸出。
CURLINFO_HEADER_OUT啟用時(shí)追蹤句柄的請(qǐng)求字符串。從 PHP 5.1.3 開始可用。CURLINFO_前綴是故意的(intentional)。
CURLOPT_HTTPGET啟用時(shí)會(huì)設(shè)置HTTP的method為GET,因?yàn)镚ET是默認(rèn)是,所以只在被修改的情況下使用。
CURLOPT_HTTPPROXYTUNNEL啟用時(shí)會(huì)通過HTTP代理來傳輸。
CURLOPT_MUTE啟用時(shí)將CURL函數(shù)中所有修改過的參數(shù)恢復(fù)默認(rèn)值。
CURLOPT_NETRC在連接建立以后,訪問~/.netrc文件獲取用戶名和密碼信息連接遠(yuǎn)程站點(diǎn)。
CURLOPT_NOBODY啟用時(shí)將不對(duì)HTML中的BODY部分進(jìn)行輸出。
CURLOPT_NOPROGRESS

啟用時(shí)關(guān)閉curl傳輸?shù)倪M(jìn)度條,此項(xiàng)的默認(rèn)設(shè)置為啟用。

Note:

PHP自動(dòng)地設(shè)置這個(gè)選項(xiàng)為TRUE,這個(gè)選項(xiàng)僅僅應(yīng)當(dāng)在以調(diào)試為目的時(shí)被改變。


CURLOPT_NOSIGNAL啟用時(shí)忽略所有的curl傳遞給php進(jìn)行的信號(hào)。在SAPI多線程傳輸時(shí)此項(xiàng)被默認(rèn)啟用。CURL 7.10時(shí)被加入。
CURLOPT_POST啟用時(shí)會(huì)發(fā)送一個(gè)常規(guī)的POST請(qǐng)求,類型為:application/x-www-form-urlencoded,就像表單提交的一樣。
CURLOPT_PUT啟用時(shí)允許HTTP發(fā)送文件,必須同時(shí)設(shè)置CURLOPT_INFILECURLOPT_INFILESIZE。
CURLOPT_RETURNTRANSFER將curl_exec()獲取的信息以文件流的形式返回,而不是直接輸出。
CURLOPT_SSL_VERIFYPEER禁用后CURL將終止從服務(wù)端進(jìn)行驗(yàn)證。使用CURLOPT_CAINFO選項(xiàng)設(shè)置證書使用CURLOPT_CAPATH選項(xiàng)設(shè)置證書目錄            如果CURLOPT_SSL_VERIFYPEER(默認(rèn)值為2)被啟用,CURLOPT_SSL_VERIFYHOST需要被設(shè)置成TRUE否則設(shè)置為FALSE自CURL 7.10開始默認(rèn)為TRUE。從CURL 7.10開始默認(rèn)綁定安裝。
CURLOPT_TRANSFERTEXT啟用后對(duì)FTP傳輸使用ASCII模式。對(duì)于LDAP,它檢索純文本信息而非HTML。在Windows系統(tǒng)上,系統(tǒng)不會(huì)把STDOUT設(shè)置成binary模式。
CURLOPT_UNRESTRICTED_AUTH在使用CURLOPT_FOLLOWLOCATION產(chǎn)生的header中的多個(gè)locations中持續(xù)追加用戶名和密碼信息,即使域名已發(fā)生改變。
CURLOPT_UPLOAD啟用后允許文件上傳。
CURLOPT_VERBOSE啟用時(shí)會(huì)匯報(bào)所有的信息,存放在STDERR或指定的CURLOPT_STDERR中。

對(duì)于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個(gè)integer類型的值:

選項(xiàng)可選value備注
CURLOPT_BUFFERSIZE每次獲取的數(shù)據(jù)中讀入緩存的大小,但是不保證這個(gè)值每次都會(huì)被填滿。在CURL 7.10中被加入。
CURLOPT_CLOSEPOLICY不是CURLCLOSEPOLICY_LEAST_RECENTLY_USED就是CURLCLOSEPOLICY_OLDEST,還存在另外三個(gè)CURLCLOSEPOLICY,但是CURL暫時(shí)還不支持。
CURLOPT_CONNECTTIMEOUT在發(fā)起連接前等待的時(shí)間,如果設(shè)置為0,則無限等待。
CURLOPT_CONNECTTIMEOUT_MS嘗試連接等待的時(shí)間,以毫秒為單位。如果設(shè)置為0,則無限等待。在CURL 7.16.2中被加入。從PHP 5.2.3開始可用。
CURLOPT_DNS_CACHE_TIMEOUT設(shè)置在內(nèi)存中保存DNS信息的時(shí)間,默認(rèn)為120秒。
CURLOPT_FTPSSLAUTHFTP驗(yàn)證方式:CURLFTPAUTH_SSL (首先嘗試SSL),CURLFTPAUTH_TLS (首先嘗試TLS)或CURLFTPAUTH_DEFAULT (讓CURL自動(dòng)決定)。在CURL 7.12.2中被加入。
CURLOPT_HTTP_VERSIONCURL_HTTP_VERSION_NONE (默認(rèn)值,讓CURL自己判斷使用哪個(gè)版本),CURL_HTTP_VERSION_1_0 (強(qiáng)制使用 HTTP/1.0)或CURL_HTTP_VERSION_1_1 (強(qiáng)制使用 HTTP/1.1)。
CURLOPT_INFILESIZE設(shè)定上傳文件的大小限制,字節(jié)(byte)為單位。
CURLOPT_LOW_SPEED_LIMIT當(dāng)傳輸速度小于CURLOPT_LOW_SPEED_LIMIT時(shí)(bytes/sec),PHP會(huì)根據(jù)CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_LOW_SPEED_TIME當(dāng)傳輸速度小于CURLOPT_LOW_SPEED_LIMIT時(shí)(bytes/sec),PHP會(huì)根據(jù)CURLOPT_LOW_SPEED_TIME來判斷是否因太慢而取消傳輸。
CURLOPT_MAXCONNECTS允許的最大連接數(shù)量,超過是會(huì)通過CURLOPT_CLOSEPOLICY決定應(yīng)該停止哪些連接。
CURLOPT_MAXREDIRS指定最多的HTTP重定向的數(shù)量,這個(gè)選項(xiàng)是和CURLOPT_FOLLOWLOCATION一起使用的。
CURLOPT_PORT用來指定連接端口。(可選項(xiàng))
CURLOPT_PROTOCOLSCURLPROTO_*的位域指。如果被啟用,位域值會(huì)限定libcurl在傳輸過程中有哪些可使用的協(xié)議。這將允許你在編譯libcurl時(shí)支持眾多協(xié)議,但是限制只是用它們中被允許使用的一個(gè)子集。默認(rèn)libcurl將會(huì)使用全部它支持的協(xié)議。參見CURLOPT_REDIR_PROTOCOLS.可用的協(xié)議選項(xiàng)為: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_PROTOCOLSCURLPROTO_*的位域指。如果被啟用,位域值會(huì)限定libcurl在傳輸過程中有哪些可使用的協(xié)議。這將允許你在編譯libcurl時(shí)支持眾多協(xié)議,但是限制只是用它們中被允許使用的一個(gè)子集。默認(rèn)libcurl將會(huì)使用全部它支持的協(xié)議。參見CURLOPT_REDIR_PROTOCOLS.可用的協(xié)議選項(xiàng)為: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_PROXYAUTHHTTP代理連接的驗(yàn)證方式。使用在CURLOPT_HTTPAUTH中的位域標(biāo)志來設(shè)置相應(yīng)選項(xiàng)。對(duì)于代理驗(yàn)證只有CURLAUTH_BASICCURLAUTH_NTLM當(dāng)前被支持。在CURL 7.10.7中被加入。
CURLOPT_PROXYPORT代理服務(wù)器的端口。端口也可以在CURLOPT_PROXY中進(jìn)行設(shè)置。
CURLOPT_PROXYTYPE不是CURLPROXY_HTTP (默認(rèn)值) 就是CURLPROXY_SOCKS5。在CURL 7.10中被加入。
CURLOPT_REDIR_PROTOCOLSCURLPROTO_*中的位域值。如果被啟用,位域值將會(huì)限制傳輸線程在CURLOPT_FOLLOWLOCATION開啟時(shí)跟隨某個(gè)重定向時(shí)可使用的協(xié)議。這將使你對(duì)重定向時(shí)限制傳輸線程使用被允許的協(xié)議子集默認(rèn)libcurl將會(huì)允許除FILE和SCP之外的全部協(xié)議。這個(gè)和7.19.4預(yù)發(fā)布版本種無條件地跟隨所有支持的協(xié)議有一些不同。關(guān)于協(xié)議常量,請(qǐng)參照CURLOPT_PROTOCOLS。在CURL 7.19.4中被加入。
CURLOPT_RESUME_FROM在恢復(fù)傳輸時(shí)傳遞一個(gè)字節(jié)偏移量(用來斷點(diǎn)續(xù)傳)。
CURLOPT_SSL_VERIFYHOST1 檢查服務(wù)器SSL證書中是否存在一個(gè)公用名(common name)。譯者注:公用名(Common Name)一般來講就是填寫你將要申請(qǐng)SSL證書的域名 (domain)或子域名(sub domain)。2 檢查公用名是否存在,并且是否與提供的主機(jī)名匹配。
CURLOPT_SSLVERSION使用的SSL版本(2 或 3)。默認(rèn)情況下PHP會(huì)自己檢測這個(gè)值,盡管有些情況下需要手動(dòng)地進(jìn)行設(shè)置。
CURLOPT_TIMECONDITION如果在CURLOPT_TIMEVALUE指定的某個(gè)時(shí)間以后被編輯過,則使用CURL_TIMECOND_IFMODSINCE返回頁面,如果沒有被修改過,并且CURLOPT_HEADER為true,則返回一個(gè)"304 Not Modified"的header,    CURLOPT_HEADER為false,則使用CURL_TIMECOND_IFUNMODSINCE,默認(rèn)值為CURL_TIMECOND_IFUNMODSINCE。
CURLOPT_TIMEOUT設(shè)置CURL允許執(zhí)行的最長秒數(shù)。
CURLOPT_TIMEOUT_MS設(shè)置CURL允許執(zhí)行的最長毫秒數(shù)。在CURL 7.16.2中被加入。從PHP 5.2.3起可使用。
CURLOPT_TIMEVALUE設(shè)置一個(gè)CURLOPT_TIMECONDITION使用的時(shí)間戳,在默認(rèn)狀態(tài)下使用的是CURL_TIMECOND_IFMODSINCE。

對(duì)于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個(gè)string類型的值:

選項(xiàng)可選value備注
CURLOPT_CAINFO一個(gè)保存著1個(gè)或多個(gè)用來讓服務(wù)端驗(yàn)證的證書的文件名。這個(gè)參數(shù)僅僅在和CURLOPT_SSL_VERIFYPEER一起使用時(shí)才有意義。            .
CURLOPT_CAPATH一個(gè)保存著多個(gè)CA證書的目錄。這個(gè)選項(xiàng)是和CURLOPT_SSL_VERIFYPEER一起使用的。
CURLOPT_COOKIE設(shè)定HTTP請(qǐng)求中"Cookie: "部分的內(nèi)容。多個(gè)cookie用分號(hào)分隔,分號(hào)后帶一個(gè)空格(例如, "fruit=apple; colour=red")。
CURLOPT_COOKIEFILE包含cookie數(shù)據(jù)的文件名,cookie文件的格式可以是Netscape格式,或者只是純HTTP頭部信息存入文件。
CURLOPT_COOKIEJAR連接結(jié)束后保存cookie信息的文件。
CURLOPT_CUSTOMREQUEST

使用一個(gè)自定義的請(qǐng)求信息來代替"GET""HEAD"作為HTTP請(qǐng)求。這對(duì)于執(zhí)行"DELETE" 或者其他更隱蔽的HTTP請(qǐng)求。有效值如"GET","POST","CONNECT"等等。也就是說,不要在這里輸入整個(gè)HTTP請(qǐng)求。例如輸入"GET /index.html HTTP/1.0\r\n\r\n"是不正確的。

Note:

在確定服務(wù)器支持這個(gè)自定義請(qǐng)求的方法前不要使用。


CURLOPT_EGDSOCKET類似CURLOPT_RANDOM_FILE,除了一個(gè)Entropy Gathering Daemon套接字。
CURLOPT_ENCODINGHTTP請(qǐng)求頭中"Accept-Encoding: "的值。支持的編碼有"identity","deflate""gzip"。如果為空字符串"",請(qǐng)求頭會(huì)發(fā)送所有支持的編碼類型。在CURL 7.10中被加入。
CURLOPT_FTPPORT這個(gè)值將被用來獲取供FTP"POST"指令所需要的IP地址。"POST"指令告訴遠(yuǎn)程服務(wù)器連接到我們指定的IP地址。這個(gè)字符串可以是純文本的IP地址、主機(jī)名、一個(gè)網(wǎng)絡(luò)接口名(UNIX下)或者只是一個(gè)'-'來使用默認(rèn)的IP地址。
CURLOPT_INTERFACE網(wǎng)絡(luò)發(fā)送接口名,可以是一個(gè)接口名、IP地址或者是一個(gè)主機(jī)名。
CURLOPT_KRB4LEVELKRB4 (Kerberos 4) 安全級(jí)別。下面的任何值都是有效的(從低到高的順序):"clear""safe"、"confidential""private".。如果字符串和這些都不匹配,將使用"private"。這個(gè)選項(xiàng)設(shè)置為NULL時(shí)將禁用KRB4 安全認(rèn)證。目前KRB4 安全認(rèn)證只能用于FTP傳輸。
CURLOPT_POSTFIELDS全部數(shù)據(jù)使用HTTP協(xié)議中的"POST"操作來發(fā)送。要發(fā)送文件,在文件名前面加上@前綴并使用完整路徑。這個(gè)參數(shù)可以通過urlencoded后的字符串類似'para1=val1&para2=val2&...'或使用一個(gè)以字段名為鍵值,字段數(shù)據(jù)為值的數(shù)組。如果value是一個(gè)數(shù)組,Content-Type頭將會(huì)被設(shè)置成multipart/form-data。
CURLOPT_PROXYHTTP代理通道。
CURLOPT_PROXYUSERPWD一個(gè)用來連接到代理的"[username]:[password]"格式的字符串。
CURLOPT_RANDOM_FILE一個(gè)被用來生成SSL隨機(jī)數(shù)種子的文件名。
CURLOPT_RANGE"X-Y"的形式,其中X和Y都是可選項(xiàng)獲取數(shù)據(jù)的范圍,以字節(jié)計(jì)。HTTP傳輸線程也支持幾個(gè)這樣的重復(fù)項(xiàng)中間用逗號(hào)分隔如"X-Y,N-M"。
CURLOPT_REFERER在HTTP請(qǐng)求頭中"Referer: "的內(nèi)容。
CURLOPT_SSL_CIPHER_LIST一個(gè)SSL的加密算法列表。例如RC4-SHATLSv1都是可用的加密列表。
CURLOPT_SSLCERT一個(gè)包含PEM格式證書的文件名。
CURLOPT_SSLCERTPASSWD使用CURLOPT_SSLCERT證書需要的密碼。
CURLOPT_SSLCERTTYPE證書的類型。支持的格式有"PEM" (默認(rèn)值), "DER""ENG"。在CURL 7.9.3中被加入。
CURLOPT_SSLENGINE用來在CURLOPT_SSLKEY中指定的SSL私鑰的加密引擎變量。
CURLOPT_SSLENGINE_DEFAULT用來做非對(duì)稱加密操作的變量。
CURLOPT_SSLKEY包含SSL私鑰的文件名。
CURLOPT_SSLKEYPASSWD

CURLOPT_SSLKEY中指定了的SSL私鑰的密碼。

Note:

由于這個(gè)選項(xiàng)包含了敏感的密碼信息,記得保證這個(gè)PHP腳本的安全。


CURLOPT_SSLKEYTYPECURLOPT_SSLKEY中指定的私鑰的加密類型,支持的密鑰類型為"PEM"(默認(rèn)值)、"DER""ENG"
CURLOPT_URL需要獲取的URL地址,也可以在curl_init()函數(shù)中設(shè)置。
CURLOPT_USERAGENT在HTTP請(qǐng)求中包含一個(gè)"User-Agent: "頭的字符串。
CURLOPT_USERPWD傳遞一個(gè)連接中需要的用戶名和密碼,格式為:"[username]:[password]"。

對(duì)于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個(gè)數(shù)組:

選項(xiàng)可選value備注
CURLOPT_HTTP200ALIASES200響應(yīng)碼數(shù)組,數(shù)組中的響應(yīng)嗎被認(rèn)為是正確的響應(yīng),否則被認(rèn)為是錯(cuò)誤的。在CURL 7.10.3中被加入。
CURLOPT_HTTPHEADER一個(gè)用來設(shè)置HTTP頭字段的數(shù)組。使用如下的形式的數(shù)組進(jìn)行設(shè)置:                       array('Content-type: text/plain', 'Content-length: 100')
CURLOPT_POSTQUOTE在FTP請(qǐng)求執(zhí)行完成后,在服務(wù)器上執(zhí)行的一組FTP命令。
CURLOPT_QUOTE一組先于FTP請(qǐng)求的在服務(wù)器上執(zhí)行的FTP命令。

對(duì)于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置一個(gè)流資源 (例如使用fopen()):

選項(xiàng)可選value
CURLOPT_FILE設(shè)置輸出文件的位置,值是一個(gè)資源類型,默認(rèn)為STDOUT (瀏覽器)。
CURLOPT_INFILE在上傳文件的時(shí)候需要讀取的文件地址,值是一個(gè)資源類型。
CURLOPT_STDERR設(shè)置一個(gè)錯(cuò)誤輸出地址,值是一個(gè)資源類型,取代默認(rèn)的STDERR。
CURLOPT_WRITEHEADER設(shè)置header部分內(nèi)容的寫入的文件地址,值是一個(gè)資源類型。

對(duì)于下面的這些option的可選參數(shù),value應(yīng)該被設(shè)置為一個(gè)回調(diào)函數(shù)名:

選項(xiàng)可選value
CURLOPT_HEADERFUNCTION設(shè)置一個(gè)回調(diào)函數(shù),這個(gè)函數(shù)有兩個(gè)參數(shù),第一個(gè)是CURL的資源句柄,第二個(gè)是輸出的header數(shù)據(jù)。header數(shù)據(jù)的輸出必須依賴這個(gè)函數(shù),返回已寫入的數(shù)據(jù)大小。
CURLOPT_PASSWDFUNCTION設(shè)置一個(gè)回調(diào)函數(shù),有三個(gè)參數(shù),第一個(gè)是CURL的資源句柄,第二個(gè)是一個(gè)密碼提示符,第三個(gè)參數(shù)是密碼長度允許的最大值。返回密碼的值。
CURLOPT_PROGRESSFUNCTION設(shè)置一個(gè)回調(diào)函數(shù),有三個(gè)參數(shù),第一個(gè)是CURL的資源句柄,第二個(gè)是一個(gè)文件描述符資源,第三個(gè)是長度。返回包含的數(shù)據(jù)。
CURLOPT_READFUNCTION回調(diào)函數(shù)名。該函數(shù)應(yīng)接受三個(gè)參數(shù)。第一個(gè)是 CURL resource;第二個(gè)是通過選項(xiàng) CURLOPT_INFILE 傳給 CURL 的 stream resource;第三個(gè)參數(shù)是最大可以讀取的數(shù)據(jù)的數(shù)量?;?調(diào)函數(shù)必須返回一個(gè)字符串,長度小于或等于請(qǐng)求的數(shù)據(jù)量(第三個(gè)參數(shù))。一般從傳入的 stream resource 讀取。返回空字符串作為 EOF(文件結(jié)束) 信號(hào)。
CURLOPT_WRITEFUNCTION回調(diào)函數(shù)名。該函數(shù)應(yīng)接受兩個(gè)參數(shù)。第一個(gè)是 CURL resource;第二個(gè)是要寫入的數(shù)據(jù)字符串。數(shù) 據(jù)必須在函數(shù)中被保存。函數(shù)必須返回準(zhǔn)確的傳入的要寫入數(shù)據(jù)的字節(jié)數(shù),否則傳輸會(huì)被一個(gè)錯(cuò)誤所中 斷。

返回值

成功時(shí)返回 TRUE, 或者在失敗時(shí)返回 FALSE。

更新日志

版本說明
5.2.10引入 CURLOPT_PROTOCOLS, andCURLOPT_REDIR_PROTOCOLS.
5.1.0引入 CURLOPT_AUTOREFERER,CURLOPT_BINARYTRANSFER,CURLOPT_FTPSSLAUTH,CURLOPT_PROXYAUTH, andCURLOPT_TIMECONDITION.
5.0.0引入 CURLOPT_FTP_USE_EPRT,CURLOPT_NOSIGNAL,CURLOPT_UNRESTRICTED_AUTH,CURLOPT_BUFFERSIZE,CURLOPT_HTTPAUTH,CURLOPT_PROXYPORT,CURLOPT_PROXYTYPE,CURLOPT_SSLCERTTYPE, andCURLOPT_HTTP200ALIASES.

在線示例

初始化一個(gè)新的CURL會(huì)話并獲取一個(gè)網(wǎng)頁

<?php
// 創(chuàng)建一個(gè)新CURL資源
$ch = curl_init();
// 設(shè)置URL和相應(yīng)的選項(xiàng)
curl_setopt($ch, CURLOPT_URL, "/");
curl_setopt($ch, CURLOPT_HEADER, false);
// 抓取URL并把它傳遞給瀏覽器
curl_exec($ch);
//關(guān)閉CURL資源,并且釋放系統(tǒng)資源
curl_close($ch);
?>

上傳文件示例:

<?php
/* http://localhost/upload.php:
print_r($_POST);
print_r($_FILES);
*/
$ch = curl_init();
$data = array('name' => 'Foo', 'file' => '@/home/user/test.png');
curl_setopt($ch, CURLOPT_URL, 'http://localhost/upload.php');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_exec($ch);
?>

以上示例輸出結(jié)果如下:

Array
(
    [name] => Foo
)
Array
(
    [file] => Array
        (
            [name] => test.png
            [type] => image/png
            [tmp_name] => /tmp/phpcpjNeQ
            [error] => 0
            [size] => 279
        )
)

注釋

傳遞一個(gè)數(shù)組到CURLOPT_POSTFIELDS,CURL會(huì)把數(shù)據(jù)編碼成 multipart/form-data,而然傳遞一個(gè)URL-encoded字符串時(shí),數(shù)據(jù)會(huì)被編碼成 application/x-www-form-urlencoded。

PHP CURL參考手冊

丰满人妻一级特黄a大片,午夜无码免费福利一级,欧美亚洲精品在线,国产婷婷成人久久Av免费高清