diff --git a/appendices/migration86.xml b/appendices/migration86.xml
new file mode 100644
index 0000000000..cfec8f46a1
--- /dev/null
+++ b/appendices/migration86.xml
@@ -0,0 +1,58 @@
+
+
+
+
+ PHP 8.5.x から PHP 8.6.x への移行
+
+
+ この新しいマイナーバージョンには、
+ たくさんの 新機能 と
+ 互換性のない変更がいくつか
+ あります。実運用環境の PHP をこのバージョンにあげる前に、
+ これらの変更を必ずテストすべきです。
+
+
+
+ &manual.migration.seealso;
+ 7.1.x,
+ 7.2.x,
+ 7.3.x,
+ 7.4.x,
+ 8.0.x,
+ 8.1.x,
+ 8.2.x,
+ 8.3.x,
+ 8.4.x,
+ 8.5.x.
+
+
+ &appendices.migration86.new-features;
+ &appendices.migration86.new-classes;
+ &appendices.migration86.new-functions;
+ &appendices.migration86.constants;
+ &appendices.migration86.incompatible;
+ &appendices.migration86.deprecated;
+ &appendices.migration86.other-changes;
+ &appendices.migration86.windows-support;
+
+
+
diff --git a/appendices/migration86/constants.xml b/appendices/migration86/constants.xml
new file mode 100644
index 0000000000..daa32bcbd7
--- /dev/null
+++ b/appendices/migration86/constants.xml
@@ -0,0 +1,197 @@
+
+
+
+
+ 新しいグローバル定数
+
+
+ PHP コア
+
+
+
+ ARRAY_FILTER_USE_VALUE
+
+
+ STREAM_CRYPTO_STATUS_NONE
+
+
+ STREAM_CRYPTO_STATUS_WANT_READ
+
+
+ STREAM_CRYPTO_STATUS_WANT_WRITE
+
+
+
+
+
+ cURL
+
+
+
+ CURLINFO_SIZE_DELIVERED (libcurl >= 8.20.0)
+
+
+ CURLOPT_SEEKFUNCTION
+
+
+ CURL_SEEKFUNC_OK
+
+
+ CURL_SEEKFUNC_FAIL
+
+
+ CURL_SEEKFUNC_CANTSEEK
+
+
+ CURL_READFUNC_ABORT
+
+
+
+
+
+ MySQLi
+
+
+
+ MYSQLI_OPT_COMPRESS
+
+
+
+
+
+ OpenSSL
+
+
+ OPENSSL_RSA_PSS_SALTLEN_DIGEST
+ OPENSSL_RSA_PSS_SALTLEN_AUTO
+ OPENSSL_RSA_PSS_SALTLEN_MAX
+
+
+
+
+ Sockets
+
+
+
+ TCP_USER_TIMEOUT (Linuxのみ)
+
+
+ AF_UNSPEC
+
+
+ EAI_BADFLAGS
+
+
+ EAI_NONAME
+
+
+ EAI_AGAIN
+
+
+ EAI_FAIL
+
+
+ EAI_NODATA
+
+
+ EAI_FAMILY
+
+
+ EAI_SOCKTYPE
+
+
+ EAI_SERVICE
+
+
+ EAI_ADDRFAMILY
+
+
+ EAI_SYSTEM
+
+
+ EAI_OVERFLOW
+
+
+ EAI_INPROGRESS
+
+
+ EAI_CANCELED
+
+
+ EAI_NOTCANCELED
+
+
+ EAI_ALLDONE
+
+
+ EAI_INTR
+
+
+ EAI_IDN_ENCODE
+
+
+ SO_DETACH_REUSEPORT_BPF (Linuxのみ)
+
+
+
+
+
+ Sodium
+
+
+ SODIUM_CRYPTO_IPCRYPT_BYTES
+ SODIUM_CRYPTO_IPCRYPT_KEYBYTES
+ SODIUM_CRYPTO_IPCRYPT_ND_KEYBYTES
+ SODIUM_CRYPTO_IPCRYPT_ND_TWEAKBYTES
+ SODIUM_CRYPTO_IPCRYPT_ND_INPUTBYTES
+ SODIUM_CRYPTO_IPCRYPT_ND_OUTPUTBYTES
+ SODIUM_CRYPTO_IPCRYPT_NDX_KEYBYTES
+ SODIUM_CRYPTO_IPCRYPT_NDX_TWEAKBYTES
+ SODIUM_CRYPTO_IPCRYPT_NDX_INPUTBYTES
+ SODIUM_CRYPTO_IPCRYPT_NDX_OUTPUTBYTES
+ SODIUM_CRYPTO_IPCRYPT_PFX_KEYBYTES
+ SODIUM_CRYPTO_IPCRYPT_PFX_BYTES
+ SODIUM_CRYPTO_XOF_SHAKE128_BLOCKBYTES
+ SODIUM_CRYPTO_XOF_SHAKE128_STATEBYTES
+ SODIUM_CRYPTO_XOF_SHAKE256_BLOCKBYTES
+ SODIUM_CRYPTO_XOF_SHAKE256_STATEBYTES
+ SODIUM_CRYPTO_XOF_TURBOSHAKE128_BLOCKBYTES
+ SODIUM_CRYPTO_XOF_TURBOSHAKE128_STATEBYTES
+ SODIUM_CRYPTO_XOF_TURBOSHAKE256_BLOCKBYTES
+ SODIUM_CRYPTO_XOF_TURBOSHAKE256_STATEBYTES
+ SODIUM_CRYPTO_KEM_PUBLICKEYBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_SECRETKEYBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_CIPHERTEXTBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_SHAREDSECRETBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_SEEDBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_KEYPAIRBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_MLKEM768_PUBLICKEYBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_MLKEM768_SECRETKEYBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_MLKEM768_CIPHERTEXTBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_MLKEM768_SHAREDSECRETBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_MLKEM768_SEEDBYTES (libsodium >= 1.0.22)
+ SODIUM_CRYPTO_KEM_MLKEM768_KEYPAIRBYTES (libsodium >= 1.0.22)
+
+
+
+
+
diff --git a/appendices/migration86/deprecated.xml b/appendices/migration86/deprecated.xml
new file mode 100644
index 0000000000..c17fb463ce
--- /dev/null
+++ b/appendices/migration86/deprecated.xml
@@ -0,0 +1,629 @@
+
+
+
+
+ PHP 8.6.x で推奨されなくなる機能
+
+
+ PHP コア
+
+
+ "namespace" をクラス定数の名前に使う
+
+
+
+ namespace という名前の
+ クラス定数
+ を宣言することは、推奨されなくなりました。
+ namespace はクラスのメンバー名には使えるキーワードですが、
+ ::class と同様の
+ ::namespace 疑似定数など、
+ 将来導入される可能性がある構文のために、この名前は確保されることになりました。
+ namespace という名前のメソッドや static プロパティは、
+ 影響を受けません。
+ 定数名を、たとえば NAMESPACE_NAME などに変更してください。
+
+
+
+
+
+ finally ブロックから return する
+
+
+
+ &finally; ブロックの中で return 文を使うことは、
+ 推奨されなくなりました。
+ コンパイル時に、推奨されない警告が発生します。
+ このような return は、対応する
+ try や catch ブロックでスローされた例外を握りつぶしたり、
+ そこから返された値を上書きしたりするため、
+ 失敗が跡形もなく消えてしまいます。
+ 代わりに、return を finally
+ ブロックの外に移してください。同じ結果になる書き方は、必ずあります。
+
+
+
+
+
+
+
+
+
+
+
+ __debugInfo() の nullable な戻り値の型
+
+
+ __debugInfo()
+ の戻り値の型を
+ arraynull
+ と宣言することは、推奨されなくなりました。
+ このメソッドから &null; を返すことは、
+ PHP 8.5
+ で既に推奨されなくなっているため、
+ nullable な戻り値の型も、同様に正しくありません。
+ 代わりに array と宣言してください。
+
+
+
+
+
+ __construct() と __destruct() から値を返す
+
+
+
+ __construct() や
+ __destruct()
+ から値を返すことは、推奨されなくなりました。
+ コンパイル時に、推奨されない警告が発生します。
+ これらのメソッドは戻り値の型を宣言できず、
+ 通常の使い方では戻り値を受け取ることもできないため、
+ 値を返しても紛らわしいだけでした。
+ 残りの処理を飛ばすために値なしの return; を使うことは、
+ 引き続き許可されています。これらのメソッドを手動でコールすることも、同様に可能です。
+
+
+
+ 同じ理由で、yield を使って
+ __construct() や
+ __destruct() を
+ ジェネレータ
+ にすることも、推奨されなくなりました。
+
+
+
+
+
+ 関数に readonly という名前を付ける
+
+
+
+ readonly という名前の関数を宣言することは、
+ 推奨されなくなりました。
+ readonly
+ は予約語です。PHP 8.1 では、この名前を持つ既存の WordPress
+ の関数を動かし続けるためだけに、字句解析器に特例が設けられましたが、
+ PHP でこのような特別扱いを受けているキーワードは他にありません。
+ 関数の名前を変更してください。
+
+
+
+
+
+ let、is、_ を識別子として使う
+
+
+
+
+
+
+ let や is を、
+ クラス、インターフェイス、トレイト、列挙型、関数、定数
+ (define で定義するものを含む) の名前として使うことは、
+ 推奨されなくなりました。
+ class_alias のコールや、
+ use、use function、
+ use const 宣言で、
+ これらをエイリアスとして使うことも同様です。
+ これらの名前は、将来導入される可能性がある機能のためのキーワードとして確保されます。
+ let はブロックスコープ、
+ is はパターンマッチングのためのものです。
+ 影響を受けるシンボルの名前を変更してください。
+
+
+
+ PHP 8.4
+ でクラス名を _ とすることが推奨されなくなりましたが、
+ この扱いが定数にも広がりました。
+ const や define で
+ _ という名前の定数を宣言することや、
+ use 宣言でクラスや定数に
+ _ というエイリアスを付けることは、推奨されなくなりました。
+ _ という名前の関数
+ (gettext のエイリアスである
+ _ を含む) は、影響を受けません。
+
+
+
+
+
+ define() の第 3 引数
+
+
+
+ define に case_insensitive
+ 引数を渡すことは、推奨されなくなりました。
+ 大文字小文字を区別しない定数は PHP 8.0 で削除され、
+ それ以降、この引数は無視されています。
+ &false; を明示的に渡すと、推奨されない警告が発生するようになりました。
+ &true; を渡すと、これまでどおり警告が発生しますが、
+ そのメッセージに、PHP 9.0 でエラーになることが示されるようになりました。
+ この引数は省略してください。
+
+
+
+
+
+ allow_string が false の状態で is_a() と is_subclass_of() に文字列を渡す
+
+
+
+
+ allow_string が &false; の状態で
+ is_a や is_subclass_of
+ の最初の引数に文字列を渡すことは、推奨されなくなりました。
+ この場合、クラスが既に読み込まれていても、
+ これらの関数は常に &false; を返すため、
+ このようなコールはバグを示しています。
+ オートロードを発生させたくない場合は、まずオートロードを無効にして
+ class_exists で確認し、
+ その後で allow_string を &true;
+ にしてこれらの関数をコールしてください。
+
+
+
+
+
+ metaphone()
+
+
+
+ metaphone 関数は、推奨されなくなりました。
+ この関数が実装しているのは 1990 年の最初の Metaphone アルゴリズムで、
+ 英語の発音規則にしか対応しておらず、
+ 既に後継の Double Metaphone や Metaphone 3 があります。
+ 発音に基づくアルゴリズムは言語ごとに異なり、頻繁に更新されるため、
+ PHP で書かれたライブラリで提供するほうが適しています。
+ 代わりにそうしたライブラリを使ってください。
+
+
+
+
+
+ php://filter の URL で 16 を超えるフィルタを使う
+
+
+
+ filter.max_filter_count
+ ストリームコンテキストオプションを設定せずに、
+ php://filter の URL で
+ 16 を超えるフィルタを使うと、推奨されない警告が発生するようになりました。
+ 長いフィルタチェインの正当な使い道は知られていませんが、
+ ローカルファイルインクルージョンや任意のファイルの読み取りを、
+ リモートコード実行に発展させる攻撃の土台になっています。
+ filter.max_filter_count を明示的に設定した場合は、
+ 上限を超えると既にエラーになり、
+ 警告が発生してストリームのオープンに失敗します。
+
+
+
+ 上限より多くのフィルタが必要な場合は、上限のない
+ stream_filter_append や
+ stream_filter_prepend でフィルタを追加するか、
+ コンテキストオプションで上限を引き上げてください。
+ たとえば、stream_context_set_default
+ を使えば、スクリプト全体で上限を引き上げられます。
+
+
+
+
+
+ array_walk()、array_walk_recursive()、http_build_query() にオブジェクトを渡す
+
+
+
+
+ array_walk や
+ array_walk_recursive の
+ array 引数にオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ ごく一部の関数は、オブジェクトをアクセス可能なプロパティの配列として解釈してしまいます。
+ こうしたプロパティを、値をリファレンスで受け取るコールバックで変更すると、
+ readonly
+ のセマンティクスに反するうえ、列挙型の case を壊すおそれがあります。
+ また、array_walk_recursive
+ はそもそも、ネストしたオブジェクトの中までは再帰しません。
+ オブジェクトに対して get_object_vars
+ をコールし、その結果の配列を渡してください。
+
+
+
+ http_build_query の
+ data 引数にオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ data
+ の中に値として含まれるオブジェクトが配列として解釈される場合も、推奨されない警告が発生するようになりました。
+ オブジェクトを配列として扱う挙動は、たびたび混乱の元になってきました。
+ 特に Stringable なオブジェクトは、
+ 配列ではなく文字列に変換されるものとユーザーに思われがちです。
+ 関数をコールする前に、get_object_vars
+ を使って、必要なら再帰的に、オブジェクトを配列に変換してください。
+
+
+
+
+
+ is_double()、is_long()、is_integer()、doubleval()
+
+
+
+
+
+
+ PHP 8.5
+ で正規化されていない型名でのキャストが推奨されなくなったのに続き、
+ 同じ古い型名を名前に含む関数のエイリアスも、推奨されなくなりました。
+ これらは対応する正規の関数とまったく同じ動作をするので、
+ 代わりにそちらを使ってください:
+
+
+ is_double => is_float
+ is_long => is_int
+ is_integer => is_int
+ doubleval => floatval
+
+
+
+
+
+
+ strcoll() と SORT_LOCALE_STRING
+
+
+
+
+ strcoll 関数は、推奨されなくなりました。
+ この関数は、現在のロケールの LC_COLLATE
+ 設定に従って文字列を比較しますが、この設定は
+ setlocale で決まるプロセス全体の状態であり、
+ どのライブラリからでも変更できてしまいます。
+ また、他のすべての文字列比較関数とは異なり、バイナリセーフではありません。
+ さらに、正しい照合規則を実装していないロケールもあります。
+ 代わりに、正確で最新の照合規則を持つ、
+ intl 拡張モジュールの
+ Collator::compare を使ってください。
+
+
+
+ ソート関数の SORT_LOCALE_STRING フラグも、
+ strcoll を使ってソートするため、
+ 同じ理由で推奨されなくなりました。
+ 代わりに、Collator
+ クラスの以下のメソッドのいずれかを使ってください:
+
+
+ Collator::sort
+ Collator::asort
+ Collator::sortWithSortKeys
+
+
+
+
+
+
+
+
+ Bzip2
+
+
+ bzip2.compress と
+ bzip2.decompress ストリームフィルタのパラメータとしてオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ ドキュメントに記載され、サポートされているのは連想配列だけです。
+ オブジェクトに対して get_object_vars
+ をコールし、その結果の配列を渡してください。
+
+
+
+
+
+
+ GMP
+
+
+ GMP オブジェクトに対するシフト演算子
+ (<<、>>)
+ とべき乗演算子 (**) で、右オペランドが、
+ int への変換で精度が失われる float の場合、
+ 推奨されない警告が発生するようになりました。
+ 精度が失われる float から int への暗黙の変換が、
+ 言語の他の部分で推奨されなくなっているのと同様です。
+
+
+
+
+
+ MBString
+
+
+ mbregex 関数は、推奨されなくなりました。
+ 内部で使われている Oniguruma ライブラリのメンテナンスが 2025 年 4 月に終了したためです。
+ これらの関数は PHP 9.0 で削除される予定です。
+ ほとんどの用途では、u 修飾子を付けた
+ PCRE 関数で置き換えられます。
+ 影響を受ける関数は以下のとおりです:
+
+
+
+ mb_ereg
+ mb_ereg_match
+ mb_ereg_replace
+ mb_ereg_replace_callback
+ mb_ereg_search
+ mb_ereg_search_getpos
+ mb_ereg_search_getregs
+ mb_ereg_search_init
+ mb_ereg_search_pos
+ mb_ereg_search_regs
+ mb_ereg_search_setpos
+ mb_eregi
+ mb_eregi_replace
+ mb_regex_encoding
+ mb_regex_set_options
+ mb_split
+
+
+
+
+ MB_ONIGURUMA_VERSION 定数と、INI ディレクティブ
+ mbstring.regex_retry_limit、
+ mbstring.regex_stack_limit
+ も、これらの関数とあわせて推奨されなくなりました。
+
+
+
+ mb_convert_variables の
+ vars 引数にオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ オブジェクトは、アクセス可能なプロパティの配列として解釈されてしまうためです。
+ オブジェクトに対して get_object_vars
+ をコールしてください。あるいは、
+ mb_convert_encoding を使ってください。
+ この関数は配列を再帰的に変換し、引数をその場で変更せず、結果を返します。
+
+
+
+
+
+
+ MySQLi
+
+
+ mysqli_get_charset 関数と
+ mysqli::get_charset メソッドは、
+ 推奨されなくなりました。代替機能はありません。
+ これらは文字セットの内部実装の詳細を公開していますが、
+ その情報は mysqlnd に切り替わって以来、意味を持たなくなっています。
+ 特に、返される照合順序は、サーバーで定義されている照合順序と一致しません。
+ 現在の文字セットの名前を取得するには、
+ mysqli_character_set_name か
+ mysqli::character_set_name を使ってください。
+
+
+
+
+ mysqli_stmt_init 関数と
+ mysqli::stmt_init メソッドは、
+ 推奨されなくなりました。
+ これらが生成するのは、使う前にさらに準備が必要な空のステートメントオブジェクトで、
+ 一貫性のない状態のまま放置される原因になっています。
+ 代わりに、1 回のコールでステートメントを準備できる
+ mysqli_prepare か
+ mysqli::prepare を使ってください。
+ 同じ理由で、query 引数を指定せずに
+ mysqli_stmt::__construct
+ コンストラクタをコールすることも、推奨されなくなりました。
+ クエリはコンストラクタに渡してください。
+
+
+
+
+
+
+ Reflection
+
+
+ ReflectionProperty::setValue や
+ ReflectionProperty::setRawValue に、
+ そのプロパティを宣言したクラスのインスタンスではないオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ 他の ReflectionProperty
+ のメソッドはこうしたオブジェクトに対して例外をスローしますが、
+ これらのメソッドは無関係なオブジェクトにプロパティを設定してしまいます。
+ これは通常の代入と変わらないうえ、概念的にも誤っています。
+
+
+
+
+ static メソッドを呼び出すときに、
+ ReflectionMethod::invoke や
+ ReflectionMethod::invokeArgs
+ にオブジェクトを渡すことは、推奨されなくなりました。
+ static メソッドには $this がないので、
+ 渡されたオブジェクトは無視され、検証されることもありませんでした。
+ 代わりに &null; を渡してください。
+
+
+
+
+
+
+ Session
+
+
+ SessionIdInterface::create_sid と
+ SessionUpdateTimestampHandlerInterface::validateId
+ のどちらか一方でも実装していないオブジェクトを
+ session_set_save_handler に渡すことは、
+ オブジェクトがどのインターフェイスを宣言しているかにかかわらず、
+ 推奨されなくなりました。
+ session.use_strict_mode
+ が有効なときに保存ハンドラが正しく動作するには、これらのメソッドが必要です。
+ この設定はセッション固定攻撃を緩和するもので、
+ PHP 8.6
+ 以降はデフォルトで有効です。
+
+
+
+
+ これに伴い、SessionIdInterface::create_sid か
+ SessionUpdateTimestampHandlerInterface::validateId を定義せずに
+ SessionHandlerInterface を実装すると、
+ E_WARNING が発生するようになりました。
+ PHP 9.0 では、これらのメソッドは
+ SessionIdInterface と
+ SessionUpdateTimestampHandlerInterface から
+ SessionHandlerInterface
+ に移され、必須になります。
+ 独自の保存ハンドラには、今のうちに両方のメソッドを実装してください。
+
+
+
+
+
+ SPL
+
+
+ spl_classes 関数は、推奨されなくなりました。
+ このような関数を公開している拡張モジュールは他になく、
+ Reflection 拡張モジュールは常に利用できるためです。
+ 代わりに ReflectionExtension::getClassNames
+ を使ってください。
+
+
+
+
+ spl_object_hash 関数は、推奨されなくなりました。
+ PHP 8.1 以降、この関数の戻り値は
+ spl_object_id の値を整形し直しただけのものです。
+ また、値はオブジェクトの内容から導出されるものではないので、
+ 関数名は誤解を招きます。
+ 文字列という形式も間違いのもとで、
+ 2 つのハッシュがどちらも数値形式の文字列であるために、
+ 緩やかな比較で等しいと判定されることがあります。
+ 代わりに spl_object_id を使ってください。
+
+
+
+
+ 以下の ArrayIterator のメソッドは、
+ 推奨されなくなりました。
+ これらのメソッドが存在するのは、ArrayIterator
+ が ArrayObject
+ と実装を共有してきたからにすぎません。
+ その大半はイテレータにとってほとんど意味がなく、
+ イテレータの実装を最適化する妨げにもなっています。
+ 対応する ArrayObject のメソッドは対象外です。
+
+
+
+ ArrayIterator::getFlags
+ ArrayIterator::setFlags
+ ArrayIterator::asort
+ ArrayIterator::ksort
+ ArrayIterator::uasort
+ ArrayIterator::uksort
+ ArrayIterator::natsort
+ ArrayIterator::natcasesort
+ ArrayIterator::unserialize
+ ArrayIterator::serialize
+
+
+
+
+ SplFileObject の CSV 関連のメソッドは、
+ 推奨されなくなりました。
+ 以前からある設計上の不整合が名前付き引数によっていっそう表面化し、
+ メンテナンスがますます難しくなっています。
+ また、CSV の処理は本来 SplFileObject
+ の役割ではありません。
+ 代わりに、ストリームに対して fgetcsv と
+ fputcsv を使ってください。
+
+
+
+ SplFileObject::fgetcsv
+ SplFileObject::fputcsv
+ SplFileObject::setCsvControl
+ SplFileObject::getCsvControl
+
+
+
+
+
+
+ Zlib
+
+
+ zlib.deflate と zlib.inflate
+ ストリームフィルタのパラメータとしてオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ ドキュメントに記載され、サポートされているのは連想配列だけです。
+ オブジェクトに対して get_object_vars
+ をコールし、その結果の配列を渡してください。
+
+
+
+
+ deflate_init や inflate_init の
+ options 引数にオブジェクトを渡すことは、
+ 推奨されなくなりました。
+ オブジェクトは、アクセス可能なプロパティの配列として解釈されてしまうためです。
+ オブジェクトに対して get_object_vars
+ をコールし、その結果の配列を渡してください。
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/appendices/migration86/incompatible.xml b/appendices/migration86/incompatible.xml
new file mode 100644
index 0000000000..456e8c5d52
--- /dev/null
+++ b/appendices/migration86/incompatible.xml
@@ -0,0 +1,916 @@
+
+
+
+
+ 下位互換性のない変更点
+
+
+ PHP コア
+
+
+ 配列のコンパクション後の、リファレンスを使った foreach
+
+
+ リファレンスを使った foreach
+ ループが、配列のコンパクション後に、
+ これまでスキップされていた要素を反復処理する場合があります。
+ 削除された要素を指している内部ポインタは、コピーオンライトの際に、
+ 削除されていない次の要素へ移動するようになりました。
+
+
+
+
+
+ マジックプロパティに対する Null 合体演算子と empty
+
+
+ __isset()
+ がプロパティテーブルに書き込んでプロパティを実体化した場合、
+ マジックプロパティに対する ?? と empty は、
+ __get() を呼び出さなくなりました。
+ 書き込まれたばかりの値がそのまま返されます。
+ プロパティに直接適用した isset は影響を受けませんが、
+ isset($o->p['k']) のようにネストした形は、
+ ?? と同じように処理されます。
+
+
+
+
+$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) も取り除くようになりました。
+
+
+
+
+
+
+
+
+
+
+
+
+ 不正な引数に対する新しいエラー
+
+
+ 以下の関数は、不正なフラグやモードの値が渡された場合に
+ 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"
+ のように前に反復指定用引数があれば影響を受けません。
+ 新しいエンディアン修飾子
+ も参照ください。
+
+
+
+
+
+ 1]
+// PHP 8.6.0 より前のバージョン: [" 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 をスローするようになりました。
+
+
+
+
+
+
diff --git a/appendices/migration86/new-classes.xml b/appendices/migration86/new-classes.xml
new file mode 100644
index 0000000000..6128e9bbae
--- /dev/null
+++ b/appendices/migration86/new-classes.xml
@@ -0,0 +1,117 @@
+
+
+
+
+ 新しいクラスとインターフェイス
+
+
+ PHP コア
+
+ SortDirection
+ StreamError
+ StreamException
+ StreamErrorStore
+ StreamErrorMode
+ StreamErrorCode
+ Io\IoException
+ Io\Poll\Context
+ Io\Poll\Watcher
+ Io\Poll\Backend
+ Io\Poll\Event
+ Io\Poll\Handle
+ Io\Poll\PollException
+ Io\Poll\FailedPollOperationException
+ Io\Poll\FailedContextInitializationException
+ Io\Poll\FailedHandleAddException
+ Io\Poll\FailedWatcherModificationException
+ Io\Poll\FailedPollWaitException
+ Io\Poll\BackendUnavailableException
+ Io\Poll\InactiveWatcherException
+ Io\Poll\HandleAlreadyWatchedException
+ Io\Poll\InvalidHandleException
+ StreamPollHandle
+
+
+
+
+
+
+
+ Date
+
+ Time\Duration
+ Time\TimeException
+
+
+
+
+
+ Intl
+
+ IntlNumberRangeFormatter
+
+
+
+
+ OpenSSL
+
+ Openssl\OpensslException
+ Openssl\Session
+ Openssl\Psk
+
+
+
+
+
+ SNMP
+
+ Snmp\Mib
+ Snmp\OidOutput
+ Snmp\Output
+ Snmp\StringOutput
+
+
+
+
+
+ Sodium
+
+ SodiumCryptoXofShake128State
+ SodiumCryptoXofShake256State
+ SodiumCryptoXofTurboshake128State
+ SodiumCryptoXofTurboshake256State
+
+
+
+
+ URI
+
+ Uri\Rfc3986\UriBuilder
+ Uri\WhatWg\UrlBuilder
+ Uri\WhatWg\UrlPercentEncodingMode
+
+
+
+
+
+
+
diff --git a/appendices/migration86/new-features.xml b/appendices/migration86/new-features.xml
new file mode 100644
index 0000000000..1276476ec6
--- /dev/null
+++ b/appendices/migration86/new-features.xml
@@ -0,0 +1,712 @@
+
+
+
+
+ 新機能
+
+
+ PHP コア
+
+
+ 読み取り専用プロパティのデフォルト値
+
+
+ 読み取り専用プロパティ
+ に、デフォルト値を宣言できるようになりました。
+
+
+
+
+
+timeout); // int(30)
+]]>
+
+
+
+
+
+
+ WeakMap での参照による代入
+
+
+ WeakMap で、事前にキーが存在していなくても、
+ 参照による代入を使えるようになりました。
+
+
+
+
+
+
+
+
+
+
+
+ 列挙型での __debugInfo
+
+
+ __debugInfo()
+ マジックメソッドを、列挙型
+ に定義できるようになりました。
+ これより前のバージョンでは、致命的なエラーになっていました。
+
+
+
+
+
+ $this->name, 'symbol' => $this->value];
+ }
+}
+
+var_dump(Suit::Hearts);
+]]>
+
+ &example.outputs;
+
+
+ string(6) "Hearts"
+ ["symbol"]=>
+ string(1) "H"
+}
+]]>
+
+
+
+
+
+
+ クラス定数に対する #[\Override] 指定
+
+
+ Override アトリビュートを、
+ 列挙型の case を含むクラス定数に指定できるようになりました。
+ メソッドやプロパティと同様に、親クラスや実装しているインターフェイスに
+ 対応する定数が存在しない場合、コンパイル時エラーが発生します。
+
+
+
+
+
+
+
+
+
+
+
+
+ 関数の部分適用
+
+
+ 関数の部分適用がサポートされました。
+ 1 つ以上の引数を ? プレースホルダに、または残りの引数を
+ ... プレースホルダに置き換えて呼び出すと、足りない引数を受け取る
+ Closure が作成されます。
+
+
+
+
+
+
+
+
+
+
+
+
+ 定数に格納されたオブジェクトの変更
+
+
+ 定数やクラス定数に格納されたオブジェクトを、
+ OBJ->prop = $val で直接変更できるようになりました。
+
+
+
+
+
+debug = true;
+
+var_dump(CONFIG->debug); // bool(true)
+]]>
+
+
+
+
+
+
+ pack() と unpack() のエンディアン修飾子
+
+
+ pack と unpack が、
+ < (リトルエンディアン) と >
+ (ビッグエンディアン) の修飾子を受け付けるようになりました。
+ この修飾子は、整数のフォーマットコード s、S、
+ l、L、q、
+ Q の後と、float と double のフォーマットコード
+ f、d の後に指定できます。
+
+
+
+
+
+
+', 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 がスローされます。
+
+
+
+
+add(\Time\Duration::fromMilliseconds(500));
+
+printf("%d.%09d seconds\n", $timeout->seconds, $timeout->nanoseconds);
+var_dump($timeout > \Time\Duration::fromSeconds(2));
+]]>
+
+ &example.outputs;
+
+
+
+
+
+
+
+
+ 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 が追加されました。
+
+
+
+
+
+
+
diff --git a/appendices/migration86/new-functions.xml b/appendices/migration86/new-functions.xml
new file mode 100644
index 0000000000..75c6044c22
--- /dev/null
+++ b/appendices/migration86/new-functions.xml
@@ -0,0 +1,247 @@
+
+
+
+
+ 新しく追加された関数
+
+
+ PHP コア
+
+
+
+
+ clamp は、値が範囲内ならその値を、範囲外なら近いほうの境界値を返します。
+
+
+ stream_last_errors
+ stream_clear_errors
+ stream_socket_get_crypto_status
+
+
+
+
+ GMP
+
+
+ gmp_powm_sec
+ gmp_prevprime
+
+
+
+
+ Intl
+
+
+
+ grapheme_strrev
+
+ IntlDatePatternGenerator::getSkeleton
+
+
+ IntlDatePatternGenerator::getBaseSkeleton
+
+
+
+ Locale::getDisplayKeyword
+
+ locale_get_display_keyword
+
+ Locale::getDisplayKeywordValue
+
+ locale_get_display_keyword_value
+
+ SpoofChecker::areBidiConfusable
+
+
+ SpoofChecker::getBidiSkeleton
+
+
+ SpoofChecker::getSkeleton
+
+
+
+
+
+ MySQLi
+
+
+
+
+ mysqli::quote_string
+
+ mysqli_quote_string
+
+
+
+
+ Reflection
+
+
+
+ ReflectionAttribute::inNamespace
+
+
+ ReflectionAttribute::getNamespaceName
+
+
+ ReflectionAttribute::getShortName
+
+
+ ReflectionConstant::inNamespace
+
+
+
+ ReflectionParameter::getDocComment
+
+
+
+ ReflectionProperty::isReadable
+
+
+ ReflectionProperty::isWritable
+
+
+
+
+
+ SNMP
+
+
+
+ snmp_init_mib
+ snmp_set_mib_option
+ snmp_set_output_option
+ snmp_set_string_output_format
+
+ SNMP::setOidOutputFormat
+
+
+ SNMP::setStringOutputFormat
+
+
+
+
+
+ Sodium
+
+
+ sodium_crypto_ipcrypt_keygen
+ sodium_crypto_ipcrypt_encrypt
+ sodium_crypto_ipcrypt_decrypt
+ sodium_crypto_ipcrypt_nd_keygen
+ sodium_crypto_ipcrypt_nd_encrypt
+ sodium_crypto_ipcrypt_nd_decrypt
+ sodium_crypto_ipcrypt_ndx_keygen
+ sodium_crypto_ipcrypt_ndx_encrypt
+ sodium_crypto_ipcrypt_ndx_decrypt
+ sodium_crypto_ipcrypt_pfx_keygen
+ sodium_crypto_ipcrypt_pfx_encrypt
+ sodium_crypto_ipcrypt_pfx_decrypt
+ sodium_bin2ip
+ sodium_ip2bin
+ sodium_crypto_xof_shake128
+ sodium_crypto_xof_shake128_init
+ sodium_crypto_xof_shake128_update
+ sodium_crypto_xof_shake128_squeeze
+ sodium_crypto_xof_shake256
+ sodium_crypto_xof_shake256_init
+ sodium_crypto_xof_shake256_update
+ sodium_crypto_xof_shake256_squeeze
+ sodium_crypto_xof_turboshake128
+ sodium_crypto_xof_turboshake128_init
+ sodium_crypto_xof_turboshake128_update
+ sodium_crypto_xof_turboshake128_squeeze
+ sodium_crypto_xof_turboshake256
+ sodium_crypto_xof_turboshake256_init
+ sodium_crypto_xof_turboshake256_update
+ sodium_crypto_xof_turboshake256_squeeze
+
+
+
+ 以下の関数は、X-Wing KEM
+ (ML-KEM768+X25519 のハイブリッドで、libsodium が推奨する KEM) を提供します。
+ libsodium 1.0.22 以降を使って PHP をビルドした場合に利用できます。
+
+
+ sodium_crypto_kem_keypair
+ sodium_crypto_kem_seed_keypair
+ sodium_crypto_kem_secretkey
+ sodium_crypto_kem_publickey
+ sodium_crypto_kem_enc
+ sodium_crypto_kem_dec
+
+
+
+
+ 以下の関数は、ML-KEM768 (FIPS 203)
+ KEM を提供します。
+ libsodium 1.0.22 以降を使って PHP をビルドした場合に利用できます。
+
+
+ sodium_crypto_kem_mlkem768_keypair
+ sodium_crypto_kem_mlkem768_seed_keypair
+ sodium_crypto_kem_mlkem768_secretkey
+ sodium_crypto_kem_mlkem768_publickey
+ sodium_crypto_kem_mlkem768_enc
+ sodium_crypto_kem_mlkem768_dec
+
+
+
+
+
+ URI
+
+
+
+
+ Uri\Rfc3986\Uri::getUriType
+
+
+ Uri\WhatWg\Url::isSpecialScheme
+
+
+
+ Uri\Rfc3986\Uri::getHostType
+
+
+ Uri\WhatWg\Url::getHostType
+
+
+ Uri\WhatWg\url_percent_encode
+
+
+
+
+ Zip
+
+
+
+ ZipArchive::openString
+
+
+ ZipArchive::closeString
+
+
+
+
+
+
diff --git a/appendices/migration86/other-changes.xml b/appendices/migration86/other-changes.xml
new file mode 100644
index 0000000000..0ad3cf3802
--- /dev/null
+++ b/appendices/migration86/other-changes.xml
@@ -0,0 +1,588 @@
+
+
+
+
+ その他の変更
+
+
+ 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
+ で文字列をコピーしなくなりました。
+
+
+
+
+
+
+
+
diff --git a/appendices/migration86/windows-support.xml b/appendices/migration86/windows-support.xml
new file mode 100644
index 0000000000..d08328bd9f
--- /dev/null
+++ b/appendices/migration86/windows-support.xml
@@ -0,0 +1,60 @@
+
+
+
+
+ Windows のサポート
+
+
+ PHP コア
+
+
+ 公式の Windows ビルドには、Visual Studio 2026 (VS18) が使われるようになりました。
+
+
+
+
+
+ LibXML
+
+
+ 公式の Windows ビルドで使われている libxml2 ライブラリが、
+ バージョン 2.15.3 に更新されました。
+ その結果、ローカルファイルから読み込んだドキュメントの
+ DOMDocument::$documentURI には、
+ file URI ではなく、
+ ネイティブのファイルシステムパスが入るようになりました。
+
+
+
+
+
+ OpenSSL
+
+
+ 公式の Windows ビルドで使われている OpenSSL ライブラリが、
+ OpenSSL 4 に更新されました。
+
+
+
+
+
+
diff --git a/reference/pdo_pgsql/reference.xml b/reference/pdo_pgsql/reference.xml
index 72fcbd34d5..317bcc73f5 100644
--- a/reference/pdo_pgsql/reference.xml
+++ b/reference/pdo_pgsql/reference.xml
@@ -1,6 +1,6 @@
-
+
@@ -39,6 +39,14 @@
ラージオブジェクト (LOB) を参照ください。
+
+
+ PHP 8.6.0 以降、持続的接続を使う PDO
+ オブジェクトがすべて破棄されると、SET
+ で変更した設定や一時テーブルなどのセッションの状態がリセットされます。
+ PREPARE 文で作成したステートメントは残ります。
+
+