「Mixed」から「void」まで：PHPリターンタイプ宣言の実用的なガイド

PHPのリターンタイプは、関数が返さなければならないものを指定することにより、コードの信頼性と明確さを改善します。 2.文字列、配列、またはデータなどの基本タイプを使用して、正しい返品値を強制し、早期にエラーをキャッチします。 3.ヌル可能なタイプを適用しますか？ （例、？文字列）nullが有効な返品値である場合。 4.データを返すことなくアクションを実行する関数にvoidを使用し、返品のみを許可します。または返品声明はありません。 5.複数の異なるタイプを返す関数のために、PHP 8.0のユニオンタイプ（例：string | int | bool）をレバレッジします。 6. IDEのサポートと保守性を高めるために、暗黙の混合よりも明示的なリターンタイプ宣言を好みます。 7.組合の種類を過剰に使用し、混合され、あらゆるタイプが本当に期待される場合の混合を予約しないでください。 8。fals for？intのnullにfalseを変換するなど、返品タイプを動作に合わせることにより、内部PHP関数を慎重に処理します。 9.技術的には許可されていても、混乱を防ぐためにvoid関数でnullを返さないでください。 10.コアロジックとAPIから始めて、読みやすさと意図を維持しながらコードをより予測可能にし、エラーが発生しないようにするために、徐々にリターンタイプを採用します。

PHPのタイプシステムは、初期から大幅に進化しており、リターンタイプの宣言は、より予測可能で保守可能なコードを書くことの基礎です。明確な契約なしで文字列、配列、またはnullを緩めたPHP関数を緩やかに型付けしたことがある場合は、トレースが難しいバグに遭遇した可能性があります。それが戻りの種類が入ってくるところです。

PHP 7.0から始めて、機能が返されるものを指定して、エンジンとチームメイトの両方がコードの意図を理解するのに役立ちます。このガイドでは、実用的な例とベストプラクティスを使用して、NOタイプ（常に明示mixedはありませんが、常に明示的ではありvoidんが、常に明示的ではありませんが）を使用することから説明します。

なぜ返すタイプが重要なのか

構文に潜る前に、なぜ返品タイプが役立つのかを理解する価値があります。

• 早めにバグをキャッチ：文字列を期待したら配列を返しますか？ PHPはTypeRrorを投げます。
• コードの読みやすさの向上：あなたの機能を読んでいる人は誰でも何を期待するかを知っています。
• より良いIDEサポートを有効にする：オートコンプリート、リファクタリング、およびインラインドキュメントがより正確になります。
• 意図的なデザインを奨励してください：あなたの機能が何を返すべきかについてもっと難しいと思います。

返品タイプがなければ、すべてが効果的にmixed - あらゆるタイプの値。柔軟ですが、これは不確実性につながります。返品タイプでそれを絞り込むことができます。

基本的な返品タイプ：文字列からオブジェクトまで

すべての一般的なタイプの返品タイプを宣言できます。

関数getUsername（）：string {
    「アリス」を返します。
}

function getUserData（）：array {
    ['name' => 'alice'、 'age' => 30]を返します。
}

関数createdateTime（）：dateTime {
    new DateTime（）を返します。
}

契約を破った場合：

関数getUsername（）：string {
    nullを返します。 //致命的なエラー：戻り値は型文字列でなければならず、nullは返されます
}

Nullableタイプを明示的に使用してnullを許可しない限り：

関数getUsername（）：？string {
    nullを返します。 //これは有効になりました
}

?プレフィックスは「このタイプまたはヌル」を意味します。

voidを使用する時期：何も返さない関数

関数がアクションを実行しますが、ロギング、印刷、または状態の変更など、意味のあるデータを返さない場合はvoidを使用します。

関数logmessage（string $ message）：void {
    file_put_contents（ 'log.txt'、$message。php_eol、file_append）;
    //返品ステートメントは必要ありません
}

または明示的なreturn; ：

 function abortifnotadmin（user $ user）：void {
    if（！$ user-> isadmin（））{
        die（ 'アクセス拒否'）;
    }
    戻る; //オプションですが、許可されています
}

voidの重要なルール：

• 値を返すことはできません： return 5; →致命的なエラー。
• return;価値は許可されていません（戻ってこないのと同じ）。
• nullも有効な返品値ではありません。

これにより、「この関数は何かをしますが、何もしません。」

ユニオンタイプを使用したオプションまたは複数のタイプの処理（PHP 8.0）

PHP 8.0の前に、「これは文字列またはブールを返す」を表現できませんでした。今、あなたはできます：

 function finduser（int $ id）：？user {
    //ユーザーまたはnullを返します
}

組合タイプでさらに良い：

 function processinput（$ input）：string | int | bool {
    if（$ input === ''）{
        falseを返します。
    }
    if（is_numeric（$ input））{
        return（int）$ input;
    }
    return trim（$ input）;
}

これにより、リターン契約は、文書化されていないmixedとして残すのではなく、明示的になります。

？ヒント：組合タイプの過剰使用を避けてください。関数があまりにも多くのタイプを返している場合は、あまりにも多くのことをしているかどうかを検討してください。

一般的な落とし穴とベストプラクティス

注意すべきことがいくつかあります：

• そのためだけにタイプを追加しないでください
  すべてのヘルパーではなく、クリティカル関数（API、コアロジック）から始めます。

• 内部PHP関数には注意してください
  障害時にfalseを返すもの（例： strpos() ）。期待の一致：

  関数FindPosition（String $ HayStack、String $ edele）：？int {
      $ pos = strpos（$ haystack、$ edele）;
      $ $ pos === falseを返しますか？ null：$ pos;
  }

  これで、返品タイプは?int 、 int|falseより明確です。

• 意図的にmixed使用する（PHP 8.0）
  関数が真に任意のタイプを受け入れるか返す場合は、 mixed使用してください。

   function debugprint（mixed $ value）：void {
      var_dump（$ value）;
  }

  これは、タイプのヒントがまったくないよりも優れています。

• return null; void関数で
  許可されていますが、読者を混乱させることができます。早めに終了しない限り、 returnを省略します。

---

まとめ

Untyped（ mixed By Convention）から裕福な機能に移行すると、PHPコードがより堅牢になります。

• 返品値を知っている場合は、特定のタイプ（ string 、 array 、 User ）を使用します。
• nullが有効な応答である場合?Type使用します。
• 副作用のみの関数にはvoidを使用します。
• 複数のタイプが予想される場合は、ユニオンタイプ（ string|int ）を使用します。
• 控えめに、意図的にmixed使用します。

目標は、すべてを最大限に入力することではなく、コードの動作をより明確にし、エラーが発生しないようにすることです。

基本的に：関数が返品タイプを約束する場合は、その約束を維持していることを確認してください。 PHPはあなたがそれを実施するのに役立ちます。

以上が「Mixed」から「void」まで：PHPリターンタイプ宣言の実用的なガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。