zendframework/zend-form

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #235 fixes PHP 7.4 compatibility.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #235 fixes PHP 7.4 compatibility.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #232 fixes validating $creationOption
  of Zend\Form\ElementFactory. Allowed values are: array, Traversable or null.
  If invalid value provided exception will be thrown.

• #234 registers Search and Tel form elements
  within Zend\Form\FormElementManager plugin manager.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #232 fixes validating $creationOption of Zend\Form\ElementFactory. Allowed values are: array, Traversable or null. If invalid value provided exception will be thrown.

• #234 registers Search and Tel form elements within Zend\Form\FormElementManager plugin manager.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #230 fixes the "__clone method called on non-object" error that happens when
  the $targetElement is null within a Collection instance. It now properly
  sets the data to an empty array in such circumstances.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #230 fixes the "__clone method called on non-object" error that happens when the $targetElement is null within a Collection instance. It now properly sets the data to an empty array in such circumstances.

Added

• #228 adds support for PHP 7.3.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• #228 removes support for zend-stdlib v2 releases.

Fixed

• Nothing.

Added

• #228 adds support for PHP 7.3.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• #228 removes support for zend-stdlib v2 releases.

Fixed

• Nothing.

Added

• #224 adds support for zend-hydrator v3 releases, while keeping support for
  versions 1 and 2.

• #211 adds support for the HTML5 minlength attribute in all form elements
  that support it.

• #217 adds Zend\Form\View\HelperTrait, which can be used to provide IDE
  autocompletion for view helpers provided by zend-form. See
  https://docs.zendframework.com/zend-form/view-helpers/#ide-auto-completion-in-templates
  for more information.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Nothing.

Added

• #224 adds support for zend-hydrator v3 releases, while keeping support for versions 1 and 2.

• #211 adds support for the HTML5 minlength attribute in all form elements that support it.

• #217 adds Zend\Form\View\HelperTrait, which can be used to provide IDE autocompletion for view helpers provided by zend-form. See https://docs.zendframework.com/zend-form/view-helpers/#ide-auto-completion-in-templates for more information.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Nothing.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #218 ensures object values of select elements can be rendered without error.

• #216 fixes an issue when performing data binding and a fieldset has no mapped
  input elements, casting null values to empty arrays to ensure they can be
  passed to an input filter.

• #207 fixes the return value annotation for the Fieldset::get() method to
  indicate it can also return a FieldsetInterface instance.

Added

• Nothing.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #218 ensures object values of select elements can be rendered without error.

• #216 fixes an issue when performing data binding and a fieldset has no mapped input elements, casting null values to empty arrays to ensure they can be passed to an input filter.

• #207 fixes the return value annotation for the Fieldset::get() method to indicate it can also return a FieldsetInterface instance.

Added

• #194 adds the ability to whitelist additional HTML attributes for use with a view helper,
  as well as attribute prefixes. These can be enabled via the following:

  $helper->addValidAttribute('attribute-name');
  $helper->addValidAttributePrefix('prefix-');

• #188 adds a new method to the FormElementErrors view helper, setTranslateMessages(bool $flag).
  By default, the helper continues to translate error messages (if a translator
  is present), as introduced in 2.11.0. However, using this method, you can
  disable translation, which may be necessary to prevent double translation
  and/or to reduce logs from missed translation lookups. Because the method
  implements a fluent interface, you may do so in one line:

  echo $this->formElementErrors()->setTranslateMessages(false)->render($element);

  Note: you will need to reset the value afterwards if you want translations to occur
  in later invocations.

Changed

• #193 modifies how attributes are escaped. If zend-espaper raises an exception
  for an invalid attribute value, helpers will now catch the exception, and use
  a blank value for the attribute. This prevents 500 errors from being raised
  for such pages.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Nothing.

Added

• #194 adds the ability to whitelist additional HTML attributes for use with a view helper, as well as attribute prefixes. These can be enabled via the following:

  $helper->addValidAttribute('attribute-name');
  $helper->addValidAttributePrefix('prefix-');
  

• #188 adds a new method to the FormElementErrors view helper, setTranslateMessages(bool $flag). By default, the helper continues to translate error messages (if a translator is present), as introduced in 2.11.0. However, using this method, you can disable translation, which may be necessary to prevent double translation and/or to reduce logs from missed translation lookups. Because the method implements a fluent interface, you may do so in one line:

  echo $this->formElementErrors()->setTranslateMessages(false);
  

  Note: you will need to reset the value afterwards if you want translations to occur in later invocations.

