fdf_get_file — Funktion · PHP-Referenz

Signatur

fdf_get_file(resource $fdf_document): string

Beschreibung

fdf_get_file() liest den im FDF-Dokument hinterlegten /F-Schlüssel aus, der auf die zugehörige PDF-Datei verweist. FDF (Forms Data Format) ist ein Format, das Formulardaten zusammen mit einer Referenz auf das ursprüngliche PDF-Formular speichert. Der /F-Schlüssel enthält typischerweise einen Pfad oder URL zur PDF-Datei, mit der die Formulardaten verknüpft sind.

Diese Funktion ist nützlich, wenn FDF-Daten empfangen werden und bekannt sein muss, aus welchem Formular diese Daten stammen – etwa um die richtige Verarbeitung oder Weiterleitung zu steuern. Der zurückgegebene Wert entspricht dem, was mit fdf_set_file() gesetzt wurde.

Die FDF-Erweiterung gehört zur Adobe-FDF-Toolkit-Unterstützung in PHP und ermöglicht das Lesen, Erstellen und Schreiben von FDF-Dokumenten für die Arbeit mit PDF-Formularen. Beachte, dass die FDF-Erweiterung als veraltet gilt und in modernen PHP-Versionen nicht mehr enthalten ist.

Parameter

Name	Typ	Default	Beschreibung
$fdf_document Pflicht	resource		Eine FDF-Dokument-Ressource, die zuvor mit `fdf_open()`, `fdf_open_string()` oder `fdf_create()` geöffnet bzw. erzeugt wurde.

Rückgabewert

Typ

string

Beschreibung

Gibt den Wert des /F-Schlüssels als Zeichenkette zurück. Ist kein /F-Schlüssel im FDF-Dokument vorhanden, wird eine leere Zeichenkette zurückgegeben.

Beispiele

Verknüpfte PDF-Datei aus einem FDF-Dokument ermitteln

<?php
// FDF-Dokument aus einer Datei öffnen
$fdf = fdf_open('/var/www/forms/eingabe.fdf');

if ($fdf !== false) {
    // Den /F-Schlüssel (Pfad zur verknüpften PDF-Datei) auslesen
    $pdf_datei = fdf_get_file($fdf);

    if ($pdf_datei !== '') {
        echo 'Verknüpfte PDF-Datei: ' . htmlspecialchars($pdf_datei);
    } else {
        echo 'Kein /F-Schlüssel im FDF-Dokument vorhanden.';
    }

    fdf_close($fdf);
} else {
    echo 'FDF-Dokument konnte nicht geöffnet werden.';
}
?>

Verknüpfte PDF-Datei: http://www.example.com/formulare/antrag.pdf

FDF-Dokument erstellen und /F-Schlüssel setzen und auslesen

<?php
// Neues FDF-Dokument erstellen
$fdf = fdf_create();

// Den /F-Schlüssel auf eine PDF-Datei setzen
fdf_set_file($fdf, 'https://www.example.com/formulare/bestellung.pdf');

// Den gesetzten /F-Schlüssel wieder auslesen
$pdf_pfad = fdf_get_file($fdf);
echo 'Gespeicherter PDF-Pfad: ' . htmlspecialchars($pdf_pfad);

// FDF-Dokument schließen
fdf_close($fdf);
?>

Gespeicherter PDF-Pfad: https://www.example.com/formulare/bestellung.pdf

// Wichtig · Fallstricke

Veraltet: Die FDF-Erweiterung (ext/fdf) ist seit PHP 5.x nicht mehr aktiv gepflegt und in modernen PHP-Distributionen (PHP 7+) in der Regel nicht mehr verfügbar. Für neue Projekte sollten Alternativen wie PDFParser oder andere PDF-Bibliotheken (z. B. TCPDF, FPDF) verwendet werden.

Der Rückgabewert enthält den Pfad oder die URL exakt so, wie er im FDF-Dokument gespeichert ist. Wird der Wert weiterverarbeitet oder ausgegeben, sollte er stets mit htmlspecialchars() kodiert werden, um XSS-Angriffe zu verhindern.

Siehe auch

fdf_set_file fdf_open fdf_open_string fdf_create fdf_close fdf_get_value