Start · Sprachen · PHP · Referenz · fdf_get_version

fdf_get_version

Funktion

Gibt die Versionsnummer einer FDF-Datei oder – ohne Argument – die Version des FDF-Toolkits zurück.

seit PHP 4.3.0 Kategorie: io

Signatur

fdf_get_version(resource $fdf_document = null): string

Beschreibung

fdf_get_version() gehört zur FDF-Erweiterung (Forms Data Format) von PHP und ermöglicht die Abfrage der Versionsnummer. Wird ein gültiges FDF-Dokument-Handle übergeben, liefert die Funktion die Versionsnummer der geöffneten FDF-Datei. Wird kein Argument (oder null) übergeben, gibt die Funktion stattdessen die Versionsnummer des installierten Adobe FDF Toolkits zurück.

FDF (Forms Data Format) ist ein Format zum Austausch von Formulardaten in PDF-Dokumenten. Die Versionsinformation kann nützlich sein, um sicherzustellen, dass das FDF-Toolkit mit den vorliegenden FDF-Dateien kompatibel ist, bevor Daten ausgelesen oder geschrieben werden.

Die Funktion ist Teil der fdf-Erweiterung, die das Adobe FDF Toolkit voraussetzt. Diese Erweiterung ist in modernen PHP-Versionen kaum noch verbreitet und gilt als veraltet. Für neue Projekte sollten alternative Bibliotheken zur PDF-Formularverarbeitung in Betracht gezogen werden.

Parameter

Name Typ Default Beschreibung
$fdf_document resource|null null Ein FDF-Dokument-Handle, das zuvor mit fdf_open() oder fdf_create() erzeugt wurde. Wird null oder kein Argument übergeben, wird die Version des FDF-Toolkits zurückgegeben.

Rückgabewert

Typ
string
Beschreibung
Gibt die Versionsnummer als Zeichenkette zurück. Ist ein FDF-Dokument-Handle angegeben, entspricht dies der Version der FDF-Datei (z. B. "1.2"). Ohne Argument wird die Version des Adobe FDF Toolkits zurückgegeben (z. B. "5.0").

Beispiele

Toolkit-Version ausgeben

<?php
// Gibt die Version des installierten FDF-Toolkits aus
$version = fdf_get_version();
echo "FDF Toolkit Version: " . $version . PHP_EOL;
?>
FDF Toolkit Version: 5.0

Version einer geöffneten FDF-Datei auslesen

<?php
// FDF-Datei öffnen
$fdf = fdf_open('/pfad/zur/formulardaten.fdf');
if ($fdf !== false) {
    // Version der FDF-Datei abfragen
    $fileVersion = fdf_get_version($fdf);
    echo "FDF-Datei Version: " . $fileVersion . PHP_EOL;

    // Dokument schließen
    fdf_close($fdf);
} else {
    echo "FDF-Datei konnte nicht geöffnet werden." . PHP_EOL;
}
?>
FDF-Datei Version: 1.2

// Wichtig · Fallstricke

Veraltet: Die fdf-Erweiterung erfordert das Adobe FDF Toolkit, das seit vielen Jahren nicht mehr aktiv weiterentwickelt wird. Die Erweiterung ist in Standard-PHP-Distributionen häufig nicht enthalten und muss separat kompiliert bzw. installiert werden.

Für neue Projekte, die mit PDF-Formularen arbeiten müssen, empfehlen sich Alternativen wie TCPDF, FPDI oder smalot/pdfparser. Diese benötigen kein externes Adobe-Toolkit und werden aktiv gepflegt.