包简介

Laravel Mpdf: Arabic Customized for Using Mpdf in Laravel to generate Pdfs.

README 文档

README

Easily generate PDF files using Laravel's Blade templates and the MPDF library. This package has been tested since Laravel 5.4.

Installation

Run this composer command in your laravel application:

composer require mohamedhekal/arabic-laravel-mpdf

Important Notes:

Always check the official MPDF documentation
mPDF will timeout on fetching external HTTP resources when using single-threaded servers such as php -S or artisan serve. Use a proper webserver for full functionality.

To start using Laravel, add the Service Provider and the Facade to your config/app.php:

Note: This package supports auto-discovery features of Laravel 5.5+, You only need to manually add the service provider and alias if working on Laravel version lower then 5.5.

'providers' => [
    // ...
    MohamedHekal\ArabicLaravelMpdf\ArabicLaravelMpdfServiceProvider::class
]

'aliases' => [
    // ...
    'PDF' => MohamedHekal\ArabicLaravelMpdf\Facades\ArabicLaravelMpdf::class
]

Basic Usage

To use Laravel Mpdf add something like this to one of your controllers. You can pass data to a view in /resources/views.

//....

use PDF;

class ReportController extends Controller 
{
    public function viewPdf()
    {
        $data = [
            'foo' => 'bar'
        ];

        $pdf = PDF::loadView('pdf.document', $data);

        return $pdf->stream('document.pdf');
    }

}

Config

You can use a custom file to overwrite the default configuration. Just execute php artisan vendor:publish --tag=mpdf-config or create config/pdf.php and add this:

return [
    'mode'                       => '',
    'format'                     => 'A4',
    'default_font_size'          => '12',
    'default_font'               => 'sans-serif',
    'margin_left'                => 10,
    'margin_right'               => 10,
    'margin_top'                 => 10,
    'margin_bottom'              => 10,
    'margin_header'              => 0,
    'margin_footer'              => 0,
    'orientation'                => 'P',
    'title'                      => 'Laravel mPDF',
    'author'                     => '',
    'watermark'                  => '',
    'show_watermark'             => false,
    'show_watermark_image'       => false,
    'watermark_font'             => 'sans-serif',
    'display_mode'               => 'fullpage',
    'watermark_text_alpha'       => 0.1,
    'watermark_image_path'       => '',
    'watermark_image_alpha'      => 0.2,
    'watermark_image_size'       => 'D',
    'watermark_image_position'   => 'P',
    'custom_font_dir'            => '',
    'custom_font_data'           => [],
    'auto_language_detection'    => false,
    'temp_dir'                   => storage_path('app'),
    'pdfa'                       => false,
    'pdfaauto'                   => false,
    'use_active_forms'           => false,
];

To override this configuration on a per-file basis use the fourth parameter of the initializing call like this:

// ...

PDF::loadView('pdf', $data, [], [
    'title' => 'Another Title',
    'margin_top' => 0
])->save($pdfFilePath);

Get instance your Mpdf

You can access all mpdf methods through the mpdf instance with getMpdf method.

use PDF;

$pdf = PDF::loadView('pdf.document', $data);
$pdf->getMpdf()->AddPage(/*...*/);

Headers and Footers

If you want to have headers and footers that appear on every page, add them to your <body> tag like this:

<htmlpageheader name="page-header">
    Your Header Content
</htmlpageheader>

<htmlpagefooter name="page-footer">
    Your Footer Content
</htmlpagefooter>

Now you just need to define them with the name attribute in your CSS:

@page {
  header: page-header;
  footer: page-footer;
}

Inside of headers and footers {PAGENO} can be used to display the page number.

Included Fonts

By default you can use all the fonts shipped with Mpdf.

Custom Fonts

You can use your own fonts in the generated PDFs. The TTF files have to be located in one folder, e.g. resources/fonts/. Add this to your configuration file (/config/pdf.php):

return [
    'custom_font_dir'  => base_path('resources/fonts/'), // don't forget the trailing slash!
    'custom_font_data' => [
        'examplefont' => [ // must be lowercase and snake_case
            'R'  => 'ExampleFont-Regular.ttf',    // regular font
            'B'  => 'ExampleFont-Bold.ttf',       // optional: bold font
            'I'  => 'ExampleFont-Italic.ttf',     // optional: italic font
            'BI' => 'ExampleFont-Bold-Italic.ttf' // optional: bold-italic font
        ]
      // ...add as many as you want.
    ]
];

Now you can use the font in CSS:

body {
  font-family: 'examplefont', sans-serif;
}

Chunk HTML

For big HTML you might get Uncaught Mpdf\MpdfException: The HTML code size is larger than pcre.backtrack_limit xxx error, or you might just get empty or blank result. In these situations you can use chunk methods while you added a separator to your HTML:

//....
use PDF;
class ReportController extends Controller 
{
    public function generate_pdf()
    {
        $data = [
            'foo' => 'hello 1',
            'bar' => 'hello 2'
        ];
        $pdf = PDF::chunkLoadView('<html-separator/>', 'pdf.document', $data);
        return $pdf->stream('document.pdf');
    }
}

<div>
    <h1>Hello World</h1>

    <table>
        <tr><td>{{ $foo }}</td></tr>
    </table>
    
    <html-separator/>

    <table>
        <tr><td>{{ $bar }}</td></tr>
    </table>

    <html-separator/>
</div>

Added Support for the Macroable Trait

You can configure the macro in the AppServiceProvider provider file.

//...
use MohamedHekal\ArabicLaravelMpdf\ArabicLaravelMpdf;

class AppServiceProvider extends ServiceProvider
{
  //...

    public function boot()
    {
        ArabicLaravelMpdf::macro('hello', function () {
            return "Hello, World!";
        });
    }

  //...
}

Now

PDF::loadView(/* ... */)->hello();

License

Laravel Mpdf is open-sourced software licensed under the MIT license

mohamedhekal/arabic-laravel-mpdf 适用场景与选型建议

mohamedhekal/arabic-laravel-mpdf 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 233 次下载、GitHub Stars 达 1，最近一次更新时间为 2023 年 09 月 26 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「pdf」「mpdf」「laravel」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

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

围绕 mohamedhekal/arabic-laravel-mpdf 我们能提供哪些服务？

定制开发 / 二次开发

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

BUG 修复 & 性能优化

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

项目外包 & 长期维护

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

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

与 mohamedhekal/arabic-laravel-mpdf 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

rezgui/laravel-mpdf-dz 0

Laravel MPdf : Easily generate PDF files with arabic support

imjcw/laravel-pdf 0

Generate PDFs in Laravel with this mPDF wrapper.

vzool/laravel-pdf 1

Generate PDFs in Laravel with this mPDF wrapper.

gonzakpo/tcpdfbundle 0

Provides TCPDF integration for Symfony

willmav5000/laravel-mpdf 0

A mPDF Wrapper for Laravel

peripteraptos/laravel-pdf 0

Generate PDFs in Laravel with this mPDF wrapper.

mohamedhekal/arabic-laravel-mpdf

包简介

关键字：

README 文档

README

Installation

Important Notes:

Basic Usage

Config

Get instance your Mpdf

Headers and Footers

Included Fonts

Custom Fonts

Chunk HTML

Added Support for the Macroable Trait

License

mohamedhekal/arabic-laravel-mpdf 适用场景与选型建议

与 mohamedhekal/arabic-laravel-mpdf 相关的其它包

统计信息

GitHub 信息

其他信息