Migrating
Table of Contents
From Version 2.46 to >=2.47 (Namespaces)
In version 2.47 we finally introduce namespaces into the code base which results in a complete new class structure and class names.
All classes were renamed and we added a backwards compatiblity layer with the use of class aliases to support the old class names. So there's no real need to refactor but it's simply a cosmetic change and a matter of style. All our demos and documentation will use the namespaced version in the future.
The new root namespace for the SetaPDF-FormFiller component is: setasign\SetaPDF2\FormFiller
You can find the new class names by following the class alias definition in your IDE or simply search for the old class name in the manual.
We intensively tested the namespaced version with projects or our own test-suite using the old class names and an upgrade is possible without touching any code.
Anyhow we found very rare and special situations which you need to pay attention on and which we documented in the manual of the SetaPDF-Core component.
If you encounter any problem or question, do not hesitate to contact us at support@setasign.com.
From Version 2.x to 2.5
What has changed
As of version 2.5 the SetaPDF-FormFiller component allows you to fill in static and dynamic XFA forms.
If an XFA form was loaded in a version before 2.5 it was a must to introduce the component to remove these information by calling setRemoveXfaInformation()
. Otherwise the component had thrown an exception if you'd tried to access a field instance.
If you want to benefit from the new XFA support you should remove this call from your php scripts. Anyhow it's still possible to remove the XFA information.
Removed Classes
In version 2.5 the SetaPDF_FormFiller_Exception_Xfa
exception class was removed. If you rely on that specific exception you will need to refactor your php code.
Deprecated Methods
The save() method of the \setasign\SetaPDF2\FormFiller\FormFiller
class is marked as deprecated as of version 2.5. It's only a proxy method to the \setasign\SetaPDF2\Core\Document::save()
method as of version 2.5 and has no other functionallity.