PHP从早期版本开始逐步引入类型提示功能，并在后续版本中不断完善相关特性。类型提示能够帮助开发者在函数参数、返回值以及类属性等位置明确指定数据类型，让代码的意图更加清晰，同时可以减少因类型不匹配而引发的潜在缺陷。通过类型提示，PHP能够在运行时自动校验数据的类型，一旦发现类型不符合预期，便会抛出TypeError异常，从而促使开发者更早地发现并修复问题。合理使用类型提示，可以显著提升代码的可读性、可维护性和健壮性。
函数参数与返回值类型提示
在PHP中，函数参数类型提示允许开发者定义函数时，为每一个参数指定预期的数据类型。当调用函数时，如果传入的参数类型与声明不符，PHP会抛出TypeError错误，从而避免错误类型的数据进入函数内部参与计算或逻辑处理。参数类型提示支持标量类型，例如int、float、string、bool，也支持复合类型，例如array、callable、iterable，还可以指定自定义类、接口或抽象类的类型。这种机制让函数接口更加明确，调用方能够快速了解参数应该传递什么类型的数据。
下面通过一个示例来展示函数参数类型提示的基本用法。示例中定义了多个函数，分别约束参数为字符串、数组以及自定义类的实例，并演示了正确调用与错误调用的区别。
<?php
// 指定参数必须为字符串类型
function showUserName(string $name): void {
echo "姓名：" . $name;
}
// 指定参数必须为数组类型，并返回数组元素之和
function sumList(array $numbers): int {
return array_sum($numbers);
}
class User {}
// 指定参数必须为User类的实例
function processUser(User $user): string {
return "用户对象已处理";
}
// 正确调用
showUserName("李四");
echo sumList([1, 2, 3, 4]);
$user = new User();
echo processUser($user);
// 下面调用会抛出TypeError
// showUserName(123);
?>
除了参数类型提示，PHP还支持返回值类型提示。从PHP 7.0版本开始，开发者可以在函数定义的末尾使用冒号加类型的方式来声明函数返回值的类型。如果函数内部实际返回的值与声明类型不一致，同样会抛出TypeError错误。返回值类型提示能够让函数的调用者明确知道函数会返回什么类型的数据，便于后续处理。对于可能返回null的情况，可以在类型前添加问号，表示该返回值类型允许为null。例如?User表示返回值可以是User对象，也可以是null。
下面的示例展示了返回值类型提示的用法，包括普通类型返回值和可空类型返回值。
<?php
class Member {}
// 指定返回值必须为int类型
function multiply(int $a, int $b): int {
return $a * $b;
}
// 使用?前缀表示返回值可以为null
function findMemberById(int $id): ?Member {
if ($id > 0) {
return new Member();
}
return null;
}
// 正确调用
$result = multiply(6, 7);
$member = findMemberById(10);
// 错误示例：返回类型与声明不一致会抛出TypeError
function wrongResult(): string {
return 100;
}
?>
类属性类型提示与严格类型模式
类属性类型提示是PHP 7.4版本引入的一个重要特性。在较早的版本中，开发者通常需要通过构造函数、setter方法或者手动类型判断来保证类属性的数据类型符合预期。而有了属性类型提示之后，可以直接在类属性声明时指定其类型，例如public string $name或public array $tags。这样不仅能够简化代码，还能从语言层面提供更严格的类型约束。属性类型提示同样支持标量类型、复合类型以及自定义类类型，并且可以使用问号前缀来表示属性允许为null。
通过属性类型提示，类的内部结构变得更加清晰，外部代码在访问或赋值属性时也会受到类型约束。如果尝试给类型不匹配的属性赋值，PHP会立即抛出TypeError异常，从而避免错误数据残留在对象内部。下面的示例演示了属性类型提示的定义方式和错误赋值的情况。
<?php
class Product {
// 属性类型提示：字符串
public string $title;
// 属性类型提示：可为null的浮点数
public ?float $price;
// 属性类型提示：数组
public array $tags;
public function __construct(string $title, ?float $price, array $tags) {
$this->title = $title;
$this->price = $price;
$this->tags = $tags;
}
}
$product = new Product("显示器", 1299.90, ["办公", "外设"]);
echo $product->title;
// 错误赋值会抛出TypeError
// $product->title = 123;
?>
PHP默认采用弱类型模式进行类型提示。所谓弱类型，指的是当传入的数据类型与声明类型不同但可以转换时，PHP会自动进行类型转换。例如，如果函数参数声明为int类型，而传入的是字符串"18"，在弱类型模式下字符串会被自动转换为整数18。这种自动转换虽然方便，但在某些业务场景下可能会掩盖潜在的数据类型错误，导致难以排查的逻辑问题。为了提供更严格的类型校验，PHP允许在脚本开头使用declare(strict_types=1)来启用严格类型模式。
在严格类型模式下，类型提示将不再进行自动类型转换。如果传入的参数类型或返回值的类型与声明完全不一致，PHP会直接抛出TypeError错误，而不是尝试转换。需要注意的是，严格类型声明必须放在脚本的最开始位置，前面不能有任何输出或语句。严格类型模式有助于在开发阶段尽早暴露类型问题，尤其适合对数据类型要求较高的应用场景。以下示例展示了严格类型模式下的行为。
<?php
declare(strict_types=1); // 严格类型声明必须放在脚本开始位置
function showAge(int $age): void {
echo "年龄：" . $age;
}
// 严格模式下，传入字符串"20"不会自动转为int，会直接抛出TypeError
showAge("20");
?>
类型提示支持范围与开发注意事项
PHP的类型提示支持多种数据类型，主要可以分为几个类别。标量类型包括int、float、string和bool；复合类型包括array、object、callable和iterable；特殊类型包括null、void等，其中null通常需要与问号前缀配合使用，而void只能用于返回值类型，表示函数不返回任何值。此外，还可以使用自定义类、接口和抽象类作为类型提示。开发者可以根据实际需要选择合适的类型来约束数据。
需要注意的是，类型提示并不支持资源类型resource。如果需要校验某个变量是否为资源类型，只能通过手动调用is_resource()函数来进行判断。此外，类型提示的作用范围仅限于函数参数、返回值以及类属性，普通的局部变量无法直接添加类型提示。如果业务逻辑需要对普通局部变量进行类型校验，可以使用PHP提供的is_系列函数，例如is_int()、is_string()、is_array()等，或者使用assert()函数在调试阶段进行断言检查。
类型错误通常是在运行时才被抛出的，这意味着如果代码没有走到出错的执行路径，类型问题可能不会被立即发现。因此，在实际开发中，建议开发者结合集成开发环境或静态分析工具来进行类型检查，提前发现潜在的类型不匹配问题，从而减少调试成本。下面的示例演示了如何对普通局部变量进行手动的类型校验。
<?php
// 普通局部变量无法直接声明类型，可手动校验
$score = "95";
if (!is_int($score)) {
throw new InvalidArgumentException("score变量必须为整数类型");
}
// 使用assert进行调试期校验
assert(is_numeric($score), "score变量应为数值类型");
?>
总体而言，类型提示是PHP中提升代码质量的重要特性之一。通过在函数参数、返回值和类属性中合理使用类型提示，可以让代码接口更加清晰，减少类型相关错误的发生。结合严格类型声明和手动类型校验，开发者能够在不同场景下灵活控制类型检查的严格程度，从而编写出更可靠、更易于维护的PHP程序。建议在团队协作或大型项目中，逐步引入类型提示规范，并配合完善的测试和静态分析流程，充分发挥类型系统的优势。