scragg0x/fpdf

Unofficial PSR-0 compliant version of the FPDF library

1.7.3 2015-01-05 22:05 UTC

This package is not auto-updated.

Last update: 2024-12-17 17:00:44 UTC


README

Latest Stable Version

Unofficial PSR-0 compliant version of the FPDF library

This is version 1.7 with some minor changes:

  • the library is namespaced in fpdf. To create instance use

    $fpdf = new \fpdf\FPDF();

  • directory structure follow the PSR-0 standard with src/ as root

  • on error a RuntimeException is thrown instead on lib dramatically dying

  • constructor is renamed __construct instead of FPDF

Installing with composer

The package exists in the packagist repository as itbz/fpdf.

FPDF_EXTENDED

This package also contains some extensions that break backwards compatibility. To access the enhanced functinality use FPDF_EXTENDED instead of FPDF.

  • FPDF_EXTENDED expects all input to be UTF-8 encoded. FPDF natively expects all input to be ISO-8859-1 encoded and recommends the use of utf8_decode() when working with utf-8 encoded strings.

  • FPDF uses a somewath strange syntax for printing the total number of pages in the pdf. FPDF_EXTENDED defines two methods to handle this. TotalPagesNo() returns a string that will be replaced with total number of pages at output. PaginationStr() takes an optional delimiter (default '/') and retuns '{current page} / {total number of pages}'.

  • Calling AliasNbPages() is no longer necessary.

  • You may set an image path using setImagePath() and image() will be able to understand relative paths.

  • FPDF_EXTENDED gracefuly handles missing font styles. If a font is only defined (added) for one style (eg. bold) and you try to use another (eg. italic) this FPDF_EXTENDED fallbacks to the defined style (eg. bold). Regular styles takes precedence.

  • FPDF_EXTENDED defines moveX() and moveY() to move the cursor, in addition to FPDFs setX() and setY().

  • Subclasses of FPDF_EXTENDED may define draw(). Draw is called just before pdf is rendered. In this may actions can be taken just before pdf creation.

  • FPDF_EXTENDED defines GetPdf() as a shorthand for outputing the pdf as a raw string.

  • AS of version 1.7.2 FPDF_EXTENDED defines WriteXY() for writing to a specified position.