From 0dcce7a5c6b933deb26bae353c6c7f9dcd9e8427 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 25 Oct 2020 14:21:35 +0100 Subject: [PATCH 01/24] PHP 8.0 migration guide --- appendices/migration80.xml | 56 + appendices/migration80/constants.xml | 38 + appendices/migration80/deprecated.xml | 165 ++ appendices/migration80/incompatible.xml | 1570 +++++++++++++++++ appendices/migration80/new-classes.xml | 38 + appendices/migration80/new-features.xml | 402 +++++ appendices/migration80/new-functions.xml | 174 ++ appendices/migration80/other-changes.xml | 362 ++++ appendices/migration80/removed-extensions.xml | 41 + appendices/migration80/windows-support.xml | 53 + 10 files changed, 2899 insertions(+) create mode 100644 appendices/migration80.xml create mode 100644 appendices/migration80/constants.xml create mode 100644 appendices/migration80/deprecated.xml create mode 100644 appendices/migration80/incompatible.xml create mode 100644 appendices/migration80/new-classes.xml create mode 100644 appendices/migration80/new-features.xml create mode 100644 appendices/migration80/new-functions.xml create mode 100644 appendices/migration80/other-changes.xml create mode 100644 appendices/migration80/removed-extensions.xml create mode 100644 appendices/migration80/windows-support.xml diff --git a/appendices/migration80.xml b/appendices/migration80.xml new file mode 100644 index 000000000000..6b0abb3a3f76 --- /dev/null +++ b/appendices/migration80.xml @@ -0,0 +1,56 @@ + + + + + Migrating from PHP 7.4.x to PHP 8.0.x + + &appendices.migration80.new-features; + &appendices.migration80.new-classes; + &appendices.migration80.new-functions; + &appendices.migration80.constants; + &appendices.migration80.incompatible; + &appendices.migration80.deprecated; + &appendices.migration80.removed-extensions; + &appendices.migration80.other-changes; + &appendices.migration80.windows-support; + + + + This new major version brings with it a number of + new features and + some incompatibilities + that should be tested for before switching PHP versions in production + environments. + + + + &manual.migration.seealso; + 7.0.x, + 7.1.x, + 7.2.x, + 7.3.x. + 7.4.x. + + + + + diff --git a/appendices/migration80/constants.xml b/appendices/migration80/constants.xml new file mode 100644 index 000000000000..0b11b5daa29b --- /dev/null +++ b/appendices/migration80/constants.xml @@ -0,0 +1,38 @@ + + + + + New Global Constants + + + Filter + + + FILTER_VALIDATE_BOOL has been added as an alias for + FILTER_VALIDATE_BOOLEAN. The new name is preferred, as it uses the canonical + type name. + + + + + + diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml new file mode 100644 index 000000000000..6c1154484e11 --- /dev/null +++ b/appendices/migration80/deprecated.xml @@ -0,0 +1,165 @@ + + + + + Deprecated Features + + + PHP Core + + + + + Declaring a required parameter after an optional one is deprecated. As an exception, declaring a + parameter of the form Type $param = null before a required one continues to be + allowed, because this pattern was sometimes used to achieve nullable types in older PHP versions. + + + + + + + + + + Calling get_defined_functions with exclude_disabled + explicitly set to &false; is deprecated. get_defined_functions will never + include disabled functions. + + + + + + + Enchant + + + + + enchant_broker_set_dict_path and + enchant_broker_get_dict_path + are deprecated, because that functionality is neither available in libenchant < 1.5 nor in + libenchant-2. + + + + + enchant_dict_add_to_personal is deprecated; use + enchant_dict_add instead. + + + + + enchant_dict_is_in_session is deprecated; use + enchant_dict_is_added instead. + + + + + enchant_broker_free and enchant_broker_free_dict are + deprecated; unset the object instead. + + + + + The ENCHANT_MYSPELL and ENCHANT_ISPELL constants are + deprecated. + + + + + + + LibXML + + + libxml_disable_entity_loader has been deprecated. As libxml 2.9.0 is now + required, external entity loading is guaranteed to be disabled by default, and this function is + no longer needed to protect against XXE attacks. + + + + + PGSQL / PDO PGSQL + + + + + The constant PG_VERSION_STR has now the same value as + PG_VERSION, and thus is deprecated. + + + + + Function aliases in the pgsql extension have been deprecated. + + + + + + + Zip + + + + + Using an empty file as ZipArchive is deprecated. Libzip 1.6.0 does not accept empty files as + valid zip archives any longer. The existing workaround will be removed in the next version. + + + + + The procedural API of Zip is deprecated. Use ZipArchive instead. + + + + + + + Reflection + + + + + ReflectionFunction::isDisabled is deprecated, as it is no longer + possible to create a ReflectionFunction for a disabled function. This + method now always returns &false;. + + + + + ReflectionParameter::getClass, + ReflectionParameter::isArray, and + ReflectionParameter::isCallable are deprecated. + ReflectionParameter::getType and the + ReflectionType APIs should be used instead. + + + + + + + + diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml new file mode 100644 index 000000000000..30f490195e79 --- /dev/null +++ b/appendices/migration80/incompatible.xml @@ -0,0 +1,1570 @@ + + + + + Backward Incompatible Changes + + + PHP Core + + + + + match is now a reserved keyword. + + + + + Assertion failures now throw by default. If the old behavior is desired, + assert.exception=0 can be set in the INI settings. + + + + + Methods with the same name as the class are no longer interpreted as constructors. The + __construct() method should be used instead. + + + + + The ability to call non-static methods statically has been removed. Thus + is_callable will fail when checking for a non-static method with a classname + (must check with an object instance). + + + + + The (unset) cast has been removed. + + + + + The track_errors ini directive has been removed. This + means that php_errormsg is no longer available. The + error_get_last function may be used instead. + + + + + The ability to define case-insensitive constants has been removed. The third argument to + define may no longer be &true;. + + + + + Access to undefined constants now always results in an Error exception. + Previously, unqualified constant accesses resulted in a warning and were interpreted as strings. + + + + + The ability to specify an autoloader using an __autoload function has been + removed. spl_autoload_register should be used instead. + + + + + The errcontext argument for custom error handlers has been removed. + + + + + create_function has been removed. Anonymous functions may be used instead. + + + + + each has been removed. &foreach; or ArrayIterator + should be used instead. + + + + + The ability to unbind this from closures that were created from a method, + using Closure::fromCallable or + ReflectionMethod::getClosure, has been removed. + + + + + The ability to unbind this from proper closures that contain uses of + this has also been removed. + + + + + The ability to use array_key_exists with objects has been removed. + isset or property_exists may be used instead. + + + + + The behavior of array_key_exists regarding the type of the + key parameter has been made consistent with isset and + normal array access. All key types now use the usual coercions and array/object keys throw a + TypeError. + + + + + Any array that has a number n as its first numeric key will use + n+1 for its next implicit key, even if n is + negative. + + + + + + The default error_reporting level is now E_ALL. Previously it excluded + E_NOTICE and E_DEPRECATED. + + + + + display_startup_errors is now enabled by + default. + + + + + Using parent inside a class that has no parent will now result in a fatal + compile-time error. + + + + + The @ operator will no longer silence fatal errors + (E_ERROR, E_CORE_ERROR, + E_COMPILE_ERROR, E_USER_ERROR, + E_RECOVERABLE_ERROR, E_PARSE). Error handlers that + expect error_reporting to be 0 when @ is used, should be + adjusted to use a mask check instead: + + + + +]]> + + + + Additionally, care should be taken that error messages are not displayed in production + environments, which can result in information leaks. Please ensure that + display_errors=Off is used in conjunction with error logging. + + + + + Following the hash comment operator # immediately with an opening bracket is + not supported as a comment anymore since this syntax is now used for attributes. + + + + + + Inheritance errors due to incompatible method signatures (LSP violations) will now always + generate a fatal error. Previously a warning was generated in some cases. + + + + + + The precedence of the concatenation operator has changed relative to bitshifts and addition as + well as subtraction. + + + + + + Arguments with a default value that resolves to &null; at runtime will no longer implicitly mark + the argument type as nullable. Either an explicit nullable type, or an explicit &null; default + value has to be used instead. + + + + +]]> + + + + + + A number of warnings have been converted into Error exceptions: + + + + Attempting to write to a property of a non-object. Previously this + implicitly created an stdClass object for null, false and empty strings. + Attempting to append an element to an array for which the PHP_INT_MAX key + is already used. + Attempting to use an invalid type (array or object) as an array key or + string offset. + Attempting to write to an array index of a scalar value. + Attempting to unpack a non-array/Traversable. + + + + A number of notices have been converted into warnings: + + + + Attempting to read an undefined variable. + Attempting to read an undefined property. + Attempting to read an undefined array key. + Attempting to read a property of a non-object. + Attempting to access an array index of a non-array. + Attempting to convert an array to string. + Attempting to use a resource as an array key. + Attempting to use null, a boolean, or a float as a string offset. + Attempting to read an out-of-bounds string offset. + Attempting to assign an empty string to a string offset. + + + + + + + Attempting to assign multiple bytes to a string offset will now emit a warning. + + + + + Unexpected characters in source files (such as NUL bytes outside of strings) will now result in a + ParseError exception instead of a compile warning. + + + + + Uncaught exceptions now go through "clean shutdown", which means that destructors will be called + after an uncaught exception. + + + + + Compile time fatal error "Only variables can be passed by reference" has been delayed until + runtime and converted to "Argument cannot be passed by reference" exception. + + + + + Some "Only variables should be passed by reference" notices have been converted to "Argument + cannot be passed by reference" exception. + + + + + The generated name for anonymous classes has changed. It will now include the name of the first + parent or interface: + + + + ParentClass@anonymous +new class implements FirstInterface, SecondInterface {}; +// -> FirstInterface@anonymous +new class {}; +// -> class@anonymous +?> +]]> + + + + The name shown above is still followed by a NUL byte and a unique suffix. + + + + + Non-absolute trait method references in trait alias adaptations are now required to be + unambiguous: + + + + +]]> + + + + If both T1::func() and T2::func() exist, this code was previously + silently accepted, and func as assumed to refer to T1::func. Now it will generate a + fatal error instead, and either T1::func or T2::func needs to be + written explicitly. + + + + + The signature of abstract methods defined in traits is now checked against the implementing class + method: + + + + +]]> + + + + + + + Disabled functions are now treated exactly like non-existent functions. Calling a disabled + function will report it as unknown, and redefining a disabled function is now possible. + + + + + data:// stream wrappers are no longer writable, which matches the documented + behavior. + + + + + The arithmetic and bitwise operators +, -, + *, /, **, %, + <<, >>, &, + |, ^, ~, ++, + -- will now consistently throw a TypeError when one of + the operands is an &array;, &resource; or non-overloaded &object;. The only exception to this is + the array + array merge operation, which remains supported. + + + + + + Float to string casting will now always behave locale-independently. + + + + + + Support for deprecated curly braces for offset access has been removed. + + + + + + Applying the final modifier on a private method will now produce a warning unless that method is + the constructor. + + + + + + If an object constructor exits, the object destructor will no longer be + called. This matches the behavior when the constructor throws. + + + + + Non-strict comparisons between numbers and non-numeric strings now work by casting the number to + string and comparing the strings. Comparisons between numbers and numeric strings continue to + work as before. Notably, this means that 0 == "not-a-number" is considered false + now. + + + + + + Namespaced names can no longer contain whitespace: While Foo\Bar will be recognized + as a namespaced name, Foo \ Bar will not. Conversely, reserved keywords are now + permitted as namespace segments, which may also change the interpretation of code: + new\x is now the same as constant('new\x'), not + new \x(). + + + + + + Nested ternaries now require explicit parentheses. + + + + + + debug_backtrace and Exception::getTrace will no + longer provide references to arguments. It will not be possible to change function arguments + through the backtrace. + + + + + Numeric string handling has been altered to be more intuitive and less error-prone. Trailing + whitespace is now allowed in numeric strings for consistency with how leading whitespace is + treated. This mostly affects: + + + + The is_numeric function + String-to-string comparisons + Type declarations + Increment and decrement operations + + + + The concept of a "leading-numeric string" has been mostly dropped; the cases where this remains + exist in order to ease migration. Strings which emitted an E_NOTICE "A non + well-formed numeric value encountered" will now emit an E_WARNING "A + non-numeric value encountered" and all strings which emitted an E_WARNING "A + non-numeric value encountered" will now throw a + TypeError. This mostly affects: + + + + Arithmetic operations + Bitwise operations + + + + This E_WARNING to TypeError change also affects the + E_WARNING "Illegal string offset 'string'" for illegal string offsets. The + behavior of explicit casts to int/float from strings has not been changed. + + + + + + Magic Methods will now have their arguments and return types checked if they have them declared. + The signatures should match the following list: + + + + __call(string $name, array $arguments): mixed + __callStatic(string $name, array $arguments): mixed + __clone(): void + __debugInfo(): ?array + __get(string $name): mixed + __invoke(mixed $arguments): mixed + __isset(string $name): bool + __serialize(): array + __set(string $name, mixed $value): void + __set_state(array $properties): object + __sleep(): array + __unserialize(array $data): void + __unset(string $name): void + __wakeup(): void + + + + + + + call_user_func_array array keys will now be interpreted as parameter names, + instead of being silently ignored. + + + + + + + COM and .Net (Windows) + + + The ability to import case-insensitive constants from type libraries has been removed. + The second argument to com_load_typelib may no longer be false; + com.autoregister_casesensitive + may no longer be disabled; case-insensitive markers in + com.typelib_file are ignored. + + + + + CURL + + + CURLOPT_POSTFIELDS no longer accepts objects as arrays. To + interpret an object as an array, perform an explicit (array) cast. The + same applies to other options accepting arrays as well. + + + + + Date and Time + + + mktime and gmmktime now require at least one + argument. time can be used to get the current timestamp. + + + + + DOM + + + Unimplemented classes from the DOM extension that had no behavior and contained test + data have been removed. These classes have also been removed in the latest version of + the DOM standard: + + + + DOMNameList + DomImplementationList + DOMConfiguration + DomError + DomErrorHandler + DOMImplementationSource + DOMLocator + DOMUserDataHandler + DOMTypeInfo + + + + + + Enchant + + + + + enchant_broker_list_dicts, enchant_broker_describe and + enchant_dict_suggest will now return an empty array instead of &null;. + + + + + enchant_broker_init will now return an EnchantBroker + object rather than a &resource;. Return value checks using is_resource + should be replaced with checks for &false;. + + + + + enchant_broker_request_dict and + enchant_broker_request_pwl_dict will now return an + EnchantDictionary object rather than a &resource;. Return value checks + using is_resource should be replaced with checks for &false;. + + + + + + + Exif + + + read_exif_data has been removed; exif_read_data + should be used instead. + + + + + Filter + + + + + The FILTER_FLAG_SCHEME_REQUIRED and + FILTER_FLAG_HOST_REQUIRED flags for the + FILTER_VALIDATE_URL filter have been removed. The scheme + and host are (and have been) always required. + + + + + The INPUT_REQUEST and INPUT_SESSION source for + filter_input etc. have been removed. These were never implemented and their + use always generated a warning. + + + + + + + GD + + + + + The GD extension now uses GdImage objects as the underlying data structure + for images, rather than &resource;s. These objects are completely opaque, i.e. they don't have + any methods. Return value checks using is_resource should be replaced with + checks for &false;. + + + + + The deprecated functions image2wbmp has been removed. + + + + + + The deprecated functions png2wbmp and jpeg2wbmp have + been removed. + + + + + + The default mode parameter of imagecropauto no longer + accepts -1. IMG_CROP_DEFAULT should be used instead. + + + + + + + GMP + + + gmp_random has been removed. One of gmp_random_range or + gmp_random_bits should be used instead. + + + + + Iconv + + + iconv implementations which do not properly set errno in case of errors are no + longer supported. + + + + + IMAP + + + + + The unused default_host argument of imap_headerinfo + has been removed. + + + + + The imap_header function which is an alias of + imap_headerinfo has been removed. + + + + + + + Intl + + + + + The deprecated constant INTL_IDNA_VARIANT_2003 has been removed. + + + + + + The deprecated Normalizer::NONE constant has been removed. + + + + + The IntlDateFormatter::RELATIVE_FULL, + IntlDateFormatter::RELATIVE_LONG, + IntlDateFormatter::RELATIVE_MEDIUM, and + IntlDateFormatter::RELATIVE_SHORT + constants have been added. + + + + + + + LDAP + + + + + The deprecated functions ldap_sort, + ldap_control_paged_result and + ldap_control_paged_result_response have been removed. + + + + + The interface of ldap_set_rebind_proc has changed; the + callback parameter does not accept empty strings anymore; &null; should be + used instead. + + + + + + + MBString + + + + + The mbstring.func_overload directive has been + removed. The related MB_OVERLOAD_MAIL, + MB_OVERLOAD_STRING, and MB_OVERLOAD_REGEX constants + have also been removed. Finally, the "func_overload" and + "func_overload_list" entries in mb_get_info have been + removed. + + + + + mb_parse_str can no longer be used without specifying a result array. + + + + + A number of deprecated mbregex aliases have been removed. See the following + list for which functions should be used instead: + + + + mbregex_encoding → mb_regex_encoding + mbereg → mb_ereg + mberegi → mb_eregi + mbereg_replace → mb_ereg_replace + mberegi_replace → mb_eregi_replace + mbsplit → mb_split + mbereg_match → mb_ereg_match + mbereg_search → mb_ereg_search + mbereg_search_pos → mb_ereg_search_pos + mbereg_search_regs → mb_ereg_search_regs + mbereg_search_init → mb_ereg_search_init + mbereg_search_getregs → mb_ereg_search_getregs + mbereg_search_getpos → mb_ereg_search_getpos + mbereg_search_setpos → mb_ereg_search_setpos + + + + + + The e modifier for mb_ereg_replace has been removed. + mb_ereg_replace_callback should be used instead. + + + + + A non-string pattern argument to mb_ereg_replace will now be interpreted as + a string instead of an ASCII codepoint. The previous behavior may be restored with an explicit + call to chr. + + + + + The needle argument for mb_strpos, + mb_strrpos, mb_stripos, + mb_strripos, mb_strstr, + mb_stristr, mb_strrchr and + mb_strrichr can now be empty. + + + + + The is_hex parameter, which was not used internally, has been removed from + mb_decode_numericentity. + + + + + The legacy behavior of passing the encoding as the third argument instead of an offset for the + mb_strrpos function has been removed; an explicit 0 + offset with the encoding should be provided as the fourth argument instead. + + + + + The ISO_8859-* character encoding aliases have been replaced by + ISO8859-* aliases for better interoperability with the iconv extension. The + mbregex ISO 8859 aliases with underscores (ISO_8859_* and + ISO8859_*) have also been removed. + + + + + mb_ereg and mb_eregi will now return boolean &true; on + a successfuly match. Previously they returned integer 1 if + matches was not passed, or max(1, strlen($reg[0])) if + matches was passed. + + + + + + + OCI8 + + + + + The OCI-Lob class is now called OCILob, and the + OCI-Collection class is now called OCICollection + for name compliance enforced by PHP 8 arginfo type annotation tooling. + + + + + Several alias functions have been marked as deprecated. + + + + + oci_internal_debug and its alias ociinternaldebug have + been removed. + + + + + + + ODBC + + + + + odbc_connect no longer reuses persistent connections. + + + + + The unused flags parameter of odbc_exec has been + removed. + + + + + + + OpenSSL + + + + + openssl_x509_read and openssl_csr_sign will now return + an OpenSSLCertificate object rather than a &resource;. Return value checks + using is_resource should be replaced with checks for &false;. + + + + + The openssl_x509_free function is deprecated and no longer has an effect, + instead the OpenSSLCertificate instance is automatically destroyed if it + is no longer referenced. + + + + + openssl_csr_new will now return an + OpenSSLCertificateSigningRequest object rather than a &resource;. Return + value checks using is_resource should be replaced with checks for &false;. + + + + + openssl_pkey_new will now return an + OpenSSLAsymmetricKey object rather than a &resource;. Return value checks + using is_resource should be replaced with checks for &false;. + + + + + The openssl_pkey_free function is deprecated and no longer has an effect, + instead the OpenSSLAsymmetricKey instance is automatically destroyed if it + is no longer referenced. + + + + + openssl_seal and openssl_open now require + method to be passed, as the previous default of "RC4" + is considered insecure. + + + + + + + Regular Expressions (Perl-Compatible) + + + When passing invalid escape sequences they are no longer interpreted as literals. This behavior + previously required the X modifier – which is now ignored. + + + + + PHP Data Objects + + + + + The default error handling mode has been changed from "silent" to "exceptions". See + Errors and error handling for details. + + + + + + The signatures of some PDO methods have changed: + + + + PDO::query(string $statement, ?int $fetch_mode = null, ...$fetch_mode_args) + PDOStatement::setFetchMode(int $mode, ...$params) + + + + + + + + PDO ODBC + + + The &php.ini; directive + pdo_odbc.db2_instance_name has been + removed. + + + + + PostgreSQL + + + + + The deprecated pg_connect syntax using multiple parameters instead of a + connection string is no longer supported. + + + + + The deprecated pg_lo_import and pg_lo_export signature + that passes the connection as the last argument is no longer supported. The connection should be + passed as first argument instead. + + + + + pg_fetch_all will now return an empty array instead of &false; for result + sets with zero rows. + + + + + + + Phar + + + Metadata associated with a phar will no longer be automatically unserialized, to fix potential + security vulnerabilities due to object instantiation, autoloading, etc. + + + + + + Reflection + + + + + The method signatures + + + + ReflectionClass::newInstance($args) + ReflectionFunction::invoke($args) + ReflectionMethod::invoke($object, $args) + + + + have been changed to: + + + + ReflectionClass::newInstance(...$args) + ReflectionFunction::invoke(...$args) + ReflectionMethod::invoke($object, ...$args) + + + + Code that must be compatible with both PHP 7 and PHP 8 can use the following + signatures to be compatible with both versions: + + + + ReflectionClass::newInstance($arg = null, ...$args) + ReflectionFunction::invoke($arg = null, ...$args) + ReflectionMethod::invoke($object, $arg = null, ...$args) + + + + + + The ReflectionType::__toString method will now return a complete debug + representation of the type, and is no longer deprecated. In particular the result will include a + nullability indicator for nullable types. The format of the return value is not stable and may + change between PHP versions. + + + + + Reflection export() methods have been removed. + + + + + The following methods can now return information about default values of + parameters of internal functions: + + + + ReflectionParameter::isDefaultValueAvailable + ReflectionParameter::getDefaultValue + ReflectionParameter::isDefaultValueConstant + ReflectionParameter::getDefaultValueConstantName + + + + + + ReflectionMethod::isConstructor and + ReflectionMethod::isDestructor now also return &true; for + __construct() and + __destruct() methods of interfaces. + Previously, this would only be true for methods of classes and traits. + + + + + ReflectionType::isBuiltin method has been moved to + ReflectionNamedType. ReflectionUnionType does not + have it. + + + + + + + Sockets + + + + + The deprecated AI_IDN_ALLOW_UNASSIGNED and + AI_IDN_USE_STD3_ASCII_RULES flags for + socket_addrinfo_lookup have been removed. + + + + + socket_create, socket_create_listen, + socket_accept, socket_import_stream, + socket_addrinfo_connect, socket_addrinfo_bind, and + socket_wsaprotocol_info_import will now return a + Socket object rather than a &resource;. Return value checks using + is_resource should be replaced with checks for &false;. + + + + + socket_addrinfo_lookup will now return an array of + AddressInfo objects rather than resources. + + + + + + + Standard PHP Library (SPL) + + + + + SplFileObject::fgetss has been removed. + + + + + SplHeap::compare now specifies a method signature. Inheriting classes + implementing this method will now have to use a compatible method signature. + + + + + SplDoublyLinkedList::push, + SplDoublyLinkedList::unshift and + SplQueue::enqueue now return void instead of &true;. + + + + + spl_autoload_register will now always throw a + TypeError on invalid arguments, therefore the second argument + do_throw is ignored and a notice will be emitted if it is set to &false;. + + + + + SplFixedArray is now an IteratorAggregate + and not an Iterator. + SplFixedArray::rewind, SplFixedArray::current, + SplFixedArray::key, SplFixedArray::next, and + SplFixedArray::valid have been removed. In their place, + SplFixedArray::getIterator has been added. Any code which uses explicit + iteration over SplFixedArray must now obtain an + Iterator through + SplFixedArray::getIterator. This means that + SplFixedArray is now safe to use in nested loops. + + + + + + + Standard Library + + + + + assert will no longer evaluate string arguments, instead they will be + treated like any other argument. assert($a == $b) should be used instead of + assert('$a == $b'). The assert.quiet_eval ini directive and the + ASSERT_QUIET_EVAL constant have also been removed, as they would no longer + have any effect. + + + + + parse_str can no longer be used without specifying a result array. + + + + + fgetss has been removed. + + + + + The string.strip_tags filter has been removed. + + + + + The needle argument of strpos, + strrpos, stripos, strripos, + strstr, strchr, strrchr, and + stristr will now always be interpreted as a string. Previously non-string + needles were interpreted as an ASCII code point. An explicit call to chr can + be used to restore the previous behavior. + + + + + The needle argument for strpos, + strrpos, stripos, strripos, + strstr, stristr and strrchr can + now be empty. + + + + + The length argument for substr, + substr_count, substr_compare, and + iconv_substr can now be &null;. &null; values will behave as if no length + argument was provided and will therefore return the remainder of the string instead of an empty + string. + + + + + The length argument for array_splice can now be + &null;. &null; values will behave identically to omitting the argument, thus removing everything + from the offset to the end of the array. + + + + + The args argument of vsprintf, + vfprintf, and vprintf must now be an array. Previously + any type was accepted. + + + + + The 'salt' option of password_hash is no longer + supported. If the 'salt' option is used a warning is generated, the provided + salt is ignored, and a generated salt is used instead. + + + + + The quotemeta function will now return an empty string if an empty string + was passed. Previously &false; was returned. + + + + + The following functions have been removed: + + + + hebrevc + convert_cyr_string + money_format + ezmlm_hash + restore_include_path + get_magic_quotes_gpc + get_magic_quotes_gpc_runtime + + + + + + FILTER_SANITIZE_MAGIC_QUOTES has been removed. + + + + + Calling implode with parameters in a reverse order ($pieces, + $glue) is no longer supported. + + + + + parse_url will now distinguish absent and empty queries and fragments: + + + + http://example.com/foo → query = null, fragment = null + http://example.com/foo? → query = "", fragment = null + http://example.com/foo# → query = null, fragment = "" + http://example.com/foo?# → query = "", fragment = "" + + Previously all cases resulted in query and fragment being &null;. + + + + + var_dump and debug_zval_dump will now print + floating-point numbers using serialize_precision + rather than precision. In a default configuration, this + means that floating-point numbers are now printed with full accuracy by these debugging + functions. + + + + + If the array returned by __sleep() contains non-existing + properties, these are now silently ignored. Previously, such properties would have been + serialized as if they had the value &null;. + + + + + The default locale on startup is now always "C". No locales are inherited from + the environment by default. Previously, LC_ALL was set to + "C", while LC_CTYPE was inherited from the environment. + However, some functions did not respect the inherited locale without an explicit + setlocale call. An explicit setlocale call is now + always required if locale component should be changed from the default. + + + + + The deprecated DES fallback in crypt has been removed. If an unknown salt + format is passed to crypt, the function will fail with *0 + instead of falling back to a weak DES hash now. + + + + + Specifying out of range rounds for SHA256/SHA512 crypt will now fail with + *0 instead of clamping to the closest limit. This matches glibc behavior. + + + + + The result of sorting functions may have changed, if the array contains elements that compare as + equal. + + + + + Sort comparison functions that return &true; or &false; will now throw a deprecation warning, and + should be replaced with an implementation that returns an integer less than, equal to, or greater + than zero. + + + + $a > $b); +// With +usort($array, fn($a, $b) => $a <=> $b); +?> +]]> + + + + + + Any functions accepting callbacks that are not explicitly specified to accept parameters by + reference will now warn if a callback with reference parameters is used. Examples include + array_filter and array_reduce. This was already the + case for most, but not all, functions previously. + + + + + The HTTP stream wrapper as used by functions like file_get_contents + now advertises HTTP/1.1 rather than HTTP/1.0 by default. This does not change the behavior of the + client, but may cause servers to respond differently. To retain the old behavior, set the + 'protocol_version' stream context option, e.g. + + + + ['protocol_version' => '1.0']]); +echo file_get_contents('http://example.org', false, $ctx); +?> +]]> + + + + + + Calling crypt without an explicit salt is no longer supported. If you would + like to produce a strong hash with an auto-generated salt, use + password_hash instead. + + + + + substr, mb_substr, iconv_substr and + grapheme_substr now consistently clamp out-of-bounds offsets to the string + boundary. Previously, &false; was returned instead of the empty string in some cases. + + + + + + + Sysvmsg + + + msg_get_queue will now return an SysvMessageQueue + object rather than a &resource;. Return value checks using is_resource + should be replaced with checks for &false;. + + + + + Sysvsem + + + + + sem_get will now return an SysvSemaphore object + rather than a &resource;. Return value checks using is_resource should be + replaced with checks for &false;. + + + + + The auto_release parameter of sem_get was changed to + accept bool values rather than int. + + + + + + + Sysvshm + + + shm_attach will now return an SysvSharedMemory object + rather than a &resource;. Return value checks using is_resource should be + replaced with checks for &false;. + + + + + Tidy + + + + + The use_include_path parameter, which was not used internally, has been + removed from tidy_repair_string. + + + + + tidy::repairString and tidy::repairFile became + static methods. + + + + + + + Tokenizer + + + + + T_COMMENT tokens will no longer include a trailing newline. The newline will + instead be part of a following T_WHITESPACE token. It should be noted that + T_COMMENT is not always followed by whitespace, it may also be followed by + T_CLOSE_TAG or end-of-file. + + + + + Namespaced names are now represented using the T_NAME_QUALIFIED + (Foo\Bar), T_NAME_FULLY_QUALIFIED (\Foo\Bar) and + T_NAME_RELATIVE (namespace\Foo\Bar) tokens. + T_NS_SEPARATOR is only used for standalone namespace separators, and only + syntactially valid in conjunction with group use declarations. + + + + + + + + XML + + + xml_parser_create and xml_parser_create_ns will now + return an XmlParser object rather than a &resource;. Return value checks + using is_resource should be replaced with checks for &false;. The + xml_parser_free function no longer has an effect, instead the XmlParser + instance is automatically destroyed if it is no longer referenced. + + + + + XMLReader + + + XMLReader::open and XMLReader::xml are now + static methods. They still can be called dynamically, but inheriting classes need to declare them + as static if they override these methods. + + + + + XMLWriter + + + The XMLWriter functions now accept and return, respectively, + XMLWriter objects instead of &resource;s. + + + + + Zip + + + ZipArchive::OPSYS_Z_CPM has been removed (this name was a typo). Use + ZipArchive::OPSYS_CPM instead. + + + + + Zlib + + + + + gzgetss has been removed. + + + + + inflate_init will now return an InflateContext object + rather than a &resource;. Return value checks using is_resource should be + replaced with checks for &false;. + + + + + deflate_init will now return a DeflateContext object + rather than a &resource;. Return value checks using is_resource should be + replaced with checks for &false;. + + + + + zlib.output_compression is no longer + automatically disabled for Content-Type: image/*. + + + + + + + + diff --git a/appendices/migration80/new-classes.xml b/appendices/migration80/new-classes.xml new file mode 100644 index 000000000000..5ca748262400 --- /dev/null +++ b/appendices/migration80/new-classes.xml @@ -0,0 +1,38 @@ + + + + + New Classes and Interfaces + + + Tokenizer + + + PhpToken adds an object-based interface to the tokenizer. It provides a + more uniform and ergonomic representation, while being more memory efficient and faster. + + + + + + + diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml new file mode 100644 index 000000000000..b8c2ddf458f8 --- /dev/null +++ b/appendices/migration80/new-features.xml @@ -0,0 +1,402 @@ + + + + + New Features + + + PHP Core + + + + + Support for union types has been added. + + + + + + The WeakMap class has been added. + + + + + + The ValueError class has been added. + + + + + Any number of function parameters may now be replaced by a variadic argument, as long as the + types are compatible. For example, the following code is now allowed: + + + + +]]> + + + + + + static (as in "late static binding") can now be used as a return type: + + + + +]]> + + + + + + + It is now possible to fetch the class name of an object using + $object::class. The result is the same as get_class($object). + + + + + + New and instanceof can now be used with arbitrary + expressions, using new (expression)(...$args) and $obj instanceof + (expression). + + + + + + Some consistency fixes to variable syntax have been applied, for example writing + Foo::BAR::$baz is now allowed. + + + + + + Added Stringable interface, which is automatically implemented if + a class defines a __toString() method. + + + + + + Traits can now define abstract private methods. + + + + + + throw can now be used as an expression. + + + + + + An optional trailing comma is now allowed in parameter lists. + + + + + + It is now possible to write catch (Exception) to catch an exception without storing + it in a variable. + + + + + + Support for mixed type has been added. + + + + + + Support for Attributes has been added. + + + + + + + + + Support for constructor property promotion (declaring properties in the constructor signature) + has been added. + + + + + + Support for match expression has been added. + + + + + + Private methods declared on a parent class no longer enforce any inheritance rules on the methods + of a child class. (with the exception of final private constructors) + + + + + + Support for nullsafe operator (?->) has been added. + + + + + + Support for named arguments has been added. + + + + + + + + Date and Time + + + + + DateTime::createFromInterface and + DateTimeImmutable::createFromInterface have been added. + + + + + The DateTime format specifier p has been added, which is the same as + P but returns Z for UTC. + + + + + + + DOM + + + DOMParentNode and DOMChildNode with + new traversal and manipulation APIs have been added. + + + + + + Enchant + + + enchant_dict_add and enchant_dict_is_added, and + LIBENCHANT_VERSION have been added. + + + + + FPM + + + Added a new option pm.status_listen that allows getting the status from + different endpoint (e.g. port or UDS file) which is useful for getting the status when all + children are busy with serving long running requests. + + + + + Hash + + + HashContext objects can now be serialized. + + + + + OPcache + + + If the opcache.record_warnings ini setting is + enabled, OPcache will record compile-time warnings and replay them on the next include, even if + it is served from cache. + + + + + OpenSSL + + + Added Cryptographic Message Syntax (CMS) (RFC 5652) + support composed of functions for encryption, decryption, signing, verifying and reading. The API + is similar to the API for PKCS #7 functions with an addition of new encoding constants: + OPENSSL_ENCODING_DER, OPENSSL_ENCODING_SMIME + and OPENSSL_ENCODING_PEM. + + + + + Standard Library + + + + + printf and friends now support the %h and + %H format specifiers. These are the same as %g and + %G, but always use "." as the decimal separator, rather + than determining it through the LC_NUMERIC locale. + + + + + printf and friends now support using "*" as width or + precision, in which case the width/precision is passed as an argument to printf. This also allows + using precision -1 with %g, %G, + %h and %H. For example, the following code can be used to + reproduce PHP's default floating point formatting: + + + + + + + + + + proc_open now supports pseudo-terminal (PTY) descriptors. The following + attaches stdin, stdout and stderr to the + same PTY: + + + + + + + + + + proc_open now supports socket pair descriptors. The following attaches a + distinct socket pair to stdin, stdout and + stderr: + + + + + + + + Unlike pipes, sockets do not suffer from blocking I/O issues on Windows. However, not all + programs may work correctly with stdio sockets. + + + + + Sorting functions are now stable, which means that equal-comparing elements will retain their + original order. + + + + + + array_diff, array_intersect and their variations can + now be used with a single array as argument. This means that usages like the following are now + possible: + + + + + + + + + + The flag parameter of ob_implicit_flush was changed + to accept bool values rather than int. + + + + + + + Zip + + + + + The Zip extension has been updated to version 1.19.1. + + + + + The ZipArchive::lastId property to get index value of last added entry has been added. + + + + + Errors can now be checked after an archive has been closed using the + ZipArchive::status and + ZipArchive::statusSys properties, or the + ZipArchive::getStatusString method. + + + + + The 'remove_path' option of ZipArchive::addGlob and + ZipArchive::addPattern is now treated as arbitrary string prefix (for + consistency with the 'add_path' option), whereas formerly it was treated as + directory name. + + + + + Optional compression / encryption features are now listed in phpinfo. + + + + + + + + diff --git a/appendices/migration80/new-functions.xml b/appendices/migration80/new-functions.xml new file mode 100644 index 000000000000..990cddf921b4 --- /dev/null +++ b/appendices/migration80/new-functions.xml @@ -0,0 +1,174 @@ + + + + + New Functions + + + PHP Core + + + get_resource_id, which returns the same value as + (int) $resource. It provides the same functionality under a clearer API. + + + + + LDAP + + + ldap_count_references, which returns the number of reference messages in a + search result. + + + + + OpenSSL + + + + + openssl_cms_encrypt encrypts the message in the file with the certificates + and outputs the result to the supplied file. + + + + + openssl_cms_decrypt that decrypts the S/MIME message in the file and outputs + the results to the supplied file. + + + + + openssl_cms_read that exports the CMS file to an array of PEM certificates. + + + + + openssl_cms_sign that signs the MIME message in the file with a cert and key + and output the result to the supplied file. + + + + + openssl_cms_verify that verifies that the data block is intact, the signer + is who they say they are, and returns the certs of the signers. + + + + + + + Regular Expressions (Perl-Compatible) + + + preg_last_error_msg, which returns a human-readable message for the last + PCRE error. It complements preg_last_error, which returns an integer enum + instead. + + + + + SQLite3 + + + SQLite3::setAuthorizer and respective class constants to set a userland + callback that will be used to authorize or not an action on the database. + + + + + + Standard Library + + + + + str_contains, str_starts_with and + str_ends_with, which check whether haystack contains, + starts with or ends with needle, respectively. + + + + + + + fdiv, which performs a floating-point division under IEEE 754 semantics. + Division by zero is considered well-defined and will return one of Inf, + -Inf or NaN. + + + + + get_debug_type, which returns a type useful for error messages. Unlike + gettype, it uses canonical type names, returns class names for objects, and + indicates the resource type for resources. + + + + + + + + Zip + + + + + ZipArchive::setMtimeName and + ZipArchive::setMtimeIndex to set the modification time of an entry. + + + + + ZipArchive::setProgressCallback to provide updates during archive close. + + + + + ZipArchive::setCancelCallback to allow cancellation during archive + close. + + + + + ZipArchive::replaceFile to replace an entry content. + + + + + ZipArchive::isCompressionMethodSupported to check optional compression + features. + + + + + ZipArchive::isEncryptionMethodSupported to check optional encryption + features. + + + + + + + + diff --git a/appendices/migration80/other-changes.xml b/appendices/migration80/other-changes.xml new file mode 100644 index 000000000000..202f24ef81d2 --- /dev/null +++ b/appendices/migration80/other-changes.xml @@ -0,0 +1,362 @@ + + + + + Other Changes + + + Changes in SAPI Modules + + + Apache2Handler + + + The PHP module has been renamed from php7_module to + php_module. + + + + + + Changed Functions + + + Reflection + + + ReflectionClass::getConstants and + ReflectionClass::getReflectionConstants results can be now filtered via + a new parameter filter. Three new constants were added to be used with it: + + + + ReflectionClassConstant::IS_PUBLIC + ReflectionClassConstant::IS_PROTECTED + ReflectionClassConstant::IS_PRIVATE + + + + + + Zip + + + + + The ZipArchive::addGlob and + ZipArchive::addPattern methods accept more values in the + options array argument: + + + + flags + comp_method + comp_flags + env_method + enc_password + + + + + + ZipArchive::addEmptyDir, ZipArchive::addFile + and ZipArchive::addFromString + methods have a new flags argument. This allows managing name encoding + (ZipArchive::FL_ENC_*) and entry replacement + (ZipArchive::FL_OVERWRITE). + + + + + ZipArchive::extractTo now restores the file modification time. + + + + + + + + Other Changes to Extensions + + + CURL + + + + + The CURL extension now requires at least libcurl 7.29.0. + + + + + curl_init will now return a CurlHandle object rather + than a &resource;. Return value checks using is_resource should be replaced + with checks for &false;. The curl_close function no longer has an effect, + instead the CurlHandle instance is automatically destroyed if it is no + longer referenced. + + + + + curl_multi_init will now return a CurlMultiHandle + object rather than a &resource;. Return value checks using is_resource + should be replaced with checks for &false;. The curl_multi_close function no + longer has an effect, instead the CurlMultiHandle instance is + automatically destroyed if it is no longer referenced. + + + + + curl_share_init will now return a CurlShareHandle + object rather than a &resource;. Return value checks using is_resource + should be replaced with checks for &false;. The curl_share_close function no + longer has an effect, instead the CurlShareHandle instance is + automatically destroyed if it is no longer referenced. + + + + + The deprecated parameter version of curl_version has + been removed. + + + + + + + Date and Time + + + DatePeriod now implements IteratorAggregate + (instead of Traversable). + + + + + DOM + + + DOMNamedNodeMap and DOMNodeList now implement + IteratorAggregate (instead of + Traversable). + + + + + Intl + + + IntlBreakIterator and ResourceBundle now implement + IteratorAggregate (instead of Traversable). + + + + + Enchant + + + The enchant extension now uses libenchant-2 by default when available. libenchant version 1 is + still supported but is deprecated and could be removed in the future. + + + + + GD + + + + + The num_points parameter of imagepolygon, + imageopenpolygon and imagefilledpolygon is now + optional, i.e. these functions may be called with either 3 or 4 arguments. If the arguments is + omitted, it is calculated as count($points)/2. + + + + + The function imagegetinterpolation to get the current interpolation method + has been added. + + + + + + + JSON + + + The JSON extension cannot be disabled anymore and is always an integral part of any PHP build, + similar to the date extension. + + + + + MBString + + + The Unicode data tables have been updated to version 13.0.0. + + + + + PDO + + + PDOStatement now implements + IteratorAggregate (instead of + Traversable). + + + + + LibXML + + + The minimum required libxml version is now 2.9.0. This means that external entity loading is now + guaranteed to be disabled by default, and no extra steps need to be taken to protect against XXE + attacks. + + + + + MySQLi / PDO MySQL + + + + + When mysqlnd is not used (which is the default and recommended option), the minimum supported + libmysqlclient version is now 5.5. + + + + + mysqli_result now implements + IteratorAggregate (instead of + Traversable). + + + + + + + PGSQL / PDO PGSQL + + + The PGSQL and PDO PGSQL extensions now require at least libpq 9.1. + + + + + Readline + + + Calling readline_completion_function before the interactive prompt starts + (e.g. in auto_prepend_file) will now override the + default interactive prompt completion function. Previously, + readline_completion_function only worked when called after starting the + interactive prompt. + + + + + SimpleXML + + + SimpleXMLElement now implements + RecursiveIterator and absorbed the functionality of + SimpleXMLIterator. SimpleXMLIterator is an empty + extension of SimpleXMLElement. + + + + + Shmop + + + shmop_open will now return a Shmop object rather than + a &resource;. Return value checks using is_resource should be replaced with + checks for &false;. The shmop_close function no longer has an effect, and is + deprecated; instead the Shmop instance is automatically destroyed if it is + no longer referenced. + + + + + + Changes to INI File Handling + + + + + com.dotnet_version + is a new INI directive to choose the version of the .NET framework to use for + dotnet objects. + + + + + zend.exception_string_param_max_len + is a new INI directive to set the maximum string length in an argument of a stringified + stack strace has been added. + + + + + + + EBCDIC + + + EBCDIC targets are no longer supported, though it's unlikely that they were still working in the + first place. + + + + + Performance + + + + + A Just-In-Time (JIT) compiler has been added to the opcache extension. + + + + + + array_slice on an array without gaps will no longer scan the whole array + to find the start offset. This may significantly reduce the runtime of the function with large + offsets and small lengths. + + + + + strtolower now uses a SIMD implementation when using the + "C" LC_CTYPE locale (which is the default). + + + + + + + + diff --git a/appendices/migration80/removed-extensions.xml b/appendices/migration80/removed-extensions.xml new file mode 100644 index 000000000000..14283edcde7b --- /dev/null +++ b/appendices/migration80/removed-extensions.xml @@ -0,0 +1,41 @@ + + + + + Removed Extensions + + + These extensions have been moved to PECL and are no longer part of the PHP + distribution. The PECL package versions of these extensions will be created + according to user demand. + + + + + + XML-RPC + + + + + + diff --git a/appendices/migration80/windows-support.xml b/appendices/migration80/windows-support.xml new file mode 100644 index 000000000000..b88e22d86947 --- /dev/null +++ b/appendices/migration80/windows-support.xml @@ -0,0 +1,53 @@ + + + + + Windows Support + + + Standard Library + + The program execution functions (proc_open, exec, + popen etc.) using the shell, now consistently execute %comspec% /s + /c "$commandline", which has the same effect as executing + $commandline (without additional quotes). + + + + + GD + + php_gd2.dll has been renamed to php_gd.dll. + + + + + PHP Test Packs + + The test runner has been renamed from run-test.php to + run-tests.php, to match its name in php-src. + + + + + + From dc84e0d00a2236d1fd9a46e901c1b1ee023e037a Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Mon, 26 Oct 2020 23:15:52 +0100 Subject: [PATCH 02/24] Fold XMP-RPC removal into incompatible changes section --- appendices/migration80.xml | 1 - appendices/migration80/incompatible.xml | 10 +++++ appendices/migration80/removed-extensions.xml | 41 ------------------- 3 files changed, 10 insertions(+), 42 deletions(-) delete mode 100644 appendices/migration80/removed-extensions.xml diff --git a/appendices/migration80.xml b/appendices/migration80.xml index 6b0abb3a3f76..7bd4115dd348 100644 --- a/appendices/migration80.xml +++ b/appendices/migration80.xml @@ -10,7 +10,6 @@ &appendices.migration80.constants; &appendices.migration80.incompatible; &appendices.migration80.deprecated; - &appendices.migration80.removed-extensions; &appendices.migration80.other-changes; &appendices.migration80.windows-support; diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 30f490195e79..adba279229ec 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -1496,6 +1496,16 @@ echo file_get_contents('http://example.org', false, $ctx); + + XML-RPC + + + The XML-RPC extension has been moved to PECL and is no longer part of the PHP + distribution. The PECL package version of this extension will be created + according to user demand. + + + XMLWriter diff --git a/appendices/migration80/removed-extensions.xml b/appendices/migration80/removed-extensions.xml deleted file mode 100644 index 14283edcde7b..000000000000 --- a/appendices/migration80/removed-extensions.xml +++ /dev/null @@ -1,41 +0,0 @@ - - - - - Removed Extensions - - - These extensions have been moved to PECL and are no longer part of the PHP - distribution. The PECL package versions of these extensions will be created - according to user demand. - - - - - - XML-RPC - - - - - - From 08f07a4b57a2e1cf08d10a0ef87f30f3b9c2628e Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Mon, 26 Oct 2020 23:39:16 +0100 Subject: [PATCH 03/24] Fix grammar Co-authored-by: Nikita Popov --- appendices/migration80/deprecated.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index 6c1154484e11..6fc24f012b47 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -88,7 +88,8 @@ function test(Foo $a = null, $b) {} // Allowed - The constant PG_VERSION_STR has now the same value as + The constant PG_VERSION_STR now has the same value as + PG_VERSION, and thus is deprecated. From 21fdc49556a593a60754a13245d6e23eb22abc1f Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Mon, 26 Oct 2020 23:50:55 +0100 Subject: [PATCH 04/24] Explicitly list deprecated pgsql function aliases and replacements --- appendices/migration80/deprecated.xml | 30 ++++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index 6fc24f012b47..cdbc8ac6b3e1 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -89,13 +89,41 @@ function test(Foo $a = null, $b) {} // Allowed The constant PG_VERSION_STR now has the same value as - PG_VERSION, and thus is deprecated. Function aliases in the pgsql extension have been deprecated. + See the following list for which functions should be used instead: + + + + pg_errormessage → pg_last_error + pg_numrows → pg_num_rows + pg_numfields → pg_num_fields + pg_cmdtuples → pg_affected_rows + pg_fieldname → pg_field_name + pg_fieldsize → pg_field_size + pg_fieldtype → pg_field_type + pg_fieldnum → pg_field_num + pg_result → pg_fetch_result + pg_fieldprtlen → pg_field_prtlen + pg_fieldisnull → pg_field_is_null + pg_freeresult → pg_free_result + pg_getlastoid → pg_last_oid + pg_locreate → pg_lo_create + pg_lounlink → pg_lo_unlink + pg_loopen → pg_lo_open + pg_loclose → pg_lo_close + pg_loread → pg_lo_read + pg_lowrite → pg_lo_write + pg_loreadall → pg_lo_read_all + pg_loimport → pg_lo_import + pg_loexport → pg_lo_export + pg_setclientencoding → pg_set_client_encoding + pg_clientencoding -> pg_client_encoding + From d4dd0a606a74ddd0a8cec2d4d9afb56a87742b6a Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Wed, 28 Oct 2020 23:44:42 +0100 Subject: [PATCH 05/24] Move resource to object conversions into own section --- appendices/migration80/incompatible.xml | 270 ++++++++++++----------- appendices/migration80/other-changes.xml | 39 ---- 2 files changed, 140 insertions(+), 169 deletions(-) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index adba279229ec..1d34fb3c2c59 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -499,6 +499,146 @@ class MyClass { + + Resource to Object Migration + + + Several &resource;s have been migrated to &object;s. + Return value checks using is_resource should be replaced with checks for &false;. + + + + + curl_init will now return a CurlHandle object rather + than a &resource;. The curl_close function no longer has an effect, + instead the CurlHandle instance is automatically destroyed if it is no + longer referenced. + + + + + curl_multi_init will now return a CurlMultiHandle + object rather than a &resource;. The curl_multi_close function no + longer has an effect, instead the CurlMultiHandle instance is + automatically destroyed if it is no longer referenced. + + + + + curl_share_init will now return a CurlShareHandle + object rather than a &resource;. The curl_share_close function no + longer has an effect, instead the CurlShareHandle instance is + automatically destroyed if it is no longer referenced. + + + + + enchant_broker_init will now return an EnchantBroker + object rather than a &resource;. + + + + + enchant_broker_request_dict and + enchant_broker_request_pwl_dict will now return an + EnchantDictionary object rather than a &resource;. + + + + + The GD extension now uses GdImage objects as the underlying data structure + for images, rather than &resource;s. These objects are completely opaque, i.e. they don't have + any methods. + + + + + openssl_x509_read and openssl_csr_sign will now return + an OpenSSLCertificate object rather than a &resource;. + The openssl_x509_free function is deprecated and no longer has an effect, + instead the OpenSSLCertificate instance is automatically destroyed if it + is no longer referenced. + + + + + openssl_csr_new will now return an + OpenSSLCertificateSigningRequest object rather than a &resource;. + + + + + openssl_pkey_new will now return an + OpenSSLAsymmetricKey object rather than a &resource;. + The openssl_pkey_free function is deprecated and no longer has an effect, + instead the OpenSSLAsymmetricKey instance is automatically destroyed if it + is no longer referenced. + + + + + shmop_open will now return a Shmop object rather than + a &resource;. The shmop_close function no longer has an effect, and is + deprecated; instead the Shmop instance is automatically destroyed if it is + no longer referenced. + + + + + socket_create, socket_create_listen, + socket_accept, socket_import_stream, + socket_addrinfo_connect, socket_addrinfo_bind, and + socket_wsaprotocol_info_import will now return a + Socket object rather than a &resource;. + + + + + msg_get_queue will now return an SysvMessageQueue + object rather than a &resource;. + + + + + sem_get will now return an SysvSemaphore object + rather than a &resource;. + + + + + shm_attach will now return an SysvSharedMemory object + rather than a &resource;. + + + + + xml_parser_create and xml_parser_create_ns will now + return an XmlParser object rather than a &resource;. The + xml_parser_free function no longer has an effect, instead the XmlParser + instance is automatically destroyed if it is no longer referenced. + + + + + The XMLWriter functions now accept and return, respectively, + XMLWriter objects instead of &resource;s. + + + + + inflate_init will now return an InflateContext object + rather than a &resource;. + + + + + deflate_init will now return a DeflateContext object + rather than a &resource;. + + + + + COM and .Net (Windows) @@ -563,21 +703,6 @@ class MyClass { enchant_dict_suggest will now return an empty array instead of &null;. - - - enchant_broker_init will now return an EnchantBroker - object rather than a &resource;. Return value checks using is_resource - should be replaced with checks for &false;. - - - - - enchant_broker_request_dict and - enchant_broker_request_pwl_dict will now return an - EnchantDictionary object rather than a &resource;. Return value checks - using is_resource should be replaced with checks for &false;. - - @@ -616,14 +741,6 @@ class MyClass { GD - - - The GD extension now uses GdImage objects as the underlying data structure - for images, rather than &resource;s. These objects are completely opaque, i.e. they don't have - any methods. Return value checks using is_resource should be replaced with - checks for &false;. - - The deprecated functions image2wbmp has been removed. @@ -875,41 +992,6 @@ class MyClass { OpenSSL - - - openssl_x509_read and openssl_csr_sign will now return - an OpenSSLCertificate object rather than a &resource;. Return value checks - using is_resource should be replaced with checks for &false;. - - - - - The openssl_x509_free function is deprecated and no longer has an effect, - instead the OpenSSLCertificate instance is automatically destroyed if it - is no longer referenced. - - - - - openssl_csr_new will now return an - OpenSSLCertificateSigningRequest object rather than a &resource;. Return - value checks using is_resource should be replaced with checks for &false;. - - - - - openssl_pkey_new will now return an - OpenSSLAsymmetricKey object rather than a &resource;. Return value checks - using is_resource should be replaced with checks for &false;. - - - - - The openssl_pkey_free function is deprecated and no longer has an effect, - instead the OpenSSLAsymmetricKey instance is automatically destroyed if it - is no longer referenced. - - openssl_seal and openssl_open now require @@ -1094,16 +1176,6 @@ class MyClass { socket_addrinfo_lookup have been removed. - - - socket_create, socket_create_listen, - socket_accept, socket_import_stream, - socket_addrinfo_connect, socket_addrinfo_bind, and - socket_wsaprotocol_info_import will now return a - Socket object rather than a &resource;. Return value checks using - is_resource should be replaced with checks for &false;. - - socket_addrinfo_lookup will now return an array of @@ -1390,27 +1462,10 @@ echo file_get_contents('http://example.org', false, $ctx); - - Sysvmsg - - - msg_get_queue will now return an SysvMessageQueue - object rather than a &resource;. Return value checks using is_resource - should be replaced with checks for &false;. - - - Sysvsem - - - sem_get will now return an SysvSemaphore object - rather than a &resource;. Return value checks using is_resource should be - replaced with checks for &false;. - - The auto_release parameter of sem_get was changed to @@ -1420,16 +1475,6 @@ echo file_get_contents('http://example.org', false, $ctx); - - Sysvshm - - - shm_attach will now return an SysvSharedMemory object - rather than a &resource;. Return value checks using is_resource should be - replaced with checks for &false;. - - - Tidy @@ -1474,18 +1519,6 @@ echo file_get_contents('http://example.org', false, $ctx); - - XML - - - xml_parser_create and xml_parser_create_ns will now - return an XmlParser object rather than a &resource;. Return value checks - using is_resource should be replaced with checks for &false;. The - xml_parser_free function no longer has an effect, instead the XmlParser - instance is automatically destroyed if it is no longer referenced. - - - XMLReader @@ -1506,15 +1539,6 @@ echo file_get_contents('http://example.org', false, $ctx); - - XMLWriter - - - The XMLWriter functions now accept and return, respectively, - XMLWriter objects instead of &resource;s. - - - Zip @@ -1533,20 +1557,6 @@ echo file_get_contents('http://example.org', false, $ctx); gzgetss has been removed. - - - inflate_init will now return an InflateContext object - rather than a &resource;. Return value checks using is_resource should be - replaced with checks for &false;. - - - - - deflate_init will now return a DeflateContext object - rather than a &resource;. Return value checks using is_resource should be - replaced with checks for &false;. - - zlib.output_compression is no longer diff --git a/appendices/migration80/other-changes.xml b/appendices/migration80/other-changes.xml index 202f24ef81d2..05af4dba9cd4 100644 --- a/appendices/migration80/other-changes.xml +++ b/appendices/migration80/other-changes.xml @@ -87,33 +87,6 @@ The CURL extension now requires at least libcurl 7.29.0. - - - curl_init will now return a CurlHandle object rather - than a &resource;. Return value checks using is_resource should be replaced - with checks for &false;. The curl_close function no longer has an effect, - instead the CurlHandle instance is automatically destroyed if it is no - longer referenced. - - - - - curl_multi_init will now return a CurlMultiHandle - object rather than a &resource;. Return value checks using is_resource - should be replaced with checks for &false;. The curl_multi_close function no - longer has an effect, instead the CurlMultiHandle instance is - automatically destroyed if it is no longer referenced. - - - - - curl_share_init will now return a CurlShareHandle - object rather than a &resource;. Return value checks using is_resource - should be replaced with checks for &false;. The curl_share_close function no - longer has an effect, instead the CurlShareHandle instance is - automatically destroyed if it is no longer referenced. - - The deprecated parameter version of curl_version has @@ -268,18 +241,6 @@ extension of SimpleXMLElement. - - - Shmop - - - shmop_open will now return a Shmop object rather than - a &resource;. Return value checks using is_resource should be replaced with - checks for &false;. The shmop_close function no longer has an effect, and is - deprecated; instead the Shmop instance is automatically destroyed if it is - no longer referenced. - - From eb5836c5d7381004c834ae7ce8713934d92d50fc Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Wed, 28 Oct 2020 23:49:34 +0100 Subject: [PATCH 06/24] Elaborate Suggested by Nikic. --- appendices/migration80/deprecated.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index cdbc8ac6b3e1..641ccc684026 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -26,8 +26,8 @@ function test(Foo $a = null, $b) {} // Allowed Calling get_defined_functions with exclude_disabled - explicitly set to &false; is deprecated. get_defined_functions will never - include disabled functions. + explicitly set to &false; is deprecated and no longer has an effect. + get_defined_functions will never include disabled functions. From 81f9ee1df4c3c681fea48a675b72864cc22117ac Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Tue, 3 Nov 2020 01:14:39 +0100 Subject: [PATCH 07/24] Address some of Nikita's review comments --- appendices/migration80/deprecated.xml | 31 +++++++++++++++++------- appendices/migration80/new-features.xml | 5 ++-- appendices/migration80/other-changes.xml | 4 +-- 3 files changed, 26 insertions(+), 14 deletions(-) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index 641ccc684026..fd309574d7b1 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -9,16 +9,29 @@ - - Declaring a required parameter after an optional one is deprecated. As an exception, declaring a - parameter of the form Type $param = null before a required one continues to be - allowed, because this pattern was sometimes used to achieve nullable types in older PHP versions. - - - + + If a parameter with a default value is followed by a required parameter, the default value has + no effect. This is deprecated as of PHP 8.0.0 and can generally be resolved by dropping the + default value, without a change in functionality: + + + + + + + + One exception to this rule are parameters of the form Type $param = null, where + the null default makes the type implicitly nullable. This usage remains allowed, but it is + recommended to use an explicit nullable type instead: + + + diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index b8c2ddf458f8..9928650c600a 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -73,9 +73,8 @@ class Test { - New and instanceof can now be used with arbitrary - expressions, using new (expression)(...$args) and $obj instanceof - (expression). + &new; and &instanceof; can now be used with arbitrary expressions, + using new (expression)(...$args) and $obj instanceof (expression). diff --git a/appendices/migration80/other-changes.xml b/appendices/migration80/other-changes.xml index 05af4dba9cd4..1d921c3bd09f 100644 --- a/appendices/migration80/other-changes.xml +++ b/appendices/migration80/other-changes.xml @@ -141,7 +141,7 @@ The num_points parameter of imagepolygon, imageopenpolygon and imagefilledpolygon is now - optional, i.e. these functions may be called with either 3 or 4 arguments. If the arguments is + optional, i.e. these functions may be called with either 3 or 4 arguments. If the argument is omitted, it is calculated as count($points)/2. @@ -258,7 +258,7 @@ zend.exception_string_param_max_len is a new INI directive to set the maximum string length in an argument of a stringified - stack strace has been added. + stack strace. From 287c8d56d3de7f8e3d7de851c9231f7564737ec6 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Wed, 4 Nov 2020 00:17:02 +0100 Subject: [PATCH 08/24] Incorporate further suggestions from Nikita --- appendices/migration80/new-features.xml | 33 ++++++++++++++++++++----- 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index 9928650c600a..dca3d96f49cf 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -95,18 +95,37 @@ class Test { Traits can now define abstract private methods. + Such methods must be implemented by the class using the trait. throw can now be used as an expression. + That allows usages like: + + throw new Exception('Exception in arrow function'); +$user = $session->user ?? throw new Exception('Must have user'); +]]> + An optional trailing comma is now allowed in parameter lists. + + + @@ -180,7 +199,8 @@ class Test { The DateTime format specifier p has been added, which is the same as - P but returns Z for UTC. + P but returns Z rather than +00:00 + for UTC. @@ -200,7 +220,7 @@ class Test { Enchant - enchant_dict_add and enchant_dict_is_added, and + enchant_dict_add, enchant_dict_is_added, and LIBENCHANT_VERSION have been added. @@ -333,7 +353,7 @@ array_intersect(...$arrays); The flag parameter of ob_implicit_flush was changed - to accept bool values rather than int. + to accept a bool rather than an int. @@ -350,7 +370,8 @@ array_intersect(...$arrays); - The ZipArchive::lastId property to get index value of last added entry has been added. + The ZipArchive::lastId property to get the index value of + the last added entry has been added. @@ -364,8 +385,8 @@ array_intersect(...$arrays); The 'remove_path' option of ZipArchive::addGlob and - ZipArchive::addPattern is now treated as arbitrary string prefix (for - consistency with the 'add_path' option), whereas formerly it was treated as + ZipArchive::addPattern is now treated as an arbitrary string prefix (for + consistency with the 'add_path' option), whereas formerly it was treated as a directory name. From 0f71a05d68d6f553a6c276738a463c693ba1a6fa Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Wed, 4 Nov 2020 00:18:39 +0100 Subject: [PATCH 09/24] Avoid linking to wrong WeakMap class --- appendices/migration80/new-features.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index dca3d96f49cf..22798cd73179 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -16,7 +16,8 @@ - The WeakMap class has been added. + + The WeakMap class has been added. From 0efb45a75e7b6d62090d38e602128df826dc51e9 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Thu, 5 Nov 2020 00:31:35 +0100 Subject: [PATCH 10/24] Incorporate more of Nikita's suggestions --- appendices/migration80/new-features.xml | 26 +++++++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index 22798cd73179..016af58665bb 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -168,13 +168,35 @@ function functionWithLongSignature( Private methods declared on a parent class no longer enforce any inheritance rules on the methods - of a child class. (with the exception of final private constructors) + of a child class (with the exception of final private constructors). + The following example illustrates which restrictions have been removed: + + +]]> + - Support for nullsafe operator (?->) has been added. + Support for the nullsafe operator (?->) has been added. From fab49675d4570f19d057513f94d943a3ce73aad8 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Thu, 5 Nov 2020 01:04:44 +0100 Subject: [PATCH 11/24] Add example for iterating over ZipArchive entries --- appendices/migration80/deprecated.xml | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index fd309574d7b1..b6d51b36e0ac 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -155,6 +155,27 @@ function test(?A $a, $b) {} // Recommended The procedural API of Zip is deprecated. Use ZipArchive instead. + Iteration over all entries can be accomplished using ZipArchive::statIndex + and a for loop: + + + +statIndex($i); $i++) { + echo $entry['name']; +} +?> +]]> + From 5c6c863ac5a7a825d97da6acf4ab0223b397a120 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Thu, 5 Nov 2020 01:41:41 +0100 Subject: [PATCH 12/24] =?UTF-8?q?Enclose=20PHP=20code=20snippet=20in=20=20tags?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- appendices/migration80/deprecated.xml | 4 ++++ appendices/migration80/new-features.xml | 12 ++++++++++-- 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index b6d51b36e0ac..2dc986edb1ae 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -17,8 +17,10 @@ ]]> @@ -30,8 +32,10 @@ function test($a, $b) {} // After ]]> diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index 016af58665bb..dd9e9c6a7235 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -311,8 +311,10 @@ class ChildClass extends ParentClass { ]]> @@ -326,7 +328,9 @@ printf("%.*H", (int) ini_get("serialize_precision"), $float); ]]> @@ -340,7 +344,9 @@ $proc = proc_open($command, [['pty'], ['pty'], ['pty']], $pipes); ]]> @@ -365,10 +371,12 @@ $proc = proc_open($command, [['socket'], ['socket'], ['socket']], $pipes); ]]> From 3cc6d9c0e034d0122bc232d097aae65e47af989c Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Thu, 5 Nov 2020 01:42:52 +0100 Subject: [PATCH 13/24] Declaring custom assert() is no longer allowed --- appendices/migration80/incompatible.xml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 1d34fb3c2c59..6d84faf35929 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -496,6 +496,14 @@ class MyClass { instead of being silently ignored. + + + Declaring a function called assert() inside a namespace is + no longer allowed, and issues E_COMPILE_ERROR. + The assert function is subject to special handling by the engine, + which may lead to inconsistent behavior when defining a namespaced function with the same name. + + From bea76242c3c8a90dba4cc1af8867bd0ad4ac0f59 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Thu, 5 Nov 2020 01:54:35 +0100 Subject: [PATCH 14/24] Fix function name --- appendices/migration80/incompatible.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 6d84faf35929..55096191302a 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -1334,7 +1334,7 @@ class MyClass { ezmlm_hash restore_include_path get_magic_quotes_gpc - get_magic_quotes_gpc_runtime + get_magic_quotes_runtime From 4657e648faca6f1f038d27e2b1c4da23c27b44aa Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Fri, 6 Nov 2020 23:50:41 +0100 Subject: [PATCH 15/24] Incorporate more of Nikita's suggestions --- appendices/migration80/incompatible.xml | 123 ++++++++++++++++++++---- 1 file changed, 103 insertions(+), 20 deletions(-) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 55096191302a..6c496fad4e81 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -171,8 +171,8 @@ function my_error_handler($err_no, $err_msg, $filename, $linenum) { - Following the hash comment operator # immediately with an opening bracket is - not supported as a comment anymore since this syntax is now used for attributes. + #[ is no longer interpreted as the start of a comment, + as this syntax is now used for attributes. @@ -187,6 +187,19 @@ function my_error_handler($err_no, $err_msg, $filename, $linenum) { The precedence of the concatenation operator has changed relative to bitshifts and addition as well as subtraction. + + + + +]]> + @@ -265,8 +278,9 @@ function test(int $arg = null) {} - Compile time fatal error "Only variables can be passed by reference" has been delayed until - runtime and converted to "Argument cannot be passed by reference" exception. + The compile time fatal error "Only variables can be passed by reference" has been delayed until + runtime, and converted into an "Argument cannot be passed by reference" + Error exception. @@ -319,7 +333,7 @@ class X { If both T1::func() and T2::func() exist, this code was previously - silently accepted, and func as assumed to refer to T1::func. Now it will generate a + silently accepted, and func was assumed to refer to T1::func. Now it will generate a fatal error instead, and either T1::func or T2::func needs to be written explicitly. @@ -376,12 +390,43 @@ class MyClass { Float to string casting will now always behave locale-independently. + + + + +]]> + + + + See printf, number_format and + NumberFormatter for ways to customize number formatting. Support for deprecated curly braces for offset access has been removed. + + + + +]]> + @@ -404,6 +449,49 @@ class MyClass { string and comparing the strings. Comparisons between numbers and numeric strings continue to work as before. Notably, this means that 0 == "not-a-number" is considered false now. + + + + + Comparison + Before + After + + + + + 0 == "0" + &true; + &true; + + + 0 == "0.0" + &true; + &true; + + + 0 == "foo" + &true; + &false; + + + 0 == "" + &true; + &false; + + + 42 == " 42" + &true; + &true; + + + 42 == "42foo" + &true; + &false; + + + + @@ -555,8 +643,7 @@ class MyClass { The GD extension now uses GdImage objects as the underlying data structure - for images, rather than &resource;s. These objects are completely opaque, i.e. they don't have - any methods. + for images, rather than &resource;s. @@ -598,6 +685,8 @@ class MyClass { socket_addrinfo_connect, socket_addrinfo_bind, and socket_wsaprotocol_info_import will now return a Socket object rather than a &resource;. + socket_addrinfo_lookup will now return an array of + AddressInfo objects rather than &resource;s. @@ -946,7 +1035,7 @@ class MyClass { mb_ereg and mb_eregi will now return boolean &true; on a successfuly match. Previously they returned integer 1 if - matches was not passed, or max(1, strlen($reg[0])) if + matches was not passed, or max(1, strlen($matches[0])) if matches was passed. @@ -1036,8 +1125,8 @@ class MyClass { - PDO::query(string $statement, ?int $fetch_mode = null, ...$fetch_mode_args) - PDOStatement::setFetchMode(int $mode, ...$params) + PDO::query(string $query, ?int $fetchMode = null, mixed ...$fetchModeArgs) + PDOStatement::setFetchMode(int $mode, mixed ...$args) @@ -1138,6 +1227,7 @@ class MyClass { Reflection export() methods have been removed. + Instead reflection objects can be cast to string. @@ -1184,12 +1274,6 @@ class MyClass { socket_addrinfo_lookup have been removed. - - - socket_addrinfo_lookup will now return an array of - AddressInfo objects rather than resources. - - @@ -1386,7 +1470,7 @@ class MyClass { "C", while LC_CTYPE was inherited from the environment. However, some functions did not respect the inherited locale without an explicit setlocale call. An explicit setlocale call is now - always required if locale component should be changed from the default. + always required if a locale component should be changed from the default. @@ -1532,7 +1616,7 @@ echo file_get_contents('http://example.org', false, $ctx); XMLReader::open and XMLReader::xml are now - static methods. They still can be called dynamically, but inheriting classes need to declare them + static methods. They can still be called as instance methods, but inheriting classes need to declare them as static if they override these methods. @@ -1542,8 +1626,7 @@ echo file_get_contents('http://example.org', false, $ctx); The XML-RPC extension has been moved to PECL and is no longer part of the PHP - distribution. The PECL package version of this extension will be created - according to user demand. + distribution. From 1bf3e1640f1d2ce2a1d5297c1617c9b5e5b72ff7 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sat, 7 Nov 2020 16:56:31 +0100 Subject: [PATCH 16/24] Incorporate more of Nikita's suggestions --- appendices/migration80/deprecated.xml | 26 +++++++++++ appendices/migration80/incompatible.xml | 57 +++++++++---------------- 2 files changed, 45 insertions(+), 38 deletions(-) diff --git a/appendices/migration80/deprecated.xml b/appendices/migration80/deprecated.xml index 2dc986edb1ae..8867d279b1ce 100644 --- a/appendices/migration80/deprecated.xml +++ b/appendices/migration80/deprecated.xml @@ -146,6 +146,32 @@ function test(?A $a, $b) {} // Recommended + + Standard Library + + + + + Sort comparison functions that return &true; or &false; will now throw a deprecation warning, and + should be replaced with an implementation that returns an integer less than, equal to, or greater + than zero. + + + + $a > $b); +// With +usort($array, fn($a, $b) => $a <=> $b); +?> +]]> + + + + + + Zip diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 6c496fad4e81..1af6850921b5 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -50,12 +50,6 @@ define may no longer be &true;. - - - Access to undefined constants now always results in an Error exception. - Previously, unqualified constant accesses resulted in a warning and were interpreted as strings. - - The ability to specify an autoloader using an __autoload function has been @@ -230,14 +224,24 @@ function test(int $arg = null) {} - Attempting to write to a property of a non-object. Previously this - implicitly created an stdClass object for null, false and empty strings. - Attempting to append an element to an array for which the PHP_INT_MAX key - is already used. - Attempting to use an invalid type (array or object) as an array key or - string offset. + + Attempting to write to a property of a non-object. Previously this + implicitly created an stdClass object for null, false and empty strings. + + + Attempting to append an element to an array for which the PHP_INT_MAX key + is already used. + + + Attempting to use an invalid type (array or object) as an array key or + string offset. + Attempting to write to an array index of a scalar value. Attempting to unpack a non-array/Traversable. + + Attempting to access unqualified constants which are undefined. + Previously, unqualified constant accesses resulted in a warning and were interpreted as strings. + @@ -1073,7 +1077,7 @@ $array["key"]; - odbc_connect no longer reuses persistent connections. + odbc_connect no longer reuses connections. @@ -1342,11 +1346,6 @@ $array["key"]; parse_str can no longer be used without specifying a result array. - - - fgetss has been removed. - - The string.strip_tags filter has been removed. @@ -1419,6 +1418,7 @@ $array["key"]; restore_include_path get_magic_quotes_gpc get_magic_quotes_runtime + fgetss @@ -1492,25 +1492,6 @@ $array["key"]; equal. - - - Sort comparison functions that return &true; or &false; will now throw a deprecation warning, and - should be replaced with an implementation that returns an integer less than, equal to, or greater - than zero. - - - - $a > $b); -// With -usort($array, fn($a, $b) => $a <=> $b); -?> -]]> - - - Any functions accepting callbacks that are not explicitly specified to accept parameters by @@ -1621,7 +1602,7 @@ echo file_get_contents('http://example.org', false, $ctx); - + XML-RPC From 2dbd79508daa5aec11a2a4a59a9493f5df4bb19a Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sat, 7 Nov 2020 18:03:39 +0100 Subject: [PATCH 17/24] Merge special pages for constants, functions and methods into new-features --- appendices/migration80.xml | 3 - appendices/migration80/constants.xml | 38 ----- appendices/migration80/new-classes.xml | 38 ----- appendices/migration80/new-features.xml | 136 +++++++++++++++++- appendices/migration80/new-functions.xml | 174 ----------------------- 5 files changed, 135 insertions(+), 254 deletions(-) delete mode 100644 appendices/migration80/constants.xml delete mode 100644 appendices/migration80/new-classes.xml delete mode 100644 appendices/migration80/new-functions.xml diff --git a/appendices/migration80.xml b/appendices/migration80.xml index 7bd4115dd348..170416640fc7 100644 --- a/appendices/migration80.xml +++ b/appendices/migration80.xml @@ -5,9 +5,6 @@ Migrating from PHP 7.4.x to PHP 8.0.x &appendices.migration80.new-features; - &appendices.migration80.new-classes; - &appendices.migration80.new-functions; - &appendices.migration80.constants; &appendices.migration80.incompatible; &appendices.migration80.deprecated; &appendices.migration80.other-changes; diff --git a/appendices/migration80/constants.xml b/appendices/migration80/constants.xml deleted file mode 100644 index 0b11b5daa29b..000000000000 --- a/appendices/migration80/constants.xml +++ /dev/null @@ -1,38 +0,0 @@ - - - - - New Global Constants - - - Filter - - - FILTER_VALIDATE_BOOL has been added as an alias for - FILTER_VALIDATE_BOOLEAN. The new name is preferred, as it uses the canonical - type name. - - - - - - diff --git a/appendices/migration80/new-classes.xml b/appendices/migration80/new-classes.xml deleted file mode 100644 index 5ca748262400..000000000000 --- a/appendices/migration80/new-classes.xml +++ /dev/null @@ -1,38 +0,0 @@ - - - - - New Classes and Interfaces - - - Tokenizer - - - PhpToken adds an object-based interface to the tokenizer. It provides a - more uniform and ergonomic representation, while being more memory efficient and faster. - - - - - - - diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index dd9e9c6a7235..429928a40e11 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -206,6 +206,12 @@ class ChildClass extends ParentClass { + + + get_resource_id has been added, which returns the same value as + (int) $resource. It provides the same functionality under a clearer API. + + @@ -239,6 +245,16 @@ class ChildClass extends ParentClass { + + Filter + + + FILTER_VALIDATE_BOOL has been added as an alias for + FILTER_VALIDATE_BOOLEAN. The new name is preferred, as it uses the canonical + type name. + + + Enchant @@ -266,6 +282,14 @@ class ChildClass extends ParentClass { + + LDAP + + + ldap_count_references has been added, which returns the number + of reference messages in a search result. + + OPcache @@ -284,7 +308,49 @@ class ChildClass extends ParentClass { support composed of functions for encryption, decryption, signing, verifying and reading. The API is similar to the API for PKCS #7 functions with an addition of new encoding constants: OPENSSL_ENCODING_DER, OPENSSL_ENCODING_SMIME - and OPENSSL_ENCODING_PEM. + and OPENSSL_ENCODING_PEM: + + + openssl_cms_encrypt encrypts the message in the file with the certificates + and outputs the result to the supplied file. + + + openssl_cms_decrypt that decrypts the S/MIME message in the file and outputs + the results to the supplied file. + + + openssl_cms_read that exports the CMS file to an array of PEM certificates. + + + openssl_cms_sign that signs the MIME message in the file with a cert and key + and output the result to the supplied file. + + + openssl_cms_verify that verifies that the data block is intact, the signer + is who they say they are, and returns the certs of the signers. + + + + + + + Regular Expressions (Perl-Compatible) + + + preg_last_error_msg has been added, which returns a human-readable message for the last + PCRE error. It complements preg_last_error, which returns an integer enum value + instead. + + + + + + SQLite3 + + + SQLite3::setAuthorizer and respective class constants have been added + to set a userland callback that will be used to authorize or not an action on the database. + @@ -292,6 +358,30 @@ class ChildClass extends ParentClass { Standard Library + + + str_contains, str_starts_with and + str_ends_with have been added, which check whether haystack contains, + starts with or ends with needle, respectively. + + + + + + + fdiv has been added, which performs a floating-point division under IEEE 754 semantics. + Division by zero is considered well-defined and will return one of Inf, + -Inf or NaN. + + + + + get_debug_type has been added, which returns a type useful for error messages. Unlike + gettype, it uses canonical type names, returns class names for objects, and + indicates the resource type for resources. + + + printf and friends now support the %h and @@ -390,6 +480,16 @@ array_intersect(...$arrays); + + Tokenizer + + + PhpToken adds an object-based interface to the tokenizer. It provides a + more uniform and ergonomic representation, while being more memory efficient and faster. + + + + Zip @@ -399,6 +499,40 @@ array_intersect(...$arrays); The Zip extension has been updated to version 1.19.1. + + + New ZipArchive::setMtimeName and + ZipArchive::setMtimeIndex to set the modification time of an entry. + + + + + New ZipArchive::setProgressCallback to provide updates during archive close. + + + + + New ZipArchive::setCancelCallback to allow cancellation during archive + close. + + + + + New ZipArchive::replaceFile to replace an entry content. + + + + + New ZipArchive::isCompressionMethodSupported to check optional compression + features. + + + + + New ZipArchive::isEncryptionMethodSupported to check optional encryption + features. + + The ZipArchive::lastId property to get the index value of diff --git a/appendices/migration80/new-functions.xml b/appendices/migration80/new-functions.xml deleted file mode 100644 index 990cddf921b4..000000000000 --- a/appendices/migration80/new-functions.xml +++ /dev/null @@ -1,174 +0,0 @@ - - - - - New Functions - - - PHP Core - - - get_resource_id, which returns the same value as - (int) $resource. It provides the same functionality under a clearer API. - - - - - LDAP - - - ldap_count_references, which returns the number of reference messages in a - search result. - - - - - OpenSSL - - - - - openssl_cms_encrypt encrypts the message in the file with the certificates - and outputs the result to the supplied file. - - - - - openssl_cms_decrypt that decrypts the S/MIME message in the file and outputs - the results to the supplied file. - - - - - openssl_cms_read that exports the CMS file to an array of PEM certificates. - - - - - openssl_cms_sign that signs the MIME message in the file with a cert and key - and output the result to the supplied file. - - - - - openssl_cms_verify that verifies that the data block is intact, the signer - is who they say they are, and returns the certs of the signers. - - - - - - - Regular Expressions (Perl-Compatible) - - - preg_last_error_msg, which returns a human-readable message for the last - PCRE error. It complements preg_last_error, which returns an integer enum - instead. - - - - - SQLite3 - - - SQLite3::setAuthorizer and respective class constants to set a userland - callback that will be used to authorize or not an action on the database. - - - - - - Standard Library - - - - - str_contains, str_starts_with and - str_ends_with, which check whether haystack contains, - starts with or ends with needle, respectively. - - - - - - - fdiv, which performs a floating-point division under IEEE 754 semantics. - Division by zero is considered well-defined and will return one of Inf, - -Inf or NaN. - - - - - get_debug_type, which returns a type useful for error messages. Unlike - gettype, it uses canonical type names, returns class names for objects, and - indicates the resource type for resources. - - - - - - - - Zip - - - - - ZipArchive::setMtimeName and - ZipArchive::setMtimeIndex to set the modification time of an entry. - - - - - ZipArchive::setProgressCallback to provide updates during archive close. - - - - - ZipArchive::setCancelCallback to allow cancellation during archive - close. - - - - - ZipArchive::replaceFile to replace an entry content. - - - - - ZipArchive::isCompressionMethodSupported to check optional compression - features. - - - - - ZipArchive::isEncryptionMethodSupported to check optional encryption - features. - - - - - - - - From 79547e3393cbae7ad729fafc0fb56045010a85db Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sat, 7 Nov 2020 18:08:10 +0100 Subject: [PATCH 18/24] Move info to appropriate sections --- appendices/migration80/incompatible.xml | 25 +------------------ appendices/migration80/new-features.xml | 32 +++++++++++++++++++++++++ 2 files changed, 33 insertions(+), 24 deletions(-) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 1af6850921b5..c98eb212442e 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -902,7 +902,7 @@ $array["key"]; - Intl + Internationalization Functions @@ -916,15 +916,6 @@ $array["key"]; The deprecated Normalizer::NONE constant has been removed. - - - The IntlDateFormatter::RELATIVE_FULL, - IntlDateFormatter::RELATIVE_LONG, - IntlDateFormatter::RELATIVE_MEDIUM, and - IntlDateFormatter::RELATIVE_SHORT - constants have been added. - - @@ -1234,20 +1225,6 @@ $array["key"]; Instead reflection objects can be cast to string. - - - The following methods can now return information about default values of - parameters of internal functions: - - - - ReflectionParameter::isDefaultValueAvailable - ReflectionParameter::getDefaultValue - ReflectionParameter::isDefaultValueConstant - ReflectionParameter::getDefaultValueConstantName - - - ReflectionMethod::isConstructor and diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index 429928a40e11..a481c066a3d0 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -282,6 +282,18 @@ class ChildClass extends ParentClass { + + Internationalization Functions + + + The IntlDateFormatter::RELATIVE_FULL, + IntlDateFormatter::RELATIVE_LONG, + IntlDateFormatter::RELATIVE_MEDIUM, and + IntlDateFormatter::RELATIVE_SHORT + constants have been added. + + + LDAP @@ -341,7 +353,27 @@ class ChildClass extends ParentClass { PCRE error. It complements preg_last_error, which returns an integer enum value instead. + + + Reflection + + + + + The following methods can now return information about default values of + parameters of internal functions: + + + + ReflectionParameter::isDefaultValueAvailable + ReflectionParameter::getDefaultValue + ReflectionParameter::isDefaultValueConstant + ReflectionParameter::getDefaultValueConstantName + + + + From 43c48901e00c95d807c411bd72b229a76df9eaf5 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sat, 14 Nov 2020 15:27:21 +0100 Subject: [PATCH 19/24] Add note that imagedestroy() no longer has an effect --- appendices/migration80/incompatible.xml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index c98eb212442e..ca1151bd0589 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -648,6 +648,8 @@ $array["key"]; The GD extension now uses GdImage objects as the underlying data structure for images, rather than &resource;s. + The imagedestroy function no longer has an effect; instead the + GdImage instance is automatically destroyed if it is no longer referenced. From 35ab87efb5cf42e4e25b1c3bba36f81a4e948a6e Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 22 Nov 2020 15:09:09 +0100 Subject: [PATCH 20/24] The (real) cast has been removed --- appendices/migration80/incompatible.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index ca1151bd0589..71983148d14e 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -34,7 +34,7 @@ - The (unset) cast has been removed. + The (real) and (unset) casts have been removed. From ea698e9df0dc18025c90067ca466f983718a40ba Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 22 Nov 2020 15:13:57 +0100 Subject: [PATCH 21/24] Link to union types section --- appendices/migration80/new-features.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index a481c066a3d0..e7db8bc04977 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -10,7 +10,7 @@ - Support for union types has been added. + Support for union types has been added. From 5dc520a01785b040dcd807e285627ade7ed68c04 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 22 Nov 2020 16:15:46 +0100 Subject: [PATCH 22/24] Add subsections for the most important changes --- appendices/migration80/incompatible.xml | 1001 ++++++++++++----------- appendices/migration80/new-features.xml | 331 ++++---- 2 files changed, 680 insertions(+), 652 deletions(-) diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index 71983148d14e..c4284391ed92 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -7,135 +7,193 @@ PHP Core - - - - match is now a reserved keyword. - - - - - Assertion failures now throw by default. If the old behavior is desired, - assert.exception=0 can be set in the INI settings. - - - - - Methods with the same name as the class are no longer interpreted as constructors. The - __construct() method should be used instead. - - - - - The ability to call non-static methods statically has been removed. Thus - is_callable will fail when checking for a non-static method with a classname - (must check with an object instance). - - - - - The (real) and (unset) casts have been removed. - - - + + String to Number Comparison + + + Non-strict comparisons between numbers and non-numeric strings now work by casting the number to + string and comparing the strings. Comparisons between numbers and numeric strings continue to + work as before. Notably, this means that 0 == "not-a-number" is considered false + now. + + + + + Comparison + Before + After + + + + + 0 == "0" + &true; + &true; + + + 0 == "0.0" + &true; + &true; + + + 0 == "foo" + &true; + &false; + + + 0 == "" + &true; + &false; + + + 42 == " 42" + &true; + &true; + + + 42 == "42foo" + &true; + &false; + + + + + + + + + + Other incompatible Changes + + + - The track_errors ini directive has been removed. This - means that php_errormsg is no longer available. The - error_get_last function may be used instead. + match is now a reserved keyword. - - - - The ability to define case-insensitive constants has been removed. The third argument to - define may no longer be &true;. - - - - - The ability to specify an autoloader using an __autoload function has been - removed. spl_autoload_register should be used instead. - - - - - The errcontext argument for custom error handlers has been removed. - - - - - create_function has been removed. Anonymous functions may be used instead. - - - - - each has been removed. &foreach; or ArrayIterator - should be used instead. - - - - - The ability to unbind this from closures that were created from a method, - using Closure::fromCallable or - ReflectionMethod::getClosure, has been removed. - - - - - The ability to unbind this from proper closures that contain uses of - this has also been removed. - - - - - The ability to use array_key_exists with objects has been removed. - isset or property_exists may be used instead. - - - - - The behavior of array_key_exists regarding the type of the - key parameter has been made consistent with isset and - normal array access. All key types now use the usual coercions and array/object keys throw a - TypeError. - - - - - Any array that has a number n as its first numeric key will use - n+1 for its next implicit key, even if n is - negative. - - - - - - The default error_reporting level is now E_ALL. Previously it excluded - E_NOTICE and E_DEPRECATED. - - - - - display_startup_errors is now enabled by - default. - - - - - Using parent inside a class that has no parent will now result in a fatal - compile-time error. - - - - - The @ operator will no longer silence fatal errors - (E_ERROR, E_CORE_ERROR, - E_COMPILE_ERROR, E_USER_ERROR, - E_RECOVERABLE_ERROR, E_PARSE). Error handlers that - expect error_reporting to be 0 when @ is used, should be - adjusted to use a mask check instead: - - - + + + + Assertion failures now throw by default. If the old behavior is desired, + assert.exception=0 can be set in the INI settings. + + + + + Methods with the same name as the class are no longer interpreted as constructors. The + __construct() method should be used instead. + + + + + The ability to call non-static methods statically has been removed. Thus + is_callable will fail when checking for a non-static method with a classname + (must check with an object instance). + + + + + The (real) and (unset) casts have been removed. + + + + + The track_errors ini directive has been removed. This + means that php_errormsg is no longer available. The + error_get_last function may be used instead. + + + + + The ability to define case-insensitive constants has been removed. The third argument to + define may no longer be &true;. + + + + + The ability to specify an autoloader using an __autoload function has been + removed. spl_autoload_register should be used instead. + + + + + The errcontext argument for custom error handlers has been removed. + + + + + create_function has been removed. Anonymous functions may be used instead. + + + + + each has been removed. &foreach; or ArrayIterator + should be used instead. + + + + + The ability to unbind this from closures that were created from a method, + using Closure::fromCallable or + ReflectionMethod::getClosure, has been removed. + + + + + The ability to unbind this from proper closures that contain uses of + this has also been removed. + + + + + The ability to use array_key_exists with objects has been removed. + isset or property_exists may be used instead. + + + + + The behavior of array_key_exists regarding the type of the + key parameter has been made consistent with isset and + normal array access. All key types now use the usual coercions and array/object keys throw a + TypeError. + + + + + Any array that has a number n as its first numeric key will use + n+1 for its next implicit key, even if n is + negative. + + + + + + The default error_reporting level is now E_ALL. Previously it excluded + E_NOTICE and E_DEPRECATED. + + + + + display_startup_errors is now enabled by + default. + + + + + Using parent inside a class that has no parent will now result in a fatal + compile-time error. + + + + + The @ operator will no longer silence fatal errors + (E_ERROR, E_CORE_ERROR, + E_COMPILE_ERROR, E_USER_ERROR, + E_RECOVERABLE_ERROR, E_PARSE). Error handlers that + expect error_reporting to be 0 when @ is used, should be + adjusted to use a mask check instead: + + + ]]> - - - - Additionally, care should be taken that error messages are not displayed in production - environments, which can result in information leaks. Please ensure that - display_errors=Off is used in conjunction with error logging. - - - - - #[ is no longer interpreted as the start of a comment, - as this syntax is now used for attributes. - - - - - - Inheritance errors due to incompatible method signatures (LSP violations) will now always - generate a fatal error. Previously a warning was generated in some cases. - - - - - - The precedence of the concatenation operator has changed relative to bitshifts and addition as - well as subtraction. - - - + + + + Additionally, care should be taken that error messages are not displayed in production + environments, which can result in information leaks. Please ensure that + display_errors=Off is used in conjunction with error logging. + + + + + #[ is no longer interpreted as the start of a comment, + as this syntax is now used for attributes. + + + + + + Inheritance errors due to incompatible method signatures (LSP violations) will now always + generate a fatal error. Previously a warning was generated in some cases. + + + + + + The precedence of the concatenation operator has changed relative to bitshifts and addition as + well as subtraction. + + + ]]> - - - - - - - Arguments with a default value that resolves to &null; at runtime will no longer implicitly mark - the argument type as nullable. Either an explicit nullable type, or an explicit &null; default - value has to be used instead. - - - + + + + + + + Arguments with a default value that resolves to &null; at runtime will no longer implicitly mark + the argument type as nullable. Either an explicit nullable type, or an explicit &null; default + value has to be used instead. + + + ]]> - - - - - - A number of warnings have been converted into Error exceptions: - - - - - Attempting to write to a property of a non-object. Previously this - implicitly created an stdClass object for null, false and empty strings. - - - Attempting to append an element to an array for which the PHP_INT_MAX key - is already used. - - - Attempting to use an invalid type (array or object) as an array key or - string offset. - - Attempting to write to an array index of a scalar value. - Attempting to unpack a non-array/Traversable. - - Attempting to access unqualified constants which are undefined. - Previously, unqualified constant accesses resulted in a warning and were interpreted as strings. - - - - - A number of notices have been converted into warnings: - - - - Attempting to read an undefined variable. - Attempting to read an undefined property. - Attempting to read an undefined array key. - Attempting to read a property of a non-object. - Attempting to access an array index of a non-array. - Attempting to convert an array to string. - Attempting to use a resource as an array key. - Attempting to use null, a boolean, or a float as a string offset. - Attempting to read an out-of-bounds string offset. - Attempting to assign an empty string to a string offset. - - - - - - - Attempting to assign multiple bytes to a string offset will now emit a warning. - - - - - Unexpected characters in source files (such as NUL bytes outside of strings) will now result in a - ParseError exception instead of a compile warning. - - - - - Uncaught exceptions now go through "clean shutdown", which means that destructors will be called - after an uncaught exception. - - - - - The compile time fatal error "Only variables can be passed by reference" has been delayed until - runtime, and converted into an "Argument cannot be passed by reference" - Error exception. - - - - - Some "Only variables should be passed by reference" notices have been converted to "Argument - cannot be passed by reference" exception. - - - - - The generated name for anonymous classes has changed. It will now include the name of the first - parent or interface: - - - + + + + + + A number of warnings have been converted into Error exceptions: + + + + + Attempting to write to a property of a non-object. Previously this + implicitly created an stdClass object for null, false and empty strings. + + + Attempting to append an element to an array for which the PHP_INT_MAX key + is already used. + + + Attempting to use an invalid type (array or object) as an array key or + string offset. + + Attempting to write to an array index of a scalar value. + Attempting to unpack a non-array/Traversable. + + Attempting to access unqualified constants which are undefined. + Previously, unqualified constant accesses resulted in a warning and were interpreted as strings. + + + + + A number of notices have been converted into warnings: + + + + Attempting to read an undefined variable. + Attempting to read an undefined property. + Attempting to read an undefined array key. + Attempting to read a property of a non-object. + Attempting to access an array index of a non-array. + Attempting to convert an array to string. + Attempting to use a resource as an array key. + Attempting to use null, a boolean, or a float as a string offset. + Attempting to read an out-of-bounds string offset. + Attempting to assign an empty string to a string offset. + + + + + + + Attempting to assign multiple bytes to a string offset will now emit a warning. + + + + + Unexpected characters in source files (such as NUL bytes outside of strings) will now result in a + ParseError exception instead of a compile warning. + + + + + Uncaught exceptions now go through "clean shutdown", which means that destructors will be called + after an uncaught exception. + + + + + The compile time fatal error "Only variables can be passed by reference" has been delayed until + runtime, and converted into an "Argument cannot be passed by reference" + Error exception. + + + + + Some "Only variables should be passed by reference" notices have been converted to "Argument + cannot be passed by reference" exception. + + + + + The generated name for anonymous classes has changed. It will now include the name of the first + parent or interface: + + + class@anonymous ?> ]]> - - - - The name shown above is still followed by a NUL byte and a unique suffix. - - - - - Non-absolute trait method references in trait alias adaptations are now required to be - unambiguous: - - - + + + + The name shown above is still followed by a NUL byte and a unique suffix. + + + + + Non-absolute trait method references in trait alias adaptations are now required to be + unambiguous: + + + ]]> - - - - If both T1::func() and T2::func() exist, this code was previously - silently accepted, and func was assumed to refer to T1::func. Now it will generate a - fatal error instead, and either T1::func or T2::func needs to be - written explicitly. - - - - - The signature of abstract methods defined in traits is now checked against the implementing class - method: - - - + + + + If both T1::func() and T2::func() exist, this code was previously + silently accepted, and func was assumed to refer to T1::func. Now it will generate a + fatal error instead, and either T1::func or T2::func needs to be + written explicitly. + + + + + The signature of abstract methods defined in traits is now checked against the implementing class + method: + + + ]]> - - - - - - - Disabled functions are now treated exactly like non-existent functions. Calling a disabled - function will report it as unknown, and redefining a disabled function is now possible. - - - - - data:// stream wrappers are no longer writable, which matches the documented - behavior. - - - - - The arithmetic and bitwise operators +, -, - *, /, **, %, - <<, >>, &, - |, ^, ~, ++, - -- will now consistently throw a TypeError when one of - the operands is an &array;, &resource; or non-overloaded &object;. The only exception to this is - the array + array merge operation, which remains supported. - - - - - - Float to string casting will now always behave locale-independently. - - - + + + + + + + Disabled functions are now treated exactly like non-existent functions. Calling a disabled + function will report it as unknown, and redefining a disabled function is now possible. + + + + + data:// stream wrappers are no longer writable, which matches the documented + behavior. + + + + + The arithmetic and bitwise operators +, -, + *, /, **, %, + <<, >>, &, + |, ^, ~, ++, + -- will now consistently throw a TypeError when one of + the operands is an &array;, &resource; or non-overloaded &object;. The only exception to this is + the array + array merge operation, which remains supported. + + + + + + Float to string casting will now always behave locale-independently. + + + ]]> - - - - See printf, number_format and - NumberFormatter for ways to customize number formatting. - - - - - - Support for deprecated curly braces for offset access has been removed. - - - + + + + See printf, number_format and + NumberFormatter for ways to customize number formatting. + + + + + + Support for deprecated curly braces for offset access has been removed. + + + ]]> - - - - - - - Applying the final modifier on a private method will now produce a warning unless that method is - the constructor. - - - - - - If an object constructor exits, the object destructor will no longer be - called. This matches the behavior when the constructor throws. - - - - - Non-strict comparisons between numbers and non-numeric strings now work by casting the number to - string and comparing the strings. Comparisons between numbers and numeric strings continue to - work as before. Notably, this means that 0 == "not-a-number" is considered false - now. - - - - - Comparison - Before - After - - - - - 0 == "0" - &true; - &true; - - - 0 == "0.0" - &true; - &true; - - - 0 == "foo" - &true; - &false; - - - 0 == "" - &true; - &false; - - - 42 == " 42" - &true; - &true; - - - 42 == "42foo" - &true; - &false; - - - - - - - - - - Namespaced names can no longer contain whitespace: While Foo\Bar will be recognized - as a namespaced name, Foo \ Bar will not. Conversely, reserved keywords are now - permitted as namespace segments, which may also change the interpretation of code: - new\x is now the same as constant('new\x'), not - new \x(). - - - - - - Nested ternaries now require explicit parentheses. - - - - - - debug_backtrace and Exception::getTrace will no - longer provide references to arguments. It will not be possible to change function arguments - through the backtrace. - - - - - Numeric string handling has been altered to be more intuitive and less error-prone. Trailing - whitespace is now allowed in numeric strings for consistency with how leading whitespace is - treated. This mostly affects: - - - - The is_numeric function - String-to-string comparisons - Type declarations - Increment and decrement operations - - - - The concept of a "leading-numeric string" has been mostly dropped; the cases where this remains - exist in order to ease migration. Strings which emitted an E_NOTICE "A non - well-formed numeric value encountered" will now emit an E_WARNING "A - non-numeric value encountered" and all strings which emitted an E_WARNING "A - non-numeric value encountered" will now throw a - TypeError. This mostly affects: - - - - Arithmetic operations - Bitwise operations - - - - This E_WARNING to TypeError change also affects the - E_WARNING "Illegal string offset 'string'" for illegal string offsets. The - behavior of explicit casts to int/float from strings has not been changed. - - - - - - Magic Methods will now have their arguments and return types checked if they have them declared. - The signatures should match the following list: - - - - __call(string $name, array $arguments): mixed - __callStatic(string $name, array $arguments): mixed - __clone(): void - __debugInfo(): ?array - __get(string $name): mixed - __invoke(mixed $arguments): mixed - __isset(string $name): bool - __serialize(): array - __set(string $name, mixed $value): void - __set_state(array $properties): object - __sleep(): array - __unserialize(array $data): void - __unset(string $name): void - __wakeup(): void - - - - - - - call_user_func_array array keys will now be interpreted as parameter names, - instead of being silently ignored. - - - - - Declaring a function called assert() inside a namespace is - no longer allowed, and issues E_COMPILE_ERROR. - The assert function is subject to special handling by the engine, - which may lead to inconsistent behavior when defining a namespaced function with the same name. - - - + + + + + + + Applying the final modifier on a private method will now produce a warning unless that method is + the constructor. + + + + + + If an object constructor exits, the object destructor will no longer be + called. This matches the behavior when the constructor throws. + + + + + Namespaced names can no longer contain whitespace: While Foo\Bar will be recognized + as a namespaced name, Foo \ Bar will not. Conversely, reserved keywords are now + permitted as namespace segments, which may also change the interpretation of code: + new\x is now the same as constant('new\x'), not + new \x(). + + + + + + Nested ternaries now require explicit parentheses. + + + + + + debug_backtrace and Exception::getTrace will no + longer provide references to arguments. It will not be possible to change function arguments + through the backtrace. + + + + + Numeric string handling has been altered to be more intuitive and less error-prone. Trailing + whitespace is now allowed in numeric strings for consistency with how leading whitespace is + treated. This mostly affects: + + + + The is_numeric function + String-to-string comparisons + Type declarations + Increment and decrement operations + + + + The concept of a "leading-numeric string" has been mostly dropped; the cases where this remains + exist in order to ease migration. Strings which emitted an E_NOTICE "A non + well-formed numeric value encountered" will now emit an E_WARNING "A + non-numeric value encountered" and all strings which emitted an E_WARNING "A + non-numeric value encountered" will now throw a + TypeError. This mostly affects: + + + + Arithmetic operations + Bitwise operations + + + + This E_WARNING to TypeError change also affects the + E_WARNING "Illegal string offset 'string'" for illegal string offsets. The + behavior of explicit casts to int/float from strings has not been changed. + + + + + + Magic Methods will now have their arguments and return types checked if they have them declared. + The signatures should match the following list: + + + + __call(string $name, array $arguments): mixed + __callStatic(string $name, array $arguments): mixed + __clone(): void + __debugInfo(): ?array + __get(string $name): mixed + __invoke(mixed $arguments): mixed + __isset(string $name): bool + __serialize(): array + __set(string $name, mixed $value): void + __set_state(array $properties): object + __sleep(): array + __unserialize(array $data): void + __unset(string $name): void + __wakeup(): void + + + + + + + call_user_func_array array keys will now be interpreted as parameter names, + instead of being silently ignored. + + + + + Declaring a function called assert() inside a namespace is + no longer allowed, and issues E_COMPILE_ERROR. + The assert function is subject to special handling by the engine, + which may lead to inconsistent behavior when defining a namespaced function with the same name. + + + + diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index e7db8bc04977..0d73d1bebaef 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -7,32 +7,86 @@ PHP Core - - - - Support for union types has been added. - - - - - - - The WeakMap class has been added. - - - - - - The ValueError class has been added. - - - - - Any number of function parameters may now be replaced by a variadic argument, as long as the - types are compatible. For example, the following code is now allowed: - - - + + Named Arguments + + + + + + + + Attributes + + + Support for Attributes has been added. + + + + + + + + + Constructor Property Promotion + + + Support for constructor property promotion (declaring properties in the constructor signature) + has been added. + + + + + + Union Types + + + Support for union types has been added. + + + + + + Match Expression + + + Support for match expression has been added. + + + + + + Nullsafe Operator + + + Support for the nullsafe operator (?->) has been added. + + + + + + Other new Features + + + + + + The WeakMap class has been added. + + + + + + The ValueError class has been added. + + + + + Any number of function parameters may now be replaced by a variadic argument, as long as the + types are compatible. For example, the following code is now allowed: + + + ]]> - - - - - - static (as in "late static binding") can now be used as a return type: - - - + + + + + + static (as in "late static binding") can now be used as a return type: + + + ]]> - - - - - - - It is now possible to fetch the class name of an object using - $object::class. The result is the same as get_class($object). - - - - - - &new; and &instanceof; can now be used with arbitrary expressions, - using new (expression)(...$args) and $obj instanceof (expression). - - - - - - Some consistency fixes to variable syntax have been applied, for example writing - Foo::BAR::$baz is now allowed. - - - - - - Added Stringable interface, which is automatically implemented if - a class defines a __toString() method. - - - - - - Traits can now define abstract private methods. - Such methods must be implemented by the class using the trait. - - - - - - throw can now be used as an expression. - That allows usages like: - + + + + + + + It is now possible to fetch the class name of an object using + $object::class. The result is the same as get_class($object). + + + + + + &new; and &instanceof; can now be used with arbitrary expressions, + using new (expression)(...$args) and $obj instanceof (expression). + + + + + + Some consistency fixes to variable syntax have been applied, for example writing + Foo::BAR::$baz is now allowed. + + + + + + Added Stringable interface, which is automatically implemented if + a class defines a __toString() method. + + + + + + Traits can now define abstract private methods. + Such methods must be implemented by the class using the trait. + + + + + + throw can now be used as an expression. + That allows usages like: + throw new Exception('Exception in arrow function'); $user = $session->user ?? throw new Exception('Must have user'); ]]> - - - - - - - An optional trailing comma is now allowed in parameter lists. - + + + + + + + An optional trailing comma is now allowed in parameter lists. + - - - - - - - It is now possible to write catch (Exception) to catch an exception without storing - it in a variable. - - - - - - Support for mixed type has been added. - - - - - - Support for Attributes has been added. - - - - - - - - - Support for constructor property promotion (declaring properties in the constructor signature) - has been added. - - - - - - Support for match expression has been added. - - - - - - Private methods declared on a parent class no longer enforce any inheritance rules on the methods - of a child class (with the exception of final private constructors). - The following example illustrates which restrictions have been removed: - + + + + + + + It is now possible to write catch (Exception) to catch an exception without storing + it in a variable. + + + + + + Support for mixed type has been added. + + + + + + Private methods declared on a parent class no longer enforce any inheritance rules on the methods + of a child class (with the exception of final private constructors). + The following example illustrates which restrictions have been removed: + ]]> - - - - - - - Support for the nullsafe operator (?->) has been added. - - - - - - Support for named arguments has been added. - - - - - - get_resource_id has been added, which returns the same value as - (int) $resource. It provides the same functionality under a clearer API. - - - + + + + + + + get_resource_id has been added, which returns the same value as + (int) $resource. It provides the same functionality under a clearer API. + + + + From 4619753f91bd176cb3a1ba750327cff38bf6d509 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 22 Nov 2020 16:37:55 +0100 Subject: [PATCH 23/24] Integrate Windows specific changes into incompatible section --- appendices/migration80.xml | 1 - appendices/migration80/incompatible.xml | 21 +++++++++ appendices/migration80/windows-support.xml | 53 ---------------------- 3 files changed, 21 insertions(+), 54 deletions(-) delete mode 100644 appendices/migration80/windows-support.xml diff --git a/appendices/migration80.xml b/appendices/migration80.xml index 170416640fc7..7718e97fb60e 100644 --- a/appendices/migration80.xml +++ b/appendices/migration80.xml @@ -8,7 +8,6 @@ &appendices.migration80.incompatible; &appendices.migration80.deprecated; &appendices.migration80.other-changes; - &appendices.migration80.windows-support; diff --git a/appendices/migration80/incompatible.xml b/appendices/migration80/incompatible.xml index c4284391ed92..2f1dcda03531 100644 --- a/appendices/migration80/incompatible.xml +++ b/appendices/migration80/incompatible.xml @@ -870,6 +870,11 @@ $array["key"]; accepts -1. IMG_CROP_DEFAULT should be used instead. + + + On Windows, php_gd2.dll has been renamed to php_gd.dll. + + @@ -1518,6 +1523,14 @@ echo file_get_contents('http://example.org', false, $ctx); boundary. Previously, &false; was returned instead of the empty string in some cases. + + + On Windows, the program execution functions (proc_open, exec, + popen etc.) using the shell, now consistently execute %comspec% /s + /c "$commandline", which has the same effect as executing + $commandline (without additional quotes). + + @@ -1624,6 +1637,14 @@ echo file_get_contents('http://example.org', false, $ctx); + + Windows PHP Test Packs + + + The test runner has been renamed from run-test.php to + run-tests.php, to match its name in php-src. + + - - - Windows Support - - - Standard Library - - The program execution functions (proc_open, exec, - popen etc.) using the shell, now consistently execute %comspec% /s - /c "$commandline", which has the same effect as executing - $commandline (without additional quotes). - - - - - GD - - php_gd2.dll has been renamed to php_gd.dll. - - - - - PHP Test Packs - - The test runner has been renamed from run-test.php to - run-tests.php, to match its name in php-src. - - - - - - From 57c0beda1c15c6cd9850b77be94c3d113c240a57 Mon Sep 17 00:00:00 2001 From: "Christoph M. Becker" Date: Sun, 22 Nov 2020 19:07:22 +0100 Subject: [PATCH 24/24] Link to match expression section --- appendices/migration80/new-features.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index 0d73d1bebaef..19ee314829b4 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -50,7 +50,7 @@ Match Expression - Support for match expression has been added. + Support for match expressions has been added.