Загрузка polyfill - Загрузка исходного кода polyfill

polyfill

Другие категории

1.0.0

Скачать

Symfony Полифилл

Этот проект поддерживает функции последних версий PHP и обеспечивает уровни совместимости для некоторых расширений и функций. Он предназначен для использования, когда требуется переносимость между версиями и расширениями PHP.

Полифилы предусмотрены для:

расширение apcu если установлено устаревшее расширение apc ;
расширение ctype , когда PHP компилируется без ctype;
расширения mbstring и iconv ;
расширение uuid ;
класс MessageFormatter и функции msgfmt_format_message ;
класс Normalizer и функции grapheme_* ;
функции utf8_encode и utf8_decode из расширения xml или ядра PHP-7.2;
классы Collator , NumberFormatter , Locale и IntlDateFormatter , ограниченные языковым стандартом «en»;
функции intl_error_name , intl_get_error_code , intl_get_error_message и intl_is_failure ;
функции idn_to_ascii и idn_to_utf8 ;
Binary служебный класс, который будет использоваться, когда требуется совместимость с mbstring.func_overload ;
функции spl_object_id stream_isatty представленные в PHP 7.2;
функции mb_ord , mb_chr и mb_scrub , представленные в PHP 7.2 из расширения mbstring
функция sapi_windows_vt100_support (только для Windows), представленная в PHP 7.2;
константа PHP_FLOAT_* , представленная в PHP 7.2;
константа PHP_OS_FAMILY , представленная в PHP 7.2;
функция is_countable представленная в PHP 7.3;
функции array_key_first и array_key_last представленные в PHP 7.3;
функция hrtime представленная в PHP 7.3;
класс JsonException представленный в PHP 7.3;
функции get_mangled_object_vars , mb_str_split и password_algos представленные в PHP 7.4;
функция fdiv представленная в PHP 8.0;
функция get_debug_type представленная в PHP 8.0;
функция preg_last_error_msg представленная в PHP 8.0;
функция str_contains представленная в PHP 8.0;
функции str_starts_with и str_ends_with представленные в PHP 8.0;
класс ValueError представленный в PHP 8.0;
класс UnhandledMatchError представленный в PHP 8.0;
константа FILTER_VALIDATE_BOOL представленная в PHP 8.0;
функция get_resource_id представленная в PHP 8.0;
класс Attribute представленный в PHP 8.0;
интерфейс Stringable представленный в PHP 8.0;
класс PhpToken , представленный в PHP 8.0, когда включено расширение токенизатора;
функция array_is_list представленная в PHP 8.1;
функция enum_exists представленная в PHP 8.1;
константа MYSQLI_REFRESH_REPLICA , представленная в PHP 8.1;
атрибут ReturnTypeWillChange представленный в PHP 8.1;
класс CURLStringFile , представленный в PHP 8.1 (но только если используется PHP >= 7.4);
атрибут AllowDynamicProperties представленный в PHP 8.2;
атрибут SensitiveParameter представленный в PHP 8.2;
класс SensitiveParameterValue , представленный в PHP 8.2;
интерфейс RandomEngine представленный в PHP 8.2;
интерфейс RandomCryptoSafeEngine представленный в PHP 8.2;
класс RandomEngineSecure представленный в PHP 8.2 (больше движков можно найти в arokettu/random-polyfill);
функция odbc_connection_string_is_quoted представленная в PHP 8.2;
функция odbc_connection_string_should_quote , представленная в PHP 8.2;
функция odbc_connection_string_quote представленная в PHP 8.2;
функция ini_parse_quantity представленная в PHP 8.2;
функция json_validate представленная в PHP 8.3;
атрибут Override представленный в PHP 8.3;
функция mb_str_pad представленная в PHP 8.3;
функция ldap_exop_sync представленная в PHP 8.3;
функция ldap_connect_wallet представленная в PHP 8.3;
stream_context_set_options , представленная в PHP 8.3;
функции str_increment и str_decrement представленные в PHP 8.3;
классы Date*Exception/Error представленные в PHP 8.3;
класс SQLite3Exception представленный в PHP 8.3;
функции mb_ucfirst и mb_lcfirst представленные в PHP 8.4;
функции array_find , array_find_key , array_any и array_all представленные в PHP 8.4;
атрибут Deprecated представленный в PHP 8.4;
функции mb_trim , mb_ltrim и mb_rtrim представленные в PHP 8.4;
константы CURL_HTTP_VERSION_3 и CURL_HTTP_VERSION_3ONLY представленные в PHP 8.4;

