Max Bold - Webdesign mit PHP und HTML

Solche PHP-Klassen kann ein PHP-Programmierer auch für individuelle Lösungen heranziehen und damit relativ komfortabel und mit wenig Codieraufwand den Output von PDF-Dokumenten aus einer Webanwendung heraus realisieren.

»Die PHP-Variante«

Der Platzhirsch auf diesem Sektor ist die Bibliothek PDFlib ( www.pdflib.com), die alle notwendigen API-Funktionen für die PDF-Erstellung zur Verfügung stellt. Es handelt sich dabei um ein kommerzielles Produkt, für das bei einer kommerziellen Nutzung Lizenzgebühren fällig werden. Es gibt jedoch auch noch mit PDFlib Lite eine Open-Source-Va-riante, die einen kostenlosen Einsatz unter bestimmten Bedingungen erlaubt, allerdings nur eine Teilmenge der von PDFlib angebotenen Funktionen unterstützt. Seit der Version 6 bietet PDFlib zusätzlich zum funktionsorientierten API für PHP 4 ein objektorientiertes API für PHP 5.

Mit der PHP-Klasse EZPDF lassen sich auch ansprechende Tabellen generieren.

»Freie Alternativen«

Wem die PDFlib nicht zur Verfügung steht, der kann als Alternative zu einem in PHP implementierten Ersatz greifen. Dabei handelt es sich in der Regel um eine Klasse, die dem Webentwickler Funktionen ähnlich denen von PDFlib zur Verfügung stellt. Neben funktionalen Einschränkungen muss man bei dieser Variante eventuell auch mit einer reduzierten Performance leben.Während es sich nämlich bei PDFlib um eine echte, in C geschriebene PHP-Erweiterung handelt, muss bei einer PDF-Klasse der Interpreter die ganze Arbeit leisten.

Ein Beispiel für eine solche Klasse ist EZPDF, die unter sourceforge.net/projects/pdf-php zum kostenlosen Download zur Verfügung steht.

Installation und Nutzung sind denkbar einfach: Entpacken Sie das Archiv und legen Sie es im gewünschten Server-Verzeichnis ab. Die entscheidenden Dateien sind class , ezpdf.php und class.pdf.php .Wichtig ist auch noch das Verzeichnis mit den Schriften. Zur ersten Orientierung sieht man sich am besten das Skript readme.php an. Es generiert aus einer Textdatei das Handbuch zu der Klasse - natürlich als PDF. Ein einfaches Beispiel, bei dem eine Textdatei als PDF ausgegeben werden soll, kann so aussehen:

Neben dem kompakten Code erfreut EZPDF den Entwickler noch mit ein paar netten Gimmicks: Mit ezTable kann man zum Beispiel aus den Werten eines Arrays schnell eine PDF-Tabelle erzeugen. Dabei können die Array-Werte zum Beispiel aus eine CSV-Datei oder einer Datenbankabfrage stammen. Ein konkretes Beispiel sieht etwa folgendermaßen aus:

Man kann Bilder mit ezImage einbinden oder mit Zeichenwerkzeugen operieren ( line, ellipse, polygon, rectangle ). Ja sogar Bezier-Kurven lassen sich zeichnen ( curve ).

»PDFs mit FPDF«

Eine weitere Bibliothek zum Erzeugen von PDFs aus einer Webapplikation heraus ist FPDF ( www.fpdf.org). Auch hier ist die Installation sehr einfach:Aus dem entpackten Archiv kopieren Sie fpdf.phpund den Ordner fontauf Ihren Webserver Für die Arbeit mit der Bibliothek müssen Sie als Erstes die Klassendatei einbinden und definieren, wo sich die Schriften befinden. Die Ausgabe einer Textdatei kann mit dem folgenden Codefragment realisiert werden:

Zuerst muss die Klassendatei eingebunden werden.

Ein PDF mit einem Bildelement, produziert mit der PHP-Klasse FPDF.

Mit AddPage() wird eine neue Seite in das Dokument eingefügt. Der Text wird mit fgets() zeilenweise eingelesen und mit write() in das PDF eingefügt. Zuvor muss noch eine Schriftart mit SetFont() festgelegt werden. Sie können auf die Schriften im Verzeichnis fontzugreifen.Andere Schriften lassen sich auf Wunsch installieren. Mit SetFontQ können Sie durch zusätzliche Parameter den Schriftschnitt und die Schriftgröße definieren. Die Angabe der Schriftgröße erfolgt in der Maßeinheit Punkt, unabhängig von der für das Dokument festgelegten Maßeinheit.

