kikusempai/mpdf

A PHP class to generate PDF files from HTML with Unicode/UTF-8 and CJK support

Wednesday, May 10, 2017
by kikusempai
Repository
1 Watchers
0 Stars
1,486 Installations

PHP
1 Dependents
0 Suggesters
447 Forks
0 Open issues
28 Versions
2 % Grown

The README.md

mPDF is a PHP class which generates PDF files from UTF-8 encoded HTML. It is based on FPDF and HTML2FPDF (see CREDITS), with a number of enhancements. mPDF was written by Ian Back and is released under the GNU GPL v2 licence., _(*1)

, _(*2)

Note: If you are viewing this file on mPDF Github repository homepage or on Packagist, please note that the default repository branch is development which can differ from the last stable release., _(*3)

Requirements

mPDF 7.0 requires PHP ^5.6 || ~7.0.0 || ~7.1.0. PHP mbstring and gd extensions have to be loaded., _(*4)

Additional extensions may be required for some advanced features such as zlib for compression of output and embedded resources such as fonts, bcmath for generating barcodes or xml for character set conversion and SVG handling., _(*5)

Support us

Consider supporting development of mPDF with a donation of any value. [Donation button][1] can be found on the [main page of the documentation][1]., _(*6)

Installation

Official installation method is via composer and its packagist package mpdf/mpdf., _(*7)

$ composer require mpdf/mpdf

Usage

The simplest usage of the library would be as follows:, _(*8)

<?php

require_once __DIR__ . '/vendor/autoload.php';

$mpdf = new \Mpdf\Mpdf();
$mpdf->WriteHTML('

Hello world!

');
$mpdf->Output();

This will output the PDF inline to the browser as application/pdf Content-type., _(*9)

Setup & Configuration

All configuration directives can be set by the $config parameter of the constructor., _(*10)

It is recommended to set one's own temporary directory via tempDir configuration variable. The directory must have write permissions (mode 775 is recommended) for users using mPDF (typically cli, webserver, fpm)., _(*11)

<?php

$mpdf = new \Mpdf\Mpdf(['tempDir' => __DIR__ . '/tmp']);

By default, the temporary directory will be inside vendor directory and will have correct permissions from post_install composer script., _(*12)

For more information about custom temporary directory see the note on Folder for temporary files in the section on Installation & Setup in the [manual][1]., _(*13)

If you have problems, please read the section on troubleshooting in the manual., _(*14)

Online manual

Online manual is available at https://mpdf.github.io/., _(*15)

Contributing

See [CONTRIBUTING.md][2] file in the project., _(*16)

Unit Testing

Unit testing for mPDF is done using PHPUnit., _(*17)

To get started, run composer install from the command line while in the mPDF root directory (you'll need composer installed first)., _(*18)

To execute tests, run vendor/bin/phpunit from the command line while in the mPDF root directory., _(*19)

Any assistance writing unit tests for mPDF is greatly appreciated. If you'd like to help, please note that any PHP file located in the /tests/ directory will be autoloaded when unit testing., _(*20)

The Versions

10/05 2017

6.1.1.x-dev

6.1.1.9999999-dev http://mpdf.github.io

A PHP class to generate PDF files from HTML with Unicode/UTF-8 and CJK support

library mpdf

A PHP class to generate PDF files from HTML with Unicode/UTF-8 and CJK support

kikusempai/mpdf

The README.md

Requirements

Support us

Installation

Usage

Hello world!

Setup & Configuration

Online manual

Contributing

Unit Testing

The Versions

6.1.1.x-dev

The Requires

The Development Requires

by Ian Back

v6.1.0.1

The Requires

The Development Requires

by Ian Back

dev-master

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

v7.0.0.2

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

dev-development

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

v7.0.0-beta3

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

v7.0.0.1

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

dev-test

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

v7.0.0-beta2

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

dev-barcode-hide-numbers

The Requires

The Development Requires

by Ian Back

by Matěj Humpál

v7.0.0-beta1

The Requires

The Development Requires

by Ian Back

v6.1.3

The Requires

The Development Requires

by Ian Back

v6.1.2a

The Requires

The Development Requires

by Ian Back

v6.1.2

The Requires

The Development Requires

by Ian Back

6.1.x-dev

The Requires