diff --git a/appendices/migration85.xml b/appendices/migration85.xml
new file mode 100644
index 0000000000..5cf9eed78c
--- /dev/null
+++ b/appendices/migration85.xml
@@ -0,0 +1,55 @@
+
+
+ PHP 8.4.x から PHP 8.5.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.
+
+
+ &appendices.migration85.new-features;
+ &appendices.migration85.new-classes;
+ &appendices.migration85.new-functions;
+ &appendices.migration85.constants;
+ &appendices.migration85.incompatible;
+ &appendices.migration85.deprecated;
+ &appendices.migration85.other-changes;
+ &appendices.migration85.windows-support;
+
+
+
diff --git a/appendices/migration85/constants.xml b/appendices/migration85/constants.xml
new file mode 100644
index 0000000000..a6f96396c2
--- /dev/null
+++ b/appendices/migration85/constants.xml
@@ -0,0 +1,190 @@
+
+
+ 新しいグローバル定数
+
+
+ PHP コア
+
+
+
+ PHP_BUILD_DATE
+
+
+ PHP_BUILD_PROVIDER
+
+
+
+
+
+ cURL
+
+
+
+ CURLINFO_USED_PROXY
+
+
+ CURLINFO_HTTPAUTH_USED
+
+
+ CURLINFO_PROXYAUTH_USED
+
+
+ CURLINFO_CONN_ID
+
+
+ CURLINFO_QUEUE_TIME_T
+
+
+ CURLOPT_INFILESIZE_LARGE
+
+
+ CURLFOLLOW_ALL
+
+
+ CURLFOLLOW_OBEYCODE
+
+
+ CURLFOLLOW_FIRSTONLY
+
+
+
+
+
+ Filter
+
+
+
+ FILTER_THROW_ON_FAILURE
+
+
+
+
+
+ Intl
+
+
+
+ DECIMAL_COMPACT_SHORT
+
+
+ DECIMAL_COMPACT_LONG
+
+
+
+
+
+ OpenSSL
+
+
+ OPENSSL_PKCS1_PSS_PADDING
+ PKCS7_NOSMIMECAP
+ PKCS7_CRLFEOL
+ PKCS7_NOCRL
+ PKCS7_NO_DUAL_CONTENT
+
+
+
+
+ POSIX
+
+
+ POSIX_SC_OPEN_MAX
+
+
+
+
+ Sockets
+
+
+
+ IPPROTO_ICMP
+
+
+ IPPROTO_ICMPV6
+
+
+ TCP_FUNCTION_BLK (FreeBSD only)
+
+
+ TCP_FUNCTION_ALIAS (FreeBSD only)
+
+
+ TCP_REUSPORT_LB_NUMA (FreeBSD only)
+
+
+ TCP_REUSPORT_LB_NUMA_NODOM (FreeBSD only)
+
+
+ TCP_REUSPORT_LB_NUMA_CURDOM (FreeBSD only)
+
+
+ TCP_BBR_ALGORITHM (FreeBSD only)
+
+
+ AF_PACKET (Linux only)
+
+
+ IP_BINDANY (FreeBSD/NetBSD/OpenBSD only)
+
+
+ SO_BUSY_POLL (Linux only)
+
+
+ UDP_SEGMENT (Linux only)
+
+
+ SHUT_RD
+
+
+ SHUT_WR
+
+
+ SHUT_RDWR
+
+
+
+
+
+ Tokenizer
+
+
+ T_VOID_CAST
+
+
+ T_PIPE
+
+
+
+
+
+ Standard
+
+
+
+ IMAGETYPE_SVG
+ when libxml is loaded.
+
+
+
+
+
+
diff --git a/appendices/migration85/deprecated.xml b/appendices/migration85/deprecated.xml
new file mode 100644
index 0000000000..59a0ad9fd5
--- /dev/null
+++ b/appendices/migration85/deprecated.xml
@@ -0,0 +1,575 @@
+
+
+ PHP 8.5.x で推奨されなくなる機能
+
+
+ PHP コア
+
+
+ ユーザー定義の出力ハンドラに関する変更
+
+
+
+ ユーザー定義の出力ハンドラから文字列でない値を返すことは、
+ 推奨されなくなりました。
+ この推奨されない警告が表示されることを保証するため、
+ 不正な戻り値を持つハンドラはバイパスされます。
+ つまり、ネストされた出力ハンドラが存在する場合、
+ 次のハンドラは引き続き使われるということです。
+
+
+
+ ユーザー定義の出力ハンドラから(たとえば echo
+ などを使って) 出力を行うことは、推奨されなくなりました。
+ この推奨されない警告は、
+ 出力を生成するハンドラをバイパスして、
+ それが確実に表示されるようにします。
+ つまり、ネストされた出力ハンドラが存在する場合、
+ 次のハンドラは引き続き使われるということです。
+ ユーザー定義の出力ハンドラが文字列でない値を返し、
+ かつ出力を生成する場合、出力を行ったことに関する警告が最初に発生します。
+
+
+
+
+
+ 正規化されていない型名でのキャスト
+
+
+
+ 正規化されていない型名
+ (boolean),
+ (integer),
+ (double),
+ (binary) でキャストすることは、
+ 推奨されなくなりました。
+ (bool), (int),
+ (float), (string)
+ をそれぞれ使ってください。
+
+
+
+
+
+ セミコロンでcase文を終了させる
+
+
+
+ case文をコロンではなく、セミコロンで終了させることは、
+ 推奨されなくなりました。
+
+
+
+
+
+ バッククォート演算子
+
+
+
+ shell_exec
+ のエイリアスとして使われている
+ バッククォート演算子
+ は、推奨されなくなりました。
+
+
+
+
+
+ __debugInfo() から null を返す
+
+
+
+ __debugInfo()
+ から &null; を返すことは、推奨されなくなりました。
+ 空の配列を返してください。
+
+
+
+
+
+ report_memleaks INI ディレクティブ
+
+
+
+ INI ディレクティブ
+ report_memleaks は、
+ 推奨されなくなりました。
+
+
+
+
+
+ 定数の再宣言
+
+
+
+ 同じ定数を再宣言することは、推奨されなくなりました。
+ これについては既に警告は発生しており、
+ (警告の種類が変わるだけで)それが続くことに注意してください。
+
+
+
+
+
+ クロージャのバインド時の問題
+
+
+
+ 既に E_WARNING が発生している、
+ クロージャのバインド時の以下の問題は、推奨されなくなりました:
+
+
+ インスタンスを static なクロージャにバインドすること
+ メソッドが定義されているクラス(またはサブクラス)のインスタンスでないオブジェクトに、メソッドをバインドすること
+ メソッドから $this のバインドを解除すること
+ `$this` を使っているクロージャから、$this のバインドを解除すること
+ 内部クラスのスコープにクロージャをバインドすること
+ 関数やメソッドから生成したクロージャのスコープを、再度バインドすること
+
+
+
+
+
+
+ マジックメソッド __sleep() と __wakeup()
+
+
+
+
+ マジックメソッド __sleep() と
+ __wakeup() は、
+ soft-deprecated 扱いになりました。
+ 代わりに、__serialize() と
+ __unserialize() を使ってください。
+ PHP 7 との互換性が必要な場合は、両方を同時に使ってください。
+
+
+
+
+
+ 配列のオフセットに null を指定
+
+
+
+ 配列のオフセットに &null; を指定したり、
+ array_key_exists をコールする際に &null; を指定することは、
+ 推奨されなくなりました。
+ 代わりに、空文字列を使ってください。
+
+
+
+
+
+ 数値でない文字列をインクリメント
+
+
+
+ 数値でない文字列をインクリメントすることは、推奨されなくなりました。
+ str_increment を代わりに使ってください。
+
+
+
+
+
+ register_argc_argv INI ディレクティブ
+
+
+
+ CLI でない SAPI において、
+ クエリ文字列から $_SERVER['argc'] と
+ $_SERVER['argv'] の値を取得する機能は、
+ 推奨されなくなりました。
+ 安全な使い方を検証した上で register_argc_argv=0
+ を設定し、情報を取得する手段を $_GET や
+ $_SERVER['QUERY_STRING'] に切り替えてください。
+
+
+
+
+
+
+
+ cURL
+
+
+ curl_close 関数は、推奨されなくなりました。
+ CurlHandle オブジェクトが、
+ 自動でリソースを開放するためです。
+
+
+
+
+ curl_share_close 関数は、推奨されなくなりました。
+ CurlShareHandle オブジェクトが、
+ 自動でリソースを開放するためです。
+
+
+
+
+
+
+ Date
+
+
+ 定数 DATE_RFC7231 と
+ DateTimeInterface::RFC7231
+ は、推奨されなくなりました。
+ これらに関連付けられているタイムゾーンは無視され、
+ 常に GMT を使っているためです。
+
+
+
+
+
+
+ FileInfo
+
+
+ finfo_close 関数は、推奨されなくなりました。
+ finfo オブジェクトが、
+ 自動でリソースを開放するためです。
+
+
+
+
+ finfo_buffer 関数の $context
+ パラメータは、推奨されなくなりました。
+ このパラメータは無視されているためです。
+
+
+
+
+
+
+ GD
+
+
+ imagedestroy 関数は、推奨されなくなりました。
+ GdImage オブジェクトが、
+ 自動でリソースを開放するためです。
+
+
+
+
+
+
+ Hash
+
+
+ MHASH_* 定数は、
+ 推奨されなくなりました。
+
+
+
+
+
+
+ Intl
+
+
+ INI ディレクティブ
+ intl.error_level は、
+ 推奨されなくなりました。
+ エラーは手動でチェックするか、
+ INI ディレクティブ
+ intl.use_exceptions
+ を使って例外を有効にすべきです。
+
+
+
+
+
+
+ LDAP
+
+
+ 特定の Oracle Instant Client の呼び出しや定数は、
+ 推奨されなくなりました。
+
+ 影響を受ける呼び出しは以下の通りです:
+
+ wallet のサポートを使った ldap_connect
+ ldap_connect_wallet
+
+
+ 影響を受ける定数は以下の通りです:
+
+ GSLC_SSL_NO_UATH
+ GSLC_SSL_ONEWAY_UATH
+ GSLC_SSL_TWOWAY_UATH
+
+
+
+
+
+
+
+ MySQLi
+
+
+ エイリアスとして定義されている
+ mysqli_execute 関数は、
+ 推奨されなくなりました。
+ 代わりに mysqli_stmt_execute を使いましょう。
+
+
+
+
+
+
+ OpenSSL
+
+
+ openssl_pkey_derive の $key_length
+ パラメータは、推奨されなくなりました。
+ このパラメータは無視されているか、キーを切り捨てるかしており、
+ それらの挙動がセキュリティ上の脆弱性になりうるためです。
+
+
+
+
+
+
+ PDO
+
+
+ "uri:" DSN スキームは、推奨されなくなりました。
+ リモートURI から生じる、DSN に関するセキュリティ上の懸念があるためです。
+
+
+
+
+ PDO クラスのドライバ特有の定数は、推奨されなくなりました。
+ 影響を受ける定数と、代替は以下のとおりです:
+
+
+ PDO::DBLIB_ATTR_CONNECTION_TIMEOUT => Pdo\Dblib::ATTR_CONNECTION_TIMEOUT
+ PDO::DBLIB_ATTR_QUERY_TIMEOUT => Pdo\Dblib::ATTR_QUERY_TIMEOUT
+ PDO::DBLIB_ATTR_STRINGIFY_UNIQUEIDENTIFIER => Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER
+ PDO::DBLIB_ATTR_VERSION => Pdo\Dblib::ATTR_VERSION
+ PDO::DBLIB_ATTR_TDS_VERSION => Pdo\Dblib::ATTR_TDS_VERSION
+ PDO::DBLIB_ATTR_SKIP_EMPTY_ROWSETS => Pdo\Dblib::ATTR_SKIP_EMPTY_ROWSETS
+ PDO::DBLIB_ATTR_DATETIME_CONVERT => Pdo\Dblib::ATTR_DATETIME_CONVERT
+ PDO::FB_ATTR_DATE_FORMAT => Pdo\Firebird::ATTR_DATE_FORMAT
+ PDO::FB_ATTR_TIME_FORMAT => Pdo\Firebird::ATTR_TIME_FORMAT
+ PDO::FB_ATTR_TIMESTAMP_FORMAT => Pdo\Firebird::ATTR_TIMESTAMP_FORMAT
+ PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => Pdo\Mysql::ATTR_USE_BUFFERED_QUERY
+ PDO::MYSQL_ATTR_LOCAL_INFILE => Pdo\Mysql::ATTR_LOCAL_INFILE
+ PDO::MYSQL_ATTR_LOCAL_INFILE_DIRECTORY => Pdo\Mysql::ATTR_LOCAL_INFILE_DIRECTORY
+ PDO::MYSQL_ATTR_INIT_COMMAND => Pdo\Mysql::ATTR_INIT_COMMAND
+ PDO::MYSQL_ATTR_MAX_BUFFER_SIZE => Pdo\Mysql::ATTR_MAX_BUFFER_SIZE
+ PDO::MYSQL_ATTR_READ_DEFAULT_FILE => Pdo\Mysql::ATTR_READ_DEFAULT_FILE
+ PDO::MYSQL_ATTR_READ_DEFAULT_GROUP => Pdo\Mysql::ATTR_READ_DEFAULT_GROUP
+ PDO::MYSQL_ATTR_COMPRESS => Pdo\Mysql::ATTR_COMPRESS
+ PDO::MYSQL_ATTR_DIRECT_QUERY => Pdo\Mysql::ATTR_DIRECT_QUERY
+ PDO::MYSQL_ATTR_FOUND_ROWS => Pdo\Mysql::ATTR_FOUND_ROWS
+ PDO::MYSQL_ATTR_IGNORE_SPACE => Pdo\Mysql::ATTR_IGNORE_SPACE
+ PDO::MYSQL_ATTR_SSL_KEY => Pdo\Mysql::ATTR_SSL_KEY
+ PDO::MYSQL_ATTR_SSL_CERT => Pdo\Mysql::ATTR_SSL_CERT
+ PDO::MYSQL_ATTR_SSL_CA => Pdo\Mysql::ATTR_SSL_CA
+ PDO::MYSQL_ATTR_SSL_CAPATH => Pdo\Mysql::ATTR_SSL_CAPATH
+ PDO::MYSQL_ATTR_SSL_CIPHER => Pdo\Mysql::ATTR_SSL_CIPHER
+ PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT
+ PDO::MYSQL_ATTR_SERVER_PUBLIC_KEY => Pdo\Mysql::ATTR_SERVER_PUBLIC_KEY
+ PDO::MYSQL_ATTR_MULTI_STATEMENTS => Pdo\Mysql::ATTR_MULTI_STATEMENTS
+ PDO::ODBC_ATTR_USE_CURSOR_LIBRARY => Pdo\Odbc::ATTR_USE_CURSOR_LIBRARY
+ PDO::ODBC_ATTR_ASSUME_UTF8 => Pdo\Odbc::ATTR_ASSUME_UTF8
+ PDO::ODBC_SQL_USE_IF_NEEDED => Pdo\Odbc::SQL_USE_IF_NEEDED
+ PDO::ODBC_SQL_USE_DRIVER => Pdo\Odbc::SQL_USE_DRIVER
+ PDO::ODBC_SQL_USE_ODBC => Pdo\Odbc::SQL_USE_ODBC
+ PDO::PGSQL_ATTR_DISABLE_PREPARES => Pdo\Pgsql::ATTR_DISABLE_PREPARES
+ PDO::SQLITE_ATTR_EXTENDED_RESULT_CODES => Pdo\Sqlite::ATTR_EXTENDED_RESULT_CODES
+ PDO::SQLITE_ATTR_OPEN_FLAGS => Pdo\Sqlite::OPEN_FLAGS
+ PDO::SQLITE_ATTR_READONLY_STATEMENT => Pdo\Sqlite::ATTR_READONLY_STATEMENT
+ PDO::SQLITE_DETERMINISTIC => Pdo\Sqlite::DETERMINISTIC
+ PDO::SQLITE_OPEN_READONLY => Pdo\Sqlite::OPEN_READONLY
+ PDO::SQLITE_OPEN_READWRITE => Pdo\Sqlite::OPEN_READWRITE
+ PDO::SQLITE_OPEN_CREATE => Pdo\Sqlite::OPEN_CREATE
+
+
+
+
+
+ PDO クラスのドライバ特有のメソッドは、推奨されなくなりました。
+ 影響を受けるメソッドと、代替は以下のとおりです:
+
+
+ PDO::pgsqlCopyFromArray => Pdo\Pgsql::copyFromArray
+ PDO::pgsqlCopyFromFile => Pdo\Pgsql::copyFromFile
+ PDO::pgsqlCopyToArray => Pdo\Pgsql::copyToArray
+ PDO::pgsqlCopyToFile => Pdo\Pgsql::copyToFile
+ PDO::pgsqlGetNotify => Pdo\Pgsql::getNotify
+ PDO::pgsqlGetPid => Pdo\Pgsql::getPid
+ PDO::pgsqlLOBCreate => Pdo\Pgsql::lobCreate
+ PDO::pgsqlLOBOpen => Pdo\Pgsql::lobOpen
+ PDO::pgsqlLOBUnlink => Pdo\Pgsql::lobUnlink
+ PDO::sqliteCreateAggregate => Pdo\Sqlite::createAggregate
+ PDO::sqliteCreateCollation => Pdo\Sqlite::createCollation
+ PDO::sqliteCreateFunction => Pdo\Sqlite::createFunction
+
+
+
+
+
+
+
+ PDO_PGSQL
+
+
+ トランザクションの状態に関連する以下の定数は、推奨されなくなりました。
+ この機能は PDO で利用できなくなっているからです:
+
+
+ PDO::PGSQL_TRANSACTION_IDLE
+ PDO::PGSQL_TRANSACTION_ACTIVE
+ PDO::PGSQL_TRANSACTION_INTRANS
+ PDO::PGSQL_TRANSACTION_INERROR
+ PDO::PGSQL_TRANSACTION_UNKNOWN
+
+
+
+
+
+
+
+ Reflection
+
+
+ リフレクション関連の様々な setAccessible() メソッドは、
+ 推奨されなくなりました。
+ 使っても効果がないためです。
+
+
+
+
+ 存在しない定数に対して、
+ ReflectionClass::getConstant
+ をコールすることは、推奨されなくなりました。
+
+
+
+
+ デフォルト値が存在しないプロパティに対して、
+ ReflectionProperty::getDefaultValue
+ をコールすることは、推奨されなくなりました。
+
+
+
+
+
+
+ SPL
+
+
+ spl_autoload_call を
+ spl_autoload_unregister
+ のコールバック引数に渡すことで、
+ すべての autoload の登録を解除することは、推奨されなくなりました。
+ 代わりに、spl_autoload_functions
+ の戻り値を反復処理し、
+ それぞれの値に対して spl_autoload_unregister
+ をコールする必要があります。
+
+
+
+
+ SplObjectStorage::contains,
+ SplObjectStorage::attach,
+ SplObjectStorage::detach
+ は、推奨されなくなりました。
+ SplObjectStorage::offsetExists,
+ SplObjectStorage::offsetSet,
+ SplObjectStorage::offsetUnset
+ をそれぞれ使ってください。
+
+
+
+
+ オブジェクトと一緒に
+ ArrayObject と
+ ArrayIterator を使うことは、
+ 推奨されなくなりました。
+
+
+
+
+
+
+ Standard
+
+
+ エイリアスとして定義されている
+ socket_set_timeout 関数は、
+ 推奨されなくなりました。
+ 代わりに stream_set_timeout を使いましょう。
+
+
+
+
+ 最後にオープンしたディレクトリを使う目的で、
+ readdir,
+ rewinddir,
+ closedir に &null; を渡すことは、
+ 推奨されなくなりました。
+ 最後にオープンしたディレクトリを明示的に指定してください。
+
+
+
+
+ chr に、
+ 区間 [0, 255] の範囲にない数値を指定することは、
+ 推奨されなくなりました。
+ 1バイトのデータは、この範囲でのみ保持できるからです。
+
+
+
+
+ シングルバイトでない文字列を ord に渡すことは、
+ 推奨されなくなりました。
+ こうすることは、バグであることを示唆しています。
+
+
+
+
+ ローカルで事前に定義済みの変数
+ $http_response_header
+ は、推奨されなくなりました。代わりに、
+ http_get_last_response_headers をコールすべきです。
+
+
+
+
+
+
+ XML
+
+
+ xml_parser_free 関数は、推奨されなくなりました。
+ XMLParser オブジェクトが、
+ 自動でリソースを開放するためです。
+
+
+
+
+
+
+
diff --git a/appendices/migration85/incompatible.xml b/appendices/migration85/incompatible.xml
new file mode 100644
index 0000000000..4c93e42512
--- /dev/null
+++ b/appendices/migration85/incompatible.xml
@@ -0,0 +1,503 @@
+
+
+ 下位互換性のない変更点
+
+
+ PHP コア
+
+
+ クラスの別名に <literal>"array"</literal> と <literal>"callable"</literal> を使う
+
+
+ class_alias では、
+ クラスのエイリアス名として、"array"
+ と "callable" を指定できなくなりました。
+
+
+
+
+
+ 比較できないオブジェクトと == で比較する
+
+
+ 比較できないオブジェクト
+ (例: 列挙型, CurlHandle,
+ その他の内部クラス) を boolean と比較した場合の振る舞いは、
+ 以前のバージョンでは一貫性がありませんでした。
+ boolean リテラルと $object == true
+ のように比較した場合、(bool)$object
+ と同じ振る舞いをしていました。
+ 静的に不明な値と $object == $true
+ のように比較した場合、常に &false; を返していました。
+ これらの振る舞いが、常に (bool)$object
+ に従うように統一されました。
+
+
+
+
+
+ gc_collect_cycles の戻り値
+
+
+ gc_collect_cycles の戻り値には、
+ 間接的に収集されたリソースや文字列が含まれなくなりました。
+
+
+
+
+
+ final 指定のサブクラスでの static キーワードの置き換え
+
+
+ final を指定したサブクラスにおける、
+ メソッドの戻り値 static は、
+ self または具象クラスに置き換えられるようになりました。
+
+
+
+
+
+
+
+ tick ハンドラ
+
+
+ tick ハンドラは、
+ すべてのシャットダウン関数とデストラクタが実行され、
+ 出力ハンドラがクリーンアップされた後に、
+ 無効化されるようになりました。
+
+
+
+
+
+ トレイトのバインド
+
+
+ トレイトは、親クラスの前にバインドされるようになりました。
+ これは微妙な振る舞いの変更ですが、
+ ユーザーの期待により一致するはずです。
+
+
+
+
+
+
+ コンパイル中やクラスのリンク中に発生したエラー
+
+
+ コンパイル中やクラスのリンク中に発生したエラーは、
+ 常に処理が遅延されるようになりました。
+ これらのエラーは、コンパイルまたはクラスのリンク後に処理されます。
+ コンパイル中やクラスのリンク中に致命的なエラーが発生した場合、
+ 遅延させられていたエラーがすぐに処理されます。
+ この場合、ユーザー定義のエラーハンドラを呼び出しません。
+
+
+
+
+
+
+ ユーザー定義のエラーハンドラからスローされた例外
+
+
+ クラスのリンク処理時に、
+ ユーザー定義のエラーハンドラからスローされた例外は、
+ 致命的なエラーに昇格しなくなり、リンクを妨げなくなりました。
+
+
+
+
+
+
+ コンパイル中のアトリビュート適用エラー
+
+
+ 抽象クラス、列挙型、インターフェース、
+ またはトレイトに #[\Attribute] を適用すると、
+ コンパイル時にエラーが発生します。
+ 以前のバージョンではアトリビュートを追加できていましたが、
+ ReflectionAttribute::newInstance
+ がコールされた際に Error がスローされていました。
+ 新しい #[\DelayedTargetValidation] アトリビュートを使うと、
+ このエラーをコンパイル時から実行時に遅延させることできます。
+
+
+
+
+
+ disable_classes INI ディレクティブ
+
+
+ さまざまな PHP エンジンの想定を壊してしまうため、
+ disable_classes
+ INI ディレティブは削除されました。
+
+
+
+
+
+
+ 配列でない値を分解した場合
+
+
+ 配列でない(但し &null; を除く)値を、
+ [] や list で分解した場合、
+ 警告が発生するようになりました。
+
+
+
+
+
+
+ キャスト関連の警告
+
+
+ 浮動小数点数(または浮動小数点数のように見える文字列)
+ を int 型にキャストする際、
+ それらが int 型として表現できない場合に警告が発生するようになりました。
+ これは明示的な int キャストと暗黙的な int キャストの両方に影響します。
+
+
+
+
+ NAN を他の型にキャストした場合、警告が発生するようになりました。
+
+
+
+
+
+
+
+
+ Bzip2
+
+
+ $block_size に 1 から 9 の間以外の値を指定した場合、
+ bzcompress は ValueError
+ をスローするようになりました。
+
+
+
+ $work_factor に 0 から 250 の間以外の値を指定した場合、
+ bzcompress は ValueError
+ をスローするようになりました。
+
+
+
+
+
+ DOM
+
+
+ DOMNamedNodeMap,
+ DOMNodeList,
+ Dom\NamedNodeMap,
+ Dom\NodeList,
+ Dom\HTMLCollection,
+ Dom\DtdNamedNodeMap を clone すると、
+ 失敗するようになりました。
+ 現在動いているオブジェクトが、実際に失敗することはありません。
+ よって、実際の影響はゼロのはずです。
+
+
+
+
+
+ FileInfo
+
+
+ $filename に nul バイトが含まれている場合、
+ finfo_file と
+ finfo::file は、
+ TypeError ではなく
+ ValueError をスローするようになりました。
+ これにより、スローされるエラーの型が、
+ 言語の他の動作と一貫性を保つように調整されます。
+
+
+
+
+
+ Intl
+
+
+ この拡張モジュールは、ICU 57.1 以降が必須になりました。
+
+
+
+ 数値形式の文字列の処理に関する
+ Collator::SORT_REGULAR の動作が、
+ ext/standard の SORT_REGULAR
+ の動作と同じになるように調整されました。
+
+
+
+
+
+ LDAP
+
+
+ 不正なオプションを渡した場合、
+ ldap_get_option
+ と ldap_set_option は
+ ValueError
+ をスローするようになりました。
+
+
+
+
+
+ MBString
+
+
+ Unicode データテーブルが、Unicode 17.0 に更新されました。
+
+
+
+
+
+ MySQLi
+
+
+ 既に構築済みのオブジェクトに対して、
+ mysqli のコンストラクタをコールすることはできなくなりました。
+ コールした場合、Error がスローされます。
+
+
+
+
+
+ ODBC
+
+
+ ODBC は、最低でも ODBC 3.5 の機能が使えると想定するようになりました。
+ ODBCVER の定義や、それを制御するビルドシステムフラグは削除されました。
+
+
+
+ ODBC は、
+ 特定のドライバ向けにビルドするためのビルドフラグを(DB2以外に)
+ 持たなくなり、
+ それらのドライバ向けの特別なケースも削除されました。
+ Windows 以外の環境では、
+ iODBC や unixODBC のようなドライバマネージャの使用を強く推奨します。
+
+
+
+
+
+ Opcache
+
+
+ Opcache 拡張モジュールは、
+ 常に PHP バイナリに組み込まれ、ロードされるようになりました。
+ opcache.enable
+ と opcache.enable_cli
+ の設定はまだ有効です。
+
+
+
+ /
+ configure オプションは削除され、
+ ビルドしても opcache.so
+ や php_opcache.dll はもはや生成されません。
+
+
+
+ zend_extension=opcache.so や
+ zend_extension=php_opcache.dll
+ INI 設定を使うと、警告が発生するようになりました。
+
+
+
+
+
+ PCNTL
+
+
+ pcntl_exec の
+ $args パラメータのエントリに、
+ null バイトが含まれていた場合、
+ ValueError がスローされるようになりました。
+
+
+
+ pcntl_exec の
+ $env_vars パラメータのエントリまたはキーに、
+ null バイトが含まれていた場合、
+ ValueError がスローされるようになりました。
+
+
+
+
+
+ PCRE
+
+
+ semi-deprecated 扱いになっていた、
+ コンパイルオプション PCRE2_EXTRA_ALLOW_LOOKAROUND_BSK
+ 抜きでビルドされるようになりました。
+
+
+
+
+
+
+ PDO
+
+
+ PDO::FETCH_CLASS
+ と組み合わせて設定されるコンストラクタ引数は、
+ 通常の CUFA (call_user_func_array)
+ の規約に従うようになりました。
+ つまり、文字列のキーは名前付き引数のように振る舞うということです。
+ さらに、リファレンス渡しのパラメータに渡される、
+ 値渡し引数の自動ラップが廃止され、
+ 通常の E_WARNING が発生するようになりました。
+ コンストラクタ引数に変数をリファレンス渡しするには、
+ 配列の値にリファレンスの値を代入します: $ctor_args = [&$valByRef]
+
+
+
+ PDO::fetch,
+ PDO::fetchObject,
+ PDO::fetchAll の呼び出し中に、
+ PDOStatement::setFetchMode を呼び出そうとすると、
+ Error がスローされるようになりました。
+ これはたとえば、
+ オブジェクトのフェッチ中に Statement
+ オブジェクトをコンストラクタの引数として渡す際に、
+ PDOStatement::setFetchMode を呼び出す場合が該当します。
+
+
+
+ 定数 PDO::FETCH_GROUP,
+ PDO::FETCH_UNIQUE,
+ PDO::FETCH_CLASSTYPE,
+ PDO::FETCH_PROPS_LATE,
+ PDO::FETCH_SERIALIZE の値が変更されました。
+
+
+
+ PDO::FETCH_PROPS_LATE
+ が PDO::FETCH_CLASS
+ 以外のフェッチモードと一緒に使われた場合、
+ ValueError がスローされるようになりました。
+ これは、他のフェッチフラグの動作と一貫性を持たせるためです。
+
+
+
+ PDO::fetchAll で、
+ PDO::FETCH_INTO をフェッチモードとして使おうとすると、
+ PDO::FETCH_LAZY
+ と同様に ValueError がスローされるようになりました。
+
+
+
+
+
+ PDO_FIREBIRD
+
+
+ Firebird ドライバが生成した PDOStatement
+ に対して、長過ぎるカーソル名を設定しようとすると、
+ ValueError がスローされるようになりました。
+
+
+
+
+
+ Session
+
+
+ パイプ文字 (|)
+ が含まれたキーを持つ $_SESSION
+ にセッションデータを書き込もうとすると、
+ 黙って失敗するのではなく、警告が発生するようになりました。
+
+
+
+
+
+
+ SimpleXML
+
+
+ ノードの集合以外を返す XPath 式を
+ SimpleXMLElement::xpath
+ に渡した場合、警告が発生し、&false; を返すようになりました。
+ これより前のバージョンでは、黙って失敗し、
+ 空の配列を返していました。
+
+
+
+
+
+ SOAP
+
+
+ SoapClient::__doRequest に、
+ オプションの $uriParserClass
+ パラメータが新しく追加されました。
+ これは、文字列と &null; を受け入れます。
+ &null; を渡すと、オリジナルの parse_url
+ ベースのメソッドになります。
+ Uri\Rfc3986\Uri や
+ Uri\WhatWg\Url を渡すと、
+ 新しいバックエンドを使います。
+
+
+
+
+
+
+ SPL
+
+
+
+ ArrayObject は 列挙型を受け入れなくなりました。
+ 列挙型の $name や $value
+ プロパティが、PHP エンジンの想定を壊す可能性があるからです。
+
+
+
+ SplFileObject::fwrite の
+ $length パラメータは、nullable になりました。
+ デフォルト値が 0 から &null; に変更されています。
+
+
+
+
+
+ Standard
+
+
+ printf ファミリの関数に精度を指定しないフォーマットを使った場合、
+ 精度を 0 として扱うようになりました。
+ これより前のバージョンでは、誤って精度をリセットしていました。
+
+
+
+
+
+
diff --git a/appendices/migration85/new-classes.xml b/appendices/migration85/new-classes.xml
new file mode 100644
index 0000000000..2a7e29e84a
--- /dev/null
+++ b/appendices/migration85/new-classes.xml
@@ -0,0 +1,67 @@
+
+
+ 新しいクラスとインターフェイス
+
+
+ PHP コア
+
+ NoDiscard
+ DelayedTargetValidation
+
+
+
+
+
+
+ Curl
+
+ CurlSharePersistentHandle
+
+
+
+
+
+ Filter
+
+ Filter\FilterException
+ Filter\FilterFailedException
+
+
+
+
+
+ URI
+
+ Uri\UriException
+ Uri\InvalidUriException
+ Uri\UriComparisonMode
+ Uri\Rfc3986\Uri
+ Uri\WhatWg\InvalidUrlException
+ Uri\WhatWg\UrlValidationErrorType
+ Uri\WhatWg\UrlValidationError
+ Uri\WhatWg\Url
+
+
+
+
+
+
diff --git a/appendices/migration85/new-features.xml b/appendices/migration85/new-features.xml
new file mode 100644
index 0000000000..9ebd581a77
--- /dev/null
+++ b/appendices/migration85/new-features.xml
@@ -0,0 +1,544 @@
+
+
+ 新機能
+
+
+ PHP コア
+
+
+ パイプ演算子
+
+
+
+ パイプ演算子(|>) が追加されました。
+
+
+
+
+
+ strlen(...);
+print $result . PHP_EOL; // Prints "11"
+]]>
+
+
+
+
+
+ 定数式にクロージャ
+
+
+ 定数式に、クロージャ や
+ 第一級callable
+ を指定できるようになりました。
+ これらを指定できる箇所として、以下が挙げられます:
+
+
+ アトリビュートの引数
+ プロパティやパラメーターのデフォルト値
+ 定数および、クラス定数
+
+
+
+
+
+
+
+
+ #[\NoDiscard] アトリビュート
+
+
+ 関数の戻り値が重要であり、
+ その値を使うべきことを示すアトリビュートとして、
+ NoDiscard が追加されました。
+
+
+
+
+ また、値を意図的に使わないことを指示する (void)
+ キャストが追加されました。
+ (void) キャストは、
+ プログラムそのものの実行には影響しませんが、
+ #[\NoDiscard] アトリビュートが発生させる警告や、
+ 外部の IDE や静的解析ツールが発生させる可能性がある、
+ 診断メッセージを抑制する目的に使えます。
+
+
+
+
+
+
+
+
+
+
+
+
+ 定数に対するアトリビュート
+
+
+ クラス定数でないコンパイル時定数
+ (例: define('MY_CONST', 1); ではなく、
+ const MY_CONST = 1; の形で定義するもの)
+ に対して、アトリビュートを指定できるようになりました。
+
+
+
+
+ 定数に対して、Deprecated
+ アトリビュートを指定できるようになりました。
+
+
+
+
+
+
+ <code>#[\DelayedTargetValidation]</code> アトリビュート
+
+
+ 無効なターゲットに指定した、
+ PHP コア(または拡張モジュール)
+ のアトリビュートから発生するコンパイル時エラーを抑制する手段として、
+ DelayedTargetValidation
+ アトリビュートが追加されました。
+ このアトリビュートが抑制したエラーは代わりに、
+ ReflectionAttribute::newInstance
+ がコールされたタイミングで、実行時に報告されます。
+
+
+
+
+
+
+ プロパティに対する <code>#[\Override]</code> 指定
+
+
+ プロパティに、Override
+ アトリビュートを指定できるようになりました。
+
+
+
+
+
+
+ static プロパティに対する、非対称可視性の指定
+
+
+
+ 非対称可視性プロパティ が、static プロパティをサポートしました。
+
+
+
+
+
+
+ Fatal Error 発生時のバックトレース
+
+
+ (Maximum execution time exceeded のような) 致命的なエラーにも、
+ バックトレースが含まれるようになりました。
+
+
+
+
+
+
+ final プロパティと、コンストラクタのプロモーション
+
+
+ final なプロパティも、
+
+ コンストラクタでプロパティに昇格 させることができるようになりました。
+
+
+
+
+
+
+ 定数式をキャスト
+
+
+ 定数式をキャストできるようになりました。
+
+
+
+
+
+
+
+
+
+
+
+ Clone キーワードへの変更
+
+
+ clone キーワード
+ は、関数のように振る舞うようになりました。
+ そして、読み取り専用プロパティに clone して値を再代入する際に、
+ 新しく $withProperties
+ パラメータが使えるようになりました
+
+
+
+
+
+
+
+
+
+ cURL
+
+
+ 複数のリクエストにまたがって持続する
+ CurlSharePersistentHandle
+ のサポートが追加されました。
+ これを使うと、より効率的な接続の再利用が安全にできるようになります。
+
+
+
+
+ curl_getinfo 関数に、
+ CURLINFO_USED_PROXY (libcurl >= 8.7.0),
+ CURLINFO_HTTPAUTH_USED (libcurl >= 8.12.0),
+ CURLINFO_PROXYAUTH_USED (libcurl >= 8.12.0)
+ のサポートが追加されました。
+ curl_getinfo が配列を返す場合、
+ これらの情報は "used_proxy",
+ "httpauth_used",
+ "proxyauth_used" というキーで利用できます。
+
+ CURLINFO_USED_PROXY は、
+ 直近の転送でプロキシを使った場合にゼロでない値を、
+ 使わなかった場合にゼロを返します。
+
+ CURLINFO_HTTPAUTH_USED と
+ CURLINFO_PROXYAUTH_USED は、
+ 直近の転送で HTTP および、プロキシ経由の認証メソッドを示す情報を、
+ ビットマスクで返します。利用可能な値は、
+ CURLAUTH_*
+ を参照ください。
+
+
+
+ CURLOPT_INFILESIZE を安全に置き換えられる、
+ CURLOPT_INFILESIZE_LARGE が追加されました。
+ 特定のシステムでは、たとえ 64bit システムであっても、
+ CURLOPT_INFILESIZE は 32bit の符号付き整数(2.0 Gib)
+ しか受け入れない場合があります。
+ CURLOPT_INFILESIZE_LARGE は、
+ システムが扱える整数の最大値を受け入れます。
+
+
+
+ curl_setopt 関数に指定する、
+ CURLOPT_FOLLOWLOCATION オプション向けに、
+ CURLFOLLOW_OBEYCODE,
+ CURLFOLLOW_FIRSTONLY,
+ CURLFOLLOW_ALL が追加されました。
+
+ CURLFOLLOW_OBEYCODE は、
+ 許可されている場合に、より厳密にリダイレクトを行います。
+
+ CURLFOLLOW_FIRSTONLY は、
+ 最初のリダイレクトのみを行います。そのため、
+ その後に後続のリダイレクトがあったとしても、それ以上はリダイレクトしません。
+
+ CURLFOLLOW_ALL は、
+ CURLOPT_FOLLOWLOCATION
+ を &true; に設定することと同じです。
+
+
+
+ curl_getinfo 関数に、
+ CURLINFO_CONN_ID
+ のサポートが追加されました (libcurl >= 8.2.0)。
+ この定数を使うと、
+ cURL の転送で使ったユニークな接続IDを取得できるようになります。
+ このIDは、主に PHP レベルでのアプリケーションにおいて、
+ 接続の再利用や接続のプーリング処理が必要な場合に役立ちます。
+ curl_getinfoが配列を返す場合、
+ この値は "conn_id" キーとして利用できます。
+
+
+
+ curl_getinfo 関数に、
+ CURLINFO_QUEUE_TIME_T
+ のサポートが追加されました (libcurl >= 8.6.0)。
+ この定数を使うと、
+ リクエストが送信される前に libcurl
+ の接続キューで待機した時間(マイクロ秒単位)を取得できます。
+ curl_getinfo の option
+ パラメーターに CURLINFO_QUEUE_TIME_T
+ を渡すことで、値が取得できます。
+
+
+
+ TLS で使う署名アルゴリズムを指定する定数として、
+ CURLOPT_SSL_SIGNATURE_ALGORITHMS
+ が追加されました。
+
+
+
+
+
+ DOM
+
+
+ Dom\Element::$outerHTML が追加されました。
+
+
+
+ Dom\ParentNode の実装に、
+ $children プロパティが追加されました。
+
+
+
+
+
+ EXIF
+
+
+ OffsetTime* Exif タグが追加されました。
+
+
+
+ HEIF/HEIC のサポートが追加されました。
+
+
+
+
+
+ Filter
+
+
+ フィルタ関数に渡すと、
+ 検証に失敗した際に強制的に例外を発生させる
+ FILTER_THROW_ON_FAILURE フラグが追加されました。
+ この新しいフラグは、
+ FILTER_NULL_ON_FAILURE と組み合わせることはできません。
+ 組み合わせようとすると、
+ ValueError がスローされます。
+
+
+
+
+
+
+ Intl
+
+
+ 様々な通貨関連の数値フォーマット向けに、
+ クラス定数 NumberFormatter::CURRENCY_ISO,
+ NumberFormatter::CURRENCY_PLURAL,
+ NumberFormatter::CASH_CURRENCY,
+ NumberFormatter::CURRENCY_STANDARD が追加されました。
+
+
+
+ 指定されたロケールで likely tag を処理するために、
+ Locale::addLikelySubtags と
+ Locale::minimizeSubtags が追加されました。
+
+
+
+ IntlListFormatter クラスが追加されました。
+ これは、指定されたロケールで項目のリストをフォーマット、順序付け、
+ 句読点を付ける操作を行うためのものです。
+ クラス定数として、IntlListFormatter::TYPE_AND,
+ IntlListFormatter::TYPE_OR,
+ IntlListFormatter::TYPE_UNITS 演算子と、
+ IntlListFormatter::WIDTH_WIDE,
+ IntlListFormatter::WIDTH_SHORT,
+ IntlListFormatter::WIDTH_NARROW があります。
+ このクラスは ICU 67 以降でサポートされます。
+
+
+
+
+
+ PDO_Sqlite
+
+
+ クラス定数
+ Pdo_Sqlite::ATTR_BUSY_STATEMENT が追加されました。
+
+
+
+ クラス定数
+ Pdo_Sqlite::ATTR_EXPLAIN_STATEMENT,
+ Pdo_Sqlite::EXPLAIN_MODE_PREPARED,
+ Pdo_Sqlite::EXPLAIN_MODE_EXPLAIN,
+ Pdo_Sqlite::EXPLAIN_MODE_EXPLAIN_QUERY_PLAN が追加されました。
+
+
+
+ 接続する際の属性として、
+ PDO\Sqlite::ATTR_TRANSACTION_MODE を追加しました。
+ これに指定可能な値は、
+ PDO\Sqlite::TRANSACTION_MODE_DEFERRED,
+ PDO\Sqlite::TRANSACTION_MODE_IMMEDIATE,
+ PDO\Sqlite::TRANSACTION_MODE_EXCLUSIVE があります。
+ これを使うと、beginTransaction()
+ 呼び出し時に使用するトランザクションモードを構成できます。
+
+
+
+
+
+ Session
+
+
+ session_set_cookie_params,
+ session_get_cookie_params,
+ session_start 関数は、
+ "partitioned" というキー経由で、
+ パーティショニングされた Cookie をサポートしました。
+
+
+
+
+
+
+ SOAP
+
+
+ SoapClient::__getTypes が、
+ 列挙型の case をダンプするようになりました。
+
+
+
+ Soap 1.2 の Reason テキスト向けに、xml:lang 属性のサポートが追加されました。
+
+
+
+ 上記のサポートによって、
+ SoapFault::__construct と
+ SoapServer::fault のシグネチャに、
+ オプションの $lang パラメータが追加されました。
+ これによって、.NET SOAP クライアントとの互換性問題が解決します。
+
+
+
+
+
+ Standard
+
+
+ mail は、sendmail の実際のエラーを返すようになり、
+ sendmail プロセスが予期せず終了したかどうかを検出するようになりました。
+ 予期せず終了した場合、警告が発生し、この関数は &false; を返します。
+ これより前のバージョンでは、こうしたエラーは黙って無視されていました。
+ この変更は、sendmail を使ったメール送信にのみ影響します。
+
+
+
+ getimagesize が、HEIF/HEIC 画像をサポートしました。
+
+
+
+ libxml 拡張モジュールがロードされている場合に、
+ getimagesize は SVG 画像もサポートするようになりました。
+ 同様に、image_type_to_extension と
+ image_type_to_mime_type も、
+ IMAGETYPE_SVG を処理するようになりました。
+
+
+
+ getimagesize が返す配列に、
+ 2つエントリが追加されました: "width_unit" と
+ "height_unit" です。
+ これらは、寸法がどの単位で表現されているかを示します。
+ これらの単位は px がデフォルトですが、
+ 必ずしも同じ単位であるとは限りません
+ (一例を挙げると、片方が cm で、もう片方が px である場合があります)
+
+
+
+ setcookie と setrawcookie
+ 関数が、"partitioned" キーをサポートしました。
+
+
+
+
+
+ URI
+
+
+ RFC 3986 と WHATWG URL に従い、
+ URI と URL を処理するのに使える拡張モジュールが追加されました。
+ これは、常に有効になっています。
+
+
+
+
+
+
+ XSL
+
+
+ XSLTProcessor::getParameter,
+ XSLTProcessor::setParameter,
+ XSLTProcessor::removeParameter の
+ $namespace 引数は、
+ 空でなくても動作するようになりました。
+ 動作するのは、$name 引数が Clark 記法でなく、かつ
+ QName 形式でもない場合です。
+ これらの場合は、名前空間が href または prefix からそれぞれ取得されるためです。
+
+
+
+
+
+ Zlib
+
+
+ flock が、zlib ストリームをサポートしました。
+ これより前のバージョンでは、あらゆるロック操作を行う際に常に失敗していました。
+
+
+
+
+
+
diff --git a/appendices/migration85/new-functions.xml b/appendices/migration85/new-functions.xml
new file mode 100644
index 0000000000..b7a4fc07d4
--- /dev/null
+++ b/appendices/migration85/new-functions.xml
@@ -0,0 +1,150 @@
+
+
+ 新しく追加された関数
+
+
+ PHP コア
+
+
+
+
+ get_error_handler
+ get_exception_handler
+
+ Closure::getCurrent
+
+
+
+
+
+ Curl
+
+
+
+ curl_multi_get_handles
+ curl_share_init_persistent
+
+
+
+
+ DOM
+
+
+ Dom\Element::getElementsByClassName
+
+
+ Dom\Element::insertAdjacentHTML
+
+
+
+
+
+ Enchant
+
+ enchant_dict_remove_from_session
+ enchant_dict_remove
+
+
+
+
+ Intl
+
+
+ Locale::isRightToLeft
+
+ locale_is_right_to_left
+
+ grapheme_levenshtein
+
+
+
+
+ Opcache
+
+
+ opcache_is_script_cached_in_file_cache
+
+
+
+
+ PDO_SQLITE
+
+
+ Pdo\Sqlite::setAuthorizer
+
+
+
+
+
+ PGSQL
+
+
+ pg_close_stmt
+ pg_service
+
+
+
+
+ Reflection
+
+
+
+ ReflectionConstant::getFileName
+
+
+ ReflectionConstant::getExtension
+
+
+ ReflectionConstant::getExtensionName
+
+
+
+ ReflectionConstant::getAttributes
+
+
+ ReflectionProperty::getMangledName
+
+
+
+
+
+ Sqlite
+
+
+
+ Sqlite3Stmt::busy
+
+
+
+
+
+ Standard
+
+
+
+ array_first
+ array_last
+
+
+
+
+
diff --git a/appendices/migration85/other-changes.xml b/appendices/migration85/other-changes.xml
new file mode 100644
index 0000000000..1de833579d
--- /dev/null
+++ b/appendices/migration85/other-changes.xml
@@ -0,0 +1,815 @@
+
+
+ その他の変更
+
+
+ PHP コア
+
+
+ Core
+
+
+ macOS における高精度なタイマー(hrtime)
+ は、mach_absolute_time()
+ ではなく、推奨されている
+ clock_gettime_nsec_np(CLOCK_UPTIME_RAW)
+ API を使うようになりました。
+
+
+
+
+
+ CGI/CLI
+
+
+ や、
+ オプションは、
+ 機能していないため削除されました。
+ を代わりに使ってください。
+
+
+
+
+
+ PDO_ODBC
+
+
+ 大きなカラムのフェッチ動作が変更されました。
+ 256 バイトのブロックをフェッチする代わりに、
+ PDO_ODBC はより大きなブロックサイズをフェッチしようとするようになります。
+ 現状このブロックサイズは、
+ ページサイズから文字列オーバーヘッドを差し引いたサイズです。
+ SQLGetData で SQL_NO_TOTAL を返すドライバも同様に、
+ 適切に処理されるようになります。
+ この変更で、互換性とパフォーマンスが改善するはずです。
+
+
+
+
+
+
+
+
+ SAPI モジュールへの変更
+
+
+ CLI
+
+
+ cli_set_process_title
+ に長過ぎるタイトルを設定しようとした場合、
+ 黙ってタイトルを切り詰めるのではなく、
+ 失敗するようになりました。
+
+
+
+ ビルトインのデフォルト値から変更されている INI
+ 設定を出力するオプションとして、
+ オプションが追加されました。
+
+
+
+
+
+ FPM
+
+
+ httpd ProxyPass を経由した FPM は、
+ オプションでスクリプトの完全なパスをデコードします。
+ この新しい振る舞いは、
+ 追加された fastcgi.script_path_encoded INI ディレクティブで抑止できます。
+
+
+
+ FPM のログの長さの上限は、
+ log_limit の値を尊重するようになりました。
+
+
+
+
+
+
+
+ 変更された関数
+
+
+ Intl
+
+
+ クラスが初期化されていなかったり、
+ clone が失敗した場合に、
+ IntlDateFormatter::setTimeZone/datefmt_set_timezone は IntlException
+ をスローするようになりました。
+
+
+
+ grapheme_extract は、
+ 無効な開始バイトをスキップする際に $next
+ の値を適切に割り当てるようになりました。
+ これより前のバージョンでは、grapheme 境界の終端ではなく、
+ 先頭を指すケースがありました。
+
+
+
+ Locale クラスのメソッドは、
+ ロケールの引数に null バイトが含まれていた場合に
+ ValueError をスローするようになりました。
+
+
+
+ transliterator_get_error_code,
+ transliterator_get_error_message,
+ TransLiterator::getErrorCode,
+ TransLiterator::getErrorMessage の戻り値の
+ union 型から false を削除しました。
+ &false; を返すことは実際には起こり得なかったからです。
+
+
+
+ 以下の関数は、$locale 引数をサポートしました:
+ grapheme_strpos,
+ grapheme_stripos,
+ grapheme_strrpos,
+ grapheme_strripos,
+ grapheme_substr,
+ grapheme_strstr,
+ grapheme_stristr
+
+
+
+
+
+
+ LDAP
+
+
+ ldap_get_option は、
+ ldap_set_option と同様に、
+ &null; の接続を受け付けるようになりました。
+ これは、グローバルオプションを取得できるようにするためです。
+
+
+
+
+
+ libxml
+
+
+ libxml_set_external_entity_loader は、
+ 戻り値の型を正式に true としました。
+
+
+
+
+
+ OpenSSL
+
+
+ openssl_public_encrypt と
+ openssl_private_decrypt は、
+ OAEP パディング向けのハッシュダイジェストアルゴリズムを指定するために、
+ 新しく $digest_algo
+ パラメータを設定できるようになりました。
+
+
+
+ openssl_sign と
+ openssl_verify は、
+ よりセキュアな RSA PSS パディングを使えるようにするために、
+ 新しく $padding
+ パラメータを設定できるようになりました。
+
+
+
+ openssl_cms_encrypt の $cipher_algo
+ パラメーターに、暗号名を示す文字列を指定できるようになりました。
+ これによって、認証付きのエンベロープデータ向けに、
+ AES GCM 暗号アルゴリズムを含むより多くのアルゴリズムを使えるようになります。
+
+
+
+
+
+ PCNTL
+
+
+ pcntl_exec は、
+ 戻り値の型を正式に false としました。
+
+
+
+ pcntl_waitid は、
+ 子プロセスに関する様々なプラットフォーム固有のメトリクスを収集するため、
+ 追加で resource_usage 引数を受け取るようになりました。
+
+
+
+
+
+ PDO_PGSQL
+
+
+ PDO::pgsqlCopyFromArray は、
+ Iterable の入力をサポートするようになりました。
+
+
+
+ Pdo\Pgsql::setAttribute と
+ Pdo\Pgsql::prepare は、
+ lazy フェッチモードに入ることを示すために、
+ PDO::ATTR_PREFETCH に 0 を設定できるようになりました。
+ このモードの場合、Statement は並列に実行できません。
+
+
+
+
+
+ PDO_SQLITE
+
+
+ SQLite の PDO::quote は、
+ 文字列に null バイトが含まれていた場合に、
+ エラーモードに応じて警告を発生させたり、例外をスローするようになりました。
+
+
+
+ PDO::sqliteCreateCollation は、
+ コールバック関数の戻り値の型が間違っている場合に、
+ 例外をスローするようになりました。
+ この変更によって、
+ Pdo_Sqlite::createCollation
+ の動作とより一致するようになります。
+
+
+
+
+
+ PostgreSQL
+
+
+ pg_copy_from は、
+ Iterable の入力をサポートするようになりました。
+
+
+
+ pg_connect は、
+ connection_string 引数に null
+ バイトが含まれているかをチェックするようになりました。
+
+
+
+ pg_close_stmt は、
+ statement_name 引数に null
+ バイトが含まれているかをチェックするようになりました。
+
+
+
+
+
+ POSIX
+
+
+ posix_ttyname は、
+ ファイルディスクリプタが無効な場合に、
+ last_error に EBADF を設定するようになりました。
+
+
+
+ posix_isatty は、
+ ファイルディスクリプタが無効な場合に、
+ E_WARNING を発生させるようになりました。
+
+
+
+ posix_fpathconf は、
+ ファイルディスクリプタが無効かどうかをチェックし、
+ 無効な場合に last_error に EBADF を設定しつつ、
+ E_WARNING を発生させるようになりました。
+
+
+
+ posix_kill は、
+ process_id 引数がプラットフォームがサポートする範囲
+ (符号付きまたは long）より小さいか大きい場合に
+ ValueError をスローします。
+
+ posix_setpgid は、
+ process_id または process_group_id が 0 未満、
+ またはプラットフォームがサポートする範囲より大きい場合に
+ ValueError をスローします。
+
+
+
+ posix_setrlimit は、
+ hard_limit または soft_limit 引数が -1 より小さい場合、
+ または soft_limit が hard_limit より大きい場合に
+ ValueError をスローします。
+
+
+
+
+
+ Reflection
+
+
+ ReflectionClass::__toString
+ の列挙型の出力について、
+ クラスが列挙型であることをより明確に示すように変更されました。
+ また、列挙型の case は通常のクラス定数ではなく、
+ 列挙型の case であることを示すようになりました。
+
+
+
+ ReflectionProperty::__toString の、
+ フックを持つプロパティの出力は、プロパティがどのフックを持つか、
+ それらのフックが final かどうか、
+ およびプロパティが仮想かどうかを示すように変更されました。
+ これは、クラスがフックされたプロパティを含む場合の
+ ReflectionClass::__toStringの出力にも影響します。
+
+
+
+ 無効なターゲットにアトリビュートが適用された場合、
+ ReflectionAttribute::newInstance は、
+ 内部的なアトリビュート向けに例外をスローするようになりました。
+ #[\DelayedTargetValidation] を使うと、
+ 発生するエラーがコンパイル時から実行時に遅延されます。
+
+
+
+
+
+
+ Session
+
+
+ session_start は、
+ オプション引数をより厳格に扱うようになっています。
+ 配列が連想配列でない場合、
+ ValueError がスローされます。
+ read_and_close の値が int と互換性のない値の場合、
+ TypeError がスローされます。
+
+
+
+
+
+ SNMP
+
+
+ snmpget,
+ snmpset,
+ snmp2_get,
+ snmp2_set,
+ snmp3_get,
+ snmp3_set
+ SNMP::__construct は、
+ ValueError をスローするようになりました。
+ スローされるのは、ホスト名が長すぎたり、
+ ホスト名が null バイトを含んでいたり、
+ 負の値や 65535 を超えるポート番号を指定したり、
+ タイムアウトやリトライの値が -1 より小さかったり、大きすぎたりする場合です。
+
+
+
+
+
+ Sockets
+
+
+ socket_create_listen,
+ socket_bind,
+ socket_sendto は、
+ ポートが 0 未満または 65535 を超える場合、
+ または hints 配列のエントリが数値インデックスの場合に、
+ ValueError をスローします。
+
+
+
+ socket_addrinfo_lookup は、
+ hints 値のいずれかが int 型にキャストできない場合に、
+ TypeError をスローします。
+ また、これらの値のいずれかがオーバーフローした場合、
+ ValueError をスローする可能性があります。
+
+
+
+ socket_set_option 関数で
+ MCAST_LEAVE_GROUP/MCAST_LEAVE_SOURCE_GROUP を指定した場合、
+ 値が有効なオブジェクトまたは配列でない場合は例外がスローされます。
+
+
+
+ socket_create/socket_bind は、
+ AF_PACKET
+ ファミリのソケットを作成できるようになりました。
+
+
+
+ socket_getsockname は、
+ AF_PACKET ソケットを指定すると、
+ インターフェイスのインデックスとその文字列表現を取得します。
+
+
+
+ socket_set_option
+ をマルチキャストコンテキストで呼び出す場合、
+ 作成されたソケットが
+ AF_INET/AF_INET6
+ ファミリでない場合、ValueError がスローされます。
+
+
+
+
+
+ Tidy
+
+
+ tidy::__construct,
+ tidy::parseFile,
+ tidy::parseString は、
+ 無効な設定値が含まれていたり、
+ 読み取り専用の内部エントリを設定しようとした場合に
+ ValueError をスローするようになりました。
+ 設定キーが文字列でない場合は、
+ TypeError がスローされるようになっています。
+
+
+
+
+
+ Zlib
+
+
+ gzfile, gzopen,
+ readgzfile 関数の
+ $use_include_path 引数の型が、
+ int から boolean に変更されました。
+
+
+
+ gzfile,
+ gzopen,
+ readgzfile 関数は、
+ デフォルトのストリームコンテキストを尊重するようになりました。
+
+
+
+
+
+
+
+ 拡張モジュールへのその他の変更
+
+
+ cURL
+
+
+ curl_setopt に指定する
+ CURLOPT_FOLLOWLOCATION オプションの値が、
+ boolean ではなく数値として扱われるようになりました。
+ これは CURLFOLLOW_OBEYCODE と
+ CURLFOLLOW_FIRSTONLY を処理するためです。
+
+
+
+
+
+ Fileinfo
+
+
+ file の magic データベースが、5.45 から 5.46 に更新されました。
+
+
+
+ finfo_close の戻り値の型が、
+ bool ではなく、true に変更されました。
+
+
+
+
+
+ Intl
+
+
+ Intl の内部エラー処理機構がモダンになり、
+ どの呼び出しがどのエラーを引き起こしたかを、
+ より正確に示せるようになりました。
+ さらに、一部の ext/date の例外は、
+ IntlException でラップされるようになっています。
+
+
+
+
+
+ Lexbor
+
+
+ lexbor 拡張モジュールが追加されました。
+ これは常に有効になっています。
+ 他の拡張モジュールで再利用できるようにするため、
+ ext/dom
+ から分離された laxbor ライブラリが含まれています。
+ この新しい拡張機能は、ユーザーランドに直接公開されません。
+
+
+
+
+
+ Opcache
+
+
+ Opcache 拡張モジュール は、
+ 常に PHP バイナリに組み込まれ、ロードされるようになりました。
+ opcache.enable と
+ opcache.enable_cli
+ の設定はまだ有効です。
+
+
+
+
+
+ PCRE
+
+
+ pcre2lib が、10.44 から 10.46 に更新されました。
+
+
+
+
+
+ PDO_Sqlite
+
+
+ サポートされる最低リリースバージョンが、
+ 3.7.7 から 3.7.17 に変更されました。
+
+
+
+
+
+ Readline
+
+
+ readline_add_history,
+ readline_clear_history,
+ readline_callback_handler_install
+ の戻り値の型が、
+ bool から true に変更されました。
+
+
+
+
+
+ Reflection
+
+
+ ReflectionConstant クラスは、
+ final ではなくなりました。
+
+
+
+
+
+
+
+ INI ファイルの扱いの変更
+
+
+ PHP コア
+
+
+ 致命的なエラーにバックトレースを含めるかどうかを制御するために、
+ fatal_error_backtraces INI ディレクティブが追加されました。
+
+
+
+
+ 起動時にのみ有効な、max_memory_limit INI ディレクティブが追加されました。
+ これは、起動時または実行時に設定可能な memory_limit の最大値を制御するためのものです。
+ この値を超えると、-1 を設定しない限り警告が発生します。
+ 代わりに、memory_limit の値が、現在の max_memory_limit の値に設定されます。
+
+
+
+
+
+
+ Opcache
+
+
+ opcache.file_cache
+ で指定されたディレクトリがが読み取り専用だった場合をサポートするために、
+ opcache.file_cache_read_only が追加されました。
+ これは、読み取り専用ファイルシステム(例：読み取り専用 Docker コンテナ)向けです。
+ opcache.validate_timestamps=0,
+ opcache.enable_file_override=1,
+ opcache.file_cache_consistency_checks=0
+ の組み合わせで使うことを推奨します。
+
+
+
+
+ 異なるビルドのPHP、
+ 異なるファイルパス、
+ 異なる設定(ロードされる拡張機能を含む)で生成されたキャッシュは、
+ 無視される可能性があります。
+
+
+
+
+ opcache.jit_hot_loop
+ のデフォルト値は、ループ反復回数の倍数にならないように、
+ 61 (素数) に設定されました。
+ このパラメータには、素数の値を設定することを推奨します。
+
+
+
+ OPcache SHM が既にセットアップされている状態で、
+ opcache.memory_consumption
+ の値を変更した場合に、正しく失敗を報告するようになりました。
+ これより前のバージョンでは、黙って何もせず、
+ PHPInfo で誤解を招く値を表示していました。
+
+
+
+
+
+ OpenSSL
+
+
+ OpenSSL のライブラリコンテキストタイプを選択できるようにするため、
+ openssl.libctx INI ディレクティブを追加しました。
+ スレッドごとにカスタムの libctx を使うか、
+ グローバルな、単一の libctx (デフォルト)を使えます。
+
+
+
+
+
+
+
+ パフォーマンスに関わる変更
+
+
+ PHP コア
+
+
+ match(true) パターン向けに、
+ boolean 値との同一性の比較に関する OPcode が削除されました。
+
+
+
+ === [] と
+ !== [] による比較について、
+ OPcode の特殊化処理が追加されました。
+
+
+
+ 例外オブジェクトを生成する速度が向上しました。
+
+
+
+ SSE2 を使用していたコードは、
+ ARM NEON による SIMD 命令も使うように調整されました。
+
+
+
+ x86_64 または aarch64 アーキテクチャで Clang>=19
+ を使用してコンパイルする場合、
+ デフォルトで有効となる TAILCALL VM を導入しました。
+ TAILCALL VM は、
+ GCC コンパイル時に使用される HYBRID VM と同等の速度を実現します。
+ これにより、Clang>=19 でビルドされた PHP バイナリは、
+ GCC でビルドされたバイナリと同等の速度を発揮します。
+ 他のコンパイラで使用される CALL VM のパフォーマンスも大幅に改善されました。
+
+
+
+
+
+ Intl
+
+
+ collator で文字列変換を行う際、余計な文字列コピーをしなくなりました。
+
+
+
+
+
+ MBString
+
+
+ SSE2 を使用していたコードは、
+ ARM NEON による SIMD 命令も使うように調整されました。
+
+
+
+
+
+ Opcache
+
+
+ Glibc 以外のビルドで JIT コンパイルされたコード中で、
+ TLS 変数のフェッチ処理のパフォーマンスが向上しました。
+
+
+
+
+
+ Reflection
+
+
+ 以下のメソッドのパフォーマンスが向上しました:
+
+ ReflectionProperty::getValue
+ ReflectionProperty::getRawValue
+ ReflectionProperty::isInitialized
+ ReflectionProperty::isInitialized
+ ReflectionProperty::setValue
+ ReflectionProperty::setRawValue
+
+
+
+
+
+
+ SPL
+
+
+ SplFixedArray の、
+ 多次元のアクセス処理と、メソッドのパフォーマンスが向上しました。
+
+
+
+
+
+ Standard
+
+
+ コールバックを指定した場合の、配列関数
+ (array_find, array_filter,
+ array_map, usort, ...)
+ のパフォーマンスが向上しました。
+
+
+
+ urlencode と
+ rawurlencode のパフォーマンスが向上しました。
+
+
+
+ 一時的な文字列の生成と再パースを回避することで、
+ unpack の、
+ 名前を付けない反復処理のパフォーマンスが向上しました。
+
+
+
+ pack のパフォーマンスが向上しました。
+
+
+
+ array_chunk のパフォーマンスが少し向上しました。
+
+
+
+
+
+ XML
+
+
+ XMLReader の、
+ プロパティアクセスのパフォーマンスが向上しました。
+
+
+
+ XMLWriter のパフォーマンスが向上し、
+ メモリ使用量が削減されました。
+
+
+
+
+
+
+
+
diff --git a/appendices/migration85/windows-support.xml b/appendices/migration85/windows-support.xml
new file mode 100644
index 0000000000..72781b7a8e
--- /dev/null
+++ b/appendices/migration85/windows-support.xml
@@ -0,0 +1,103 @@
+
+
+ Windows のサポート
+
+
+ Core
+
+
+ PHP_VERSION,
+ PHP_MINOR_VERSION,
+ PHP_RELEASE_VERSION の設定値は、常に数値になりました。
+ これより前のバージョンでは、buildconf のビルド設定用の文字列でした。
+
+
+
+ phpize ビルドは、
+ (in-tree ビルドで既に動作していたかのように)
+ build dir 内のソースツリーを反映するようになりました。
+ 拡張モジュールによっては、
+ (特に Makefile.frag.w32 を使う場合)
+ 調整が必要かもしれません。
+
+
+
+ MSVC ビルド向けに、
+
+ がサポートされるようになりました。
+ これによって、ASan とデバッグのアサーションが有効になります。
+ このオプションは MSVC 16.10 と Windows 10 以降でサポートされます。
+
+
+
+ clang ビルド向けの
+
+ 設定オプションは、サポートされなくなりました。
+ CFLAGS 経由で警告を抑制してください。
+
+
+
+
+
+ COM
+
+
+ この拡張モジュールは、
+ デフォルトで共有ライブラリとしてビルドされるようになりました。
+ これより前のバージョンでは、
+ デフォルトで static な拡張モジュールとしてビルドされていましたが、
+ 公式の Windows 用バイナリは、共有ライブラリとしてビルドされていました。
+
+
+
+
+
+ FFI
+
+
+ FFI::cdef と
+ FFI::load を使う際に、
+ ライブラリを指定する必要はなくなりました。
+ しかし実運用環境では、この便利機能を使うべきではありません。
+
+
+
+
+
+ Streams
+
+
+ パイプストリームが $read
+ 配列のみに存在し、かつ $write と
+ $except 配列が空の場合、
+ stream_select は、
+ POSIX システムと似た振る舞いをするようになりました。
+ つまり、少なくとも1つのパイプが読み取り可能になった場合、
+ またはタイムアウトした後にのみ、関数から戻ります。
+ これより前のバージョンでは、この関数は直ちに返り、
+ すべてのストリームが読み取り可能であると報告していました。
+
+
+
+
+
+