libcurl.net入门使用

libcurl.net入门使用

关于libcurl.net

一个引用libcurl.dll并封装为.NET使用的Curl库,方便在.NET应用程序里面执行Curl命令,没有其他库依赖,只是对libcurl.dll的封装和引用。

在大多数情况下,我们可以或者比较容易获取Web请求的Curl格式的请求内容,因此该库可以比较方便地对已知Curl命令进行.NET的程序化转换使用。

安装

因为libcurlx86x64版本,因此libcurl.NET也有两个版本,在Visual StudioNuGet仓库搜索libcurl.NET,然后根据自己的应用选择安装x86x64对应的版本。

使用流程

  1. libcurl库引用初始化,全局的,整个程序只需要调用一次:
C# 复制代码
Curl.GlobalInit((int)CURLinitFlag.CURL_GLOBAL_ALL);
  1. 创建封装的类对象,后续通过该对象执行Curl命令:
C# 复制代码
var easy = new Easy();
  1. 设置Curl参数,包括地址、请求头、请求参数等,统一使用函数easy.SetOpt,该函数第一个为枚举值的参数类型,第二个参数为对应的参数值:
C# 复制代码
easy.SetOpt(CURLoption.CURLOPT_USERPWD, UserName + ":" + UserPassword);
easy.SetOpt(CURLoption.CURLOPT_URL, url);
easy.SetOpt(CURLoption.CURLOPT_ENCODING, url);
  1. 执行Curl命令,根据返回代码判定操作结果
C# 复制代码
var result = easy.Perform();
Log("curl操作完成,结果", pr == CURLcode.CURLE_OK ? "成功" : "失败-" + pr.ToString());
  1. 销毁封装的类对象
C# 复制代码
easy.Dispose();
  1. 释放清理libcurl库的引用
C# 复制代码
Curl.GlobalCleanup();

使用示例

C# 复制代码
bool TryCurlWithUploadFile(string url)
{
    FileStream fs = null;
    try
    {
        // 读取文件
        fs = new FileStream(FilePath, FileMode.Open, FileAccess.Read, FileShare.Read);

        // 需要声明:using SeasideResearch.LibCurlNet;
        Curl.GlobalInit((int)CURLinitFlag.CURL_GLOBAL_ALL);
        var easy = new Easy();

        // 设置网址
        easy.SetOpt(CURLoption.CURLOPT_URL, url);
        // 设置授权所需的用户名和密码
        easy.SetOpt(CURLoption.CURLOPT_USERPWD, UserName + ":" + UserPassword);

        // 上传的文件信息
        var readFunc = new Easy.ReadFunction(OnReadData);
        easy.SetOpt(CURLoption.CURLOPT_READFUNCTION, readFunc);
        easy.SetOpt(CURLoption.CURLOPT_READDATA, fs);
        easy.SetOpt(CURLoption.CURLOPT_UPLOAD, true);
        easy.SetOpt(CURLoption.CURLOPT_INFILESIZE, fs.Length);

        // 可选,显示调试信息
        var dbgFunc = new Easy.DebugFunction(OnDebug);
        easy.SetOpt(CURLoption.CURLOPT_DEBUGFUNCTION, dbgFunc);
        easy.SetOpt(CURLoption.CURLOPT_VERBOSE, true);

        // 可选,显示进度
        var prgFunc = new Easy.ProgressFunction(OnProgress);
        easy.SetOpt(CURLoption.CURLOPT_PROGRESSFUNCTION, dbgFunc);

        // 设置不校验SSL
        easy.SetOpt(CURLoption.CURLOPT_SSL_VERIFYHOST, 0);
        easy.SetOpt(CURLoption.CURLOPT_SSL_VERIFYPEER, 0);

        // 执行命令
        var pr = easy.Perform();
        if(pr != CURLcode.CURLE_OK)
        {
            Log("Curl请求失败,原因:", easy.StrError(pr));
        }
        else
        {
            Log("Curl请求成功");
        }
        easy.Dispose();
        return true;
    }
    catch(Exception e)
    {
        Log("Curl异常:", e.Message);
        return false;
    }
    finally
    {
        // 清理
        fs?.Close();
        Curl.GlobalCleanup();
    }
}

public Int32 OnReadData(byte[] buf, Int32 size, Int32 nmemb, object ext)
{
    var fs = (FileStream)ext;
    return fs.Read(buf, 0, size * nmemb);
}

public void OnDebug(CURLINFOTYPE infoType, string message, object extraData)
{
    if(infoType == CURLINFOTYPE.CURLINFO_DATA_IN && !string.IsNullOrWhiteSpace(message))
    {
        Log("Curl<", message);
    }
}

public int OnProgress(object extraData, double dlTotal, double dlNow, double ulTotal, double ulNow)
{
    Log($"Curl< Progress info: {dlNow}/{dlTotal} {ulNow}/{ulTotal}");
    return 0;
}
相关推荐
唐青枫4 小时前
C#.NET 定时任务与队列利器:Hangfire 完整教程
c#·.net
hez201010 小时前
Runtime Async - 步入高性能异步时代
c#·.net·.net core·clr
追逐时光者1 天前
.NET Fiddle:一个方便易用的在线.NET代码编辑工具
后端·.net
mudtools1 天前
.NET驾驭Word之力:玩转文本与格式
c#·.net
唐青枫1 天前
C#.NET 数据库开发提速秘籍:SqlSugar 实战详解
c#·.net
追逐时光者2 天前
精选 4 款基于 .NET 开源、功能强大的 Windows 系统优化工具
后端·.net
mudtools2 天前
.NET驾驭Word之力:理解Word对象模型核心 (Application, Document, Range)
c#·.net
大飞pkz2 天前
【设计模式】C#反射实现抽象工厂模式
设计模式·c#·抽象工厂模式·c#反射·c#反射实现抽象工厂模式
唐青枫2 天前
从入门到进阶:C#.NET Stopwatch 计时与性能测量全攻略
c#·.net
私人珍藏库2 天前
[Windows] 微软 .Net 运行库离线安装包 | Microsoft .Net Packages AIO_v09.09.25
microsoft·.net·运行库