PHP cURL 函式

概述

PHP支援的由Daniel Stenberg建立的libcurl庫允許你與各種的伺服器使用各種型別的協議進行連線和通訊。

libcurl目前支援http、https、ftp、gopher、telnet、dict、file和ldap協議。libcurl同時也支援HTTPS認證、HTTP POST、HTTP PUT、 FTP 上傳(這個也能通過PHP的FTP擴充套件完成)、HTTP 基於表單的上傳、代理、cookies和使用者名稱+密碼的認證。

PHP中使用cURL實現Get和Post請求的方法

這些函式在PHP 4.0.2中被引入。



需求

為了使用PHP的cURL函式,你需要安裝 ? libcurl包。

PHP需要使用libcurl 7.0.2-beta 或者更高版本。在PHP 4.2.3 裡使用cURL,你需要安裝7.9.0或更高版本的libcurl。從PHP 4.3.0開始你需要安裝7.9.0或更高版本的libcurl。從PHP 5.0.0開始你需要安裝7.10.5或更高版本的libcurl。



安裝

要使用PHP的cURL支援你必須在編譯PHP時加上--with-curl[=DIR] 選項,DIR為包含lib和include的目錄路徑。在include目錄中必須有一個名為curl,包含了easy.h和curl.h的資料夾。lib資料夾裡應該有一個名為libcurl.a的檔案。對於PHP 4.3.0你可以配置--with-curlwrappers 使cURL使用URL流。

注意: Win32使用者注意 要在Windows環境下使用這個模組,libeay32.dll和ssleay32.dll必須放到PATH環境變數包含的目錄下。 不用cURL網站上的libcurl.dll。


資源型別

這個擴充套件定義了2中資源:cURL控制代碼和cURL批處理控制代碼。



PHP cURL 函式

以下包含了PHP cURL函式列表:

函式 描述
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() 返回描述錯誤碼的字串文字。
curl_pause() 暫停及恢復連線。
curl_reset() 重置libcurl的會話控制代碼的所有選項。
curl_setopt_array() 為cURL傳輸會話批量設定選項。
curl_setopt() 設定一個cURL傳輸選項。
curl_share_close() 關閉cURL共享控制代碼。
curl_share_init() 初始化cURL共享控制代碼。
curl_share_setopt() 設定一個共享控制代碼的cURL傳輸選項。
curl_strerror() 返回錯誤程式碼的字串描述。
curl_unescape() 解碼URL編碼後的字串。
curl_version() 獲取cURL版本資訊。