libcurl使用教程.doc

libcurl 教程译者注:这是一篇介绍如何使用 libcurl 的入门教程。文档不是逐字逐句按原文翻译,而是根据笔者对 libcurl 的理解, 参考原文写成。文中用到的一些例子, 可能不是出自原文, 而是笔者在学****过程中, 写的一些示例程序( 笔者使用的 libcurl 版本是: ) 。出现在这里主要是为了更好的说明 libcurl 的某些 api 函数的使用。许多例子都参考 libcurl 提供的 example 代码。原文 example 中的提供的示例程序完全使用 C 语言, 而这里笔者提供的例子使用 C++ 语言。因为能力有限,对于 libcurl 的某些理解和使用可能有误,欢迎批评指正。目标本文档介绍了在应用程序开发过程中, 如何正确使用 libcur l 的基本方式和指导原则。文档使用C 语言来调用 libcur l 的接口,当然也适用于其他与 C 语言接近的语言。文档主要针对使用 libcurl 来进行开发的人员。文档所掼的应用程序泛指你写的源代码,这些代码使用了 libcur l 进行数据传输。更多关于 libcurl 的功能和接口信息,可以在相关的主页上查阅。编译源码有很多种不同的方式来编译 C 语言代码。这里使用 UNIX 平台下的编译方式。即使你使用的是其他的操作系统, 你仍然可以通过阅读本文档来获取许多有用的信息。编译你的编译器必须知道 libcurl 头文件的位置。所以在编译的时候, 你要设置头文件的包含路径。可以使用 curl-confi g 工具来获取这方面的信息: $ curl-config – cflags 链接编译完源码(这时的源代码不是指 libcurl 的源代码,你是你自己写的程序代码)之后,你还必须把目标文件链接成单个可执行文件。你要链接 libcurl 库,以及 libcurl 所依赖的其他库,例如 OpenSLL 库。当然可能还需要一些其他的操作系统库。最后你还要设置一些编译选项,当然可以使用 curl-config 工具简化操作: $curl-config – libs 是否使用 SSL 定制编译 libcurl 。与其他库不同的是, libcurl 可以定制编译,根据实际需要是否支持某些特性,如是否支持 SS L 传输,像 HTTPS 和 FTPS 。如果决定需要支持 SSL , 必须在编译时正确的设置。可以使用’ curl-config ’来判断 libcur l 库是否支持 SSL : $ curl-config – feature autoconf 宏当你编写配置脚本来检测 libcurl 及其相应设置时,你可以使用预定义宏。文档 docs/libcurl/ 告诉你如何使用这些宏。跨平台的可移植的代码 libcurl 的开发人员花费很大的努力,使 libcurl 尽可能在大多数平台上正常运行。全局初始化应用程序在使用 libcurl 之前,必须先初始化 libcurl 。 libcurl 只需初始化一次。可以使用以下语句进行初始化: curl_global_init(); curl_global_init() 接收一个参数, 告诉 libcurl 如何初始化。参数 CURL_GLOBAL_ALL 会使 libcurl 初始化所有的子模块和一些默认的选项,通常这是一个比较好的默认参数值。还有两个可选值: CURL_GLOBAL_WIN32 只能应用于 Windows 平台。它告诉 libcurl 初始化 winsock 库。如果 winsock 库没有正确地初始化,应用程序就不能使用 socket 。在应用程序中,只要初始化一次即可。 CURL_GLOBAL_SSL 如果 libcurl 在编译时被设定支持 SSL , 那么该参数用于初始化相应的 SSL 库。同样, 在应用程序中, 只要初始化一次即可。 libcurl 有默认的保护机制,如果在调用 curl_easy_perform 时它检测到还没有通过 curl_global_init 进行初始化, libcurl 会根据当前的运行时环境, 自动调用全局初始化函数。但必须清楚的是, 让系统自已初始化不是一个好的选择。当应用程序不再使用 libcurl 的时候,应该调用 curl_global_cleanup 来释放相关的资源。在程序中,应当避免多次调用 curl_global_init 和 curl_global_cleanup 。它们只能被调用一次。 libcurl 提供的功能在运行时根据 libcurl 支持的特性来进行开发,通常比编译时更好。可以通过调用 curl_version_info 函数返回的结构体来获取运行时的具体信息,从而确定当前环境下 libcurl 支持的一些特