上級

同じ名前付き引数を2回指定すると Named parameter overwrites エラーになる

PHP8の名前付き引数は、同じパラメータ名を2回指定すると致命的エラーになります。位置引数と名前付き引数を混ぜて書いた際に、同じパラメータへ二重に値を渡してしまうミスで起こります。

エラーメッセージの読み方

Fatal error: Uncaught Error: Named parameter $name overwrites previous argument in main.php:5

main.php

ファイル名

5

行番号 — 実際にクラッシュした行

Error

例外クラス — 何が起きたか。ここを検索するのが最短です

Named parameter $name overwrites previous argument

内容 — どの値が問題だったか

このエラーが出る典型パターン

 1  <?php
 2  function makeUser(string $name, int $age) {
 3      return "$name is $age";
 4  }
 5  echo makeUser(name: "Al", name: 20);
                                ^

 1  <?php
 2  function makeProduct(string $title, float $price) {
 3      return "$title: $price";
 4  }
 5  echo makeProduct(title: "Pen", title: 1.5);
                                     ^

 1  <?php
 2  function makeEvent(string $name, string $date) {
 3      return "$name on $date";
 4  }
 5  echo makeEvent(name: "Party", name: "2026-01-01");
                                    ^

 1  <?php
 2  function makeBooking(string $room, string $date) {
 3      return "$room on $date";
 4  }
 5  echo makeBooking(room: "A1", room: "2026-02-01");
                                   ^

 1  <?php
 2  function makeInvoice(string $client, float $amount) {
 3      return "$client: $amount";
 4  }
 5  echo makeInvoice(client: "Acme", client: 99.5);
                                        ^

よくある誤解

「後から指定した名前付き引数で上書きされるだけのはず」という思い込みは誤りです。PHPは意図しない上書きをバグの温床とみなし、実行時エラーとして止めます。

実務での勘所

典型的な発生パターンは、function greet($name, $greeting = "こんにちは")に対してgreet("太郎", name: "次郎")のように呼び出す場合です。最初の"太郎"は位置引数として1番目のパラメータ$nameに渡され、続くname: "次郎"という名前付き引数も同じ$nameを指しています。同じパラメータに2つの値を渡そうとしている以上、PHPはどちらを採用すべきか決められず、Named parameter overwrites previous argumentという分かりやすいメッセージ付きでエラーにします。

演習をはじめる

関連するエラー

• Cannot modify readonly property の原因と直し方readonlyを付けたプロパティは、コンストラクタの中で一度初期化した後は二度と値を変更できません。
• ArgumentCountError: Too few arguments passed の原因と直し方関数が必要とする数より少ない引数しか渡さなかったときに出るエラーです。