PHP函數返回值類型

在PHP中，函數返回值類型定義了函數在調用後返回的數據類型。PHP 7開始支持指定函數返回類型，這讓代碼更加清晰和可靠。本文將從多個方面對PHP函數返回值類型進行詳細的闡述。

一、基本數據類型

PHP支持多個基本數據類型的函數返回類型，包括int，float，string，bool和void。在函數聲明時使用一個冒號後跟類型名稱指定返回類型。示例代碼如下：

function add(int $num1, int $num2): int {
    return $num1 + $num2;
}

function getPrice(float $price, float $discount_rate): float {
    return $price * $discount_rate;
}

function getUsername(string $fullname): string {
    $name_parts = explode(" ", $fullname);
    return $name_parts[0];
}

function isActive(bool $status): void {
    if($status) {
        echo "Active";
    } else {
        echo "Inactive";
    }
}

二、對象和類類型

除了基本數據類型之外，PHP函數還可以返回對象和類實例類型。如果使用對象或類類型作為返回類型，您需要在返回類型前面加上類名稱或接口名稱。示例代碼如下：

class User {
    public $name;
    public $email;
}

function getUser(): User {
    $user = new User();
    $user->name = "John";
    $user->email = "john@example.com";
    return $user;
}

interface Calculator {
    public function add(int $num1, int $num2): int;
}

class SimpleCalculator implements Calculator {
    public function add(int $num1, int $num2): int {
        return $num1 + $num2;
    }
}

三、Nullable類型

有時候我們需要在函數返回類型中使用null，這時我們需要使用Nullable類型。在類型名稱前加上一個問號表示此類型是可空的。示例代碼如下：

function getAge(?int $age): ?int {
    return $age;
}

這個函數可以返回整數或null。註：要使用可空類型，你需要php7.1以上版本支持。

四、Mixed類型

Mixed類型代表了無法確定返回類型。這個類型不推薦使用，但是它在某些情況下是很有用的。

function process($data) : mixed {
    // process data here
}

五、Union類型

Union類型是指函數可以返回多個類型中的一個，用豎線“|”分隔。以下是一個小例子：

function double($value): int|float{
    return $value * 2;
}

此函數可以返回整數或浮點數。

總結

本文從各個方面對PHP函數返回值類型進行了詳細的介紹，包括基本數據類型、對象和類類型、Nullable類型、Mixed類型和Union類型。通過合理使用這些類型，可以讓我們的代碼更加清晰和可靠。