robbertkl/simplepdf

Simple extension of ZendPdf, allowing top-to-bottom geometry using arbitrary units (e.g. inches or centimeters)

v1.0.2 2016-05-19 09:13 UTC

This package is not auto-updated.

Last update: 2024-11-19 02:00:31 UTC


README

Latest Stable Version

Internal PDF geometry (and therefore ZendPdf as well) uses "points" (1/72 of an inch), with [0, 0] being the bottom left corner of a page. This library, which extends ZendPdf, changes this by using arbitrary units (e.g. inches or centimeters) and going from top-to-bottom, which makes much more sense from a user's persepective. Also, very basic functionality has been added, like text alignment, margins and word wrap.

SimplePdf is PSR-0, PSR-1 and PSR-2 compliant.

Semantic Versioning is used for releases / tags.

Requirements

  • PHP 5.3 or newer
  • ZendPdf component, which it extends

Installation

The easiest way to install is using Composer / Packagist by adding this to you composer.json file:

"require": {
    "robbertkl/simplepdf": "dev-master"
}

Alternatively, you could manually include/autoload the appriate files from the classes/ dir.

Documentation

See the examples/ dir for usage examples. Also, check out the API documentation, generated using ApiGen.

Known Limitations

  • The extension is not complete at all; only specific methods (to accommodate my needs) have been overridden to handle custom units + top-to-bottom geometry
  • The word-wrap code is still pretty basic; for example, it doesn't do word-breaking or handle certain border cases
  • Unfortunately, ZendPdf was kicked out of ZF2, and doesn't seem to be maintained (although it still works fine)

Authors

License

SimplePdf is published under the MIT License.