PHP 捲曲
概述
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版本資訊。 |