Changed

• #193 modifies how attributes are escaped. If zend-espaper raises an exception for an invalid attribute value, helpers will now catch the exception, and use a blank value for the attribute. This prevents 500 errors from being raised for such pages.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Nothing.

Added

• #104 adds the ability for the FormElementErrors view helper to translate validation error messages using the composed translator and text domain instances.

• #171, #186, and #187 add support for PHP 7.2.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• #171 removes support for HHVM.

• #186 removes support for PHP 5.5.

Fixed

• #162 fixes an issue with hydration when a form has called setWrapElements(true), ensuring that binding values in a fieldset will correctly identify the elements in the provided data.

• #172 fixes the DateTime element such that it no longer attempts to use its DATETIME_FORMAT constant, but, rather, the value of the $format property, when representing the element; this change allows developers to override the format, which was the original intention.

• #178 loosens the checks in Zend\Form\Element\DateTime::getValue() to check against PHP's DateTimeInterface (vs DateTime) when retrieving the value; this fixes edge cases where it was instead returning the format for DateTimeImmutable values.

Added

• #104 adds the ability for the FormElementErrors view helper to translate validation error messages using the composed translator and text domain instances.

• #171, #186, and #187 add support for PHP 7.2.

Changed

• Nothing.

Deprecated

• Nothing.

Removed

• #171 removes support for HHVM.

• #186 removes support for PHP 5.5.

Fixed

• #162 fixes an issue with hydration when a form has called setWrapElements(true), ensuring that binding values in a fieldset will correctly identify the elements in the provided data.

• #172 fixes the DateTime element such that it no longer attempts to use its DATETIME_FORMAT constant, but, rather, the value of the $format property, when representing the element; this change allows developers to override the format, which was the original intention.

• #178 loosens the checks in Zend\Form\Element\DateTime::getValue() to check against PHP's DateTimeInterface (vs DateTime) when retrieving the value; this fixes edge cases where it was instead returning the format for DateTimeImmutable values.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #161 adds an import statement to the ElementFactory, fixing an error whereby checks for Traversable creation options would lead to a service creation exception; these now correctly identify traversable options and convert them to an array.
• #164 fixes how the FormElementManagerFactory factory initializes the plugin manager instance, ensuring it is injecting the relevant configuration from the config service and thus seeding it with configured form/form element services. This means that the form_elements configuration will now be honored in non-zend-mvc contexts.
• #159 fixes the behavior of the min and max attributes of the various DateTime elements, ensuring that the elements raise an exception during instantiation if the values provided are in a format that DateTime does not recognize for the element type in question.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #134 fixes how the FormElementManager handles invokable classes when the autoAddInvokableClass flag is enabled. Previously, it used the built-in utilities from zend-servicemanager, but now correctly uses its own setInvokableClass() method, which forces usage of the ElementFactory for such classes, and thus ensures the name and options are passed to the element constructor.
• #136 fixes how error messages are provided when an element uses a required ArrayInput, but no values are submitted. Previously, no messages were returned; now they are.
• #156 fixes how elements that act as InputProviders are merged into parent CollectionInputFilters; previously, forms did not check if the element was in the target input filter composed in a CollectionInputFilter, leading to duplicate elements with varying behavior; now the inputs are correctly merged.

Added

• #115 adds translatable HTML attributes to the abstract view helper.
• #116 adds the InputFilterFactory dependency to the constructor.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #139 adds support for ReCaptcha version 2 though zend-captcha 2.7.1.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #122 fixes collection binding following successful validation. The fix introduced in #106, while it corrected the behavior around binding a collection that was not re-submitted, broke behavior around binding submitted collections. #122 corrects the issue, retaining the fix from #106.

Added

• #85 adds support for the zend-code 3.0 series (retaining support for the 2.* series).

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #119 fixes the order in which the default initializers are injected into the FormElementManager, ensuring that the initializer injecting a factory into a FormFactoryAware instance is triggered before the initializer that calls init(), and also that the initializer calling init() is always triggered last.
• #106 updates behavior around binding collection values to a fieldset or form such that if the collection is not part of the current validation group, its value will not be overwritten with an empty set.

Added

• #57 adds new elements, FormSearch and FormTel, which map to the FormSearch and FormTel view helpers.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Updates the composer suggestions list to remove those that were redundant, and to add explicit constraints and reasons for each listed (e.g., zend-code is required for annotations support).

