Skip to content

Fix typos in UPGRADING and improve wording in a few places #4478

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 22 additions & 22 deletions UPGRADING
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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.
Expand All @@ -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

Expand All @@ -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().
Expand Down Expand Up @@ -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
Expand All @@ -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:
Expand Down Expand Up @@ -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).
Expand Down Expand Up @@ -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().
Expand All @@ -467,22 +467,22 @@ PHP 7.4 UPGRADE NOTES
See <https://github.com/php/php-src/pull/3624>.

- 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
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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().
Expand Down Expand Up @@ -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:
Expand Down