下位互換性のない変更点

PHP コア

配列のコンパクション後の、リファレンスを使った foreach

リファレンスを使った foreach ループが、配列のコンパクション後に、 これまでスキップされていた要素を反復処理する場合があります。 削除された要素を指している内部ポインタは、コピーオンライトの際に、 削除されていない次の要素へ移動するようになりました。

マジックプロパティに対する Null 合体演算子と empty

__isset() がプロパティテーブルに書き込んでプロパティを実体化した場合、 マジックプロパティに対する ?? と empty は、 __get() を呼び出さなくなりました。 書き込まれたばかりの値がそのまま返されます。 プロパティに直接適用した isset は影響を受けませんが、 isset($o->p['k']) のようにネストした形は、 ?? と同じように処理されます。

<?php
#[\AllowDynamicProperties]
class Example
{
    public function __isset(string $name): bool
    {
        $this->$name = 'from __isset()';
        return true;
    }

    public function __get(string $name): string
    {
        return 'from __get()';
    }
}

$example = new Example();
var_dump($example->foo ?? 'default');
// PHP 8.6.0 以降: string(14) "from __isset()"
// PHP 8.6.0 より前のバージョン: string(12) "from __get()"

array_intersect での文字列への変換

array_intersect に 2 つ以上の配列を渡した場合、 値を文字列に変換するのは、ソートの比較中ではなく、 入力を走査している間になりました。 これにより、変換時の警告や __toString() の呼び出しの回数と順序、どの変換で例外がスローされるか、状態を持つ __toString() の実装を使った場合の結果が変わることがあります。 空の配列があるかどうかの確認や値の変換より前に引数の型を検証するようになったため、 後ろの引数が不正だと、それより前の配列の変換による副作用が起きなくなることがあります。 いずれかの入力配列が空の場合、値は変換されません。

フォームフィードをデフォルトで取り除く

trim、rtrim、 ltrim は、デフォルトでフォームフィード (\f) も取り除くようになりました。

<?php
var_dump(trim("\f hello \f"));
// PHP 8.6.0 以降: string(5) "hello"
// PHP 8.6.0 より前のバージョン: string(9) "\f hello \f"

不正な引数に対する新しいエラー

以下の関数は、不正なフラグやモードの値が渡された場合に ValueError をスローするようになりました:

  • array_filter (mode)
  • array_change_key_case (case)
  • pathinfo (flags)
  • scandir (sorting_order)

以下の関数は、対象の引数に NUL バイトが含まれている場合に ValueError をスローするようになりました:

  • getenv と putenv (最初の引数)
  • dl (extension_filename)
  • openlog (prefix)
  • parse_str (string)
  • proc_open (cwd)

以下の関数は、範囲外の値を範囲内に収めたりオーバーフローさせたりせず、 ValueError をスローするようになりました:

  • number_format で decimals が整数の範囲外の場合。
  • sleep で seconds が UINT_MAX (Windows では UINT_MAX / 1000) より大きい場合。
  • usleep で microseconds が UINT_MAX より大きい場合。

linkinfo は、path 引数が空の場合に ValueError をスローするようになりました。

setlocale は、ロケール名に NUL バイトが含まれている場合、ロケール名を切り詰めるのではなく、 ValueError をスローするようになりました。 配列を受け付けるのは、locales 引数だけになりました。 後続の可変長引数にロケールとして配列を渡すと、 TypeError がスローされるようになりました。 locales が配列の場合、ロケールの引数を 1 つでも追加で渡すと、 ArgumentCountError がスローされるようになりました。

以下の関数は、filename 引数に NUL バイトが含まれている場合に ValueError をスローするようになりました:

  • fileperms
  • fileinode
  • filesize
  • fileowner
  • filegroup
  • fileatime
  • filemtime
  • filectime
  • filetype
  • is_writable
  • is_readable
  • is_executable
  • is_file
  • is_dir
  • is_link
  • file_exists
  • lstat
  • stat

数値を正確に変換できない場合の notice

base_convert、bindec、 hexdec、octdec は、 指定された数値を正確に変換できない場合に notice を発生させるようになりました。

unpack のフォーマット中の名前とエンディアン修飾子

