Object properties may now have additional logic associated with their
get and set operations.
Depending on the usage, that may or may not make the property virtual,
that is, it has no backing value at all.
<?php
class Person
{
// A "virtual" property. It may not be set explicitly.
public string $fullName {
get => $this->firstName . ' ' . $this->lastName;
}
// All write operations go through this hook, and the result is what is written.
// Read access happens normally.
public string $firstName {
set => ucfirst(strtolower($value));
}
// All write operations go through this hook, which has to write to the backing value itself.
// Read access happens normally.
public string $lastName {
set {
if (strlen($value) < 2) {
throw new \InvalidArgumentException('Too short');
}
$this->lastName = $value;
}
}
}
$p = new Person();
$p->firstName = 'peter';
print $p->firstName; // Prints "Peter"
$p->lastName = 'Peterson';
print $p->fullName; // Prints "Peter Peterson"
Object properties may now have their set visibility
controlled separately from the get visibility.
<?php
class Example
{
// The first visibility modifier controls the get-visibility, and the second modifier
// controls the set-visibility. The get-visibility must not be narrower than set-visibility.
public protected(set) string $name;
public function __construct(string $name)
{
$this->name = $name;
}
}It is now possible to create objects whose initialization is deferred until they are accessed. Libraries and frameworks can leverage these lazy objects to defer fetching data or dependencies required for initialization.
<?php
class Example
{
public function __construct(private int $data)
{
}
// ...
}
$initializer = static function (Example $ghost): void {
// Fetch data or dependencies
$data = ...;
// Initialize
$ghost->__construct($data);
};
$reflector = new ReflectionClass(Example::class);
$object = $reflector->newLazyGhost($initializer);#[\Deprecated] attribute
The new Deprecated attribute can be used to mark functions, methods,
and class constants as deprecated. The behavior of functionality deprecated with this
attribute matches the behavior of the existing deprecation mechanism for functionality
provided by PHP itself. The only exception is that the emitted error code is
E_USER_DEPRECATED instead of E_DEPRECATED.
Existing deprecations in functionality provided by PHP itself have been updated to use the attribute, improving the emitted error messages by including a short explanation.
Added request_parse_body() function that allows parsing RFC1867 (multipart) requests in non-POST HTTP requests.
new expressions without parenthesesNew expressions with constructor arguments are now dereferencable, meaning they allow chaining method calls, property accesses, etc. without enclosing the expression in parentheses.
Getting the debug info for WeakReference will now
also output the object it references, or null if the reference is no
longer valid.
The output of Closure::__debugInfo() now includes the name, file, and line of the Closure.
Exiting a namespace now clears seen symbols. This allows using a symbol in a namespace block, even if a previous namespace block declared a symbol with the same name.
curl_version() returns an additional
feature_list value, which is an associative array
of all known cURL features, and whether they are supported (true)
or not (false).
Added CURL_HTTP_VERSION_3 and
CURL_HTTP_VERSION_3ONLY constants (available
since libcurl 7.66 and 7.88) as available options for
CURLOPT_HTTP_VERSION.
Added CURLOPT_PREREQFUNCTION as a cURL option that
accepts a callable to be called after the connection is made,
but before the request is sent.
This callable must return either CURL_PREREQFUNC_OK or
CURL_PREREQFUNC_ABORT to allow or abort the request.
Added CURLOPT_SERVER_RESPONSE_TIMEOUT,
which was formerly known as CURLOPT_FTP_RESPONSE_TIMEOUT.
Both constants hold the same value.
Added CURLOPT_DEBUGFUNCTION as a cURL option that
accepts a callable that gets called during the request lifetime
with the CurlHandle object,
an integer containing the debug message type, and a string containing the
debug message.
The debug message type is one of the following constants:
CURLINFO_TEXTCURLINFO_HEADER_INCURLINFO_HEADER_OUTCURLINFO_DATA_INCURLINFO_DATA_OUTCURLINFO_SSL_DATA_INCURLINFO_SSL_DATA_OUTCURLINFO_HEADER_OUT
must not be set because it uses the same libcurl functionality.
The curl_getinfo() now returns an additional
posttransfer_time_us key, containing the number of
microseconds from the start until the last byte is sent.
When a redirect is followed, the time from each request is added together.
This value can also be retrieved by passing
CURLINFO_POSTTRANSFER_TIME_T to the
curl_getinfo() option parameter.
This requires libcurl 8.10.0 or later.
Added the Dom namespace with new classes as counterparts to the existing DOM classes (e.g. Dom\Node is the new DOMNode). These classes are compatible with HTML 5 and are WHATWG spec-compliant; solving long-standing bugs in the DOM extension. The old DOM classes remain available for backwards compatibility.
Added the DOMNode::compareDocumentPosition() with its associated constants:
DOMNode::DOCUMENT_POSITION_DISCONNECTEDDOMNode::DOCUMENT_POSITION_PRECEDINGDOMNode::DOCUMENT_POSITION_FOLLOWINGDOMNode::DOCUMENT_POSITION_CONTAINSDOMNode::DOCUMENT_POSITION_CONTAINED_BYDOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
It is now possible to pass any callable to
DOMXPath::registerPhpFunctions().
Furthermore, with DOMXPath::registerPhpFunctionNs(),
callbacks can now be registered that will use native function call syntax
rather than using php:function('name').
Flushing headers without a body will now succeed.
Status page has a new field to display a memory peak.
Added the NumberFormatter::ROUND_HALFODD to
complement the existing NumberFormatter::ROUND_HALFEVEN
functionality.
Added support for Curve25519 + Curve448 based keys. Specifically x25519, ed25519, x448 and ed448 fields are supported in openssl_pkey_new(), openssl_pkey_get_details(), openssl_sign(), and openssl_verify() were extended to support those keys.
Implement PASSWORD_ARGON2 password hashing. Requires OpenSSL 3.2 and NTS build.
The bundled pcre2lib has been updated to version 10.44. As a consequence, LoongArch JIT support has been added, spaces are now allowed between braces in Perl-compatible items, and variable-length lookbehind assertions are now supported.
With pcre2lib version 10.44, the maximum length of named capture groups
has changed from 32 to 128.
Added support for the r (PCRE2_EXTRA_CASELESS_RESTRICT)
modifier, as well as the (?r) mode modifier.
When enabled along with the case-insensitive modifier (i),
the expression locks out mixing of ASCII and non-ASCII characters.
Added support for driver-specific subclasses. This RFC adds subclasses for PDO in order to better support database-specific functionalities. The new classes are instantiatable either via calling the PDO::connect() method or by instantiating an instance of the driver-specific subclass directly.
Added support for driver specific SQL parsers. The default parser supports:
Added a custom parser supporting:
Added a custom parser supporting:
E'string')
?? as escape sequence for the
? operator
Added a custom parser supporting:
Added support for the Unix timestamp extension for Zip archives.
Added ability to change the .php_history path through
the PHP_HISTFILE environment variable.
ReflectionAttribute now contains a name property to improve the debugging experience.
ReflectionClassConstant::__toString() and ReflectionProperty::__toString() now returns the attached doc comments.
Multiple new methods and constants which are related to the lazy objects feature have been added:
ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE
ReflectionClass::SKIP_DESTRUCTOR
Added support for clark notation for namespaces in class map.
It is now possible to specify entries in a class map with clark notation
to resolve a type with a specific namespace to a specific class.
For example: '{http://example.com}foo' => 'FooClass'.
Instances of DateTimeInterface that are
passed to xsd:datetime or similar elements are now
serialized as such instead of being serialized as an empty string.
Session persistence now works with a shared session module.
Added a new RoundingMode enum with clearer naming
and improved discoverability compared to the
PHP_ROUND_* constants.
Moreover, four new rounding modes were added which are only available via
the new RoundingMode enum.
It is now possible to use parameters that contain both single and double quotes.
It is now possible to pass any callable to XSLTProcessor::registerPhpFunctions().
Added XSLTProcessor::$maxTemplateDepth and XSLTProcessor::$maxTemplateVars to control the recursion depth of XSL template evaluation.
Added the ZipArchive::ER_TRUNCATED_ZIP
constant, which was added in libzip 1.11.