Released!
PHP 8.4 is a major update of the PHP language.
It contains many new features, such as property hooks, asymmetric visibility, an updated DOM API, performance improvements, bug fixes, and general cleanup.
It contains many new features, such as property hooks, asymmetric visibility, an updated DOM API, performance improvements, bug fixes, and general cleanup.
Property hooksRFCDoc
PHP < 8.4
classLocale{ privatestring$languageCode; privatestring$countryCode; public function__construct(string$languageCode,string$countryCode) {$this->setLanguageCode($languageCode);$this->setCountryCode($countryCode); } public functiongetLanguageCode():string{ return$this->languageCode; } public functionsetLanguageCode(string$languageCode):void{$this->languageCode=$languageCode; } public functiongetCountryCode():string{ return$this->countryCode; } public functionsetCountryCode(string$countryCode):void{$this->countryCode=strtoupper($countryCode); } public functionsetCombinedCode(string$combinedCode):void{ [$languageCode,$countryCode] =explode('_',$combinedCode,2);$this->setLanguageCode($languageCode);$this->setCountryCode($countryCode); } public functiongetCombinedCode():string{ return\sprintf("%s_%s",$this->languageCode,$this->countryCode); }}$brazilianPortuguese= newLocale('pt','br');var_dump($brazilianPortuguese->getCountryCode());// BRvar_dump($brazilianPortuguese->getCombinedCode());// pt_BRPHP 8.4
classLocale{ publicstring$languageCode; publicstring$countryCode{set(string$countryCode) {$this->countryCode=strtoupper($countryCode); } } publicstring$combinedCode{get=>\sprintf("%s_%s",$this->languageCode,$this->countryCode);set(string$value) { [$this->languageCode,$this->countryCode] =explode('_',$value,2); } } public function__construct(string$languageCode,string$countryCode) {$this->languageCode=$languageCode;$this->countryCode=$countryCode; }}$brazilianPortuguese= newLocale('pt','br');var_dump($brazilianPortuguese->countryCode);// BRvar_dump($brazilianPortuguese->combinedCode);// pt_BR Property hooks provide support for computed properties that can natively be understood by IDEs and static analysis tools, without needing to write docblock comments that might go out of sync. Furthermore, they allow reliable pre- or post-processing of values, without needing to check whether a matching getter or setter exists in the class.
Asymmetric VisibilityRFCDoc
PHP < 8.4
classPhpVersion{ privatestring$version='8.3'; public functiongetVersion():string{ return$this->version; } public functionincrement():void{ [$major,$minor] =explode('.',$this->version);$minor++;$this->version="{$major}.{$minor}"; }}PHP 8.4
classPhpVersion{ public private(set)string$version='8.4'; public functionincrement():void{ [$major,$minor] =explode('.',$this->version);$minor++;$this->version="{$major}.{$minor}"; }} The scope to write to a property may now be controlled independently from the scope to read the property, reducing the need for boilerplate getter methods to expose a property’s value without allowing modification from the outside of a class.
#[\Deprecated] AttributeRFCDoc
PHP < 8.4
classPhpVersion{/** * @deprecated 8.3 use PhpVersion::getVersion() instead */public functiongetPhpVersion():string{ return$this->getVersion(); } public functiongetVersion():string{ return'8.3'; }}$phpVersion= newPhpVersion();// No indication that the method is deprecated.echo$phpVersion->getPhpVersion();PHP 8.4
classPhpVersion{ #[\Deprecated(message:"use PhpVersion::getVersion() instead",since:"8.4", )] public functiongetPhpVersion():string{ return$this->getVersion(); } public functiongetVersion():string{ return'8.4'; }}$phpVersion= newPhpVersion();// Deprecated: Method PhpVersion::getPhpVersion() is deprecated since 8.4, use PhpVersion::getVersion() insteadecho$phpVersion->getPhpVersion(); The new
#[\Deprecated] attribute makes PHP’s existing deprecation mechanism available to user-defined functions, methods, and class constants.New ext-dom features and HTML5 supportRFCRFCDoc
PHP < 8.4
$dom= newDOMDocument();$dom->loadHTML( <<<'HTML' <main> <article>PHP 8.4 is a feature-rich release!</article> <article>PHP 8.4 adds new DOM classes that are spec-compliant, keeping the old ones for compatibility.</article> </main> HTML,LIBXML_NOERROR,);$xpath= newDOMXPath($dom);$node=$xpath->query(".//main/article[not(following-sibling::*)]")[0];$classes=explode(" ",$node->className);// Simplifiedvar_dump(in_array("featured",$classes));// bool(true)PHP 8.4
$dom=Dom\HTMLDocument::createFromString( <<<'HTML' <main> <article>PHP 8.4 is a feature-rich release!</article> <article>PHP 8.4 adds new DOM classes that are spec-compliant, keeping the old ones for compatibility.</article> </main> HTML,LIBXML_NOERROR,);$node=$dom->querySelector('main > article:last-child');var_dump($node->classList->contains("featured"));// bool(true)New DOM API that includes standards-compliant support for parsing HTML5 documents, fixes several long-standing compliance bugs in the behavior of the DOM functionality, and adds several functions to make working with documents more convenient.
The new DOM API is available within theDom namespace. Documents using the new DOM API can be created using theDom\HTMLDocument andDom\XMLDocument classes.
Object API for BCMathRFC
PHP < 8.4
$num1='0.12345';$num2='2';$result=bcadd($num1,$num2,5);echo$result;// '2.12345'var_dump(bccomp($num1,$num2) >0);// falsePHP 8.4
useBcMath\Number;$num1= newNumber('0.12345');$num2= newNumber('2');$result=$num1+$num2;echo$result;// '2.12345'var_dump($num1>$num2);// falseNewBcMath\Number object enables object-oriented usage and standard mathematical operators when working with arbitrary precision numbers.
These objects are immutable and implement theStringable interface, so they can be used in string contexts likeecho $num.
Newarray_*() functionsRFC
PHP < 8.4
$animal=null;foreach (['dog','cat','cow','duck','goose'] as$value) { if (str_starts_with($value,'c')) {$animal=$value; break; }}var_dump($animal);// string(3) "cat"PHP 8.4
$animal=array_find( ['dog','cat','cow','duck','goose'], static fn(string$value):bool=>str_starts_with($value,'c'),);var_dump($animal);// string(3) "cat"PDO driver specific subclassesRFC
PHP < 8.4
$connection= newPDO('sqlite:foo.db',$username,$password,);// object(PDO)$connection->sqliteCreateFunction('prepend_php', static fn($string) =>"PHP{$string}",);$connection->query('SELECT prepend_php(version) FROM php');PHP 8.4
$connection=PDO::connect('sqlite:foo.db',$username,$password,);// object(Pdo\Sqlite)$connection->createFunction('prepend_php', static fn($string) =>"PHP{$string}",);// Does not exist on a mismatching driver.$connection->query('SELECT prepend_php(version) FROM php'); New subclasses
Pdo\Dblib,Pdo\Firebird,Pdo\MySql,Pdo\Odbc,Pdo\Pgsql, andPdo\Sqlite ofPDO are available.new MyClass()->method() without parenthesesRFCDoc
PHP < 8.4
classPhpVersion{ public functiongetVersion():string{ return'PHP 8.3'; }}var_dump((newPhpVersion())->getVersion());PHP 8.4
classPhpVersion{ public functiongetVersion():string{ return'PHP 8.4'; }}var_dump(newPhpVersion()->getVersion()); Properties and methods of a newly instantiated object can now be accessed without wrapping the
new expression in parentheses.New Classes, Interfaces, and Functions
- NewLazy Objects.
- New JIT implementation based on IR Framework.
- New
request_parse_body()function. - New
bcceil(),bcdivmod(),bcfloor(), andbcround()functions. - New
RoundingModeenum forround()with 4 new rounding modesTowardsZero,AwayFromZero,NegativeInfinity, andPositiveInfinity. - New
DateTime::createFromTimestamp(),DateTime::getMicrosecond(),DateTime::setMicrosecond(),DateTimeImmutable::createFromTimestamp(),DateTimeImmutable::getMicrosecond(), andDateTimeImmutable::setMicrosecond()methods. - New
mb_trim(),mb_ltrim(),mb_rtrim(),mb_ucfirst(), andmb_lcfirst()functions. - New
pcntl_getcpu(),pcntl_getcpuaffinity(),pcntl_getqos_class(),pcntl_setns(), andpcntl_waitid()functions. - New
ReflectionClassConstant::isDeprecated(),ReflectionGenerator::isClosed(), andReflectionProperty::isDynamic()methods. - New
http_get_last_response_headers(),http_clear_last_response_headers(), andfpow()functions. - New
XMLReader::fromStream(),XMLReader::fromUri(),XMLReader::fromString(),XMLWriter::toStream(),XMLWriter::toUri(), andXMLWriter::toMemory()methods. - New
grapheme_str_split()function.
Deprecations and backward compatibility breaks
- The IMAP, OCI8, PDO_OCI, and pspell extensions have been unbundled and moved to PECL.
- Implicitly nullable parameter types are now deprecated.
- Using
_as a class name is now deprecated. - Raising zero to the power of a negative number is now deprecated.
- Passing invalid mode to
round()throwsValueError. - Class constants from extensions
date,intl,pdo,reflection,spl,sqlite,xmlreaderare typed now. GMPclass is now final.MYSQLI_SET_CHARSET_DIR,MYSQLI_STMT_ATTR_PREFETCH_ROWS,MYSQLI_CURSOR_TYPE_FOR_UPDATE,MYSQLI_CURSOR_TYPE_SCROLLABLE, andMYSQLI_TYPE_INTERVALconstants have been removed.mysqli_ping(),mysqli_kill(),mysqli_refresh()functions,mysqli::ping(),mysqli::kill(),mysqli::refresh()methods, andMYSQLI_REFRESH_*constants have been deprecated.stream_bucket_make_writeable()andstream_bucket_new()now return an instance ofStreamBucketinstead ofstdClass.exit()behavioral change.E_STRICTconstant has been deprecated.
Better performance, better syntax, improved type safety.
For source downloads of PHP 8.4 please visit thedownloads page. Windows binaries can be found on thePHP for Windows site. The list of changes is recorded in theChangeLog.
Themigration guide is available in the PHP Manual. Please consult it for a detailed list of new features and backward-incompatible changes.
