PHP 8.6.x で推奨されなくなる機能PHP コア"namespace" をクラス定数の名前に使う
finally ブロックから return する
__debugInfo() の nullable な戻り値の型
__debugInfo()
の戻り値の型を
arraynull
と宣言することは、推奨されなくなりました。
このメソッドから __construct() と __destruct() から値を返す
__construct() や
__destruct()
から値を返すことは、推奨されなくなりました。
コンパイル時に、推奨されない警告が発生します。
これらのメソッドは戻り値の型を宣言できず、
通常の使い方では戻り値を受け取ることもできないため、
値を返しても紛らわしいだけでした。
残りの処理を飛ばすために値なしの
同じ理由で、 関数に readonly という名前を付ける
let、is、_ を識別子として使う
PHP 8.4
でクラス名を define() の第 3 引数
define に allow_string が false の状態で is_a() と is_subclass_of() に文字列を渡す
metaphone()metaphone 関数は、推奨されなくなりました。 この関数が実装しているのは 1990 年の最初の Metaphone アルゴリズムで、 英語の発音規則にしか対応しておらず、 既に後継の Double Metaphone や Metaphone 3 があります。 発音に基づくアルゴリズムは言語ごとに異なり、頻繁に更新されるため、 PHP で書かれたライブラリで提供するほうが適しています。 代わりにそうしたライブラリを使ってください。 php://filter の URL で 16 を超えるフィルタを使う
上限より多くのフィルタが必要な場合は、上限のない stream_filter_append や stream_filter_prepend でフィルタを追加するか、 コンテキストオプションで上限を引き上げてください。 たとえば、stream_context_set_default を使えば、スクリプト全体で上限を引き上げられます。 array_walk()、array_walk_recursive()、http_build_query() にオブジェクトを渡す
array_walk や
array_walk_recursive の
http_build_query の
is_double()、is_long()、is_integer()、doubleval()PHP 8.5 で正規化されていない型名でのキャストが推奨されなくなったのに続き、 同じ古い型名を名前に含む関数のエイリアスも、推奨されなくなりました。 これらは対応する正規の関数とまったく同じ動作をするので、 代わりにそちらを使ってください:
strcoll() と SORT_LOCALE_STRING
strcoll 関数は、推奨されなくなりました。
この関数は、現在のロケールの
ソート関数の
Bzip2bzip2.compress と bzip2.decompress ストリームフィルタのパラメータとしてオブジェクトを渡すことは、 推奨されなくなりました。 ドキュメントに記載され、サポートされているのは連想配列だけです。 オブジェクトに対して get_object_vars をコールし、その結果の配列を渡してください。 GMP
GMP オブジェクトに対するシフト演算子
( MBString
mbregex 関数は、推奨されなくなりました。
内部で使われている Oniguruma ライブラリのメンテナンスが 2025 年 4 月に終了したためです。
これらの関数は PHP 9.0 で削除される予定です。
ほとんどの用途では、
mb_convert_variables の
MySQLimysqli_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 を使ってください。
同じ理由で、 ReflectionReflectionProperty::setValue や ReflectionProperty::setRawValue に、 そのプロパティを宣言したクラスのインスタンスではないオブジェクトを渡すことは、 推奨されなくなりました。 他の ReflectionProperty のメソッドはこうしたオブジェクトに対して例外をスローしますが、 これらのメソッドは無関係なオブジェクトにプロパティを設定してしまいます。 これは通常の代入と変わらないうえ、概念的にも誤っています。
static メソッドを呼び出すときに、
ReflectionMethod::invoke や
ReflectionMethod::invokeArgs
にオブジェクトを渡すことは、推奨されなくなりました。
static メソッドには $this がないので、
渡されたオブジェクトは無視され、検証されることもありませんでした。
代わりに SessionSessionIdInterface::create_sid と SessionUpdateTimestampHandlerInterface::validateId のどちらか一方でも実装していないオブジェクトを session_set_save_handler に渡すことは、 オブジェクトがどのインターフェイスを宣言しているかにかかわらず、 推奨されなくなりました。 session.use_strict_mode が有効なときに保存ハンドラが正しく動作するには、これらのメソッドが必要です。 この設定はセッション固定攻撃を緩和するもので、 PHP 8.6 以降はデフォルトで有効です。
これに伴い、 SessionIdInterface::create_sid か
SessionUpdateTimestampHandlerInterface::validateId を定義せずに
SessionHandlerInterface を実装すると、
SPLspl_classes 関数は、推奨されなくなりました。 このような関数を公開している拡張モジュールは他になく、 Reflection 拡張モジュールは常に利用できるためです。 代わりに ReflectionExtension::getClassNames を使ってください。 spl_object_hash 関数は、推奨されなくなりました。 PHP 8.1 以降、この関数の戻り値は spl_object_id の値を整形し直しただけのものです。 また、値はオブジェクトの内容から導出されるものではないので、 関数名は誤解を招きます。 文字列という形式も間違いのもとで、 2 つのハッシュがどちらも数値形式の文字列であるために、 緩やかな比較で等しいと判定されることがあります。 代わりに spl_object_id を使ってください。 以下の ArrayIterator のメソッドは、 推奨されなくなりました。 これらのメソッドが存在するのは、ArrayIterator が ArrayObject と実装を共有してきたからにすぎません。 その大半はイテレータにとってほとんど意味がなく、 イテレータの実装を最適化する妨げにもなっています。 対応する ArrayObject のメソッドは対象外です。
SplFileObject の CSV 関連のメソッドは、 推奨されなくなりました。 以前からある設計上の不整合が名前付き引数によっていっそう表面化し、 メンテナンスがますます難しくなっています。 また、CSV の処理は本来 SplFileObject の役割ではありません。 代わりに、ストリームに対して fgetcsv と fputcsv を使ってください。
Zlibzlib.deflate と zlib.inflate ストリームフィルタのパラメータとしてオブジェクトを渡すことは、 推奨されなくなりました。 ドキュメントに記載され、サポートされているのは連想配列だけです。 オブジェクトに対して get_object_vars をコールし、その結果の配列を渡してください。
deflate_init や inflate_init の
|