Standardmäßig wird die zuletzt festgelegte Schriftgröße verwendet, die mit SetFontSize() oder einem vorherigen SetFont() -Aufruf gesetzt wurde. Wir keine Größe angegeben, ist die Schrift automatisch 12 Punkt groß. Der Schriftstil wird den Buchstaben U (Unterstreichung), I (kursiv) oder B (fett) definiert. Mehrere Buchstaben lassen sich auch kombinieren, um zum Beispiel einen kursiven Fettdruck zu realisieren.

»Mehrzeilige Texte«

Für den Einbau der Zeilen in das PDF-Dokument wird die Methode write() verwendet. Sie gibt einen Text ab der aktuellen Position aus. Ist der rechte Seitenrand erreicht oder taucht in dem String ein \n auf, erfolgt ein Zeilenumbruch. Am linken Seitenrand erfolgt die Ausgabe in einer neuen Zeile.

Mehrzeilige Texte lassen sich mit der Methode MultiCell() ausgeben, wobei die Texte auch über mehrere Seiten laufen können. Als Parameter gibt man der Methode die Breite und Höhe einer Zeile, den Text und optional einen Rahmen an.

Durch die Kombination verschiedener Methoden lassen sich auch aufwendigere PDFs generieren. Das folgende Beispiel platziert zuerst eine Headline in einer Schriftgröße von 32 Punkt, dann eine Bannergrafik und schließlich den Fließtext aus einer Datei:

Gegenüber dem ersten Beispiel werden hier noch folgende weitere Methoden verwendet: Zuerst wird mit SetFont('Anal ' /'B',32) die Schriftgröße auf 32 Punkt und fett festgelegt. Mit der Cell() -Methode wird anschließend eine Headline ausgegeben. Danach soll ein Bild erscheinen. Das erledigt die Methode ImageQ, die die Bilddatei sowie eine horizontale und vertikale Positionsangabe als Parameter benötigt.

Bevor nun der eigentliche Text ausgegeben werden kann, muss der Pointer an eine Position unterhalb des Bildes positioniert werden. Das erledigt die Methode SetY() .

»Ausgabe des PDFs«

Die Methode Output() , die dann in der letzten Zeile aufgerufen wird, schickt die Daten direkt an den Browser. Standardmäßig sendet FPDF die Daten als Datei mit dem Namen doc.pdf zum Browser. Um die Datei unter einem anderen Namen zu verschicken, geben Sie diesen einfach als ersten Parameter an. Mit dem zweiten Parameter können Sie dann noch bestimmen, ob die Datei wirklich an den Browser geschickt werden soll. Geben Sie 'I' an, so wird die Datei im Browser dargestellt, wenn ein entsprechendes Plug-in vorhanden ist. Der String 'D' sendet die Datei als Download an den Browser. Hierbei kann es allerdings passieren, dass der ein oder andere Browser das ignoriert und die Datei trotzdem via Plug-in darstellt. Mit dem Parameter 'F' wird das PDF-Dokument als Datei auf dem Server abgespeichert, und 'S' gibt die Datei als String zurück. [mb]

Lightbox

Mit dem Lightbox-Effekt, realisiert mit JavaScript, lassen sich Bilder oder auch komplette Diaschauen mit interessanten Effekten auf Webseiten präsentieren. Von Max Bold

Auf einen Blick

» Dieser Workshop stellt zwei Javascript-Bibliotheken vor, mit deren Hilfe sich Lightbox-Effekte für die Darstellung von Bildern auf Webseiten einfach realisieren lassen.

Das brauchen Sie

» Die Javascript-Bibliotheken Litebox 1.0 ( www.doknowevil.net/litebox) und Lightbox 2 ( www.lokeshdhakar.com/projects/lightbox2/)

Der Lightbox-Effekt präsentiert auf einer abgedunkelten Webseite die Großansichten Ihrer Fotos. Mit einem Klick auf ein kleines Vorschaubild wird die Webseite abgedunkelt und die Großansicht des Bildes überlagert sie. Diese trendige Funktion bauen Sie mit dem JavaScript-Paket Litebox 1.0 ( www.doknowevil.net/litebox) sehr einfach in die eigenen Webseiten ein.