Signatur
Beschreibung
fdf_errno() gibt den Fehlercode zurück, der bei der zuletzt ausgeführten Operation der FDF-Bibliothek (Acrobat Forms Data Format) aufgetreten ist. Der Rückgabewert ist eine ganze Zahl, die einem der vordefinierten FDF-Fehlercodes entspricht.
Diese Funktion wird typischerweise zur Fehlerdiagnose eingesetzt, nachdem eine andere FDF-Funktion fehlgeschlagen ist oder unerwartetes Verhalten gezeigt hat. In Kombination mit fdf_error(), die den zugehörigen Fehlertext liefert, lässt sich eine aussagekräftige Fehlerbehandlung implementieren.
Ein Rückgabewert von 0 bedeutet, dass kein Fehler aufgetreten ist (FDFErcOK). Alle anderen Werte weisen auf spezifische Fehlertypen hin, die in der FDF-Dokumentation von Adobe definiert sind.
Hinweis: Die FDF-Erweiterung gilt als veraltet und ist ab PHP 5.3.0 nicht mehr standardmäßig verfügbar. Sie sollte nicht für neue Projekte verwendet werden.
Rückgabewert
0 steht für keinen Fehler (FDFErcOK). Andere Werte entsprechen den in der Acrobat FDF Toolkit Dokumentation definierten Fehlercodes.Beispiele
Fehlercode nach einer FDF-Operation prüfen
<?php
// FDF-Dokument öffnen
$fdf = fdf_open('formular.fdf');
// Fehlercode der letzten Operation abfragen
$fehlercode = fdf_errno();
if ($fehlercode !== 0) {
echo 'Fehlercode: ' . $fehlercode . PHP_EOL;
echo 'Fehlermeldung: ' . fdf_error($fehlercode) . PHP_EOL;
} else {
echo 'Keine Fehler aufgetreten.' . PHP_EOL;
// Weiterverarbeitung ...
fdf_close($fdf);
}Hilfsfunktion zur FDF-Fehlerbehandlung
<?php
function fdf_check_error(string $kontext = ''): bool {
$code = fdf_errno();
if ($code !== 0) {
$msg = fdf_error($code);
error_log(sprintf('[FDF-Fehler%s] Code %d: %s',
$kontext !== '' ? ' in ' . $kontext : '',
$code,
$msg
));
return false;
}
return true;
}
$fdf = fdf_open('daten.fdf');
if (!fdf_check_error('fdf_open')) {
exit('FDF konnte nicht geöffnet werden.');
}
$wert = fdf_get_value($fdf, 'Name');
fdf_check_error('fdf_get_value');
fdf_close($fdf);// Wichtig · Fallstricke
Veraltet: Die FDF-Erweiterung (ext/fdf) wurde mit PHP 5.3.0 als veraltet markiert und in neueren PHP-Versionen entfernt. Für aktuelle Projekte sollte stattdessen eine moderne PDF-Bibliothek wie FPDF, mPDF oder die pdftk-CLI-Lösung verwendet werden.
Die FDF-Bibliothek muss korrekt installiert und in der php.ini aktiviert sein (extension=php_fdf.dll bzw. extension=fdf.so), damit diese Funktion verfügbar ist.