PHPackages mohamedhekal/arabic-laravel-mpdf - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [PDF & Document Generation](/categories/documents) 4. / 5. mohamedhekal/arabic-laravel-mpdf ActiveLibrary[PDF & Document Generation](/categories/documents) mohamedhekal/arabic-laravel-mpdf ================================ Laravel Mpdf: Arabic Customized for Using Mpdf in Laravel to generate Pdfs. V2.3(1y ago)1232[1 issues](https://github.com/mohamedhekal/arabic-laravel-mpdf/issues)MITPHPPHP ^5.6|^7.0|^8.0|^8.1|^8.2|^8.3 Since Sep 26Pushed 1y ago1 watchersCompare [ Source](https://github.com/mohamedhekal/arabic-laravel-mpdf)[ Packagist](https://packagist.org/packages/mohamedhekal/arabic-laravel-mpdf)[ RSS](/packages/mohamedhekal-arabic-laravel-mpdf/feed)WikiDiscussions main Synced 3w ago READMEChangelog (5)Dependencies (1)Versions (5)Used By (0) Laravel Mpdf: Customized Package for Generating Arabic PDFs - (Easy To use) - (Arabic Fonts Included). ====================================================================================================== [](#laravel-mpdf-customized-package-for-generating-arabic-pdfs---easy-to-use----arabic-fonts-included) Easily generate PDF files using [Laravel's Blade templates](https://laravel.com/docs/blade) and the [MPDF library](https://mpdf.github.io/). This package has been tested since Laravel 5.4. Installation ------------ [](#installation) Run this composer command in your laravel application: ``` composer require mohamedhekal/arabic-laravel-mpdf ``` Important Notes: ---------------- [](#important-notes) - Always check the [official MPDF documentation](https://mpdf.github.io/) - mPDF will timeout on [fetching external HTTP resources](https://github.com/mpdf/mpdf#known-server-caveats) 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 ----------- [](#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 ------ [](#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 ---------------------- [](#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 ------------------- [](#headers-and-footers) If you want to have headers and footers that appear on every page, add them to your `` tag like this: ``` Your Header Content Your Footer Content ``` 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 -------------- [](#included-fonts) By default you can use all the fonts [shipped with Mpdf](https://mpdf.github.io/fonts-languages/available-fonts-v6.html). Custom Fonts ------------ [](#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 ---------- [](#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](https://mpdf.github.io/troubleshooting/known-issues.html#blank-pages-or-some-sections-missing). 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('', 'pdf.document', $data); return $pdf->stream('document.pdf'); } } ``` ``` Hello World {{ $foo }} {{ $bar }} ``` Added Support for the Macroable Trait ------------------------------------- [](#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 ------- [](#license) Laravel Mpdf is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT) ### Health Score 26 — LowBetter than 41% of packages Maintenance12 Infrequent updates — may be unmaintained Popularity13 Limited adoption so far Community7 Small or concentrated contributor base Maturity61 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~106 days Total 4 Last Release 689d ago Major Versions v1.0.1 → V2.12024-08-08 PHP version history (3 changes)V1PHP ^5.6|^7.0|^8.0 v1.0.1PHP ^5.6|^7.0|^8.0|^8.1 V2.1PHP ^5.6|^7.0|^8.0|^8.1|^8.2|^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/a9d7c092a109fe780c7efd87ce4142eae2c0cec0f92fd1e87e769bec5661953b?d=identicon)[mohamedhekal](/maintainers/mohamedhekal) --- Top Contributors [![mohamedhekal](https://avatars.githubusercontent.com/u/21014387?v=4)](https://github.com/mohamedhekal "mohamedhekal (15 commits)") --- Tags laravelpdfmpdf ### Embed Badge ![Health badge](/badges/mohamedhekal-arabic-laravel-mpdf/health.svg) ``` [![Health](https://phpackages.com/badges/mohamedhekal-arabic-laravel-mpdf/health.svg)](https://phpackages.com/packages/mohamedhekal-arabic-laravel-mpdf) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)