Easy interface概览
描述
使用步骤如下:
1、使用 libcurl 的“easy”接口时,需要初始化会话并获得一个句柄(通常称为“easy句柄”),这个句柄就是我们整个传输发布的开始,后面设置参数都是围绕这个句柄进行设置。使用curl_easy_init获取句柄。
2、当获取到句柄之后,需要对句柄设置一些属性,其中最重要的是 URL连接(如果没有指定的 URL,无法传输任何内容)。当然我们在真正的开发过程中换需要接收服务器返回的数据,因此还需要设置一些回调。而所有的属性设置都是通过函数curl_easy_setopt。每个属性都有一个对应的字符串作为kay值。
CURLOPT_URL是url属性的kay值,无论是发送文档还是数据都需要哦设置url属性,否则无法进行传输。
CURLOPT_VERBOSE这个属性值显示一些运行信息的。可以帮助了解 libcurl 在后台执行的操作,例如在调试时很有用。
当然我们可以设置属性,那就可以清除属性,如果我们不想一个属性一个属性的清除。就可以调用curl_easy_reset 函数将所有的属性设置都还原成默认值
还可以使用curl_easy_duphandle克隆一个简单句柄(及其所有设置选项)。
curl_easy_setopt手册页包含近 300 个可用选项的完整索引。
3、当我们所需要的所有属性都设置好后,就可以使用curl_easy_perform执行传输。然后它将执行整个操作,并且在完成(成功与否)之前不会返回。
4、传输完成后,就可以修改设置新选项并进行另一次传输,或者如果完成,请调用curl_easy_cleanup清理会话。如果您想要持久连接,则不要立即清理,而是提前运行并使用相同的简单句柄执行其他传输。
需要注意的是:
curl_easy_init和curl_easy_cleanup是成对出现的,有对应的初始化则必须要有对应的清除。