PHP 类型提示：让函数只接受该接受的数据-代码号

PHP在很长一段时间里被贴上“弱类型语言”的标签，因为它的解析器会尽较大努力去自动转换变量类型——比如当你把一个字符串 "6" 和一个整数 7 相加，PHP 会默默把字符串转成数字，然后算出 13。这种行为在写小脚本时确实省心，但在大型项目中，这种隐式转换反而可能掩盖掉数据类型的错误，让 bug 藏得很深。

类型提示（Type Hinting）正是用来解决这个问题的。简单来说，它让你在函数或方法定义时就能声明“这个参数只能接受什么类型”、“这个方返回什么类型”。如果传入的值类型不对，PHP 会在运行前就抛出错误，帮你把问题暴露在早期。

这个机制从 PHP 5 开始逐步引入，到 PHP 7 和 PHP 8 已经变得相当成熟，覆盖了函数参数、返回值、类属性等多个维度。

函数参数的类型提示

这是类型提示最直观的应用。在函数定义时，给每个参数前面加上类型名，PHP 就会强制检查传入值的类型。看下面这个计算两数相乘的函数：

function multiply(int $a, int $b) {
    echo "First number: $a, Second number: $b, Product: " . ($a * $b);
}

$num1 = "6";  // 一个看起来像整数的字符串
$num2 = 7;
multiply($num1, $num2);

输出：

First number: 6, Second number: 7, Product: 42

这里参数声明为 int，但传进来的 $num1 是个字符串 "6"。PHP 并没有直接报错，而是尝试将它强制转换为整数再执行。这是因为 PHP 默认处于强制类型模式（coercive mode），会在可能的情况下自动转换。

如果你想要更严格的检查，可以在文件开头加上 declare(strict_types=1);，这样传 "6" 就会直接报 TypeError，因为它不再做隐式转换，要求传入的值严格匹配声明的类型。我个人在写新项目时会在入口文件统一开启严格模式，减少意外类型转换带来的排查成本。

类方法的参数类型约束

类型提示在类方法中的应用更具实际价值。假设我们写一个日志类，要求日志消息必须是字符串：

class Logger {
    private $message;

    public function alert(string $message) {
        $this->message = $message;
        return "ALERT: " . $this->message;
    }
}

$logger = new Logger();
echo $logger->alert('Wrong password');

输出：

ALERT: Wrong password

alert(string $message) 中的 string 就是类型提示。如果你传一个数组或对象进去，PHP 立刻会抛出 TypeError。相比不写类型、全靠注释和约定来保证参数类型的做法，这多了一层语法级别的保障。而且从我自己的经历来看，带类型声明的代码在半年后重新打开时理解成本明显更低，因为你一看方法签名就知道它要什么、返回什么。

类属性的类型声明

从 PHP 7.4 开始，类属性也可以加上类型声明，确保属性在整个生命周期中只存放指定类型的数据：

class Logger {
    private string $message;

    public function alert(string $message): string {
        $this->message = $message;
        return "ALERT: " . $this->message;
    }
}

$logger = new Logger();
echo $logger->alert('Wrong password');

输出：

ALERT: Wrong password

private string $message; 强制 $message 必须是字符串。如果构造函数或其他地方试图给它赋一个非字符串值，PHP 会报错。这个特性在数据实体类（Entity）或值对象（Value Object）中很实用——你可以从类型层面保证数据的一致性，而不是依赖 setter 方法里的手动校验。

返回值类型声明

不仅参数能加类型，方法的返回值也能加。PHP 7 开始支持返回值类型声明，用冒号加类型名跟在参数括号后面：

class Logger {
    private string $message;

    public function alert(string $message): string {
        $this->message = $message;
        return "ALERT: " . $this->message;
    }
}

$logger = new Logger();
echo $logger->alert('Wrong password');

输出：

ALERT: Wrong password

alert(string $message): string 中，前面的 string 约束参数，后面的 : string 约束返回值。如果你在方法里不小心 return 了一个数组或数字，PHP 会直接报错。这在团队协作中作用不小——你不需要翻看方法体，只要看签名就知道它承诺返回什么。

常见的返回类型还包括 void（表示不返回任何值）、int、float、bool、array、以及自定义类名或接口名。

综合示例：带 getter 和 setter 的日志类

下面这个例子把参数类型提示、返回值类型声明、属性类型声明整合在一起：

class Logger {
    private string $message;

    // setter 方法：参数是 string，返回 void
    public function setMessage(string $message): void {
        $this->message = $message;
    }

    // getter 方法：返回 string
    public function getMessage(): string {
        return $this->message;
    }
}

$logger = new Logger();
$logger->setMessage("Database connection failed.");
echo $logger->getMessage();

输出：

Database connection failed.

这个类虽小，但覆盖了日常开发中大部分类型声明的用法。setMessage 要求字符串输入且不返回任何内容（void），getMessage 承诺返回字符串。整套接口的行为被类型系统约束得明明白白。

类型提示的几种常见形式

在 PHP 中，你可以为参数和返回值声明以下类型：

标量类型：int、float、string、bool
复合类型：array、object、callable、iterable
类与接口：任何自定义的类名或接口名
特殊类型：self（当前类）、parent（父类）、mixed（PHP 8.0+，任意类型）、null（PHP 8.0+，独立使用）、void（仅用于返回值）
联合类型（PHP 8.0+）：int|float 表示可以是整数或浮点数
可空类型：在类型前加 ?，如 ?string 表示可以是字符串或 null

为什么用类型提示而不是依赖注释？

在没有类型提示的年代，很多 PHP 项目靠 PHPDoc 注释（如 @param string $message）来标注类型。这种方式有两个明显的问题：

注释没有强制力：写 @param string 但传入整数，代码照常运行，错误只能靠人工审查发现。
注释容易过时：改代码时忘了同步更新注释是常有的事，久而久之注释就变成了误导。

类型提示把约束从“建议”变成了“规则”，违反规则会直接报错，这让代码的质量保障从依赖人的细心转向依赖解释器的检查。在接手别人代码或维护长期项目时，有类型声明的代码库维护体验会好很多。

本节课程知识要点

类型提示用于在函数和方法定义时声明参数和返回值的预期类型，PHP 会据此进行类型校验。
PHP 默认工作在强制类型模式，会自动尝试类型转换；开启 declare(strict_types=1); 后进入严格模式，类型不匹配会直接报 TypeError。
从 PHP 7.4 起，类属性也可以添加类型声明，确保属性值的类型一致性。
返回值类型声明用 : 类型 语法跟在参数括号后，void 表示不返回任何值。
类型提示覆盖标量类型、复合类型、类与接口、联合类型以及可空类型等多种形式，是提升代码可读性和可靠性的基础机制。

本文标签：

PHP 类型提示：让函数只接受该接受的数据