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版本信息。