Forum und email

Forms Data Format Functions

Introducere

Forms Data Format (FDF) is a format for handling forms within PDF documents. You should read the documentation at » https://partners.adobe.com/asn/acrobat/forms.jsp for more information on what FDF is and how it is used in general.

The general idea of FDF is similar to HTML forms. The difference is basically the format how data is transmitted to the server when the submit button is pressed (this is actually the Form Data Format) and the format of the form itself (which is the Portable Document Format, PDF). Processing the FDF data is one of the features provided by the fdf functions. But there is more. One may as well take an existing PDF form and populated the input fields with data without modifying the form itself. In such a case one would create a FDF document (fdf_create()) set the values of each input field (fdf_set_value()) and associate it with a PDF form (fdf_set_file()). Finally it has to be sent to the browser with MimeType application/vnd.fdf. The Acrobat reader plugin of your browser recognizes the MimeType, reads the associated PDF form and fills in the data from the FDF document.

If you look at an FDF-document with a text editor you will find a catalogue object with the name FDF. Such an object may contain a number of entries like Fields, F, Status etc.. The most commonly used entries are Fields which points to a list of input fields, and F which contains the filename of the PDF-document this data belongs to. Those entries are referred to in the FDF documentation as /F-Key or /Status-Key. Modifying this entries is done by functions like fdf_set_file() and fdf_set_status(). Fields are modified with fdf_set_value(), fdf_set_opt() etc..

Necesităţi

You need the FDF toolkit SDK available from » https://partners.adobe.com/asn/acrobat/forms.jsp. As of PHP 4.3.0 you need at least SDK version 5.0. The FDF toolkit library is available in binary form only, platforms supported by Adobe are Win32, Linux, Solaris and AIX.

Instalarea

You must compile PHP with --with-fdftk[=DIR].

Notă: If you run into problems configuring PHP with fdftk support, check whether the header file fdftk.h and the library libfdftk.so are at the right place. The configure script supports both the directory structure of the FDF SDK distribution and the usual DIR/include / DIR/lib layout, so you can point it either directly to the unpacked distribution directory or put the header file and the appropriate library for your platform into e.g. /usr/local/include and /usr/local/lib and configure with --with-fdftk=/usr/local.

Notă: Note to Win32 Users Pentru ca această extensie să funcţioneze, anumite fişiere DLL trebuie să fie accesibile în calea de sistem a Windows din variabila PATH. Accesaţi FAQ întitulat "Cum să adaug directorul meu PHP la variabila PATH din Windows" pentru informaţii despre cum să realizaţi aceasta. Cu toate că copierea fişierelor DLL din directorul PHP în directorul de sistem al Windows de asemenea funcţionează (deoarece directorul de sistem este în mod implicit inclus în variabila PATH), acest lucru nu este recomandabil. Această extensie necesită ca următoarele fişiere să existe în calea PATH: fdftk.dll

Configuraţia la rulare

Această extensie nu are directive de configurare definite în php.ini.

Tipurile resurselor

fdf

Most fdf functions require a fdf resource as their first parameter. A fdf resource is a handle to an opened fdf file. fdf resources may be obtained using fdf_create(), fdf_open() and fdf_open_string().

Constante predefinite

Constantele de mai jos sunt definite de această extensie şi vor fi disponibile doar dacă această extensie a fost compilată în interiorul PHP, sau a fost încărcată dinamic în timpul rulării.

FDFValue (integer)
FDFStatus (integer)
FDFFile (integer)
FDFID (integer)
FDFFf (integer)
FDFSetFf (integer)
FDFClearFf (integer)
FDFFlags (integer)
FDFSetF (integer)
FDFClrF (integer)
FDFAP (integer)
FDFAS (integer)
FDFAction (integer)
FDFAA (integer)
FDFAPRef (integer)
FDFIF (integer)
FDFEnter (integer)
FDFExit (integer)
FDFDown (integer)
FDFUp (integer)
FDFFormat (integer)
FDFValidate (integer)
FDFKeystroke (integer)
FDFCalculate (integer)
FDFNormalAP (integer)
FDFRolloverAP (integer)
FDFDownAP (integer)

Exemple

The following examples shows just the evaluation of form data.

Example#1 Evaluating a FDF document

<?php
// Open fdf from input string provided by the extension
// The pdf form contained several input text fields with the names
// volume, date, comment, publisher, preparer, and two checkboxes
// show_publisher and show_preparer.
$fdf fdf_open_string($HTTP_FDF_DATA);
$volume fdf_get_value($fdf"volume");
echo 
"The volume field has the value '<b>$volume</b>'<br />";

$date fdf_get_value($fdf"date");
echo 
"The date field has the value '<b>$date</b>'<br />";

$comment fdf_get_value($fdf"comment");
echo 
"The comment field has the value '<b>$comment</b>'<br />";

if (
fdf_get_value($fdf"show_publisher") == "On") {
  
$publisher fdf_get_value($fdf"publisher");
  echo 
"The publisher field has the value '<b>$publisher</b>'<br />";
} else
  echo 
"Publisher shall not be shown.<br />";

if (
fdf_get_value($fdf"show_preparer") == "On") {
  
$preparer fdf_get_value($fdf"preparer");
  echo 
"The preparer field has the value '<b>$preparer</b>'<br />";
} else
  echo 
"Preparer shall not be shown.<br />";
fdf_close($fdf);
?>

Cuprins