Installation

Anleitung für die Installation von FPDF

Die Installation von FPDF gestaltet sich einfach. Bitte folgenden Sie den nachstehend aufgeführten Schritten um FPDF zu installieren und zu verwenden.

Schritt 1 - Herunterladen von FPDF

Laden die das Archiv der gewünschten Version von FPDF (aktuellste Version ist 1.53) im Downloadbereich herunter und entpacken Sie das Archiv in ein Verzeichnis, auf das Ihre PHP-Scripte, zugreifen können. Als Beispiel wird im folgenden das Verzeichnis /home/www/fpdf verwendet.

In dem Verzeichnis, in dem das Archiv entpackt wurde, sollten (kann versionsabhängig abweichen) folgende Verzeichnisse und Dateien vorhanden sein:

  • doc
  • font
  • tutorial
  • FAQ.htm
  • fpdf.css
  • fpdf.php
  • histo.htm
  • install.txt

Wichtig hierbei ist das Vorhandensein der Datei fpdf.php (enthält die FPDF Klasse) und des Verzeichnisses font (enthält die Schriftarten-Dateien),

Schritt 2 - FPDF Klasse einbinden

Damit Sie die FPDF Klasse in Ihren PHP Scripten verwenden können, müssen Sie die Datei fpdf.php mit der include() Funktion in Ihr Script einbinden. In diesem Beispiel lautet die Anweisung zum Einbinden der fpdf.php, entsprechend dem oben genannten Verzeichnis:

include("/home/www/fpdf/fpdf.php");

Schritt 3 - Pfad für Schriftarten-Dateien definieren

Wenn Sie FPDF ab Version 1.53 verwenden und die Schriftartendateien im Unterordner font/ des Installationsverzeichnis liegen, ist die Definition dieser Konstante nicht mehr erforderlich.

Falls Sie FPDF in der Version 1.52 oder niedriger verwenden, ist es erforderlich den Pfad zu den Schriftarten-Dateien zu definieren, damit Sie für FPDF Schriftarten verwenden können.

Die Schriftarten-Dateien liegen standardmäßig im Unterverzeichnis font im Installationsverzeichnis (siehe Schritt 1). Um der FPDF Klasse vor Version 1.53 diese Information bereitzustellen, ist die Definition von FPDF_FONTPATH erforderlich. Das folgende Beispiel bezieht sich wieder auf das in Schritt 1 genannte Installationsverzeichnis.

define('FPDF_FONTPATH','/home/www/fpdf/font/'); include("/home/www/fpdf/fpdf.php");


Sie können diese Anweisung in jedem Script, in dem das FPDF Script eingebunden wird vornehmen, oder diese Definition direkt im fpdf.php Script vornehmen. Hierzu ändern Sie bitte die Zeilen (die Versionsnummer kann abweichen)

define('FPDF_VERSION','1.52');

class FPDF


in die Zeilen

define('FPDF_VERSION','1.52');
define('FPDF_FONTPATH','/home/www/fpdf/font/');

class FPDF


um. Beachten Sie bitte, dass diese Verzeichnisangabe wieder auf das in Schritt 1 genannte Beispiel-Installationsverzeichnis bezieht und von Ihnen angepasst werden muss.

Schritt 4 - Die erste Verwendung von FPDF

Die Installation von FPDF ist nach diesen Schritten abgeschlossen und FPDF kann nun von Ihnen verwendet werden. Führen Sie hierzu einfach folgendes Script aus, wobei Sie bitte die Angabe /home/www/fpdf durch das von Ihnen verwendete Installationsverzeichnis ersetzen.

<?php

define('FPDF_INSTALLDIR', '/home/www/fpdf');

if(!defined('FPDF_FONTPATH')) define('FPDF_FONTPATH', FPDF_INSTALLDIR.'/font/');

include(FPDF_INSTALLDIR.'/fpdf.php');

// Prüfen ob die Klasse existiert
if(class_exists('FPDF')) {
    // Die Klasse existiert, Installation ok
    die("Die Installation war erfolgreich. Die Klasse FPDF existiert.");
} else {
    // Die Klasse existiert nicht
    die("Die Klasse FPDF existiert nicht. Prüfen Sie, ob die Datei '".FPDF_INSTALLDIR."/fpdf.php' vorhanden ist.");
}

?>

Schritt 5 - FPDF Objekt erstellen

Wenn Sie beim Ausführen des in Schritt 4 aufgeführten Scripts die Meldung "Die Installation war erfolgreich. Die Klasse FPDF existiert." erhalten, war die Installation erfolgreich und Sie können mit der folgenden Anweisung ein Objekt aus der FPDF Klasse erzeugen um FPDF zu nutzen:

$pdf = new FPDF();

Schritt 6 - Allgemeines zur Verwendung von Klassen

Sofern Sie noch nicht mit Klassen gearbeitet haben, bietet Ihnen das PHP Manual - Objektorientierte Programmierung (OOP) eine ausführliche Dokumentation zu diesem Thema.

Schritt 7 - Funktionen von FPDF

Die Funktionen der FPDF Klasse sind ausführlich in der Dokumentation unter Funktionsreferenz beschrieben. Die Dokumentation einer Funktion können Sie auch schnell und einfach über die Auswahlbox (recht oben) aufrufen.

Haben Sie noch Fragen?

Sollten Sie noch Fragen zur Installation von FPDF haben, teilen Sie diese bitte in unserem Forum mit den anderen Usern.