包简介

A Laravel package to convert PDF files to HTML using poppler-utils

README 文档

README

A Laravel package that converts PDF files to HTML with preserved formatting and styling using poppler-utils.

Requirements

PHP 8.2 or higher
Laravel 7.x|8.x|9.x|10.x|11.x
pdftohtml command-line tool (poppler-utils)

Installation

Install the package via Composer:

composer require moinul/laravel-pdf-to-html

Install the required system dependency:

For Ubuntu/Debian:

sudo apt-get install poppler-utils

For CentOS/RHEL:

sudo yum install poppler-utils

For macOS:

brew install poppler

The package will automatically register its service provider in Laravel 5.5 and newer.
Create the storage symlink if you haven't already:

php artisan storage:link

Usage

Basic Usage

use Moinul\LaravelPdfToHtml\Services\PdfToHtmlConverter;

public function convertPdf(Request $request)
{
    $converter = app(PdfToHtmlConverter::class);
    $html = $converter->convert('path/to/your/file.pdf');
    
    return $html; // Returns HtmlString
}

Example Route

Here's a complete example of a route that converts a PDF file to HTML:

use Illuminate\Support\Facades\Route;

Route::get('/pdf-to-html', function () {
    $pdfPath = public_path('example.pdf');
    
    try {
        $converter = app(PdfToHtmlConverter::class);
        $html = $converter->convert($pdfPath);
        
        return view('pdf.html-output', ['html' => $html]);
    } catch (\Exception $e) {
        return "Error converting PDF: " . $e->getMessage();
    }
});

Example View

Create a view file resources/views/pdf/html-output.blade.php:

<!DOCTYPE html>
<html>
<head>
    <title>PDF to HTML Conversion</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
</head>
<body>
    {!! $html !!}
</body>
</html>

Features

Converts PDF files to responsive HTML
Preserves text formatting and layout
Handles images and maintains their positions
Includes print-friendly styles
Responsive design for various screen sizes
Uses the efficient pdftohtml command-line tool

How it Works

The package uses the pdftohtml command-line tool from poppler-utils to convert PDF files to HTML. The conversion process:

Takes a PDF file as input
Converts it to HTML while preserving formatting
Processes images and fixes their paths
Adds responsive and print-friendly CSS
Returns a clean, formatted HTML string

License

This package is open-sourced software licensed under the MIT license.

Support

If you encounter any issues or have questions, please create an issue on GitHub.

moinul/laravel-pdf-to-html 适用场景与选型建议

moinul/laravel-pdf-to-html 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 105 次下载、GitHub Stars 达 0，最近一次更新时间为 2025 年 04 月 24 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 moinul/laravel-pdf-to-html 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 moinul/laravel-pdf-to-html 我们能提供哪些服务？

定制开发 / 二次开发

基于 moinul/laravel-pdf-to-html 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

moinul/laravel-pdf-to-html

包简介