導入
PHPのReflection APIを活用する際、特定の関数がphp.iniの「disable_functions」で制限されているかどうかを確認するために「ReflectionFunction::isDisabled」を利用していた方も多いのではないでしょうか。しかし、PHP 8.0以降、このメソッドは「非推奨（Deprecated）」となり、非常に重要な仕様変更が行われました。本記事では、なぜこのメソッドが不要になったのか、そしてモダンなPHP環境で安全に関数をチェックする方法を解説します。
基礎知識
「disable_functions」は、セキュリティ上の理由から、特定の危険な関数（exec, shell_exec, systemなど）をPHPの実行環境から無効化するためのphp.ini設定です。
これまで「ReflectionFunction::isDisabled」は、Reflectionオブジェクトを生成した後に、その関数が「disable_functions」に含まれているかをプログラム側で検知するために使われていました。しかし、PHP 8.0からは、そもそも「無効化された関数」に対してReflectionFunctionをインスタンス化しようとすると、例外（ReflectionException）がスローされる仕様に変更されました。つまり、インスタンスが生成できた時点で、その関数は利用可能であると保証されるようになったのです。
実装/解決策
PHP 8.0以降では、特定の関数が利用可能かどうかを調べるためにReflectionに頼る必要はありません。最もシンプルかつ高速な方法は、関数が定義されているかを返す「function_exists」を使用することです。これにより、オーバーヘッドを最小限に抑えつつ、直感的なコードで安全性を担保できます。
サンプルプログラム
以下に、モダンなPHP環境における関数呼び出しの安全な判定処理の例を示します。
/
function isFunctionSafeToCall(string $functionName): bool
{
// 1. function_existsは、disable_functionsの影響も考慮して
// 関数が利用可能であればtrueを返します。
if (function_exists($functionName)) {
return true;
}
// 2. そもそも定義されていないか、無効化されている場合はfalseを返す
return false;
}
$target = ‘shell_exec’;
if (isFunctionSafeToCall($target)) {
echo “{$target} は実行可能です。安全に処理を開始します。”;
} else {
// ログ出力やフォールバック処理を記述
echo “{$target} は無効化されているか、環境に存在しません。”;
}
?>
応用・注意点
現場での開発において注意すべき点は、「既存の古いコードベースからの移行」です。もしPHP 7系から8系へマイグレーションを行っている場合、従来の「ReflectionFunction::isDisabled」を呼び出している箇所では、PHP 8.0以降で非推奨警告（Deprecated）が発生します。
また、もし「どのような関数が無効化されているか」を動的に取得したい場合は、Reflectionではなく「ini_get(‘disable_functions’)」を利用して設定値を直接読み取るのが適切です。
ただし、ini設定を解析するよりも、上記サンプルコードのように「実行したい関数が実際に呼べる状態か」を個別にチェックする設計の方が、可読性と保守性の観点から強く推奨されます。特にフレームワークやライブラリを開発している場合は、実行環境に依存しない堅牢なチェックロジックを心がけましょう。