diff --git a/UPGRADING b/UPGRADING index e2656f3c27a75..1050f746f0998 100644 --- a/UPGRADING +++ b/UPGRADING @@ -72,8 +72,8 @@ PHP 7.4 UPGRADE NOTES - Openssl: . The openssl_random_pseudo_bytes() function will now throw an exception in error situations, similar to random_bytes(). In particular, an Error is - thrown if the number of requested bytes is smaller *or equal* than zero, - and an Exception is thrown is sufficient randomness cannot be gathered. + thrown if the number of requested bytes is less than *or equal to* zero, + and an Exception is thrown if sufficient randomness cannot be gathered. The $crypto_strong output argument is guaranteed to always be true if the function does not throw, so explicitly checking it is not necessary. RFC: http://php.net/manual/de/function.openssl-random-pseudo-bytes.php @@ -161,7 +161,7 @@ PHP 7.4 UPGRADE NOTES public string $name; } - This will enforce that $user->id can only be assigned integer and + This will enforce that $user->id can only be assigned integers and $user->name can only be assigned strings. For more information see the RFC: https://wiki.php.net/rfc/typed_properties_v2 @@ -246,7 +246,7 @@ PHP 7.4 UPGRADE NOTES imagefilter($im, IMG_FILTER_SCATTER, int $sub, int $plus, array $colors = []); - The $colors array can be populated with a set of indexed colors where to + The $colors array can be populated with a set of indexed colors to apply the scatter pixel shifting on. Note, the result of this filter is always random. @@ -256,7 +256,7 @@ PHP 7.4 UPGRADE NOTES used by storage systems, such as iSCSI, SCTP, Btrfs and ext4. - Mbstring: - . Added mb_str_split() function, which provide the same functionality as + . Added mb_str_split() function, which provides the same functionality as str_split(), but operating on code points rather than bytes. RFC: https://wiki.php.net/rfc/mb_str_split @@ -282,8 +282,8 @@ PHP 7.4 UPGRADE NOTES . PDOStatement::getColumnMeta() is now available - PDO_SQLite: - . PDOStatement::getAttribute(PDO::SQLITE_ATTR_READONLY_STATEMENT) allows to - check whether this statement is read-only, i.e. whether it doesn't modify + . PDOStatement::getAttribute(PDO::SQLITE_ATTR_READONLY_STATEMENT) allows + checking whether the statement is read-only, i.e. if it doesn't modify the database. . PDO::setAttribute(PDO::SQLITE_ATTR_EXTENDED_RESULT_CODES, true) enables the use of SQLite3 extended result codes in errorInfo(). @@ -362,7 +362,7 @@ PHP 7.4 UPGRADE NOTES so is equivalent to calling a non-static method statically, which has been deprecated since PHP 7.0. . Unbinding $this of a non-static closure is deprecated. - . Using "parent" inside a class without parent is deprecated, and will throw + . Using "parent" inside a class without a parent is deprecated, and will throw a compile-time error in the future. Currently an error will only be generated if/when the parent is accessed at run-time. . The allow_url_include ini directive is deprecated. Enabling it will generate @@ -373,7 +373,7 @@ PHP 7.4 UPGRADE NOTES deprecated. - Filter: - . FILTER_SANITIZE_MAGIC_QUOTES is deprecated, use FILTER_SANITIZER_ADD_SLASHES + . FILTER_SANITIZE_MAGIC_QUOTES is deprecated, use FILTER_SANITIZE_ADD_SLASHES instead. - Mbstring: @@ -418,7 +418,7 @@ PHP 7.4 UPGRADE NOTES . The money_format() function is deprecated. It can be replaced by the intl NumberFormatter functionality. . The ezmlm_hash() function is deprecated. - . The restore_include_path() function is deprecated. It can be replace by + . The restore_include_path() function is deprecated. It can be replaced by ini_restore('include_path'). . Passing parameters to implode() in reverse order is deprecated, use implode($glue, $parts) instead of implode($parts, $glue). @@ -455,7 +455,7 @@ PHP 7.4 UPGRADE NOTES ArrayObject. - GD: - . Added imagecreatefromtga() function, which allows to read images in TGA + . Added imagecreatefromtga() function, which allows reading images in TGA format. TGA support is now also indicated by gd_info() and imagetypes(). Note that TGA images are not recognized by imagecreatefromstring() and getimagesize(). @@ -467,22 +467,22 @@ PHP 7.4 UPGRADE NOTES See . - Pcntl: - . Added bool pcntl_unshare(int flags) function which allows to dissociate + . Added bool pcntl_unshare(int flags) function which allows dissociating parts of the process execution context which are currently being shared with other processes. Explicitly, it allows you to unshare the mount, IPC, UTS, network, PID, user and cgroup namespaces. - SQLite3: - . Added SQLite3Stmt::getSQL() to retrieve the SQL of the statement. If TRUE is - passed as parameter, query parameters will be replaced in the return value - by their currently bound value, if libsqlite ≥ 3.14 is used. + . Added SQLite3Stmt::getSQL() to retrieve the SQL of the statement. If true is + passed as $expanded argument, query parameters will be replaced in the return + value by their currently bound value, if libsqlite ≥ 3.14 is used. . Added SQLite3::backup() to create database backups via the SQLite3 online backup API. - Standard . bool sapi_windows_set_ctrl_handler(callable handler, [, bool add = true]) - set or remove a handler function upon receiving a CTRL event. The handler - function is expected have a signature "function handler(int $event)". + function is expected to have this signature: "function handler(int $event)". . bool sapi_windows_generate_ctrl_event(int type, int pid) - send a CTRL event to another process. . array password_algos() - return a complete list of all registered password @@ -557,7 +557,7 @@ PHP 7.4 UPGRADE NOTES - PDO: . It is now possibile to escape question marks in SQL queries to avoid them - being interpreted as parameter placeholders. Writing "??" allows to send + being interpreted as parameter placeholders. Writing "??" allows sending a single question mark to the database and e.g. use the PostgreSQL JSON key exists "?" operator. For more details see the RFC: https://wiki.php.net/rfc/pdo_escape_placeholders @@ -573,7 +573,7 @@ PHP 7.4 UPGRADE NOTES . SimpleXMLElement now implements Countable. - SQLite3: - . The bundled libsqlite has been removed. To build the SQLite3 extension + . The bundled libsqlite has been removed. To build the SQLite3 extension a system libsqlite3 ≥ 3.7.4 is now required. To build the PDO_SQLite extension a system libsqlite3 ≥ 3.5.0 is now required. . (Un)serialization of SQLite3, SQLite3Stmt and SQLite3Result is now @@ -652,9 +652,9 @@ PHP 7.4 UPGRADE NOTES - An inode number is delivered and is based on the NTFS file index. - The device number is now based on the volume serial number. - Note, that both values derived from the system and provided as is on 64-bit - systems. On 32-bit system, these values might overflow the 32-bit integer in - PHP, so they're a fake. + Note that both values are derived from the system and provided as is on 64-bit + systems. On 32-bit systems, these values might overflow the 32-bit integer in + PHP, so they're fake. - CTRL+C and CTRL+BREAK on console can be caught by setting a handler function with sapi_windows_set_ctrl_handler(). @@ -725,7 +725,7 @@ The following extensions and SAPIs are affected: - ODBC: . --with-iodbc no longer accepts a directory. - . --with-unixODBC without directory now use pkg-config (preferred). + . --with-unixODBC without a directory now uses pkg-config (preferred). Directory is still accepted for old versions without libodbc.pc. - OpenSSL: