Unknown 1cf8679705 Miscellaneous fixes 7 years ago
..
.github 4f489045cc PDF categories and style 7 years ago
classes 4f489045cc PDF categories and style 7 years ago
collations 4f489045cc PDF categories and style 7 years ago
data 4f489045cc PDF categories and style 7 years ago
examples 4f489045cc PDF categories and style 7 years ago
font 4f489045cc PDF categories and style 7 years ago
graph_cache 4f489045cc PDF categories and style 7 years ago
iccprofiles 4f489045cc PDF categories and style 7 years ago
includes 4f489045cc PDF categories and style 7 years ago
patterns 4f489045cc PDF categories and style 7 years ago
qrcode 4f489045cc PDF categories and style 7 years ago
src 4f489045cc PDF categories and style 7 years ago
tests 4f489045cc PDF categories and style 7 years ago
tmp 4f489045cc PDF categories and style 7 years ago
ttfontdata 4f489045cc PDF categories and style 7 years ago
ttfonts 4f489045cc PDF categories and style 7 years ago
utils 4f489045cc PDF categories and style 7 years ago
vendor 4f489045cc PDF categories and style 7 years ago
.travis.yml 4f489045cc PDF categories and style 7 years ago
CHANGELOG.md 4f489045cc PDF categories and style 7 years ago
CHANGELOG.txt 4f489045cc PDF categories and style 7 years ago
CREDITS.txt 4f489045cc PDF categories and style 7 years ago
LICENSE.txt 4f489045cc PDF categories and style 7 years ago
MpdfException.php 4f489045cc PDF categories and style 7 years ago
README.md 4f489045cc PDF categories and style 7 years ago
Tag.php 4f489045cc PDF categories and style 7 years ago
canvas-download.php 1cf8679705 Miscellaneous fixes 7 years ago
canvas-pdf.css 4f489045cc PDF categories and style 7 years ago
canvas-save.php 1cf8679705 Miscellaneous fixes 7 years ago
composer.json 4f489045cc PDF categories and style 7 years ago
composer.lock 4f489045cc PDF categories and style 7 years ago
compress.php 4f489045cc PDF categories and style 7 years ago
config.php 4f489045cc PDF categories and style 7 years ago
config_fonts-distr-without-OTL.php 4f489045cc PDF categories and style 7 years ago
config_fonts.php 4f489045cc PDF categories and style 7 years ago
config_lang2fonts.php 4f489045cc PDF categories and style 7 years ago
config_script2lang.php 4f489045cc PDF categories and style 7 years ago
graph.php 4f489045cc PDF categories and style 7 years ago
lang2fonts.css 4f489045cc PDF categories and style 7 years ago
makepdf.php 4f489045cc PDF categories and style 7 years ago
mpdf.css 4f489045cc PDF categories and style 7 years ago
mpdf.php 4f489045cc PDF categories and style 7 years ago
phpunit.xml 4f489045cc PDF categories and style 7 years ago
progbar.css 4f489045cc PDF categories and style 7 years ago

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.

Build Status

Installation

Preferred installation method is via composer and its packagist package mpdf/mpdf.

Manual installation

  • Download the .zip release file and unzip it
  • Create a folder e.g. /mpdf on your server
  • Upload all of the files to the server, maintaining the folders as they are
  • Ensure that you have write permissions set (CHMOD 6xx or 7xx) for the following folders:

    /ttfontdata/ - used to cache font data; improves performance a lot

    /tmp/ - used for some images and ProgressBar

    /graph_cache/ - if you are using JpGraph in conjunction with mPDF

To test the installation, point your browser to the basic example file:

[path_to_mpdf_folder]/mpdf/examples/example01_basic.php

If you wish to define a different folder for temporary files rather than /tmp/ see the note on Folder for temporary files in the section on Installation & Setup in the manual.

If you have problems, please read the section on troubleshooting in the manual.

Online manual

Online manual is available at https://mpdf.github.io/.

Unit Testing

Unit testing for mPDF is done using PHPUnit.

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

To execute tests, run vendor/bin/phpunit from the command line while in the mPDF root directory.

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.