Added

• #74 adds an alias for the FormTextarea view helper that is referenced in the documentation.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #77 updates Zend\Form\View\HelperConfig to improve performance when running under zend-servicemanager v3.
• #19 provides a thorough fix for an issue when removing all items in a collection associated with a form. Prior to this release, values that existed in the collection persisted when a form submission intended to remove them.

Added

• #70 adds and publishes the documentation to https://zendframework.github.io/zend-form/

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #69 fixes aliases in the FormElementManager polyfill for zend-servicemanager v2 to ensure they are canonicalized correctly.

Added

• #60 adds an alias from Zend\Form\FormElementManager to FormElementManager in the ConfigProvider.
• #67 adds polyfills for the FormElementManager to vary its definitions based on the major version of zend-servicemanager in use. FormElementManagerFactory was updated to return the specific polyfill version, and an autoload rule was added to alias the class to the correct polyfill version. The polyfills were necessary to ensure that invokable classes are mapped to the new ElementFactory introduced in the 2.7 series, thus ensuring instantiation is performed correctly.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #65 fixes instantiation of Zend\Form\FormElementManager to ensure that the default initializers, injectFactory() and callElementInit() are registered as the first and last initializers, respectively, during construction, restoring the pre-2.7 behavior.
• #67 fixes the behavior of Factory::create() to the pre-2.7.1 behavior of not passing creation options when retrieving an instance from the FormElementManager. This ensures that options are not passed to Element/Fieldset/Form instances until after they are fully initialized, ensuring that all dependencies are present.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #59 fixes the Module::init() method to properly receive a ModuleManager instance, and not expect a ModuleEvent.

Added

• #53 adds Zend\Form\FormElementManagerFactory, for creating and returning instances of Zend\Form\FormElementManager. This factory was ported from zend-mvc, and will replace it for version 3 of that component.
• #53 adds Zend\Form\Annotation\AnnotationBuilderFactory, for creating and returning instances of Zend\Form\Annotation\AnnotationBuilder. This factory was ported from zend-mvc, and will replace it for version 3 of that component.
• #53 exposes the package as a config-provider and ZF component, by adding:
  • ConfigProvider, which maps the FormElementsManager and FormAnnotationBuilder servies previously provided by zend-mvc; the form abstract factory as previously registered by zend-mvc; and all view helper configuration.
  • Module, which maps services and view helpers per the ConfigProvider, and provides configuration to the zend-modulemanager ServiceLocator in order for modules to provide form and form element configuration.

Deprecated

• #53 deprecates Zend\Form\View\HelperConfig; the functionality is made obsolete by ConfigProvider. It now consumes the latter in order to provide view helper configuration.

Removed

• Nothing.

Fixed

• Nothing.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #24 ensures that when Zend\Form\Form::getInputFilter() when lazy-creates an InputFilter instance, it is populated with the InputFilterFactory present in its own FormFactory. This ensures that any custom inputs, input filters, validators, or filters are available to the new instance.
• #38 removes the arbitrary restriction of only the "labelledby" and "describedby" aria attributes on form element view helpers; any aria attribute is now allowed.
• #45 fixes the behavior in Zend\Form\Factory::create() when pulling elements from the form element manager; it now will pass specifications provided for the given element when calling the manager's get() method.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #40 and #43 prepare the component to be forwards compatible with each of the following:
  • zend-eventmanager v3
  • zend-hydrator v2.1
  • zend-servicemanager v3
  • zend-stdlib v3
• #14 ensures that collections can remove all elements when populating values.

Added

• #17 updates the component to use zend-hydrator for hydrator functionality; this provides forward compatibility with zend-hydrator, and backwards compatibility with hydrators from older versions of zend-stdlib.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• Nothing.

Added

• Nothing.

Deprecated

• Nothing.

Removed

• Nothing.

Fixed

• #16 updates the zend-stdlib dependency to reference >=2.5.0,<2.7.0 to ensure hydrators will work as expected following extraction of hydrators to the zend-hydrator repository.

Added

• Nothing.

Deprecated

• #12 deprecates the AllowEmpty and ContinueIfEmpty annotations, to mirror changes made in zend-inputfilter#26.

Removed

• Nothing.

Fixed

• #1 AbstractHelper was being utilized on the method signature vs. HelperInterface.
• #9 fixes typos in two aria attribute names in the AbstractHelper.