Настоятельно рекомендуется обновить версию PHP и/или установить недостающие расширения, когда это возможно. Этот полифилл следует использовать только тогда, когда нет лучшего выбора или когда требуется переносимость.

Примечания о совместимости

Чтобы написать переносимый код между PHP5 и PHP7, необходимо соблюдать некоторую осторожность:

*Error должны быть перехвачены до Exception ;
после вызова error_clear_last() результат $e = error_get_last() должен быть проверен с использованием isset($e['message'][0]) вместо null !== $e .

Использование

При использовании Composer для управления вашими зависимостями вам не следует require пакет symfony/polyfill , а использовать автономные пакеты:

symfony/polyfill-apcu для использования функций apcu_* ,
symfony/polyfill-ctype для использования функций ctype,
symfony/polyfill-php54 для использования функций PHP 5.4,
symfony/polyfill-php55 для использования функций PHP 5.5,
symfony/polyfill-php56 для использования функций PHP 5.6,
symfony/polyfill-php70 для использования функций PHP 7.0,
symfony/polyfill-php71 для использования функций PHP 7.1,
symfony/polyfill-php72 для использования функций PHP 7.2,
symfony/polyfill-php73 для использования функций PHP 7.3,
symfony/polyfill-php74 для использования функций PHP 7.4,
symfony/polyfill-php80 для использования функций PHP 8.0,
symfony/polyfill-php81 для использования функций PHP 8.1,
symfony/polyfill-php82 для использования функций PHP 8.2,
symfony/polyfill-php83 для использования функций PHP 8.3,
symfony/polyfill-php84 для использования функций PHP 8.4,
symfony/polyfill-iconv для использования функций iconv,
symfony/polyfill-intl-grapheme для использования функций grapheme_* ,
symfony/polyfill-intl-idn для использования функций idn_to_ascii и idn_to_utf8 ,
symfony/polyfill-intl-icu для использования функций и классов intl,
symfony/polyfill-intl-messageformatter для использования intl messageformatter,
symfony/polyfill-intl-normalizer для использования нормализатора intl,
symfony/polyfill-mbstring для использования функций mbstring,
symfony/polyfill-util для использования помощников утилиты polyfill.
symfony/polyfill-uuid для использования функций uuid_* ,

Прямое требование symfony/polyfill помешает Composer правильно использовать полифилы в графах зависимостей. Таким образом, скорее всего, будет установлено больше кода, чем требуется.

Дизайн

Этот пакет предназначен для небольших накладных расходов и высокого качества полифилла.

Он добавляет лишь несколько облегченных операторов require в процесс начальной загрузки для поддержки всех полифилов. Затем реализации загружаются по требованию, когда это необходимо во время выполнения кода.

Если вашему проекту требуется минимальная версия PHP, рекомендуется добавить полифилы для более низких версий PHP в раздел replace вашего composer.json . Это устранит любые накладные расходы на эти полифилы, поскольку они больше не являются частью вашего проекта. То же самое можно сделать и с полифилами для необходимых вам расширений.

Если вашему проекту требуется PHP 7.0 и расширение mb, раздел замены будет выглядеть примерно так:

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

Полифиллы тестируются вместе с их собственной реализацией, поэтому в долгосрочной перспективе можно доказать и обеспечить соответствие функций и поведения.