Php/docs/migration80.deprecated
Deprecated Features
PHP Core
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:
<?phpfunction test($a = [], $b) {} // Beforefunction test($a, $b) {} // After?>
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:<?phpfunction test(A $a = null, $b) {} // Still allowedfunction test(?A $a, $b) {} // Recommended?>
Calling get_defined_functions() with
exclude_disabled
explicitly set toFALSE
is deprecated and no longer has an effect. 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
andENCHANT_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
now has the same value asPG_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()
Standard Library
Sort comparison functions that return
TRUE
orFALSE
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.<?php// Replaceusort($array, fn($a, $b) => $a > $b);// Withusort($array, fn($a, $b) => $a <=> $b);?>
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. Iteration over all entries can be accomplished using ZipArchive::statIndex() and a for loop:
<?php// iterate using the procedural APIassert(is_resource($zip));while ($entry = zip_read($zip)) { echo zip_entry_name($entry);}// iterate using the object-oriented APIassert($zip instanceof ZipArchive);for ($i = 0; $entry = $zip->statIndex($i); $i++) { echo $entry['name'];}?>
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.