Convert HTML to PDF in Azure Functions Linux
The Syncfusion® HTML to PDF converter is a .NET Core library for converting webpages, SVG, MHTML, and HTML to PDF using C#. The result preserves all graphics, images, text, fonts, and the layout of the original HTML document or webpage. Using this library, you can convert an HTML to PDF using C# with the Blink rendering engine in Azure Functions Linux.
NOTE
HTML to PDF converter is not supported with Azure App Service windows. We internally use Blink rendering engine for the conversion, it uses GDI calls for viewing and rendering the webpages. But Azure app service blocks GDI calls in the Azure website environment. As the Azure website does not have the elevated permission and enough rights, we can not launch the Chrome headless browser in the Azure app service windows (Azure website and Azure function).
Steps to convert HTML to PDF in the Azure Functions using the Blink rendering engine
Step 1: Create the Azure function project.
Step 2: Select the Azure Functions type and .NET Core version.
Step 3: Select the function worker as .NET 8.0 isolated (Long-term support), and the selected HTTP triggers as follows.
Step 4: Install the Syncfusion.HtmlToPdfConverter.Net.Linux NuGet package as a reference to your .NET Core application NuGet.org.
NOTE
Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add “Syncfusion.Licensing” assembly reference and include a license key in your projects. Please refer to this link to know about registering Syncfusion® license key in your application to use our components.
Step 5: Include the following namespaces in Function1.cs file.
using Syncfusion.HtmlConverter;
using Syncfusion.Pdf;
using Syncfusion.Pdf.Graphics;
using System.Runtime.InteropServices;Step 6: This Azure Function converts HTML to PDF using HTTP triggers. It handles GET/POST requests, processes the HTML, and returns a PDF response.
[Function("Function1")]
public static async Task<IActionResult> Run([HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req, ILogger log, FunctionContext executionContext)
{
_logger.LogInformation("C# HTTP trigger function processed a request.");
try
{
byte[] pdfBytes = HtmlToPdfConvert("<p>Hello world</p>");
return new FileStreamResult(new MemoryStream(pdfBytes), "application/pdf");
}
catch (Exception ex)
{
_logger.LogError(ex.Message.ToString(), "An error occurred while converting HTML to PDF.");
return new ContentResult
{
Content = $"Error: {ex.Message}",
ContentType = "text/plain",
StatusCode = StatusCodes.Status500InternalServerError
};
}
}step 7: Use the following code example in the HtmlToPdfConvert method to convert HTML to a PDF document using the Convert method in the HtmlToPdfConverter class. The Blink command line arguments are configured based on the given CommandLineArguments property of the BlinkConverterSettings class.
public byte[] HtmlToPdfConvert(string htmlText)
{
if (string.IsNullOrWhiteSpace(htmlText))
{
throw new ArgumentException("HTML text cannot be null or empty.", nameof(htmlText));
}
try
{
// Setup Blink binaries and install necessary packages
var blinkBinariesPath = SetupBlinkBinaries();
InstallLinuxPackages();
// Initialize HTML to PDF converter
HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter(HtmlRenderingEngine.Blink);
// Display settings
BlinkConverterSettings settings = new BlinkConverterSettings
{
BlinkPath = blinkBinariesPath,
ViewPortSize = new Syncfusion.Drawing.Size(1024, 768), // Set your desired viewport size
Margin = new PdfMargins
{
Top = 20, // Set your desired margins
Left = 20,
Right = 20,
Bottom = 20
}
};
htmlConverter.ConverterSettings = settings;
// Convert HTML to PDF
using (var memoryStream = new MemoryStream())
{
PdfDocument document = htmlConverter.Convert(htmlText, null);
document.Save(memoryStream);
document.Close(true);
return memoryStream.ToArray();
}
}
catch (Exception ex)
{
// Handle exceptions
Console.WriteLine("An error occurred: " + ex.Message);
throw;
}
}NOTE
Starting from version 29.2.4, it is no longer necessary to manually add the following command-line arguments when using the Blink rendering engine:
settings.CommandLineArguments.Add("--no-sandbox"); settings.CommandLineArguments.Add("--disable-setuid-sandbox");These arguments are only required when using older versions of the library that depend on Blink in sandbox-restricted environments.
Step 8: This code is designed to ensure that the necessary Linux packages for HTML to PDF conversion are installed if the operating system is Linux. It adjusts file permissions and executes a shell script to carry out the installation.
// This method checks if the current operating system is Linux and installs necessary package
// dependencies for HTML to PDF conversion if they are not already installed.
private static void InstallLinuxPackages()
{
// Check if the OS is Linux; return immediately if not.
if (!RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
{
return;
}
// Define file permissions needed for the executable files.
FileAccessPermissions ExecutableFilePermissions =
FileAccessPermissions.UserRead | FileAccessPermissions.UserWrite | FileAccessPermissions.UserExecute |
FileAccessPermissions.GroupRead | FileAccessPermissions.GroupExecute | FileAccessPermissions.OtherRead |
FileAccessPermissions.OtherExecute;
// Get the directory where the assembly is located.
string assemblyDirectory = Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location);
// Path for the shell script file that installs dependencies.
string shellFilePath = Path.Combine(assemblyDirectory);
string tempBlinkDir = Path.GetTempPath();
string dependenciesPath = Path.Combine(tempBlinkDir, "dependenciesInstall.sh");
// Check if the dependencies script does not already exist.
if (!File.Exists(dependenciesPath))
{
// Copy necessary files to a temporary directory.
CopyFilesRecursively(shellFilePath, tempBlinkDir);
// Get the path for the executable script.
var execPath = Path.Combine(tempBlinkDir, "dependenciesInstall.sh");
// If the script exists, update its permissions to make it executable.
if (File.Exists(execPath))
{
var code = Chmod(execPath, ExecutableFilePermissions);
if (code != 0)
{
throw new Exception("Chmod operation failed");
}
}
// Start a new process to run the shell script.
Process process = new Process
{
StartInfo = new ProcessStartInfo
{
FileName = "/bin/bash",
Arguments = "-c " + execPath,
CreateNoWindow = true,
UseShellExecute = false,
}
};
// Execute the process and wait for it to finish.
process.Start();
process.WaitForExit();
}
}Step 9: Add the following helper methods to copy and set permission to the BlinkBinariesLinux folder.
private static string SetupBlinkBinaries()
{
string assemblyDirectory = Path.Combine(Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location), "runtimes", "linux", "native");
string blinkAppDir = Path.Combine(assemblyDirectory);
string tempBlinkDir = Path.GetTempPath();
string chromePath = Path.Combine(tempBlinkDir, "chrome");
if (!File.Exists(chromePath))
{
CopyFilesRecursively(blinkAppDir, tempBlinkDir);
SetExecutablePermission(tempBlinkDir);
}
return tempBlinkDir;
}
private static void CopyFilesRecursively(string sourcePath, string targetPath)
{
// Create all the directories from the source to the destination path.
foreach (string dirPath in Directory.GetDirectories(sourcePath, "*", SearchOption.AllDirectories))
{
Directory.CreateDirectory(dirPath.Replace(sourcePath, targetPath));
}
// Copy all the files from the source path to the destination path.
foreach (string newPath in Directory.GetFiles(sourcePath, "*.*", SearchOption.AllDirectories))
{
File.Copy(newPath, newPath.Replace(sourcePath, targetPath), true);
}
}
[DllImport("libc", SetLastError = true, EntryPoint = "chmod")]
internal static extern int Chmod(string path, FileAccessPermissions mode);
private static void SetExecutablePermission(string tempBlinkDir)
{
FileAccessPermissions ExecutableFilePermissions =
FileAccessPermissions.UserRead | FileAccessPermissions.UserWrite | FileAccessPermissions.UserExecute |
FileAccessPermissions.GroupRead | FileAccessPermissions.GroupExecute | FileAccessPermissions.OtherRead |
FileAccessPermissions.OtherExecute;
string[] executableFiles = new string[] { "chrome", "chrome_sandbox" };
foreach (string executable in executableFiles)
{
var execPath = Path.Combine(tempBlinkDir, executable);
if (File.Exists(execPath))
{
var code = Chmod(execPath, ExecutableFilePermissions);
if (code != 0)
{
throw new Exception("Chmod operation failed");
}
}
}
}Step 10: Include the below enum in the Function1.cs file.
[Flags]
internal enum FileAccessPermissions : uint
{
OtherExecute = 1,
OtherWrite = 2,
OtherRead = 4,
GroupExecute = 8,
GroupWrite = 16,
GroupRead = 32,
UserExecute = 64,
UserWrite = 128,
UserRead = 256
}Publish to Azure Functions Linux
Step 1: Right-click the project and select Publish. Then, create a new profile in the Publish Window.
Step 2: Select the target as Azure and click Next.
Step 3: Right-click the project and select Publish. Then, create a new profile in the Publish Window. The Blink rendering engine will work in consumption plan. So, you can create the Azure Function App service with a consumption plan.
Step 4: Select the Create new.
Step 5: Click Create.
Step 6: After creating the function app service, click Finish.
Step 7: Click Close button.
Step 8: Click Publish.
Step 9: Now, Publish has succeeded.
Step 10: Now, go to the Azure portal and select the App Services. After running the service, click Get function URL > Copy. Include the URL as a query string in the URL. Then, paste it into the new browser tab. You will get the PDF document as follows.
A complete working sample can be downloaded from Github
Click here to explore the rich set of Syncfusion® HTML to PDF converter library features.
An online sample link to convert HTML to PDF document in ASP.NET Core.
Click here to explore the rich set of Syncfusion® HTML to PDF converter library features.
An online sample link to convert HTML to PDF document in ASP.NET Core.