新的返回类型 PHP 8.1 - PHP

介绍

PHP 8.1 在返回类型上做了一些重大的变化。 这些变化影响了函数、方法和接口方法的返回类型注释。

在 PHP 8.0 及更早的版本中，支持以下几种返回类型：

• void
• 类的名称、接口或 trait 名称。
• 数组
• \Generator
• \Traversable
• 所有内置类型
• 可使用 (类型) 表达式表示的任何类型

在 PHP 8.1 中，我们可以定义多个返回类型和返回类型联合类型。

多个返回类型

PHP 8.1 允许函数和方法指定多种返回类型。可以使用 pipe 符号（|）分隔各种类型。例如：

function example(): string | int
{
    // ...
}

在这个例子中，函数example()可以返回两种不同类型的值。

返回类型联合类型

PHP 8.1 中还支持返回类型联合类型。返回类型联合类型是指代多个可能类型的返回值的类型。

使用返回类型联合类型，可以更准确地指定函数或方法可能的返回类型。

function foo(): int|string
{
    if (rand(0, 1) === 0) {
        return 42;
    }
    return 'forty two';
}

在这个例子中，函数 foo() 返回 int 或 string 之一。 这在您需要返回多种可能的返回类型时非常有用。

结论

以上介绍了 PHP 8.1 在多个返回类型和返回类型联合类型方面的变化。 此外，从 PHP 8.1 开始，还可以将 void 作为联合类型的一部分返回。

这两个变化为 PHP 开发者更详细地说明了他们的函数和方法的可能返回值。 返回类型的详细说明使代码更加清晰，并提高了代码的可读性和可维护性。