Welcome to the Zend Framework 2.1 Release!

Master: Develop:

RELEASE INFORMATION

Zend Framework 2.1.4dev

This is the fourth maintenance release for the version 2.1 series.

DD MMM YYYY

UPDATES IN 2.1.4

Better polyfill support in Zend\Session and Zend\Stdlib. Polyfills (version-specific class replacements) have caused some issues in the 2.1 series. In particular, users who were not using Composer were unaware/uncertain about what extra files needed to be included to load polyfills, and those users who were generating classmaps were running into issues since the same class was being generated twice.

New polyfill support was created which does the following:

• A stub class file was created for each class needing polyfill support. A conditional is present in each that uses class_alias to alias an appropriate version-specific class to the class requested. A stub class was created in each stub file following a __halt_compiler() directive to ensure that classmap generators will pick up the "class" and put it in the map.
• New, uniquely named classes were created for each polyfill.
• Zend\File\ClassFileLocator was altered to look for class definitions following a halt_compiler() directive. This ensures that bin/classmap_generator.php will discover the stub class files and use them in the generated classmaps.
• The compatibility/autoload.php files in each component affected was altered to trigger an E_USER_DEPRECATED error asking the user to remove the require statement for the file.

The only issue discovered so far is that mock objects generated via PHPUnit that have typehinted arguments referencing the aliased class may not work. In most situations, typehinting on the common abstract class or interface was done to ensure functionality is preserved.

The functionality works with both Composer and ZF2's autoloading support, using either PSR-0 or classmaps.

Please see CHANGELOG.md.

SYSTEM REQUIREMENTS

Zend Framework 2 requires PHP 5.3.3 or later; we recommend using the latest PHP version whenever possible.

INSTALLATION

Please see INSTALL.md.

CONTRIBUTING

If you wish to contribute to Zend Framework, please read both the CONTRIBUTING.md and README-GIT.md file.

QUESTIONS AND FEEDBACK

Online documentation can be found at http://framework.zend.com/manual. Questions that are not addressed in the manual should be directed to the appropriate mailing list:

http://framework.zend.com/archives/subscribe/

If you find code in this release behaving in an unexpected manner or contrary to its documented behavior, please create an issue in our GitHub issue tracker:

https://github.com/zendframework/zf2/issues

If you would like to be notified of new releases, you can subscribe to the fw-announce mailing list by sending a blank message to [email protected].

LICENSE

The files in this archive are released under the Zend Framework license. You can find a copy of this license in LICENSE.txt.

ACKNOWLEDGEMENTS

The Zend Framework team would like to thank all the contributors to the Zend Framework project, our corporate sponsor, and you, the Zend Framework user. Please visit us sometime soon at http://framework.zend.com.