PHP 8.6.x で推奨されなくなる機能

PHP コア

"namespace" をクラス定数の名前に使う

namespace という名前の クラス定数 を宣言することは、推奨されなくなりました。 namespace はクラスのメンバー名には使えるキーワードですが、 ::class と同様の ::namespace 疑似定数など、 将来導入される可能性がある構文のために、この名前は確保されることになりました。 namespace という名前のメソッドや static プロパティは、 影響を受けません。 定数名を、たとえば NAMESPACE_NAME などに変更してください。

finally ブロックから return する

finally ブロックの中で return 文を使うことは、 推奨されなくなりました。 コンパイル時に、推奨されない警告が発生します。 このような return は、対応する try や catch ブロックでスローされた例外を握りつぶしたり、 そこから返された値を上書きしたりするため、 失敗が跡形もなく消えてしまいます。 代わりに、return を finally ブロックの外に移してください。同じ結果になる書き方は、必ずあります。

<?php
function getConfig(): array
{
    try {
        return loadConfig(); // ファイルがなければ例外をスローする
    } finally {
        return []; // 非推奨: 例外は失われ、呼び出し元は [] を受け取るだけ
    }
}

__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 をコールし、その結果の配列を渡してください。