その他の変更

PHP コア

PHP コア

システムからメモリを確保できない OOM (メモリ不足) が発生した場合、PHP は exit(1) ではなく abort() を呼び出すようになりました。 そのため、終了コードが 134 に変わり、コアダンプが生成されることもあります。

PHP_OS_FAMILY 定数は、 AIX 上か、PASE を介した IBM i 上で実行している場合、 AIX という値を取るようになりました。

SAPI モジュールへの変更

CLI

ビルトインの開発用サーバー は、HTTP の QUERY メソッドを使ったリクエストを、501 Not Implemented を返さず受け付けるようになりました。

ビルトインの開発用サーバー は、リクエストの Host ヘッダをレスポンスで送り返さなくなりました。

変更された関数

PHP コア

header_register_callback は、 戻り値の型を正式に true としました。 PHP 8.0.0 以降、無効なコールバックを渡すと TypeError がスローされていたため、 false を返すことはありませんでした。

register_tick_function は、 戻り値の型を正式に true としました。 これまでも、成功時には常に true を返していました。 無効なコールバックを渡すと、関数本体に到達する前、引数を解析する段階で TypeError がスローされます。

ini_get_all は、 details が true の場合、各ディレクティブに "builtin_default_value" 要素を含めるようになりました。 この要素には、php.ini、コマンドライン、実行時に設定された値とは関係なく、 ディレクティブのビルトインのデフォルト値 (存在しない場合は null) が格納されます。

fclose、file_put_contents、 copy は、ストリームのフラッシュやクローズに失敗した場合に false を返すようになりました。 これより前のバージョンでは、こうした失敗は無視されていました。

Date

以下のメソッドは、仮の戻り値の型が static になりました:

  • DateTime::createFromInterface
  • DateTimeImmutable::__set_state
  • DateTimeImmutable::modify
  • DateTimeImmutable::add
  • DateTimeImmutable::sub
  • DateTimeImmutable::setTimezone
  • DateTimeImmutable::setTime
  • DateTimeImmutable::setDate
  • DateTimeImmutable::setISODate
  • DateTimeImmutable::setTimestamp
  • DateTimeImmutable::createFromInterface
  • DateTimeZone::__set_state
  • DateInterval::__set_state
  • DatePeriod::__set_state

Filter

filter_var_array の戻り値の型が、 arrayfalsenull から arrayfalse に絞り込まれました。 この関数はフィルタリングの前に必ず配列を用意するため、 null を返すことはありませんでした。 filter_input_array は影響を受けません。 指定したスーパーグローバルが存在しない場合、これまでどおり null を返します。

LDAP

ldap_free_result の戻り値の型が、 bool から true に絞り込まれました。 この関数は、もともと常に true を返していました。

MySQLi

mysqli_get_charset の戻り値には、ドキュメント化されていない "comment" 要素が含まれなくなりました。 "charsetnr" の値は、本来公開すべきでなかった実装の詳細であるため、常に 0 になりました。

OpenSSL

openssl_x509_parse の戻り値に、 クリティカルな証明書拡張をすべて列挙した "criticalExtensions" エントリが含まれるようになりました。

openssl_sign と openssl_verify に、オプションの引数 salt_length が追加されました。 これにより、OPENSSL_PKCS1_PSS_PADDING を使う場合の RSA-PSS のソルト長を制御できます。 この引数には、具体的な長さか、新しく追加された OPENSSL_RSA_PSS_SALTLEN_* 定数のいずれかを指定します。

PDO_DBLIB

持続的接続を使う場合、 PDO::__construct で接続が生きているかを確認するようになりました。

Phar

Phar::mungServer は、渡された配列の値がリファレンスであっても受け付けるようになりました。

Readline

readline_completion_function は、 戻り値の型を正式に true としました。 これまでも、成功時には常に true を返していました。 無効なコールバックを渡すと、関数本体に到達する前、引数を解析する段階で TypeError がスローされます。

Reflection

ReflectionClassConstant::__toString と ReflectionConstant::__toString は、 bool 型の定数の値を、1 と空文字列ではなく、 true と false として出力するようになりました。 これは、 ReflectionClass::__toString など、クラス定数を出力する他の方法にも影響します。

Sockets

socket_addrinfo_lookup に、オプションの引数 error_code が追加されました。 この引数を指定すると、失敗時にエラーコード (EAI_* 定数のいずれか) が格納されます。

socket_cmsg_space の戻り値の型が、 intnull から int に絞り込まれました。 PHP 8.0.0 以降、失敗するケースではすべて ValueError がスローされていたため、 null を返すことはありませんでした。

Zip

zip_entry_close の戻り値の型が、 bool から true に絞り込まれました。 この関数は、もともと常に true を返していました。

拡張モジュールへのその他の変更

Fileinfo

file が 5.48 に更新されました。 古いバージョンの file で独自にコンパイルした magic データベースは、 再生成する必要があります。

Hash

バンドルしている xxHash のバージョンが 0.8.2 に更新されました。

MySQLi

MYSQLI_OPT_COMPRESS 定数が追加されました。

Opcache

