PHP 8.1 移行時の null パラメータ警告の解決方法

重要情報

PHP 8.1 では、コア関数に null を渡すと非推奨警告が発生します。この変更は PHP 9.0 でエラーになる予定のため、事前の対応が必要です。

問題の概要

PHP 8.1 では htmlspecialchars()、trim()、strlen() などの多くの組み込み関数に null 値を渡すと、以下のような非推奨警告が発生します：

Deprecated: Passing null to parameter #1 ($string) of type string is deprecated

これまで null は暗黙的に空文字列に変換されていましたが、PHP 8.1 からは明示的な対応が必要になりました。

推奨される解決方法

基本的な修正：null 合体演算子の使用

最も簡単で安全な解決方法は、null 合体演算子 (??) を使用することです：

php

// 修正前
$result = htmlspecialchars($input);

// 修正後
$result = htmlspecialchars($input ?? '');

この方法は、ほとんどのケースで安全に動作し、元の挙動を維持します。

型キャストによる明示的な変換

文字列処理関数に対しては、明示的な型キャストも有効です：

php

// 修正前
$length = strlen($value);

// 修正後
$length = strlen((string)$value);

注意点

型キャストは null を空文字列に変換しますが、数値や配列などの他の型も文字列に変換するため、意図しない動作になる可能性があります。

大規模コードベースの効率的な対応

自動修正ツールの活用

Rector を使用すると、コードベース全体を自動的に修正できます：

php

// Rector 設定例
use Rector\Config\RectorConfig;
use Rector\Php81\Rector\FuncCall\NullToStrictStringFuncCallArgRector;

return static function (RectorConfig $rectorConfig): void {
    $rectorConfig->rule(NullToStrictStringFuncCallArgRector::class);
};

Rector は mb_strtolower($value) を mb_strtolower((string) $value) に自動変換します。

正規表現を使用した一括置換

正規表現を使用して特定の関数呼び出しを一括修正することも可能です：

検索パターン:

htmlspecialchars\((\$\w+)\)

置換パターン:

htmlspecialchars($1 ?? '')

注意

正規表現を使用した置換は、複雑な式やネストされた関数呼び出しでは正確に動作しない可能性があります。必ず置換後のコードを確認してください。

カスタム関数の作成と活用

ラッパー関数の定義

頻繁に使用する関数用のカスタムラッパーを作成できます：

php

function safe_trim(?string $value): string
{
    return trim($value ?? '');
}

function safe_htmlspecialchars(?string $string, int $flags = ENT_QUOTES, ?string $encoding = null, bool $double_encode = true): string
{
    return htmlspecialchars($string ?? '', $flags, $encoding, $double_encode);
}

名前空間を利用した関数オーバーライド

カスタム名前空間で関数を再定義することで、組み込み関数をオーバーライドできます：

php

namespace My\Utils;

function trim(?string $value): string
{
    return \trim($value ?? '');
}

// 使用例
use function My\Utils\trim;

$result = trim($possiblyNullValue);

テンプレートエンジンやフレームワークでの対応

Smarty テンプレートでの対応

php

// カスタム修飾子の登録
$smarty->registerPlugin('modifier', 'safe_trim', function ($value) {
    return empty($value) ? '' : trim($value);
});

// テンプレート内での使用
{$variable|safe_trim}

Laravel フレームワークでの例

php

// 修正前
return trim($old, '/');

// 修正後
return trim((string)$old, '/');

エラーレポートの調整（一時的な対策）

本質的な解決ではありませんが、移行期間中のみ非推奨警告を抑制する方法もあります：

php

// 非推奨警告のみを無効化
error_reporting(E_ALL & ~E_DEPRECATED);

警告

この方法はあくまで一時的な対策です。本番環境では非推奨警告を無効化せず、根本的な修正を行うことを推奨します。

推奨アプローチの比較

方法	利点	欠点	適したケース
Null 合体演算子	簡潔、安全	各呼び出しの修正が必要	小〜中規模の修正
型キャスト	簡潔、広範囲に対応	型変換の副作用あり	文字列系関数全般
Rector	自動化可能、一貫性あり	設定が必要	大規模プロジェクト
カスタム関数	再利用可能、制御しやすい	関数呼び出しの変更が必要	プロジェクト全体の標準化

まとめ

PHP 8.1 の null パラメータに関する非推奨警告への対応は、以下のように段階的に進めることを推奨します：

現状把握: 影響範囲の特定
優先順位付け: よく使用される関数から修正
自動化: Rector や一括置換の活用
テスト: 修正後の挙動確認
標準化: カスタム関数による今後の予防

適切に対応することで、PHP 9.0 へのスムーズな移行と、より堅牢なコードベースの構築が可能になります。

関連記事

PHP 8.1 移行時の null パラメータ警告の解決方法 ​

問題の概要 ​

推奨される解決方法 ​

基本的な修正：null 合体演算子の使用 ​

型キャストによる明示的な変換 ​

大規模コードベースの効率的な対応 ​

自動修正ツールの活用 ​

正規表現を使用した一括置換 ​

カスタム関数の作成と活用 ​

ラッパー関数の定義 ​

名前空間を利用した関数オーバーライド ​

テンプレートエンジンやフレームワークでの対応 ​

Smarty テンプレートでの対応 ​

Laravel フレームワークでの例 ​

エラーレポートの調整（一時的な対策） ​

推奨アプローチの比較 ​

まとめ ​