ルール
動的な 変数名 を 避ける
動的な 変数名 （可変変数） は、 保守が 困難な コード
や 予期せぬ 動作に つながる 可能性 が あります 。
その 使用は 通常、 タイプミス が 原因 です 。
対応言語: PHPはじめに
PHPの可変変数機能は、ある変数の値を別の変数の名前として使用することを可能にします。 $$ 構文。巧妙なショートカットに見えるものが、どの変数が存在し、何を含んでいるかを静的に判断できない場合、デバッグの悪夢と化します。使用するコードは $$userName 配列やオブジェクトプロパティの代わりに（何かを行うと）、IDEがオートコンプリートを提供すること、静的アナライザーがバグを検出すること、あるいは開発者がアプリケーション内のデータフローを追跡することが不可能になります。
なぜ重要なのか
コードの保守性：可変変数は、開発者が依存するあらゆるツールを破壊します。IDEは変数名のオートコンプリート、使用箇所の検索、安全なリファクタリングができません。静的解析ツールは未定義の変数や型ミスマッチを検出できません。変数がどこで設定または読み取られているかを見つけるためにコードベースをgrepできないため、デバッグにはランタイム検査が必要です。
セキュリティへの影響： 変数名がユーザー入力から来る場合、攻撃者はセキュリティ上重要な変数を含め、任意の変数を上書きできます。悪意のあるリクエストパラメータは、～を標的にする可能性があります。 $$_GET['var'] 上書きするには $isAdmin, $userIdまたはセッション変数。これにより、検出が困難でエクスプロイトが容易な変数インジェクションの脆弱性が発生します。
パフォーマンスへの影響: 可変変数を使用すると、PHPはコンパイル時のシンボル解決ではなく、実行時のルックアップを実行せざるを得なくなります。インタープリタはアクセスごとに変数名を動的に評価する必要があり、通常の変数で機能する最適化が妨げられます。配列とオブジェクトは、より優れたパフォーマンス特性で同様の機能を提供します。
コード例
❌ 非準拠：
function processFormData($formType) {
$userForm = ['name' => '', 'email' => ''];
$adminForm = ['name' => '', 'email' => '', 'role' => ''];
$formName = $formType . 'Form';
$$formName = array_merge($$formName, $_POST);
if ($$formName['email']) {
sendEmail($$formName['email']);
}
return $$formName;
}
// What variable does this actually use?
processFormData('user');
誤っている理由： コードは$userFormまたはを作成します $adminForm 動的に使用する $$formName, どの変数が変更されているかを追跡することが不可能になります。もし $formType ユーザー入力に由来する場合、攻撃者は任意の変数名を注入して重要な変数を上書きする可能性があります。
✅ 準拠済み:
function processFormData(string $formType): array {
$forms = [
'user' => ['name' => '', 'email' => ''],
'admin' => ['name' => '', 'email' => '', 'role' => '']
];
if (!isset($forms[$formType])) {
throw new InvalidArgumentException('Invalid form type');
}
$form = array_merge($forms[$formType], $_POST);
if (!empty($form['email'])) {
sendEmail($form['email']);
}
return $form;
}
// Clear which data structure is being used
processFormData('user');
これが重要な理由：コードは既知のキーを持つ明示的な配列を使用しており、データフローを明確にし、すべてのIDE機能を有効にします。入力検証はインジェクション攻撃を防ぎ、静的解析はコードが正しいことを検証できます。
まとめ
可変変数を配列、オブジェクト、またはより良いコード構造に置き換えます。動的なキーアクセスが必要な場合は配列を使用し、既知のプロパティを持つ構造化データにはオブジェクトを使用し、重複するロジックは適切な抽象化にリファクタリングします。可変変数は、適切なデータ構造によってより明確に解決できる設計上の問題を示していることがほとんどです。
