PHPackages                             flamingosrules/dompdf - 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 &amp; Document Generation](/categories/documents)
4. /
5. flamingosrules/dompdf

ActiveLibrary[PDF &amp; Document Generation](/categories/documents)

flamingosrules/dompdf
=====================

DOMPDF is a CSS 2.1 compliant HTML to PDF converter

v0.8.2(8y ago)16LGPL-2.1PHPPHP &gt;=5.4.0

Since Feb 7Pushed 7y agoCompare

[ Source](https://github.com/flamingosRules/dompdf)[ Packagist](https://packagist.org/packages/flamingosrules/dompdf)[ Docs](https://github.com/dompdf/dompdf)[ RSS](/packages/flamingosrules-dompdf/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (4)Versions (15)Used By (0)

Dompdf
======

[](#dompdf)

[![Build Status](https://camo.githubusercontent.com/96143b11e27cd7364619b0e6587ab0cb8fba08c7f5dc8a11adf329950031df6b/68747470733a2f2f7472617669732d63692e6f72672f646f6d7064662f646f6d7064662e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/dompdf/dompdf)[![Latest Stable Version](https://camo.githubusercontent.com/31a21343b20fbe3865d090f8343934cbc0c4b4ef22d69e7f94400f141b2e6af1/68747470733a2f2f706f7365722e707567782e6f72672f646f6d7064662f646f6d7064662f762f737461626c652e706e67)](https://packagist.org/packages/dompdf/dompdf)[![Total Downloads](https://camo.githubusercontent.com/1b37eb32e163300bb392bd46fea96b5a00919d561ac2f25e4b85707bd3b7b00a/68747470733a2f2f706f7365722e707567782e6f72672f646f6d7064662f646f6d7064662f646f776e6c6f6164732e706e67)](https://packagist.org/packages/dompdf/dompdf)[![Latest Unstable Version](https://camo.githubusercontent.com/90e37ddd4f85515f2b7f35b51962b58d84a16f201b98eff70d0f65e3653f0829/68747470733a2f2f706f7365722e707567782e6f72672f646f6d7064662f646f6d7064662f762f756e737461626c652e706e67)](https://packagist.org/packages/dompdf/dompdf)[![License](https://camo.githubusercontent.com/6043736d50c8077da33e9790154a07c77d8924a3470a9b6580cf1521cc8c1e94/68747470733a2f2f706f7365722e707567782e6f72672f646f6d7064662f646f6d7064662f6c6963656e73652e706e67)](https://packagist.org/packages/dompdf/dompdf)

**Dompdf is an HTML to PDF converter**

At its heart, dompdf is (mostly) a [CSS 2.1](http://www.w3.org/TR/CSS2/) compliant HTML layout and rendering engine written in PHP. It is a style-driven renderer: it will download and read external stylesheets, inline style tags, and the style attributes of individual HTML elements. It also supports most presentational HTML attributes.

*This document applies to the latest stable code which may not reflect the current release. For released code please [navigate to the appropriate tag](https://github.com/dompdf/dompdf/tags).*

---

**Check out the [demo](https://dompdf.net/examples.php) and ask any question on [StackOverflow](http://stackoverflow.com/questions/tagged/dompdf) or on the [Google Groups](http://groups.google.com/group/dompdf).**

Follow us on [![Twitter](https://camo.githubusercontent.com/a48223ec1e9d088ad8d71cd6b9a63a3904b3c5f35d63fba3873ca3e55f135eef/687474703a2f2f747769747465722d6261646765732e73332e616d617a6f6e6177732e636f6d2f747769747465722d612e706e67)](http://www.twitter.com/dompdf) or [![Follow us on Google+](https://camo.githubusercontent.com/62d72d9b812f2b5ecd3bde69e4644bf49e52749433051ee194d31d54d7e2a516/68747470733a2f2f73736c2e677374617469632e636f6d2f696d616765732f69636f6e732f67706c75732d31362e706e67)](https://plus.google.com/108710008521858993320?prsrc=3).

---

Features
--------

[](#features)

- Handles most CSS 2.1 and a few CSS3 properties, including @import, @media &amp; @page rules
- Supports most presentational HTML 4.0 attributes
- Supports external stylesheets, either local or through http/ftp (via fopen-wrappers)
- Supports complex tables, including row &amp; column spans, separate &amp; collapsed border models, individual cell styling
- Image support (gif, png (8, 24 and 32 bit with alpha channel), bmp &amp; jpeg)
- No dependencies on external PDF libraries, thanks to the R&amp;OS PDF class
- Inline PHP support
- Basic SVG support

Requirements
------------

[](#requirements)

- PHP version 5.4.0 or higher
- DOM extension
- GD extension
- MBString extension
- php-font-lib
- php-svg-lib

### Recommendations

[](#recommendations)

- OPcache (OPcache, XCache, APC, etc.): improves performance
- IMagick or GMagick extension: improves image processing performance

Visit the wiki for more information:

About Fonts &amp; Character Encoding
------------------------------------

[](#about-fonts--character-encoding)

PDF documents internally support the following fonts: Helvetica, Times-Roman, Courier, Zapf-Dingbats, &amp; Symbol. These fonts only support Windows ANSI encoding. In order for a PDF to display characters that are not available in Windows ANSI, you must supply an external font. Dompdf will embed any referenced font in the PDF so long as it has been pre-loaded or is accessible to dompdf and reference in CSS @font-face rules. See the [font overview](https://github.com/dompdf/dompdf/wiki/About-Fonts-and-Character-Encoding)for more information on how to use fonts.

The [DejaVu TrueType fonts](http://dejavu-fonts.org) have been pre-installed to give dompdf decent Unicode character coverage by default. To use the DejaVu fonts reference the font in your stylesheet, e.g. `body { font-family: DejaVu Sans; }` (for DejaVu Sans). The following DejaVu 2.34 fonts are available: DejaVu Sans, DejaVu Serif, and DejaVu Sans Mono.

Easy Installation
-----------------

[](#easy-installation)

### Install with composer

[](#install-with-composer)

To install with [Composer](https://getcomposer.org/), simply require the latest version of this package.

```
composer require dompdf/dompdf
```

Make sure that the autoload file from Composer is loaded.

```
// somewhere early in your project's loading, require the Composer autoloader
// see: http://getcomposer.org/doc/00-intro.md
require 'vendor/autoload.php';
```

### Download and install

[](#download-and-install)

Download an archive of dompdf and extract it into the directory where dompdf will reside

- You can download stable copies of dompdf from
- Or download a nightly (the latest, unreleased code) from

Use the packaged release autoloader to load dompdf, libraries, and helper functions in your PHP:

```
// include autoloader
require_once 'dompdf/autoload.inc.php';
```

### Install with git

[](#install-with-git)

From the command line, switch to the directory where dompdf will reside and run the following commands:

```
git clone https://github.com/dompdf/dompdf.git
cd dompdf

git clone https://github.com/PhenX/php-font-lib.git lib/php-font-lib
cd lib/php-font-lib
git checkout 0.5.1
cd ..

git clone https://github.com/PhenX/php-svg-lib.git php-svg-lib
cd php-svg-lib
git checkout v0.3
```

Require dompdf, libraries, and helper functions in your PHP:

```
require_once 'dompdf/lib/html5lib/Parser.php';
require_once 'dompdf/lib/php-font-lib/src/FontLib/Autoloader.php';
require_once 'dompdf/lib/php-svg-lib/src/autoload.php';
require_once 'dompdf/src/Autoloader.php';
Dompdf\Autoloader::register();
```

Quick Start
-----------

[](#quick-start)

Just pass your HTML in to dompdf and stream the output:

```
// reference the Dompdf namespace
use Dompdf\Dompdf;

// instantiate and use the dompdf class
$dompdf = new Dompdf();
$dompdf->loadHtml('hello world');

// (Optional) Setup the paper size and orientation
$dompdf->setPaper('A4', 'landscape');

// Render the HTML as PDF
$dompdf->render();

// Output the generated PDF to Browser
$dompdf->stream();
```

### Setting Options

[](#setting-options)

Set options during dompdf instantiation:

```
use Dompdf\Dompdf;
use Dompdf\Options;

$options = new Options();
$options->set('defaultFont', 'Courier');
$dompdf = new Dompdf($options);
```

or at run time

```
use Dompdf\Dompdf;

$dompdf = new Dompdf();
$dompdf->set_option('defaultFont', 'Courier');
```

See [Dompdf\\Options](src/Options.php) for a list of available options.

Limitations (Known Issues)
--------------------------

[](#limitations-known-issues)

- Dompdf is not particularly tolerant to poorly-formed HTML input. To avoid any unexpected rendering issues you should either enable the built-in HTML5 parser at runtime (`$dompdf->set_option('isHtml5ParserEnabled', true);`) or run your HTML through a HTML validator/cleaner (such as [Tidy](http://tidy.sourceforge.net) or the [W3C Markup Validation Service](http://validator.w3.org)).
- Large files or large tables can take a while to render.
- CSS float is in development and may not produce the desired result

---

[![Donate button](https://camo.githubusercontent.com/acff8a4af46413276118b9f3b883b373601ac053d9dd5acf8a4e8a944c2538a9/68747470733a2f2f7777772e70617970616c2e636f6d2f656e5f55532f692f62746e2f62746e5f646f6e6174655f534d2e676966)](http://goo.gl/DSvWf)

*If you find this project useful, please consider making a donation. Any funds donated will be used to help further development on this project.)*

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~154 days

Recently: every ~168 days

Total

10

Last Release

3092d ago

PHP version history (2 changes)v0.7.0-betaPHP &gt;=5.3.0

v0.8.2PHP &gt;=5.4.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/25409269?v=4)[flamingos2018](/maintainers/flamingosRules)[@flamingosRules](https://github.com/flamingosRules)

---

Top Contributors

[![bsweeney](https://avatars.githubusercontent.com/u/485897?v=4)](https://github.com/bsweeney "bsweeney (356 commits)")[![PhenX](https://avatars.githubusercontent.com/u/42170?v=4)](https://github.com/PhenX "PhenX (233 commits)")[![gabrielbull](https://avatars.githubusercontent.com/u/671923?v=4)](https://github.com/gabrielbull "gabrielbull (38 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (17 commits)")[![simonberger](https://avatars.githubusercontent.com/u/7163526?v=4)](https://github.com/simonberger "simonberger (15 commits)")[![flaviencrochard](https://avatars.githubusercontent.com/u/564388?v=4)](https://github.com/flaviencrochard "flaviencrochard (13 commits)")[![Mellthas](https://avatars.githubusercontent.com/u/5852189?v=4)](https://github.com/Mellthas "Mellthas (6 commits)")[![tomlankhorst](https://avatars.githubusercontent.com/u/675432?v=4)](https://github.com/tomlankhorst "tomlankhorst (6 commits)")[![amacneil](https://avatars.githubusercontent.com/u/637671?v=4)](https://github.com/amacneil "amacneil (4 commits)")[![eddturtle](https://avatars.githubusercontent.com/u/902607?v=4)](https://github.com/eddturtle "eddturtle (4 commits)")[![andreasnij](https://avatars.githubusercontent.com/u/1712334?v=4)](https://github.com/andreasnij "andreasnij (3 commits)")[![Cyrille37](https://avatars.githubusercontent.com/u/368965?v=4)](https://github.com/Cyrille37 "Cyrille37 (3 commits)")[![ThomasLandauer](https://avatars.githubusercontent.com/u/1054469?v=4)](https://github.com/ThomasLandauer "ThomasLandauer (3 commits)")[![zimmski](https://avatars.githubusercontent.com/u/1847950?v=4)](https://github.com/zimmski "zimmski (2 commits)")[![alxndrmlr](https://avatars.githubusercontent.com/u/579553?v=4)](https://github.com/alxndrmlr "alxndrmlr (2 commits)")[![doubleslash](https://avatars.githubusercontent.com/u/1533784?v=4)](https://github.com/doubleslash "doubleslash (2 commits)")[![godrar](https://avatars.githubusercontent.com/u/1152802?v=4)](https://github.com/godrar "godrar (2 commits)")[![insightfuls](https://avatars.githubusercontent.com/u/635085?v=4)](https://github.com/insightfuls "insightfuls (2 commits)")[![marijnvdwerf](https://avatars.githubusercontent.com/u/737603?v=4)](https://github.com/marijnvdwerf "marijnvdwerf (2 commits)")[![marrch-caat](https://avatars.githubusercontent.com/u/6179078?v=4)](https://github.com/marrch-caat "marrch-caat (2 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/flamingosrules-dompdf/health.svg)

```
[![Health](https://phpackages.com/badges/flamingosrules-dompdf/health.svg)](https://phpackages.com/packages/flamingosrules-dompdf)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
