下位互換性のない変更点
PHP コア
配列のコンパクション後の、リファレンスを使った foreach
リファレンスを使った foreach
ループが、配列のコンパクション後に、
これまでスキップされていた要素を反復処理する場合があります。
削除された要素を指している内部ポインタは、コピーオンライトの際に、
削除されていない次の要素へ移動するようになりました。
マジックプロパティに対する Null 合体演算子と empty
__isset()
がプロパティテーブルに書き込んでプロパティを実体化した場合、
マジックプロパティに対する ?? と empty は、
__get() を呼び出さなくなりました。
書き込まれたばかりの値がそのまま返されます。
プロパティに直接適用した isset は影響を受けませんが、
isset($o->p['k']) のようにネストした形は、
?? と同じように処理されます。
array_intersect での文字列への変換
array_intersect に 2 つ以上の配列を渡した場合、
値を文字列に変換するのは、ソートの比較中ではなく、
入力を走査している間になりました。
これにより、変換時の警告や
__toString() の呼び出しの回数と順序、どの変換で例外がスローされるか、状態を持つ
__toString() の実装を使った場合の結果が変わることがあります。
空の配列があるかどうかの確認や値の変換より前に引数の型を検証するようになったため、
後ろの引数が不正だと、それより前の配列の変換による副作用が起きなくなることがあります。
いずれかの入力配列が空の場合、値は変換されません。
不正な引数に対する新しいエラー
以下の関数は、不正なフラグやモードの値が渡された場合に
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"
のように前に反復指定用引数があれば影響を受けません。
新しいエンディアン修飾子
も参照ください。
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 をスローするようになりました。