不得不懂的HTML转PDF神器,支持.NET,C ,php,java等

.NET
486
0
0
2022-04-25

我们在开发各种管理系统的时候,不免需要将一些报表导出为PDF,这使用率应该来说是还相当广的,今天,小编将给大家推荐一个HTML转PDF的利器,神器,有了他,如虎添翼。

什么html2pdf,pdflib,FPDF这些可能也有不少人用过,但,我推荐的不是这个,也是我们的:wkhtmltopdf

wkhtmltopdf并且wkhtmltoimage是开源的(LGPLv3)命令行工具来渲染HTML到使用Qt WebKit渲染引擎PDF和各种图像格式。这些运行完全“无头”,不需要显示或显示服务。

还有一个C库,如果你是这样的事情。

我如何使用它?

  1. 下载预编译的二进制文件或从源代码构建
  2. 创建您想要转换为PDF(或图像)的HTML文档
  3. 通过该工具运行您的HTML文档。
  4. 例如,如果我真的很喜欢Google今天对他们的徽标所做的处理,并希望以PDF形式永久捕获它:
  5. wkhtmltopdf http://google.com google.pdf

其他选项

这很好,我一直想把Google的主页变成PDF,但是我也想要一个目录。

有很多命令行选项。查看自动生成的wkhtmltopdf手册。

获取核心

命令行工具很棒,但我想要一个C库。

没问题。检查图书馆的文件。

真实世界的例子?

正如我们所说,如果您今天真的很喜欢Google的主页,并且希望将其保存为PDF,则可以使用wkhtmltopdf。

说真的,你可以用它来生成发票,生成生日贺卡,或其他各种有趣的事情。只是用你的想象力!

wkhtmltopdf,wkhtmltopdf可以直接把任何一个可以在浏览器中浏览的网页直接转换成一个pdf,首先说明一下它不是一个C#类 其他语类的方法封装,而是一个把html页面转换成pdf的一个软件(需要安装在服务器上),但是它并不是一个简单的桌面软件,而且它直接cmd批处理的,我们可以很简便的调用它。

今天我通过一个asp .net core mvc的例子给大家介绍下他的使用方法:

首先,我们先在

https://wkhtmltopdf.org/downloads.html 下载相应的服务器系统 wkhtmltopdf软件

不得不懂的HTML转PDF神器,支持.NET,C ,php,java等

当然,在

https://github.com/wkhtmltopdf/wkhtmltopdf 我们也可以查到一些具体的应用例子

我在先nuget添加了:

https://github.com/cp79shark/Shark.PdfConvert,这个封装了.net core调用wkhtmltopdf的常用操作方法,可以直接快速引用。

什么是Shark.PdfConvert?

Shark.PdfConvert是WkHtmlToPdf工具的一个简单的.NET Core(也是目标net451)包装器。大多数选项通过PdfConversionSettings对象公开,其他可以通过使用自定义覆盖来指定所需的配置区域。

转换设置默认值是为Windows环境设置的,并假定您已安装WkHTMLToPDF(x64)工具。您可以通过重写PdfConversionSettings来覆盖工具的路径。PdfToolPath。

您将需要安装/下载WkHtmlToPdf,它不嵌入在NuGet包中

示例1:静态HTML内容

PdfConvert.Convert(new PdfConversionSettings{
    Title = "My Static Content",
    Content = @"<h1>Lorem ipsum dolor sit amet consectetuer adipiscing elit
    I SHOULD BE RED BY JAVASCRIPT</h1> 
    <script>document.querySelector('h1').style.color = 'rgb(128,0,0)';</script>",
    OutputPath = @"C:\temp\temp.pdf"
});

示例2:从URL获取内容

PdfConvert.Convert(new PdfConversionSettings{
    Title = "My Static Content from URL",
    ContentUrl = "http://www.lipsum.com/",
    OutputPath = @"C:\temp\temp-url.pdf"
});

示例3:使用流进行输出和输入

PdfConversionSettings config = new PdfConversionSettings{
    Title = "Streaming my HTML to PDF"
};
using (var fileStream = new FileStream(Path.GetTempFileName() + ".pdf", FileMode.Create)){
    var task = new System.Net.Http.HttpClient().GetStreamAsync("http://www.google.com");
    task.Wait();
    using (var inputStream = task.Result)
    {
        PdfConvert.Convert(config, fileStream, inputStream);
    }
}

样品4:混合和匹配

