Signatur
Beschreibung
fdf_set_version() legt die Versionsnummer eines FDF-Dokuments (Forms Data Format) fest. FDF ist ein von Adobe entwickeltes Dateiformat zum Austausch von Formulardaten aus PDF-Dokumenten. Die Versionsnummer gibt an, welche FDF-Spezifikationsversion das Dokument entspricht.
Die Funktion wird typischerweise verwendet, wenn ein neues FDF-Dokument mit fdf_create() erzeugt wurde und vor dem Speichern oder Senden eine bestimmte Versionskompatibilität sichergestellt werden soll. Gängige Versionswerte sind z. B. '1.2' oder '1.4', entsprechend den jeweiligen Acrobat-Versionen.
Die FDF-Erweiterung (fdftk) gilt seit PHP 5.3 als veraltet und wurde in neueren PHP-Versionen entfernt. Für moderne Projekte empfiehlt sich der Einsatz von Bibliotheken wie FPDF, TCPDF oder setasign/fpdi, die aktiv gepflegt werden.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $fdf_document Pflicht | resource | Eine gültige FDF-Dokument-Ressource, wie sie von fdf_create() oder fdf_open() zurückgegeben wird. |
|
| $version Pflicht | string | Die zu setzende Versionsnummer als Zeichenkette, z. B. '1.2' oder '1.4'. |
Rückgabewert
true bei Erfolg zurück, oder false im Fehlerfall (z. B. wenn das FDF-Dokument ungültig ist).Beispiele
FDF-Dokument erstellen und Versionsummer setzen
<?php
// FDF-Erweiterung muss installiert und aktiviert sein
$fdf = fdf_create();
if ($fdf !== false) {
// Versionsnummer auf 1.2 setzen
$result = fdf_set_version($fdf, '1.2');
if ($result) {
echo "Version erfolgreich gesetzt.\n";
} else {
echo "Fehler beim Setzen der Version.\n";
}
// FDF-Daten an den Browser senden
header('Content-Type: application/vnd.fdf');
fdf_save($fdf);
// Ressource schließen
fdf_close($fdf);
} else {
echo "FDF-Dokument konnte nicht erstellt werden.\n";
}
?>FDF-Dokument aus Datei öffnen und Version aktualisieren
<?php
// Bestehendes FDF-Dokument öffnen
$fdf = fdf_open('/pfad/zu/dokument.fdf');
if ($fdf !== false) {
// Version aktualisieren
fdf_set_version($fdf, '1.4');
// Geänderte Datei speichern
fdf_save($fdf, '/pfad/zu/dokument_v14.fdf');
fdf_close($fdf);
echo "Version auf 1.4 aktualisiert und Datei gespeichert.\n";
} else {
echo "Datei konnte nicht geöffnet werden.\n";
}
?>// Wichtig · Fallstricke
Veraltet: Die FDF-Erweiterung (fdftk) wurde mit PHP 5.3 als veraltet markiert und ist in aktuellen PHP-Versionen (ab PHP 8.0) nicht mehr verfügbar. fdf_set_version() sollte daher nur in Legacy-Projekten mit PHP 5.x oder älteren PHP-7.x-Versionen eingesetzt werden.
Für neue Projekte empfiehlt sich stattdessen die Verwendung aktiv gewarteter PDF/FDF-Bibliotheken wie TCPDF, setasign/fpdi oder mikehaertl/php-pdftk, die auch unter aktuellen PHP-Versionen funktionieren.