PHP curl_setopt函數用於設定一個cURL傳輸選項，即為給定的cURL會話句柄設定一個選項。 curl_setopt函數成功時回傳TRUE， 失敗時回傳FALSE。
PHP curl_setopt函數
curl_setopt — 設定一個cURL傳輸選項。
說明
bool curl_setopt ( resource $ch , int $option , mixed $value )
為給定的cURL會話句柄設定一個選項。
參數
ch：由 curl_init() 傳回的 cURL 句柄。
option：需要設定的CURLOPT_XXX選項。
value：將設定在option選項上的值。
對於下面的這些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狀態碼，預設行為是忽略編號小於等於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 | CURLOPT_FTP_USE_EPSV | |
CURLOPT_FTPAPPEND | ||
| CURLOPT_FTPASCII | ||
CURLOPT_FTPLISTONLY | ||
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傳輸的進度條，此項目的默認設定為啟用。
| |
| CURLOPT_NOSIGNAL | 啟用時忽略所有的curl傳遞給php進行的信號。在SAPI多執行緒傳輸時此項目被預設為啟用。 | cURL 7.10時加入。 |
| CURLOPT_POST | ##CURLOPT_POST | |
| ##application/x-www-form-urlencoded ，就像表單提交的一樣。 | CURLOPT_PUT | |
| 和CURLOPT_INFILESIZE。 | ||
| 將curl_exec()取得的資訊以檔案流的形式傳回，而不是直接輸出。 | CURLOPT_SSL_VERIFYPEER停用後cURL將終止從服務端進行驗證。使用CURLOPT_CAINFO選項設定憑證使用CURLOPT_CAPATH | #選項設定憑證目錄 如果CURLOPT_SSL_VERIFYPEER(預設值為2)啟用，CURLOPT_SSL_VERIFYHOST | #需要設定為
| #。 自cURL 7.10開始預設為 | TRUE。從cURL 7.10開始預設綁定安裝。 | CURLOPT_TRANSFERTEXT |
| STDOUT設定成binary模式。 | CURLOPT_UNRESTRICTED_AUTH | |
| CURLOPT_FOLLOWLOCATION產生的header中的多個locations中持續追加使用者名稱和密碼訊息，即使網域已改變。 | ||
| #啟用後允許檔案上傳。 | CURLOPT_VERBOSE |
對於下面的這些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_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_T.L.SVTOSTO_EL. FTP、CURLPROTO_ALL | 在cURL 7.19. 4中被加入。 |
| CURLOPT_PROTOCOLS | #CURLPROTO_*的位元域指。如果啟用，位元域值會限定libcurl在傳輸過程中有哪些可使用的協定。這將允許你在編譯libcurl時支援眾多協議，但是限制只是用它們中被允許使用的一個子集。預設libcurl將會使用全部它支援的協定。請參閱CURLOPT_REDIR_PROTOCOLS.可用的協定選項為：CURLPROTO_HTTP、CURLPROTO_HTTPS、CURLPROTO_FTP、CURLPROTO_FTPS、CURLPROTO_SCP、CURLPROTO_SFTP、CURLPROTO_T.L.SVTOSTO_EL. FTP、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_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCECOND_IFMODSINCE 。 |
對於下面的這些option的可選參數，value應該被設定一個string類型的值：
| #選項 | ##可選value值 | 備註|
|---|---|---|
| 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"是不正確的。
| |
| 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私鑰的密碼。
| |
| CURLOPT_SSLKEYTYPE | CURLOPT_SSLKEY中規定的私鑰的加密類型，支援的金鑰類型為"PEM"(預設值)、"DER"和"ENG"。 | |
| CURLOPT_URL | 需要取得的URL位址，也可以在curl_init()函數中設定。 | |
| CURLOPT_USERAGENT | 在HTTP請求中包含一個"User-Agent: "頭的字串。 | |
| CURLOPT_USERPWD | #傳遞一個連線中所需的使用者名稱和密碼，格式為： "[username]:[password]"。 |
#對於下面的這些option的可選參數，value應該被設定一個陣列：
| 選項 | 可選value值 | 備註 |
|---|---|---|
| # #CURLOPT_HTTP200ALIASES | 200回應碼數組，數組中的回應嗎被認為是正確的回應，否則被認為是錯誤的。在cURL 7.10.3中被加入。 | |
| CURLOPT_HTTPHEADER | #一個用來設定HTTP頭字段的陣列。使用如下的形式的陣列進行設定： array('Content-type: text/plain', 'Content-length: 100')||
| 在FTP請求執行完成後，在伺服器上執行的一組FTP指令。 | ||
| 一組先於FTP請求的在伺服器上執行的FTP指令。 |
| 选项 | 可选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 | 回调函数名。该函数应接受三个参数。第一个是 cURL resource；第二个是通过选项 CURLOPT_INFILE 传给 cURL 的 stream resource；第三个参数是最大可以读取的数据的数量。回 调函数必须返回一个字符串，长度小于或等于请求的数据量（第三个参数）。一般从传入的 stream resource 读取。返回空字符串作为 EOF（文件结束） 信号。 |
| CURLOPT_WRITEFUNCTION | 回调函数名。该函数应接受两个参数。第一个是 cURL resource；第二个是要写入的数据字符串。数 据必须在函数中被保存。函数必须返回准确的传入的要写入数据的字节数，否则传输会被一个错误所中 断。 |
返回值
成功时返回 TRUE， 或者在失败时返回 FALSE。
实例
初始化一个新的cURL会话并获取一个网页
<?php // 创建一个新cURL资源 $ch = curl_init(); // 设置URL和相应的选项 curl_setopt($ch, CURLOPT_URL, "http://www.example.com/"); curl_setopt($ch, CURLOPT_HEADER, false); // 抓取URL并把它传递给浏览器 curl_exec($ch); //关闭cURL资源，并且释放系统资源 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); ?>
以上实例输出结果如下：
Array
(
[name] => Foo
)
Array
(
[file] => Array
(
[name] => test.png
[type] => image/png
[tmp_name] => /tmp/phpcpjNeQ
[error] => 0
[size] => 279
)
)更多相关知识，请访问 PHP中文网！！
以上是PHP curl_setopt函數有什麼用的詳細內容。更多資訊請關注PHP中文網其他相關文章！