unpack は、フォーマットコードの直後にある < や > を、 要素名の最初の文字ではなく、エンディアン修飾子として読み取るようになりました。 "s<value" のようなフォーマットでは、キーが "<value" ではなく "value" になります。 また、フォーマットコード C はエンディアン修飾子を受け付けないため、 "C>name" を指定すると ValueError がスローされます。 これらの文字で始まる名前でも、"s1<value" のように前に反復指定用引数があれば影響を受けません。 新しいエンディアン修飾子 も参照ください。

<?php
var_dump(unpack('s<value', "\x01\x00"));
// PHP 8.6.0 以降: ["value" => 1]
// PHP 8.6.0 より前のバージョン: ["<value" => 1]

COM

clone 時の振る舞いがきちんと定義されていなかったため、 variant オブジェクトを clone できなくなりました。

cURL

CURLOPT_READFUNCTION で登録したコールバックが 0、CURL_READFUNC_ABORT、 CURL_READFUNC_PAUSE 以外の整数を返すと、 ValueError がスローされるようになりました。

DOM

読み取り専用とドキュメントに記載されていたプロパティ (例: DOMNode::$nodeType、 DOMDocument::$xmlEncoding、 DOMEntity::$actualEncoding、 DOMEntity::$encoding、 DOMEntity::$version) は、 非対称可視性 (public private(set)) を使って宣言されるようになりました。 クラスの外部からこれらに書き込もうとすると、 これまでの読み取り専用プロパティの変更エラーではなく、 Cannot modify private(set) property class::$prop from global scope というエラーが発生するようになりました。 ReflectionProperty::isWritable も、 これらのプロパティを正しく判定します。

Dom\DtdNamedNodeMap オブジェクトに配列としてアクセスした場合、 負の整数のインデックスに対しては、最初のノードではなく null を返すようになりました。 また、整数のインデックスが INT_MAX より大きい場合、より小さいインデックスにオーバーフローするのではなく、 ValueError がスローされるようになりました。

Fileinfo

TrueType フォントは、font/sfnt ではなく font/ttf として検出されるようになりました。

FTP

ftp_nb_fget、ftp_nb_fput、 ftp_nb_get、ftp_nb_put は、 接続が既に転送中の場合、警告を発生させて false を返すのではなく、 Error をスローするようになりました。 ftp_close は、以前から同じ条件で例外をスローしています。

GD

imagesetstyle、imagefilter、 imagecrop は、配列の引数の型と値を検証し、不正な場合は TypeError や ValueError をスローするようになりました。

imageaffinematrixget は、options 引数の型が、ドキュメントに記載されている arrayfloat であるかを検証するようになりました。 この検証は、自動変換モードと strict モードのそれぞれの規則に従います。

GMP

gmp_fact は、num が unsigned long に収まらない場合、 ValueError をスローするようになりました。

gmp_pow、gmp_binomial、 gmp_root、gmp_rootrem は、 2 番目の引数が unsigned long に収まらない場合、 ValueError をスローするようになりました。

GMP オブジェクトに対するシフト演算子 (<<、>>) とべき乗演算子 (**) は、右オペランドの GMP オブジェクトが unsigned long の範囲外の場合、値を切り詰めるのではなく、 ValueError をスローするようになりました。

GMP が整数を表す文字列をパースする際、 NUL バイトを含む文字列を切り詰めるのではなく、 ValueError をスローするようになりました。

gmp_powm でゼロによる剰余を求めようとしたときにスローされる DivisionByZeroError のメッセージに、 関数名と引数の位置 (modulus) が含まれるようになりました。

Intl

タイムゾーンのオブジェクトや文字列を受け付ける Intl の API に、文字列に変換できないオブジェクトを タイムゾーンとして渡すと、Error ではなく TypeError がスローされるようになりました。

IntlIterator::current は、 イテレータの位置が決まる前や、イテレータが無効になった後に呼び出された場合、 未定義の値を返すのではなく null を返すようになりました。

IntlBreakIterator::getLocale は、ロケールの種類が Locale::ACTUAL_LOCALE と Locale::VALID_LOCALE のどちらでもない場合、 false を返すのではなく ValueError をスローするようになりました。

