polyfill

Symfony Polyfill

Ce projet rétroporte les fonctionnalités trouvées dans les dernières versions de PHP et fournit des couches de compatibilité pour certaines extensions et fonctions. Il est destiné à être utilisé lorsque la portabilité entre les versions et extensions de PHP est souhaitée.

Les polyfills sont fournis pour :

• l'extension apcu lorsque l'ancienne extension apc est installée ;
• l'extension ctype lorsque PHP est compilé sans ctype ;
• les extensions mbstring et iconv ;
• l'extension uuid ;
• la classe MessageFormatter et les fonctions msgfmt_format_message ;
• la classe Normalizer et les fonctions grapheme_* ;
• les fonctions utf8_encode et utf8_decode de l'extension xml ou du noyau PHP-7.2 ;
• les classes Collator , NumberFormatter , Locale et IntlDateFormatter , limitées à la locale "en" ;
• les fonctions intl_error_name , intl_get_error_code , intl_get_error_message et intl_is_failure ;
• les fonctions idn_to_ascii et idn_to_utf8 ;
• une classe utilitaire Binary à utiliser lorsque la compatibilité avec mbstring.func_overload est requise ;
• les fonctions spl_object_id et stream_isatty introduites dans PHP 7.2 ;
• les fonctions mb_ord , mb_chr et mb_scrub introduites dans PHP 7.2 à partir de l'extension mbstring
• la fonction sapi_windows_vt100_support (Windows uniquement) introduite dans PHP 7.2 ;
• la constante PHP_FLOAT_* introduite dans PHP 7.2 ;
• la constante PHP_OS_FAMILY introduite dans PHP 7.2 ;
• la fonction is_countable introduite dans PHP 7.3 ;
• les fonctions array_key_first et array_key_last introduites dans PHP 7.3 ;
• la fonction hrtime introduite dans PHP 7.3 ;
• la classe JsonException introduite dans PHP 7.3 ;
• les fonctions get_mangled_object_vars , mb_str_split et password_algos introduites dans PHP 7.4 ;
• la fonction fdiv introduite dans PHP 8.0 ;
• la fonction get_debug_type introduite dans PHP 8.0 ;
• la fonction preg_last_error_msg introduite dans PHP 8.0 ;
• la fonction str_contains introduite dans PHP 8.0 ;
• les fonctions str_starts_with et str_ends_with introduites dans PHP 8.0 ;
• la classe ValueError introduite dans PHP 8.0 ;
• la classe UnhandledMatchError introduite dans PHP 8.0 ;
• la constante FILTER_VALIDATE_BOOL introduite dans PHP 8.0 ;
• la fonction get_resource_id introduite dans PHP 8.0 ;
• la classe Attribute introduite dans PHP 8.0 ;
• l'interface Stringable introduite dans PHP 8.0 ;
• la classe PhpToken introduite dans PHP 8.0 lorsque l'extension tokenizer est activée ;
• la fonction array_is_list introduite dans PHP 8.1 ;
• la fonction enum_exists introduite dans PHP 8.1 ;
• la constante MYSQLI_REFRESH_REPLICA introduite dans PHP 8.1 ;
• l'attribut ReturnTypeWillChange introduit dans PHP 8.1 ;
• la classe CURLStringFile introduite dans PHP 8.1 (mais seulement si PHP >= 7.4 est utilisé) ;
• l'attribut AllowDynamicProperties introduit dans PHP 8.2 ;
• l'attribut SensitiveParameter introduit dans PHP 8.2 ;
• la classe SensitiveParameterValue introduite dans PHP 8.2 ;
• l'interface RandomEngine introduite dans PHP 8.2 ;
• l'interface RandomCryptoSafeEngine introduite dans PHP 8.2 ;
• la classe RandomEngineSecure introduite dans PHP 8.2 (consultez arokettu/random-polyfill pour plus de moteurs) ;
• la fonction odbc_connection_string_is_quoted introduite dans PHP 8.2 ;
• la fonction odbc_connection_string_should_quote introduite dans PHP 8.2 ;
• la fonction odbc_connection_string_quote introduite dans PHP 8.2 ;
• la fonction ini_parse_quantity introduite dans PHP 8.2 ;
• la fonction json_validate introduite dans PHP 8.3 ;
• l'attribut Override introduit dans PHP 8.3 ;
• la fonction mb_str_pad introduite dans PHP 8.3 ;
• la fonction ldap_exop_sync introduite dans PHP 8.3 ;
• la fonction ldap_connect_wallet introduite dans PHP 8.3 ;
• la fonction stream_context_set_options introduite dans PHP 8.3 ;
• les fonctions str_increment et str_decrement introduites dans PHP 8.3 ;
• les classes Date*Exception/Error introduites dans PHP 8.3 ;
• la classe SQLite3Exception introduite dans PHP 8.3 ;
• les fonctions mb_ucfirst et mb_lcfirst introduites dans PHP 8.4 ;
• les fonctions array_find , array_find_key , array_any et array_all introduites dans PHP 8.4 ;
• l'attribut Deprecated introduit dans PHP 8.4 ;
• les fonctions mb_trim , mb_ltrim et mb_rtrim introduites dans PHP 8.4 ;
• les constantes CURL_HTTP_VERSION_3 et CURL_HTTP_VERSION_3ONLY introduites dans PHP 8.4 ;

