上級

enumのfrom()に存在しない値を渡すと ValueError になる

バックドenum（値を持つenum）のfrom()メソッドは、対応するcaseが存在しない値を渡すとValueErrorを投げます。外部からの入力値をそのままfrom()に渡す場合は、事前の検証やtryFrom()の利用が必要です。

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

Fatal error: Uncaught ValueError: "pending" is not a valid backing value for enum Status in main.php:6

main.php

ファイル名

6

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

ValueError

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

"pending" is not a valid backing value for enum Status

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

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

 1  <?php
 2  enum Status: string {
 3      case Active = 'active';
 4      case Inactive = 'inactive';
 5  }
 6  $s = Status::from('pending');
                          ^
 7  echo $s->value;

 1  <?php
 2  enum Level: int {
 3      case Low = 1;
 4      case High = 2;
 5  }
 6  $l = Level::from(3 );
                      ^
 7  echo $l->name;

 1  <?php
 2  enum Currency: string {
 3      case Yen = 'JPY';
 4      case Dollar = 'USD';
 5  }
 6  $c = Currency::from('EUR');
                          ^
 7  echo $c->name;

よくある誤解

「from()は該当が無ければnullを返すだけのはず」という思い込みは誤りです。nullを返すのはtryFrom()の役割で、from()は該当が無ければ必ず例外を投げます。

まとめ

enumのfrom()に存在しない値を渡すと ValueError になるは上級でつまずきやすい項目です。上の3パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

• match式で該当する条件が無いと UnhandledMatchError になるmatch式は該当するcaseが1つも無いと、switch文のように黙って何もしないのではなく、UnhandledMatchErrorという例外を投げます。
• 同じ名前付き引数を2回指定すると Named parameter overwrites エラーになるPHP8の名前付き引数は、同じパラメータ名を2回指定すると致命的エラーになります。