PHP类型提示

在 PHP 中，类型提示指的是函数或方法的参数必须与特定类型的值一起使用。它在编写更安全和健壮的代码时非常有用。

基本类型提示

在 PHP 中，您可以通过将函数或方法的参数前面添加类型限制，来指定参数接受的数据类型。例如，如果您希望一个函数或方法的参数是整数类型，则可以在函数或方法的参数列表中添加 int 类型。

function myFunction(int $number) {
    // ...
}

现在，如果您尝试将非整数类型的值传递给该函数，将会引发一个 TypeError 错误。

myFunction("1"); // TypeError: Argument 1 passed to myFunction() must be of the type integer, string given

此外，您还可以在参数类型前面添加一个问号，表示该参数可以是 null 值。

function myFunction(?string $text) {
    // ...
}

对象类型提示

您还可以在函数或方法的参数中指定一个特定的对象类型。这种类型的提示确保参数是一个特定类的对象。

function myFunction(MyClass $object) {
    // ...
}

这将只允许传递一个 MyClass 的对象。如果您尝试传递一个不是 MyClass 对象的对象，将会引发一个 TypeError 错误。

myFunction(new OtherClass()); // TypeError: Argument 1 passed to myFunction() must be an instance of MyClass, instance of OtherClass given

可输入多种类型的类型提示

在 PHP 7.0 及更高版本中，您可以指定一个或多个类型，以使用 | 连接。这表示参数可以是多个类型之一。

function myFunction(string|int $input) {
    // ...
}

这允许您在方法或函数中使用多个类型的参数。但是，这种类型提示仅在 PHP 7.0 及更高版本中可用。如果您使用的是旧版本的 PHP，则必须分别检查每种类型。

继承类型提示

继承类型提示允许您指定一个父类或接口，以允许该类或其子类的所有实例作为函数或方法的参数。

class MyParentClass {}
class MyChildClass extends MyParentClass {}

function myFunction(MyParentClass $object) {
    // ...
}

在这种情况下，您可以传递 MyParentClass 类或其子类 MyChildClass 的实例。

总结

PHP 类型提示是一种有效的帮助您编写更安全和健壮的代码的工具。无论您编写的是小型项目还是大型项目，它都能帮助您避免常见的程序错误，并促进您的代码的可读性和可维护性。