64 ビットプラットフォームで整数値をパースする際、 MessageFormatter::parse と MessageFormatter::parseMessage は、 PHP_INT_MIN を float ではなく int として返すようになりました。

IntlBreakIterator::getPartsIterator の type 引数の型が、内部の実装に合わせて string から int に変更されました。

UConverter::transcode は、127 バイトより長い from_subst や to_subst オプションの値を、 長さを切り詰めて ICU に渡すのではなく、 拒否するようになりました。

ResourceBundle::get と resourcebundle_get は、フォールバックを無効にしてリソースを検索した際のメッセージに、誤った形の without fallback from to locale ではなく、 without fallback to locale を使うようになりました。

IntlDateFormatter::parse/datefmt_parse と IntlDateFormatter::localtime/datefmt_localtime は、offset 引数が int 型でない場合、 値を変換するのではなく TypeError をスローするようになりました。

Collator::sort、 collator_sort、 Collator::asort、 collator_asort は、比較中に発生した UTF-8/UTF-16 の変換の失敗を intl のエラー機構で報告し、false を返すようになりました。 intl.use_exceptions が有効な場合は、IntlException がスローされます。 これより前のバージョンでは、警告を発生させ、値を空文字列として比較していました。

MBString

Unicode データテーブルが、Unicode 18.0 に更新されました。

PCNTL

pcntl_alarm は、seconds 引数が 0 未満の場合や、プラットフォームの UINT_MAX より大きい場合、ValueError をスローするようになりました。

pcntl_exec は、args 引数がリストでない場合、ValueError をスローするようになりました。

PCRE

preg_grep は、PCRE の実行エラーが発生した場合 (例: u 修飾子を指定して、不正な UTF-8 を入力した場合)、 途中までの配列ではなく false を返すようになりました。 これは、他の preg_* 関数と同じ動作です。

PDO_PGSQL

持続的接続を使う PDO オブジェクトがすべて破棄されると、SET で変更した設定や一時テーブルなどのセッションの状態がリセットされるようになりました。 PREPARE 文で作成したステートメントは残ります。

PGSQL

pg_fetch_object に、コンストラクタを持たないクラスと、 空でない constructor_args を渡した場合、 スローされる ValueError が、 class ではなく constructor_args 引数を示すようになりました。 インスタンス化できないクラス (抽象クラス、インターフェイス、列挙型) を指定した場合のエラーは、行をフェッチする前に発生するようになりました。

Phar

Phar::mungServer は、配列に REQUEST_URI、PHP_SELF、SCRIPT_NAME、SCRIPT_FILENAME 以外の文字列が含まれている場合、無視するのではなく PharException をスローするようになりました。

Phar::addEmptyDir は、".phar" のパスに加えて "/.phar" のパスも拒否するようになり、 この形式で予約済みのマジックディレクトリ ".phar" を作成しようとした場合も、同じ BadMethodCallException をスローします。 ".phar" で始まるだけで、マジックディレクトリではない名前は、 通常のディレクトリとして扱われるようになりました。

ファイルをインクルードしたときに自動的に Phar アーカイブとして解釈されるのは、 パスのファイル名部分に拡張子として ".phar" が含まれている場合だけになりました。 これより前のバージョンでは、ディレクトリ名や、".pharma" のような拡張子の一部に含まれている場合も対象になっていました。

Session

session.cookie_path、 session.cookie_domain、 session.cache_limiter に NUL バイトを含む値を設定すると、警告が発生し、 設定は変更されないようになりました。 これより前のバージョンでは、NUL バイトを含む値も受け付けていました。 その結果、cookie_path と cookie_domain では SAPI が Set-Cookie ヘッダを破棄し、 cache_limiter では値が NUL バイトの位置で切り詰められていました。

session_module_name は、name が NUL バイトを含む文字列の場合、 ValueError をスローするようになりました。

session_encode は、空のセッションに対して false ではなく空文字列を返すようになりました。 false を返すのは、セッションデータをエンコードできなかった場合だけになりました。 これは主に、デフォルトのシリアライズハンドラを使っていて、 キーにパイプ文字 (|) が含まれている場合に起こります。