JIT が、Apple Silicon 上の ZTS ビルドでサポートされるようになりました。

INI ファイルの扱いの変更

PHP コア

エラーメッセージに関数の引数を一貫した形で含めるため、 error_include_args INI ディレクティブが追加されました。デフォルトでは無効です。 これより前のバージョンでは、エラーメッセージに引数を含めるかどうかは、 内部のエラー関数を呼び出す箇所ごとに決められていました。 このディレクティブを有効にすると、関数に実際に渡されたとおりに、すべての引数が表示されます。 スタックトレースと同じ仕組みを使っているため、 機密性の高い引数は表示されず、文字列は zend.exception_string_param_max_len に従って切り詰められます。

MBString

mbstring.detect_order INI ディレクティブを実行時に ini_set で変更すると、内部の検出順も更新されるようになりました。 これより前のバージョンでは、ini_set で変更しても mb_detect_order には反映されませんでした。 実行時にこのディレクティブを null か空文字列に設定した場合、それまでの検出順が維持されるようになりました。

MySQLi

mysqli.default_port に設定した値が有効かどうかをチェックするようになりました。 値は 0 以上 65535 以下である必要があります。

Opcache

opcache.jit_debug に、新しいフラグ ZEND_JIT_DEBUG_TRACE_EXIT_INFO_SRC を指定できるようになりました。 デバッグビルドでは、このフラグを ZEND_JIT_DEBUG_TRACE_EXIT_INFO と組み合わせて使うと、exit info の出力に exit point の生成元が含まれます。

パフォーマンスに関わる変更

PHP コア

%s と %d のみを使用する printf の呼び出しは、同等の文字列補間にコンパイルされるようになりました。 これにより、関数呼び出しのオーバーヘッドも、フォーマット文字列を毎回解析する処理もなくなります。

呼び出すコンストラクタをコンパイル時に特定できる場合 (たとえば new self())、引数をより効率的に渡すようになりました。

第一級callable や 関数の部分適用 で作ったコールバックを渡す array_map の呼び出しは、同等の foreach ループにコンパイルされるようになりました。 これにより、中間的な Closure の生成と、 内部関数からユーザー定義のコールバックを呼び出すオーバーヘッドを回避でき、 JIT もコードをより詳しく把握できるようになります。

TAILCALL VM は、パフォーマンスが向上し、 x86_64 の Windows で Clang 19 以降を使ってコンパイルした場合に有効になりました。

ZTS ビルドのパフォーマンスが向上しました。

状態を持たないクロージャのキャッシュが追加されました。

VM が新しいスタックページを割り当てるほど深く再帰するコードは、 高速になったはずです。

要素が 1 つだけの配列をソートする際のパフォーマンスが向上しました。

以下の関数のパフォーマンスが向上しました:

  • addcslashes (8 進数のエスケープを生成する場合)
  • array_fill_keys
  • array_intersect
  • array_map (複数の配列を渡した場合)
  • array_product と array_sum (整数のみの配列の場合)
  • array_unshift
  • array_walk
  • intval (intval('0b...', 2) と intval('+0b...', 2) の場合)
  • pathinfo (要素を 1 つだけ要求する場合)
  • str_pad
  • str_repeat (繰り返し回数が 1 の場合)
  • str_split

DOM

DOMText::splitText と Dom\Text::splitText が高速になり、 メモリの消費量も減りました。

GD

imagebmp、imagewbmp、 imagegd、imagegd2 は、 PHP のストリームに書き込む際に出力をバッファリングするようになりました。 これにより、画像をファイルに書き込む際のパフォーマンスが大幅に向上します。

Windows における imagegrabscreen と imagegrabwindow のパフォーマンスが向上しました。

Intl

戻り値の配列を事前に確保することで、 IntlCalendar::getAvailableLocales と IntlDateFormatter::localtime/datefmt_localtime のパフォーマンスが向上しました。

戻り値の配列を事前に確保することで、 transliterator_list_ids と resourcebundle_locales のパフォーマンスが向上しました。

IntlChar::enumCharTypes でのコールバックの呼び出しが最適化されました。

JSON

配列とオブジェクトをエンコードする際のパフォーマンスが向上しました。

JSON_PRETTY_PRINT を指定した json_encode で、インデントを生成する処理のパフォーマンスが向上しました。

MBString

mb_str_pad のパフォーマンスが向上しました。

Phar

Phar のディレクトリを反復処理する際の、一時的なメモリ確保が減りました。

URI

エラーの配列を事前に確保することで、検証エラーを収集する場合の Uri\WhatWg\Url::parse のパフォーマンスが向上しました。

Uri\Rfc3986\Uri でパスや IPv6/IPvFuture のホストを読み取る際のメモリ確保が減りました。

Uri\Rfc3986\Uri の正規化を行う (raw ではない) ゲッターを、既に正規化されている URI に対して使う場合のパフォーマンスとメモリ消費量が改善されました。

Zip

戻り値の配列を事前に確保することで、 ZipArchive::addGlob と ZipArchive::addPattern のパフォーマンスが向上しました。

ZipArchive::addFromString で文字列をコピーしなくなりました。