新機能

PHP コア

読み取り専用プロパティのデフォルト値

読み取り専用プロパティ に、デフォルト値を宣言できるようになりました。

<?php
class Config
{
    public readonly int $timeout = 30;
}

$config = new Config();
var_dump($config->timeout); // int(30)

WeakMap での参照による代入

WeakMap で、事前にキーが存在していなくても、 参照による代入を使えるようになりました。

<?php
$obj = new stdClass();
$map = new WeakMap();
$count = 0;

// PHP 8.6.0 より前は、Error: "Object stdClass#1 not contained in WeakMap" が発生していました
$map[$obj] = &$count;
$count++;

var_dump($map[$obj]); // int(1)

列挙型での __debugInfo

__debugInfo() マジックメソッドを、列挙型 に定義できるようになりました。 これより前のバージョンでは、致命的なエラーになっていました。

<?php
enum Suit: string
{
    case Hearts = 'H';
    case Spades = 'S';

    public function __debugInfo(): array
    {
        return ['suit' => $this->name, 'symbol' => $this->value];
    }
}

var_dump(Suit::Hearts);

上の例の出力は以下となります。

enum(Suit::Hearts) (2) {
  ["suit"]=>
  string(6) "Hearts"
  ["symbol"]=>
  string(1) "H"
}

クラス定数に対する #[\Override] 指定

Override アトリビュートを、 列挙型の case を含むクラス定数に指定できるようになりました。 メソッドやプロパティと同様に、親クラスや実装しているインターフェイスに 対応する定数が存在しない場合、コンパイル時エラーが発生します。

<?php
interface HasVersion
{
    const VERSION = '1.0';
}

class Package implements HasVersion
{
    #[\Override]
    const VERSION = '2.0';

    // Fatal error: Package::NAME has #[\Override] attribute,
    // but no matching parent constant exists
    // #[\Override]
    // const NAME = 'package';
}

関数の部分適用

関数の部分適用 がサポートされました。 1 つ以上の引数を ? プレースホルダに、または残りの引数を ... プレースホルダに置き換えて呼び出すと、足りない引数を受け取る Closure が作成されます。

<?php
function add(int $a, int $b, int $c = 0): int
{
    return $a + $b + $c;
}

// "?" はちょうど 1 つの引数を置き換えます
$addOne = add(1, ?);
var_dump($addOne(5)); // int(6)

// "..." は残りの引数をすべて置き換えます
$addToOne = add(1, ...);
var_dump($addToOne(2, 3)); // int(6)

// 内部関数を含め、あらゆる callable で使えます
$stripSpaces = str_replace(' ', '', ?);
var_dump($stripSpaces('a b c')); // string(3) "abc"

定数に格納されたオブジェクトの変更

定数やクラス定数に格納されたオブジェクトを、 OBJ->prop = $val で直接変更できるようになりました。

<?php
const CONFIG = new stdClass();

// PHP 8.6.0 より前は、"Fatal error: Cannot use temporary expression in write context" が発生していました
CONFIG->debug = true;

var_dump(CONFIG->debug); // bool(true)

pack() と unpack() のエンディアン修飾子

pack と unpack が、 < (リトルエンディアン) と > (ビッグエンディアン) の修飾子を受け付けるようになりました。 この修飾子は、整数のフォーマットコード s、S、 l、L、q、 Q の後と、float と double のフォーマットコード f、d の後に指定できます。

<?php
echo bin2hex(pack('l>', 1)), PHP_EOL;   // Prints "00000001"
echo bin2hex(pack('l<', 1)), PHP_EOL;   // Prints "01000000"
echo bin2hex(pack('f>', 1.5)), PHP_EOL; // Prints "3fc00000"

var_dump(unpack('s>value', "\xff\xfe")); // ["value" => int(-2)]

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 がスローされます。

<?php
$timeout = \Time\Duration::fromSeconds(2)->add(\Time\Duration::fromMilliseconds(500));

printf("%d.%09d seconds\n", $timeout->seconds, $timeout->nanoseconds);
var_dump($timeout > \Time\Duration::fromSeconds(2));

上の例の出力は以下となります。

2.500000000 seconds
bool(true)

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 が追加されました。