新機能
PHP コア
WeakMap での参照による代入
WeakMap で、事前にキーが存在していなくても、
参照による代入を使えるようになりました。
列挙型での __debugInfo
__debugInfo()
マジックメソッドを、列挙型
に定義できるようになりました。
これより前のバージョンでは、致命的なエラーになっていました。
クラス定数に対する #[\Override] 指定
Override アトリビュートを、
列挙型の case を含むクラス定数に指定できるようになりました。
メソッドやプロパティと同様に、親クラスや実装しているインターフェイスに
対応する定数が存在しない場合、コンパイル時エラーが発生します。
関数の部分適用
関数の部分適用
がサポートされました。
1 つ以上の引数を ? プレースホルダに、または残りの引数を
... プレースホルダに置き換えて呼び出すと、足りない引数を受け取る
Closure が作成されます。
定数に格納されたオブジェクトの変更
定数やクラス定数に格納されたオブジェクトを、
OBJ->prop = $val で直接変更できるようになりました。
pack() と unpack() のエンディアン修飾子
pack と unpack が、
< (リトルエンディアン) と >
(ビッグエンディアン) の修飾子を受け付けるようになりました。
この修飾子は、整数のフォーマットコード s、S、
l、L、q、
Q の後と、float と double のフォーマットコード
f、d の後に指定できます。
cURL
curl_getinfo が返す配列に、
"size_delivered" キーが追加されました。
これは、ダウンロード用の書き込みコールバックに渡された合計バイト数を示します。
この値は、CURLINFO_SIZE_DELIVERED を
option 引数に渡しても取得できます。
libcurl 8.20.0 以降が必要です。
ストリーミングで送信するリクエストボディの読み取り位置を移動するコールバックを登録する、
CURLOPT_SEEKFUNCTION が追加されました。
これにより libcurl は、リダイレクト、複数回のやり取りを伴う認証、
再利用した接続でのリトライの際に、
CURLE_SEND_FAIL_REWIND で失敗せず、
リクエストボディを巻き戻して再送できます。
コールバックは CurlHandle、オフセット、基準位置を受け取り、
CURL_SEEKFUNC_OK、
CURL_SEEKFUNC_FAIL、
CURL_SEEKFUNC_CANTSEEK のいずれかを返さなければなりません。
Date
タイムアウトのような、長さが一定の経過時間をナノ秒の精度で表す
Time\Duration クラスが追加されました。
DateInterval とは異なり、日や月などの暦の単位を持たないため、
長さに曖昧さがありません。
期間は不変で、比較演算子で比較できます。
このクラスは、以下を提供します:
-
Time\Duration::fromSeconds、
Time\Duration::fromMilliseconds、
Time\Duration::fromIso8601DurationString
などのファクトリメソッド
-
Time\Duration::add、
Time\Duration::sub、
Time\Duration::multiplyBy、
Time\Duration::divideBy による算術演算
-
符号を変える Time\Duration::negate と
Time\Duration::absolute
-
ソートのコールバックとして使える
Time\Duration::compare
期間が表現できる範囲 (約 292 年) を超えた場合や、
ISO 8601 の期間指定が不正な場合、
Time\TimeException がスローされます。
FileInfo
finfo_file が、リモートストリームでも動作するようになりました。
GMP
べき乗剰余を、サイドチャネル攻撃に耐性のある方法で計算する
gmp_powm_sec が追加されました。
GNU MP 5.0.0 以降が必要です。
MPIR を使う公式の Windows ビルドでは利用できません。
指定した数より小さい最大の素数を取得する
gmp_prevprime が追加されました。
オプションの出力用引数 definitely_prime
は、返された数が確実に素数なのか、おそらく素数というだけなのかを示します。
そのような素数が存在しない場合、
ValueError がスローされます。
この関数は、GNU MP 6.3.0 以降を使って PHP をビルドした場合のみ利用できます。
MPIR を使う公式の Windows ビルドでは利用できません。
Intl
static メソッド
IntlDatePatternGenerator::getSkeleton と
IntlDatePatternGenerator::getBaseSkeleton が追加されました。
これらは、日付/時刻のパターンから一意なスケルトンと基本スケルトンを生成します。
Locale::getDisplayKeyword と
Locale::getDisplayKeywordValue が追加されました。
エイリアスはそれぞれ
locale_get_display_keyword と
locale_get_display_keyword_value です。
指定したスケルトンとロケールで、2 つの数値で表す範囲をフォーマットする
IntlNumberRangeFormatter クラスが追加されました。
このクラスは ICU 63 以降でサポートされます。
collapse の動作は、以下のいずれかです:
IntlNumberRangeFormatter::COLLAPSE_AUTO
IntlNumberRangeFormatter::COLLAPSE_NONE
IntlNumberRangeFormatter::COLLAPSE_UNIT
IntlNumberRangeFormatter::COLLAPSE_ALL
identity fallback は、以下のいずれかです:
IntlNumberRangeFormatter::IDENTITY_FALLBACK_SINGLE_VALUE
IntlNumberRangeFormatter::IDENTITY_FALLBACK_APPROXIMATELY_OR_SINGLE_VALUE
IntlNumberRangeFormatter::IDENTITY_FALLBACK_APPROXIMATELY
IntlNumberRangeFormatter::IDENTITY_FALLBACK_RANGE
2 つの文字列が、指定したテキストの方向で紛らわしいかどうかを調べる
SpoofChecker::areBidiConfusable と、
方向を表す定数 SpoofChecker::LTR と
SpoofChecker::RTL が追加されました。
これらは ICU 74 以降でサポートされます。
指定したテキストの方向に応じた、紛らわしさの判定に使うスケルトンを生成する
SpoofChecker::getBidiSkeleton が追加されました。
このメソッドは ICU 74 以降でサポートされます。
指定した文字列から、紛らわしさの判定に使うスケルトンを生成する
SpoofChecker::getSkeleton が追加されました。
IO
ポーリング API が追加されました。
この API は、以下で構成されています:
- Io\Poll\Context クラスと Io\Poll\Watcher クラス
- Io\Poll\Backend 列挙型と Io\Poll\Event 列挙型
- Io\Poll\Handle インターフェイス
- ストリームを監視する StreamPollHandle クラス
JSON
json_last_error_msg が返すエラーメッセージと
JsonException のメッセージに、
エラーの位置についての情報が追加されました。
OpenSSL
ストリームで TLS のセッション再開がサポートされました。
以下の新しい SSL コンテキスト オプションを使うと、
リクエストをまたいだクライアントセッションの保存と復元、
サーバー側の独自のセッションストレージの実装、
セッションキャッシュの動作の制御ができます:
session_data
session_new_cb
session_cache
session_cache_size
session_timeout
session_id_context
session_get_cb
session_remove_cb
num_tickets
ストリームで TLS の外部 PSK がサポートされました。
新しい SSL コンテキスト オプション
psk_client_cb と
psk_server_cb で、事前共有鍵を設定したり受け取ったりできます。
ストリームで TLS 1.3 の早期データ (0-RTT) がサポートされました。
クライアントは early_data
SSL コンテキスト オプションで早期データを送信します。
サーバーは max_early_data を設定すると早期データを受け付け、
受け取ったデータは early_data_cb コールバックに渡されます。
結果は、stream_get_meta_data が返す配列の
"crypto" エントリにある
"early_data" キーで取得できます。
"accepted"、"rejected"、"not_sent"
のいずれかです。
PDO_PGSQL
ステートメントがチャンクごとにフェッチする行数を表す
Pdo\Pgsql::ATTR_CHUNK_SIZE が追加されました。
1 以上の値を指定すると、
PDO::ATTR_PREFETCH => 0 の遅延フェッチモードになります。
PDO::ATTR_PREFETCH を設定すると、チャンクサイズはその設定で置き換えられます。
この属性も
PDO::ATTR_PREFETCH も指定せずに準備したステートメントでは、
接続に設定した値が使われます。
libpq 17 以降が必要です。
Phar
SplFileInfo::getMTime メソッドと
SplFileInfo::getPathname メソッドをオーバーライドすると、
Phar::buildFromDirectory と
Phar::buildFromIterator 系のメソッドの結果に
反映されるようになりました。
これにより、ファイルのタイムスタンプと名前を変更できます。
SNMP
使用するライブラリがサポートしていれば、
AES192、
AES192C、AES256、
AES256C を SNMPv3 のセキュリティプロトコルとして
使えるようになりました。
MIB ツリーを、新しい関数
snmp_init_mib でリセットできるようになりました。
MIB のパースと出力を制御する機能が、以下で使えるようになりました:
- snmp_set_mib_option
- snmp_set_output_option
- snmp_set_string_output_format
- SNMP::$numeric_index
- SNMP::$numeric_timeticks
- SNMP::$extended_index
- SNMP::$dont_print_units
- SNMP::$escape_quotes
- SNMP::$print_hex_text
- SNMP::setOidOutputFormat
- SNMP::setStringOutputFormat
SOAP
"keep_headers" オプションが
SoapClient::__construct に追加されました。
これは、元のホストとは異なるホストから WSDL をインポートする際に、
SoapClient が保持する HTTP ヘッダを指定するものです。
その際、デフォルトでは Authorization、
Proxy-Authorization、Cookie
ヘッダが取り除かれます。
このオプションには、['keep_headers' => ['authorization']]
のように、保持するヘッダ名の配列を指定します。
Streams
ストリームエラー API が追加されました。
この API は、以下で構成されています:
- StreamError クラスと StreamException クラス
- StreamErrorStore、StreamErrorMode、StreamErrorCode 列挙型
- stream_last_errors 関数と stream_clear_errors 関数
この API の動作は、ストリームコンテキストオプション
error_mode、
error_store、
error_handler
で制御します。
php://filter URL 向けに、
ストリームコンテキストオプション filter.max_filter_count が追加されました。
このオプションを設定すると、
URL で指定したフィルタの数が設定値を超えた場合に警告が発生し、ストリームのオープンに失敗します。
負の値を指定すると、このチェックは無効になります。
アドレスの再利用 (SO_REUSEADDR) を無効にできる、
ソケットコンテキスト オプション
so_reuseaddr が追加されました。無効にすると、Windows では
SO_EXCLUSIVEADDRUSE を明示的に使います。
ソケットのキープアライブを設定できる、
ソケットコンテキスト オプション
so_keepalive、tcp_keepidle、
tcp_keepintvl、tcp_keepcnt
が追加されました。
ソケットコンテキスト オプション
so_linger が追加されました。これは
SO_LINGER を
TCP ソケットに設定します。
正の値を指定すると、その秒数だけ linger が有効になり、
0 または負の値を指定すると無効になります。
プラットフォームによっては linger の時間が unsigned short に制限されるため、
65535 を超える値は 65535 として扱われます。
ソケットコンテキスト オプション
so_rcvbuf と so_sndbuf が追加されました。
これらは、TCP ソケットと
UDP ソケットの受信バッファと送信バッファのサイズ
(SO_RCVBUF と SO_SNDBUF)
をバイト単位で設定します。
値は 1 から 2147483647 までの整数でなければならず、
それ以外の値を指定するとストリームの作成に失敗します。
OS は、要求されたサイズを丸めたり、上限で抑えたり、その他の方法で調整したりすることがあり、バッファのサイズを自動で調整しなくなることもあります。
そのため、後から読み取ったサイズは、要求したサイズと異なる場合があります。
フィルタを適用したストリームを、
stream_select で使うためにファイルディスクリプタにキャストできるようになりました。
bz2、iconv、zlib、convert
ストリームフィルタに、フィルタパラメータ "write_seek_mode" が追加されました。
このパラメータは、キーが "write_seek_mode"
で、値が以下の文字列のいずれかである連想配列で設定しなければなりません:
"preserve"
"reset"
"strict"
URI
Uri\Rfc3986\Uri::getUriType と
Uri\WhatWg\Url::isSpecialScheme が追加されました。
Uri\Rfc3986\Uri::getHostType と
Uri\WhatWg\Url::getHostType が追加されました。
Uri\Rfc3986\UriBuilder クラスと
Uri\WhatWg\UrlBuilder クラスが追加されました。
Uri\WhatWg\url_percent_encode が追加されました。