The ReturnTypeWillChange attribute
(PHP 8 >= 8.1.0)
Introduction
As of PHP 8.1.0, a tentative phase of transitioning to return type declarations for internal class methods began.
Most non-final internal methods now require overriding methods to declare a compatible return type. Otherwise, a deprecation notice is emitted during inheritance validation warning that the signature violates covariance rules.
In a future PHP version, method signature checking will become strict, and mismatches will cause a fatal error.
In case the return type cannot be declared for an overriding method due to
PHP cross-version compatibility concerns, or the overriding method declares
an incompatible return type, a #[\ReturnTypeWillChange] attribute
can be added to silence the deprecation notice.
When overriding methods defined in user-defined classes, return types are checked strictly. A fatal error is emitted on mismatch, even if the overriding method is marked with the attribute.
The ReturnTypeWillChange attribute suppresses deprecation warnings only during the tentative return type phase. After strict type checking is enforced, the attribute will stop working and a mismatch in the overriding method signature of an internal class will cause a fatal error.
Class synopsis
See Also
Table of Contents
- ReturnTypeWillChange::__construct — Construct a new ReturnTypeWillChange attribute instance
User Contributed Notes
-
0
pcntl_sigtimedwaitWaits for signals, with a timeout
-
0
similar_textCalculate the similarity between two strings
-
0
boolvalGet the boolean value of a variable
-
0
curl_multi_closeClose a set of cURL handles
-
0
imap_bodyRead the message body
-
0
mb_strposFind position of first occurrence of string in a string
-
0
pg_send_prepareSends a request to create a prepared statement with the given parameters, without waiting for completion
-
0
swoole_native_socket_bind
-
0
Arr::prependKeysWith
-
0
zend_versionGets the version of the current Zend engine