fdf_error — Funktion · PHP-Referenz

Signatur

fdf_error(int $error_code = -1): string

Beschreibung

fdf_error() ist Teil der FDF-Erweiterung (Forms Data Format) und liefert zu einem numerischen FDF-Fehlercode eine lesbare Fehlermeldung als Zeichenkette. FDF ist ein von Adobe entwickeltes Format zum Austausch von Formularfelddaten in PDF-Dokumenten.

Wird kein Fehlercode übergeben (oder wird -1 als Standardwert verwendet), gibt die Funktion die Beschreibung des zuletzt aufgetretenen FDF-Fehlers zurück. Andernfalls wird die Beschreibung zum explizit angegebenen Fehlercode geliefert. Dies ermöglicht eine gezielte Fehlerauswertung nach FDF-Operationen.

Typischerweise wird fdf_error() in Kombination mit fdf_errno() verwendet: Zunächst prüft man mit fdf_errno(), ob ein Fehler aufgetreten ist, und ruft dann fdf_error() auf, um die zugehörige Beschreibung für Logging oder Nutzerausgabe zu erhalten.

Hinweis: Die FDF-Erweiterung ist veraltet und wurde in modernen PHP-Versionen entfernt. Sie stand nur zur Verfügung, wenn PHP mit der Acrobat FDF Toolkit Bibliothek kompiliert wurde.

Parameter

Name	Typ	Default	Beschreibung
$error_code	int	-1	Der numerische FDF-Fehlercode, dessen Beschreibung abgerufen werden soll. Wird `-1` übergeben oder kein Argument angegeben, wird der zuletzt aufgetretene Fehlercode verwendet.

Rückgabewert

Typ

string

Beschreibung

Gibt eine lesbare Fehlerbeschreibung als Zeichenkette zurück, die dem angegebenen oder zuletzt aufgetretenen FDF-Fehlercode entspricht.

Beispiele

Letzten FDF-Fehler ermitteln und ausgeben

<?php
// FDF-Dokument öffnen und Fehler prüfen
$fdf = fdf_open('formular.fdf');

$errno = fdf_errno();
if ($errno !== 0) {
    $beschreibung = fdf_error($errno);
    echo 'FDF-Fehler ' . $errno . ': ' . $beschreibung;
} else {
    echo 'FDF-Dokument erfolgreich geöffnet.';
    fdf_close($fdf);
}

FDF-Fehler 4: File not found

Beschreibung eines bestimmten Fehlercodes abrufen

<?php
// Beschreibung für einen bekannten FDF-Fehlercode ausgeben
$fehlerCode = 2;
$beschreibung = fdf_error($fehlerCode);
echo 'Beschreibung für Fehlercode ' . $fehlerCode . ': ' . $beschreibung;

Beschreibung für Fehlercode 2: Unknown error

// Wichtig · Fallstricke

Veraltet / Entfernt: Die FDF-Erweiterung (ext/fdf) gilt als veraltet und ist in aktuellen PHP-Versionen (ab PHP 7.x aufwärts) nicht mehr verfügbar. Für die Verarbeitung von PDF-Formulardaten sollten moderne Alternativen wie FPDI oder externe Bibliotheken verwendet werden.

Die Funktion setzt voraus, dass PHP mit der Acrobat FDF Toolkit Bibliothek von Adobe kompiliert wurde. Ohne diese Bibliothek steht die gesamte fdf_*-Funktionsfamilie nicht zur Verfügung.

Siehe auch

fdf_errno fdf_open fdf_close fdf_create