tea/future

Polyfill backporting some PHP 5.4+, 5.5+ ,5.6+, 7.0+ and 7.1+ features to lower PHP versions.

Tea Future

This package back-ports features found in the latest PHP versions. It provides many of the new features in PHP 5.4+, 5.5+ ,5.6+, 7.0+ and 7.1+ to lower PHP versions., _(*1)

Most of these features are provided by symfony polyfill PHP packages., _(*2)

Installation

Composer is required to install and load the dependencies., _(*3)

On your composer managed project, run:, _(*4)

composer require tea/future

Then load composer's autoloader:, _(*5)

require 'vendor/autoload.php';

Features

Future provides many of the new PHP functions and classes introduced in PHP 5.4 through to PHP 7.1., _(*6)

Here are the back-ported features by PHP version:, _(*7)

PHP 7.1+

Functions:, _(*8)

• is_iterable

PHP 7.0+

Functions:, _(*9)

• intdiv
• preg_replace_callback_array
• error_clear_last
• random_bytes and random_int (from paragonie/random_compat)

Classes:, _(*10)

• *Error throwable classes

Compatibility notes

To write portable code between PHP5 and PHP7, some care must be taken: - \*Error exceptions must be caught before \Exception; - after calling error_clear_last(), the result of $e = error_get_last() must be verified using isset($e['message'][0]) instead of null === $e., _(*11)

PHP 5.6+

Functions:, _(*12)

• hash_equals (part of hash extension)
• ldap_escape (part of ldap extension)

PHP 5.5+

Functions:, _(*13)

• boolval
• json_last_error_msg
• array_column
• hash_pbkdf2
• password_* functions (from ircmaxell/password_compat)

PHP 5.4+

Functions:, _(*14)

• trait_exists
• class_uses
• hex2bin
• session_register_shutdown

Other

If you only need a polyfill for a specific PHP version, you can simply install the respective symfony/polyfill-phpXX package., _(*15)

License

This library is released under the MIT license., _(*16)