Latest web development tutorials

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