session.lazy_write が有効で、 セッションハンドラが SessionUpdateTimestampHandlerInterface を実装している場合、読み込み時に空で、書き込み時にも空のままのセッションでは、 SessionHandlerInterface::write ではなく SessionUpdateTimestampHandlerInterface::updateTimestamp が呼び出されるようになりました。 これより前のバージョンでは、session_encode が false を返していたため lazy_write の比較が行われず、空のセッションに対しては常に SessionHandlerInterface::write が呼び出されていました。 空のデータで SessionHandlerInterface::write が呼び出されることを前提にしている独自のセッションハンドラ (例: セッションを破棄するもの) は、同じ処理を SessionUpdateTimestampHandlerInterface::updateTimestamp メソッドに実装すべきです。

設定を変更しなくても安全に動作するように、 セッションの 3 つの INI 設定のデフォルト値が変更されました:

  • session.use_strict_mode は 1 になりました (これまでは 0)。 厳格モードでは初期化されていないセッション ID を受け付けないため、 セッション固定攻撃のリスクを軽減できます。 外部から渡された ID を、対応するエントリがストレージになくても受け入れることを前提としていた独自のセッションハンドラは、 SessionUpdateTimestampHandlerInterface::validateId と SessionIdInterface::create_sid を実装するか、 この設定を明示的に 0 にする必要があります。
  • session.cookie_httponly は 1 になりました (これまでは 0)。 JavaScript から document.cookie を使ってセッションクッキーにアクセスできなくなりました。 JavaScript からセッションクッキーを読み取るアプリケーションは、 この設定を明示的に 0 にする必要があります。
  • session.cookie_samesite は "Lax" になりました (これまでは未設定)。 安全な HTTP メソッドを使ったトップレベルのナビゲーション以外では、 クロスサイトリクエストでセッションクッキーが送信されなくなりました。 クロスサイトの POST でセッションクッキーが送信されることを前提としているアプリケーションは、 この設定を明示的に "None" にする必要があります (session.cookie_secure も 1 にしてください)。

SessionHandler::validateId が追加されました。 このメソッドは、設定されている保存ハンドラに処理を委譲します。 SessionHandler::validateId を戻り値の型なしで宣言したサブクラスでは、仮の戻り値の型 bool について推奨されない警告が発生するようになりました。 parent::open() を呼び出さず SessionHandler::open をオーバーライドしたサブクラスは、これまでどおり動作しますが、ID を検証する際に警告が発生します。

Shmop

shmop_open は、key 引数がプラットフォームの key_t の範囲外の場合、 切り詰めたキーをオペレーティングシステムに渡すのではなく、 ValueError をスローするようになりました。

SimpleXML

SimpleXMLElement::__construct は、 data 引数に NUL バイトが含まれている場合、simplexml_load_file と同様に ValueError をスローするようになりました。 これより前のバージョンでは、dataIsURL が true の場合、パスを最初の NUL バイトの位置で切り詰めていました。 false の場合は、文字列が libxml に渡されていました。 現行のバージョンの libxml は、デフォルトのオプションでは NUL を拒否しますが、古いバージョンや LIBXML_RECOVER を指定した場合は、切り詰められたドキュメントを受け入れます。

SOAP

SoapClient と SoapServer の "classmap" オプションは、 整数のキーを含む配列を受け付けなくなりました。 これより前のバージョンでは、整数のキーが連続していない配列や、 整数と文字列のキーが混在した配列を受け付ける場合がありました。 SoapClient は、配列でない "classmap" オプションに対しては TypeError を、 整数のキーを含む配列に対しては ValueError をスローするようになりました。"exceptions" オプションを無効にしている場合も同様です。

WSDL/XML スキーマをパースする際、出現回数の制約や、整数値の制約ファセットに範囲外の整数値があると、その値を拒否するようになりました。 負の minOccurs や maxOccurs の値も拒否されます。

SOAP のエンコードエラーのメッセージが、汎用的な Encoding: Violation of encoding rules から、対象の型や失敗した操作を示すものに変わりました。 メッセージを厳密に比較しているコードは、修正が必要になる場合があります。

