作成しているPHPのWEBアプリケーションで今後、非推奨になる変数の型を開発者のみに伝えたい場合どうすればよいか？

Question

現在、PHP 7.0でWEBアプリケーションを作成しています。

その中で、将来的に非推奨したい値の方が発生し、それを開発者のみに通知したいと考えています。

簡易的なコードで全体像を示すと、

function hello($value)
{
   if (!is_bool($value)) {
      // $valueがboolでなければ非推奨と通知したい <-- ココが知りたい
      // 開発者に対して通知はするが、処理は続行
   }

   // if (is_bool($value) or is_string($value)) {
      // $valueの方がboolでも、stringでも動く実装
      // ただし、今後string型は廃止していく予定
   }
}

現状trigger_errorのE_DEPRECATEDぐらいしか想像できないのですが、これ以外で実装できる方法を探しています。

• PHPマニュアル エラー処理 - 定義済み定数

よろしくお願いします。

Answer 1

他はphpdocで@deprecatedを書いておくとかですか。

自分ならどうするかなら
不特定多数が使うライブラリでないなら「将来的に」とか考える必要はなく、開発者に伝えた上ですぐ変更すればいいだけのことです。

Comments

[maisumakun]

巨大なシステムを作っていると、「どこで使っているかわからない」ために、使っていないであろうメソッドもとりあえず残して様子見、となることも多いです（使うメソッド名を動的に変える、なんて処理が入ると、どうしても見落としがちとなってしまいます）。

Answer 2

質問内容がよく分かりませんが、条件で分岐しているのであれば、ログに残せばよいのでは？