從'混合到`void'：php返回類型聲明的實用指南

通過指定函數必須返回的內容，返回PHP中的類型提高了代碼的可靠性和清晰度。 2。使用字符串，數組或DateTime等基本類型來執行正確的返回值並儘早捕獲錯誤。 3。應用無效類型？ （例如？字符串）何時為有效的返回值。 4.使用void進行執行操作的功能而無需返回數據，僅允許返回；或沒有返迴聲明。 5。 php 8.0中的利用聯合類型（例如，字符串| int | bool）用於返回多種不同類型的功能。 6.更喜歡明確的返回類型聲明，而不是混合的隱式，以增強IDE支持和可維護性。 7.避免過度使用工會類型並混合，保留在任何類型的預期的情況下混合使用。 8.通過將返回類型與其行為對準，例如將false轉換為null的null來仔細處理內部PHP功能。 9。不要在空隙函數中返回null以防止混亂，即使在技術上允許。 10。從核心邏輯和API開始，逐步採用返回類型，以使代碼更容易預測，更容易發生錯誤，同時保持可讀性和意圖。

PHP的類型系統自早期以來就已經顯著發展，而返回類型聲明是編寫更可預測和可維護的代碼的基石。如果您曾經使用過鬆散鍵入的PHP功能（無需任何明確的合同而沒有任何明確的合同null ，您可能會遇到難以追踪的錯誤。這就是返回類型的來源。

從PHP 7.0開始，您現在可以指定功能應返回的功能，從而幫助引擎和隊友了解您的代碼意圖。本指南使您無法使用不使用類型（ mixed並非總是明確的）來擁抱void ，並提供實踐的例子和最佳實踐。

為什麼返回類型很重要

在研究語法之前，值得了解為什麼返回類型會有所幫助：

• 儘早捕獲錯誤：當您期望字符串時返回數組？ PHP會拋出TypeError。
• 提高代碼可讀性：任何閱讀您的功能的人都知道會發生什麼。
• 啟用更好的IDE支持：自動完成，重構和直列文檔變得更加準確。
• 鼓勵故意設計：您對您的功能應該返回的內容更加努力。

沒有返回類型，所有內容都是mixed ，這是任何類型的值。雖然靈活，但這會導致不確定性。返回類型可讓您縮小範圍。

基本返回類型：從字符串到對象

您可以聲明所有常見類型的退貨類型：

函數getUsername（）：字符串{
    返回“愛麗絲”；
}

函數getUserData（）：array {
    返回['name'=>'alice'，'age'=> 30];
}

函數CreateTateTion（）：DateTime {
    返回new dateTime（）;
}

如果您違反合同：

函數getUsername（）：字符串{
    返回null; //致命錯誤：返回值必須是類型字符串，null返回
}

除非您允許使用無效類型顯式null ：

 function getUsername（）：？ string {
    返回null; //這現在有效
}

這?前綴表示“這種類型或無效”。

何時使用void ：不返回任何東西的函數

當功能執行操作時，請使用void ，但不會返回有意義的數據（例如記錄，打印或修改狀態）。

函數logmessage（字符串$消息）：void {
    file_put_contents（'log.txt'，$message。php_eol，file_append）;
    //無需返回語句
}

或帶有明確的return; ：

功能Abortifnotadmin（用戶$用戶）：void {
    如果（！$ user-> isadmin（））{
        死（“訪問被拒絕”）；
    }
    返回; //可選，但允許
}

void的關鍵規則：

• 您無法返回值： return 5; →致命錯誤。
• return;沒有允許的值（與不返回相同）。
• null也不是有效的返回值。

這實現了這樣的想法：“此功能可以做點什麼，但沒有給您任何回報。”

處理具有工會類型的可選或多種類型（PHP 8.0）

在PHP 8.0之前，您無法表達“返回字符串或布爾”。現在您可以：

函數finduser（int $ id）：？ user {
    //返回用戶或null
}

工會類型更好：

功能processInput（$ input）：字符串| int | bool {
    如果（$ input ===''）{
        返回false;
    }
    if（is_numeric（$ input））{
        返回（int）$輸入;
    }
    返回裝飾（$輸入）;
}

這使得返回合同明確而不是將其作為無證件的mixed 。

？提示：避免過度使用工會類型。如果功能返回太多類型，請考慮是否做得太多。

常見的陷阱和最佳實踐

這裡有幾件事要注意：

• 不要僅僅為此添加類型
  從關鍵功能（API，核心邏輯）開始，而不是每個助手。

• 小心內部PHP功能
  有些人在失敗時返回false （例如， strpos() ）。匹配期望：

  函數FindPosition（字符串$ Haystack，字符串$針）：？ int {
      $ pos = strpos（$ haystack，$針）;
      返回$ pos === false？ null：$ pos;
  }

  現在返回類型是?int ，哪個比int|false更清晰。

• 有意使用mixed （PHP 8.0）
  如果功能真正接受或返回任何類型，請使用mixed ：

  函數debugprint（混合$ value）：void {
      var_dump（$ value）;
  }

  這總比沒有類型的提示好。

• 避免return null;在void函數中
  雖然允許，但它可能會使讀者感到困惑。除非您提早退出，否則請return 。

---

概括

從未型（由公約mixed ）轉移到良好的功能使您的PHP代碼更加穩健：

• 當您知道返回值時，請使用特定類型（ string ， array ， User ）。
• 使用?Type null有效響應。
• 使用void用於僅副作用的功能。
• 預期多種類型時，請使用聯合類型（ string|int ）。
• 謹慎和故意使用mixed 。

目標不是在最大程度上鍵入所有內容，而是要使您的代碼的行為更清晰，更容易出錯。

基本上：如果您的函數承諾返回類型，請確保它保持這一承諾。 PHP將幫助您執行它。

以上是從'混合到`void'：php返回類型聲明的實用指南的詳細內容。更多資訊請關注PHP中文網其他相關文章！