Sockets

socket_set_option で SO_ATTACH_REUSEPORT_CBPF を使う場合、 value には int を、 level には SOL_SOCKET を指定することが必須になりました。 値がそれ以外の型の場合は、変換されず TypeError がスローされます。 レベルがそれ以外の場合は、警告が発生し、false が返されます。

socket_set_option で SO_ATTACH_REUSEPORT_CBPF を使い、 value に 0 を指定した場合、 SO_DETACH_REUSEPORT_BPF を使って reuseport フィルタをデタッチするようになりました。 これより前のバージョンでは、SO_DETACH_FILTER のエイリアスである SO_DETACH_BPF を使っていたため、 reuseport プログラムがアタッチされたままになっていました。

Sodium

パスワードハッシュ関数 sodium_crypto_pwhash、 sodium_crypto_pwhash_str、 sodium_crypto_pwhash_scryptsalsa208sha256、 sodium_crypto_pwhash_scryptsalsa208sha256_str は、 引数が範囲外の場合 (たとえば opslimit や memlimit がドキュメントに記載されている最小値を下回る場合)、 SodiumException ではなく ValueError をスローするようになりました。 libsodium の内部で失敗した場合は、これまでどおり SodiumException がスローされます。

SPL

SplObjectStorage::getHash を実装したメソッドの中では、 どの SplObjectStorage インスタンスも変更できなくなりました。 変更しようとすると、Error がスローされます。

SplFileObject::next は、先に SplFileObject::current を呼び出して行がキャッシュされている場合を除き、ストリームを進めるようになりました。 その後に SplFileObject::current を呼び出すと、 前の行ではなく新しい行を返します。

SplFileObject::fgets は、返した行を SplFileObject::current 用にキャッシュしなくなりました。 SplFileObject::current は、 SplFileObject::fgets が直前に返した行を返すのではなく、 ストリームの現在位置から読み直すようになりました。

EOF を過ぎて SplFileObject::next を呼び出しても、 SplFileObject::key が際限なく増えることはなくなりました。 SplFileObject::seek で EOF を越えて移動した場合の SplFileObject::key の値は、 SplTempFileObject の場合と同じになりました。 これまでは、両者は異なる値を返していました。

DirectoryIterator::key は intstring を、 DirectoryIterator::current は stringSplFileInfostatic を返すようになりました。

Sysvshm

shm_attach は、key 引数がプラットフォームの key_t の範囲外の場合、 切り詰めたキーをオペレーティングシステムに渡すのではなく、 ValueError をスローするようになりました。

URI

Uri\WhatWg\Url::__construct は、 URL の処理中に例外がスローされた場合、softErrors の値を保持するのではなく、空の配列に設定するようになりました。 URL の検証エラーは、これまでどおり Uri\WhatWg\InvalidUrlException::$errors プロパティから取得できます。

Uri\WhatWg\Url::__construct、 Uri\WhatWg\Url::parse、 Uri\WhatWg\Url::with*() メソッド、 Uri\WhatWg\UrlBuilder::build は、検証エラーを検出した順に報告するようになりました。 そのため、複数のエラーの順序が PHP 8.5 とは逆になります。

Zip

ZipArchive::extractTo は、files 引数の要素に文字列でないものが 1 つでもある場合、 TypeError をスローするようになりました。

ZipArchive::addGlob と ZipArchive::addPattern は、 "remove_all_path" オプションが bool 型でない場合や、"comp_method"、 "comp_flags"、"enc_method" オプションが int 型でない場合 (数値形式の文字列は変換されます)、 警告を発生させるのではなく TypeError をスローするようになりました。

ZipArchive をシリアライズまたはアンシリアライズすると、 Exception がスローされるようになりました。 サブクラスで __serialize() と __unserialize() をオーバーライドすれば、 ZipArchive::closeString と ZipArchive::openString を使って、シリアライズしたものをアンシリアライズで元に戻せます。

Zlib

deflate_init は、"level"、 "memory"、"window"、 "strategy" オプションの値が int 型でない場合、TypeError をスローするようになりました。

inflate_init は、"window" オプションの値が int 型でない場合、 TypeError をスローするようになりました。