Access to the $GLOBALS array is now subject to a number of restrictions. Read and write access to individual array elements like $GLOBALS['var']
continues to work as-is. Read-only access to the entire $GLOBALS array also continues to be supported. However, write access to the entire $GLOBALS array is no longer supported. For example, array_pop($GLOBALS)
will result in an error.
When a method using static variables is inherited (but not overridden), the inherited method will now share static variables with the parent method.
<?php
class A {
public static function counter() {
static $counter = 0;
$counter++;
return $counter;
}
}
class B extends A {}
var_dump(A::counter()); // int(1)
var_dump(A::counter()); // int(2)
var_dump(B::counter()); // int(3), previously int(1)
var_dump(B::counter()); // int(4), previously int(2)
?>
An optional parameter specified before required parameters is now always treated as required, even when called using named arguments. As of PHP 8.0.0, but prior to PHP 8.1.0, the below emits a deprecation notice on the definition, but runs successfully when called. As of PHP 8.1.0, an error of class ArgumentCountError is thrown, as it would be when called with positional arguments.
<?php
function makeyogurt($container = "bowl", $flavour)
{
return "Making a $container of $flavour yogurt.\n";
}
try
{
echo makeyogurt(flavour: "raspberry");
}
catch (Error $e)
{
echo get_class($e), ' - ', $e->getMessage(), "\n";
}
?>
Output of the above example in PHP 8.0:
Deprecated: Required parameter $flavour follows optional parameter $container in example.php on line 3 Making a bowl of raspberry yogurt.
Output of the above example in PHP 8.1:
Deprecated: Optional parameter $container declared before required parameter $flavour is implicitly treated as a required parameter in example.php on line 3 ArgumentCountError - makeyogurt(): Argument #1 ($container) not passed
Note that a default value of null
can be used before required parameters to specify a nullable type, but the parameter will still be required.
Most non-final internal methods now require overriding methods to declare a compatible return type, otherwise a deprecated notice is emitted during inheritance validation. In case the return type cannot be declared for an overriding method due to PHP cross-version compatibility concerns, a ReturnTypeWillChange attribute can be added to silence the deprecation notice.
readonly
is a keyword now. However, it still may be used as function name.
never
is now a reserved word, so it cannot be used to name a class, interface or trait, and is also prohibited from being used in namespaces.
Several resources have been migrated to objects. Return value checks using is_resource() should be replaced with checks for false
.
The FileInfo functions now accept and return finfo objects instead of fileinfo
resources.
The FTP functions now accept and return FTP\Connection objects instead of ftp
resources.
The IMAP functions now accept and return IMAP\Connection objects instead of imap
resources.
The LDAP functions now accept and return LDAP\Connection objects instead of ldap link
resources.
The LDAP functions now accept and return LDAP\Result objects instead of ldap result
resources.
The LDAP functions now accept and return LDAP\ResultEntry objects instead of ldap result entry
resources.
The PgSQL functions now accept and return PgSql\Connection objects instead of pgsql link
resources.
The PgSQL functions now accept and return PgSql\Result objects instead of pgsql result
resources.
The PgSQL functions now accept and return PgSql\Lob objects instead of pgsql large object
resources.
The PSpell functions now accept and return PSpell\Dictionary objects instead of pspell
resources.
The PSpell functions now accept and return PSpell\Config objects instead of pspell config
resources.
mysqli_fetch_fields(), and mysqli_fetch_field_direct() will now always return 0
for the max_length. This information can be computed by iterating over the result set, and taking the maximum length. This is what PHP was doing internally previously.
The MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH
option no longer has any effect.
The MYSQLI_STORE_RESULT_COPY_DATA
option no longer has any effect. Passing any value to the mode
parameter of mysqli::store_result() no longer has any effect.
mysqli::connect() now returns true
instead of null
on success.
The default error handling mode has been changed from "silent" to "exceptions" See the MySQLi reporting mode page for more details on what this entails, and how to explicitly set this attribute. To restore the previous behaviour use: mysqli_report(MYSQLI_REPORT_OFF);
Classes extending mysqli_stmt::execute() are now required to specify the additional optional parameter.
The mysqlnd.fetch_data_copy INI directive has been removed. This should not result in user-visible behavior changes.
EC private keys will now be exported in PKCS#8 format rather than traditional format, just like all other keys.
openssl_pkcs7_encrypt() and openssl_cms_encrypt() will now to default using AES-128-CBC rather than RC2-40. The RC2-40 cipher is considered insecure and not enabled by default by OpenSSL 3.
PDO::ATTR_STRINGIFY_FETCHES
now stringifies values of type bool to "0"
or "1"
. Previously bools were not stringified.
Calling PDOStatement::bindColumn() with PDO::PARAM_LOB
will now constantly bind a stream result when PDO::ATTR_STRINGIFY_FETCHES
is not enabled. Previously, the result would either be a stream or a string depending on the used database driver and the time the binding is performed.
Integers and floats in result sets will now be returned using native PHP types instead of strings when using emulated prepared statements. This matches the behavior of native prepared statements. The previous behaviour can be restored by enabling the PDO::ATTR_STRINGIFY_FETCHES
option.
Integers and floats in results sets will now be returned using native PHP types. The previous behaviour can be restored by enabling the PDO::ATTR_STRINGIFY_FETCHES
option.
To comply with the ArrayAccess interface, Phar::offsetUnset() and PharData::offsetUnset() no longer return a bool.
version_compare() no longer accepts undocumented operator abbreviations.
htmlspecialchars(), htmlentities(), htmlspecialchars_decode(), html_entity_decode(), and get_html_translation_table() now use ENT_QUOTES | ENT_SUBSTITUTE
rather than ENT_COMPAT
by default. This means that '
is escaped to '
while previously nothing was done. Additionally, malformed UTF-8 will be replaced by a Unicode substitution character, instead of resulting in an empty string.
debug_zval_dump() now prints the refcount of a reference wrappers with their refcount, instead of only prepending &
to the value. This more accurately models reference representation since PHP 7.0.
debug_zval_dump() now prints interned
instead of a dummy refcount for interned strings and immutable arrays.
SplFixedArray, will now be JSON encoded like an array