PdfConversionSettings config = new PdfConversionSettings{
    Title = "A little bit of Everything",
    GenerateToc = true,
    TocHeaderText = "Table of MY Contents",
    PageCoverUrl = "https://blackrockdigital.github.io/startbootstrap-landing-page/",
    ContentUrl = "http://www.lipsum.com/",
    PageHeaderHtml = @"
    <!DOCTYPE html><html><body><div style=""background-color: red; color: white; text-align: center; width: 100vw;"">SECRET SAUCE</div></body></html>"};using (var fileStream = new FileStream(Path.GetTempFileName() + ".pdf", FileMode.Create)){
    PdfConvert.Convert(config, fileStream);
}

示例5:MVC控制器操作中的用法

public IActionResult ConvertToPdf([FromBody] PdfConversionSettings model) {
    // TAKE CARE WHEN Accepting the Conversion Settings from user land, it would be best 
    // to just NOT DO it, accept your own custom model and map the parameters as needed. 
    // If you insist, then you could do something like the following to prevent malicious code execution 
    // in my testing the Custom*Args members are not a valid attack vector, PdfToolPath certainly is, never* trust 
    // the client#if DEBUG// set path to executable, UNSAFE DEBUG USE ONLY FOR TESTING
    model.PdfToolPath = model.PdfToolPath ?? _host.ContentRootPath + @"\wkhtmltopdf.exe";#else// set path to executable
    model.PdfToolPath = _host.ContentRootPath + @"\wkhtmltopdf.exe";#endif  if (model.OutputFilename.EndsWith(".pdf") == false) model.OutputFilename = model.OutputFilename + ".pdf";
    var memoryStream = new MemoryStream();
    PdfConvert.Convert(model, memoryStream);
    return new FileContentResult(memoryStream.ToArray(), MimeTypes.Pdf)
    {
        FileDownloadName = model.OutputFileName
    };
}

在Controller中的

[HttpPost]
public async Task<IActionResult> ExportPdf(PdfConversionSettings model) 
{
    var saveFilePath = "/upload/"+ model.Title + ".pdf";
    model.PdfToolPath = FileHelper.MapPath("wkhtmltox/wkhtmltopdf.exe");
    model.OutputPath = FileHelper.MapPath(saveFilePath);
    FileHelper.DeleteFile(saveFilePath);
    var ms= new MemoryStream();
    var head = @"
    <!DOCTYPE html><head><meta http-equiv=""Content-Type"" content=""text/html; charset=utf-8"" /> 
        <meta name=""viewport"" content=""width=device-width,minimum-scale=1.0,maximum-scale=1.0,initial-scale=1.0,user-scalable=no""> 
        <meta name=""apple-mobile-web-app-capable"" content=""yes"" /> 
        <title></title> 
        <link rel=""stylesheet"" type=""text/css"" href=""/lib/art-dialog/css/dialog.css"" /> 
        <link rel=""stylesheet"" type=""text/css"" href=""/admin/skin/icon/iconfont.css"" /> 
        <link rel=""stylesheet"" type=""text/css"" href=""/admin/skin/default/style.css"" /> 
        <style type=""text/css"">
        h1{line-height:70px;margin-top:20px;font-size:40px;font-weight:bold;text-align:center;}
        body,div,p {line-height:50px; font-family: 'Microsoft YaHei';font-size:25px;}
        img{text-align:center;width:120%;height:400px;}
        table,tr,td{height:40px;}
        </style></head><body>";
    model.PageWidth = 210;
    model.PageHeight = 297;
    //model.Margins = new PdfPageMargins { Top = 100, Left = 20 };
    //model.Size = PdfPageSize.A4;
    model.Content = head + model.Content + "</body></html>";
    PdfConvert.Convert(model, ms);
    FileStream fileStream = null;
    try
    {
        fileStream = new FileStream(model.OutputPath, FileMode.Create);
        ms.WriteTo(fileStream);
    }
    catch(Exception ex)
    {
        return Json(new
        {
            status = 0,
            message = "导出PDF出错!" + ex.Message
        });
    }
    finally
    {
        ms.Close();
        fileStream.Close();
    }
    return Json(new
    {
        status = 1,
        message = "PDF导出成功!",
        url = Request.Scheme + "://" + Request.Host.ToUriComponent() + "/" + saveFilePath
    });
}

这就是我的具体生成实现方法。

不得不懂的HTML转PDF神器,支持.NET,C ,php,java等

导出PDF界面

不得不懂的HTML转PDF神器,支持.NET,C ,php,java等

导出后的PDF