Il est fortement recommandé de mettre à jour votre version de PHP et/ou d'installer les extensions manquantes lorsque cela est possible. Ce polyfill ne doit être utilisé que lorsqu'il n'y a pas de meilleur choix ou lorsque la portabilité est une exigence.

Notes de compatibilité

Pour écrire du code portable entre PHP5 et PHP7, certaines précautions doivent être prises :

• *Error doivent être interceptées avant Exception ;
• après avoir appelé error_clear_last() , le résultat de $e = error_get_last() doit être vérifié en utilisant isset($e['message'][0]) au lieu de null !== $e .

Usage

Lorsque vous utilisez Composer pour gérer vos dépendances, vous ne devez pas require du package symfony/polyfill , mais des packages autonomes :

• symfony/polyfill-apcu pour utiliser les fonctions apcu_* ,
• symfony/polyfill-ctype pour utiliser les fonctions ctype,
• symfony/polyfill-php54 pour utiliser les fonctions PHP 5.4,
• symfony/polyfill-php55 pour utiliser les fonctions PHP 5.5,
• symfony/polyfill-php56 pour utiliser les fonctions PHP 5.6,
• symfony/polyfill-php70 pour utiliser les fonctions PHP 7.0,
• symfony/polyfill-php71 pour utiliser les fonctions PHP 7.1,
• symfony/polyfill-php72 pour utiliser les fonctions PHP 7.2,
• symfony/polyfill-php73 pour utiliser les fonctions PHP 7.3,
• symfony/polyfill-php74 pour utiliser les fonctions PHP 7.4,
• symfony/polyfill-php80 pour utiliser les fonctions PHP 8.0,
• symfony/polyfill-php81 pour utiliser les fonctions PHP 8.1,
• symfony/polyfill-php82 pour utiliser les fonctions PHP 8.2,
• symfony/polyfill-php83 pour utiliser les fonctions PHP 8.3,
• symfony/polyfill-php84 pour utiliser les fonctions PHP 8.4,
• symfony/polyfill-iconv pour utiliser les fonctions iconv,
• symfony/polyfill-intl-grapheme pour utiliser les fonctions grapheme_* ,
• symfony/polyfill-intl-idn pour utiliser les fonctions idn_to_ascii et idn_to_utf8 ,
• symfony/polyfill-intl-icu pour utiliser les fonctions et classes intl,
• symfony/polyfill-intl-messageformatter pour utiliser le intl messageformatter,
• symfony/polyfill-intl-normalizer pour utiliser le normaliseur intl,
• symfony/polyfill-mbstring pour utiliser les fonctions mbstring,
• symfony/polyfill-util pour utiliser les assistants utilitaires polyfill.
• symfony/polyfill-uuid pour utiliser les fonctions uuid_* ,

Exiger directement symfony/polyfill empêcherait Composer de partager correctement les polyfills dans les graphiques de dépendances. En tant que tel, il installerait probablement plus de code que nécessaire.

Conception

Ce package est conçu pour un polyfilling à faible coût et de haute qualité.

Il n'ajoute que quelques instructions require légères au processus d'amorçage pour prendre en charge tous les polyfills. Les implémentations sont ensuite chargées à la demande en cas de besoin pendant l'exécution du code.

Si votre projet nécessite une version minimale de PHP, il est conseillé d'ajouter des polyfills pour les versions PHP inférieures à la section replace de votre composer.json . Cela supprime toute surcharge de ces polyfills car ils ne font plus partie de votre projet. La même chose peut être faite pour les polyfills pour les extensions dont vous avez besoin.

Si votre projet nécessite PHP 7.0 et nécessite l'extension mb, la section de remplacement ressemblerait à ceci :

{
    "replace" : {
        "symfony/polyfill-php54" : " * " ,
        "symfony/polyfill-php55" : " * " ,
        "symfony/polyfill-php56" : " * " ,
        "symfony/polyfill-php70" : " * " ,
        "symfony/polyfill-mbstring" : " * "
    }
}

Les polyfills sont testés unitairement parallèlement à leur implémentation native afin que la parité des fonctionnalités et des comportements puisse être prouvée et appliquée à long terme.

Licence

Cette bibliothèque est publiée sous licence MIT.