Start · Sprachen · PHP · Referenz · fdf_close

fdf_close

Funktion

Schließt ein geöffnetes FDF-Dokument und gibt alle damit verbundenen Ressourcen frei.

seit PHP 4.0.0 Kategorie: io

Signatur

fdf_close(resource $fdf_document): void

Beschreibung

fdf_close() schließt ein zuvor mit fdf_open() oder fdf_open_string() geöffnetes FDF-Dokument (Forms Data Format). Die Funktion gibt den intern belegten Speicher und alle Ressourcen frei, die mit dem Dokument verbunden sind.

FDF ist ein von Adobe entwickeltes Format zum Austausch von Formulardaten aus PDF-Dokumenten. Nachdem alle notwendigen Lese- oder Schreiboperationen auf dem FDF-Dokument durchgeführt wurden, sollte fdf_close() aufgerufen werden, um Ressourcen nicht unnötig zu blockieren.

Es empfiehlt sich, fdf_close() immer dann aufzurufen, wenn das FDF-Dokument nicht mehr benötigt wird – vergleichbar mit fclose() für reguläre Datei-Handles. Das Vergessen dieses Aufrufs kann bei lang laufenden PHP-Prozessen zu Speicherlecks führen.

Parameter

Name Typ Default Beschreibung
$fdf_document Pflicht resource Das FDF-Dokumenten-Handle, das von fdf_open() oder fdf_open_string() zurückgegeben wurde.

Rückgabewert

Typ
void
Beschreibung
Die Funktion gibt keinen Wert zurück.

Beispiele

FDF-Dokument öffnen, Daten lesen und schließen

<?php
// FDF-Datei öffnen
$fdf = fdf_open('/pfad/zu/formular.fdf');

if ($fdf !== false) {
    // Feldwert eines Formularfeldes auslesen
    $vorname = fdf_get_value($fdf, 'Vorname');
    $nachname = fdf_get_value($fdf, 'Nachname');

    echo 'Vorname: ' . htmlspecialchars($vorname) . PHP_EOL;
    echo 'Nachname: ' . htmlspecialchars($nachname) . PHP_EOL;

    // Dokument schließen und Ressourcen freigeben
    fdf_close($fdf);
} else {
    echo 'Fehler: FDF-Datei konnte nicht geöffnet werden.';
}
Vorname: Max Nachname: Mustermann

FDF-Dokument aus POST-Daten erstellen und schließen

<?php
// FDF-Dokument aus den gesendeten POST-Daten erzeugen
$fdf = fdf_open_string($HTTP_FDF_DATA);

if ($fdf !== false) {
    // Alle gewünschten Felder verarbeiten
    $felder = ['Name', 'Email', 'Telefon'];
    foreach ($felder as $feld) {
        $wert = fdf_get_value($fdf, $feld);
        echo $feld . ': ' . htmlspecialchars($wert) . PHP_EOL;
    }

    // Ressourcen freigeben
    fdf_close($fdf);
}

// Wichtig · Fallstricke

Deprecation-Hinweis: Die FDF-Erweiterung (ext/fdf) gilt als veraltet und wird in modernen PHP-Versionen (ab PHP 5.3 offiziell als deprecated markiert) nicht mehr aktiv weiterentwickelt. Für neue Projekte sollten Alternativen wie die FPDF- oder TCPDF-Bibliothek sowie spezialisierte PDF-Bibliotheken in Betracht gezogen werden.

Die FDF-Erweiterung muss explizit kompiliert oder als Shared Extension geladen werden und ist auf vielen Produktivsystemen nicht verfügbar. Prüfen Sie die Verfügbarkeit mit extension_loaded('fdf').