如何處理 PHP 8.1 中的回傳類型不符？

參考：...的返回類型應該與...相容，或者應該使用#[ReturnTypeWillChange]屬性

說明：返回類型協方差和已棄使用的功能

PHP 8.1 引入了方法回傳類型的行為變更。在先前的版本中，您可以定義方法而不指定返回類型。但是，PHP 8.1 現在預設要求從介面宣告或繼承的方法傳回類型。此變更旨在提高類型安全性並確保傳回值與介面約定保持一致。

當將傳回型別新增至先前的無型別方法時，PHP 8.1 會檢查傳回值的型別是否符合宣告的傳回值型別。例如，如果介面中的方法定義為：

<code class="php">interface Countable {
    public function count(): int;
}</code>

且實作Countable 的類別：

<code class="php">class Example implements Countable {
    public function count() {
        return 42;
    }
}</code>

PHP 8.1 將引發棄用通知，因為傳回值未明確輸入為整數，這與介面定義相矛盾。

解決方案：指定回傳類型或使用#[ReturnTypeWillChange] 屬性

要解決此問題，有兩個主要選項：

1. 指定回傳類型：您可以在類別實作中明確指定方法的傳回類型，確保其與介面定義相符。在這種情況下，您可以將count 方法更新為：

<code class="php">class Example implements Countable {
    public function count(): int {
        return 42;
    }
}</code>

2. 使用#[ReturnTypeWillChange] 屬性：如果您需要保持與舊版PHP 的相容性版本或計劃在將來變更返回類型，您可以使用#[ReturnTypeWillChange] 屬性暫時抑制棄用通知。這允許您將返回類型變更推遲到稍後的時間。此屬性的用法如下所示：

<code class="php">class Example implements Countable {
    #[\ReturnTypeWillChange]
    public function count() {
        return 42;
    }
}</code>

需要注意的是，PHP 9.0 打算強制執行回傳類型，因此不需要使用 #[ReturnTypeWillChange]。因此，建議逐步遷移程式碼以明確指定傳回類型，並儘可能刪除該屬性的使用。

以上是如何處理 PHP 8.1 中的回傳類型不符？的詳細內容。更多資訊請關注PHP中文網其他相關文章！