php 7.0+ 引入的严格类型声明（declare(strict_types=1)）是解决参数类型不匹配报错的关键。默认情况下，php 采用弱类型模式，会自动尝试将传入的参数转换为函数期望的类型，而不是抛出错误。要强制检查类型并报错，必须在文件顶部启用严格模式，并确保函数签名中定义了明确的类型提示。
弱类型模式下的自动转换机制
在 PHP 的默认运行环境中，当调用函数时，如果传入的参数类型与函数定义中的类型声明不一致，解释器会尝试进行“隐式类型转换”。这种设计旨在提高代码的灵活性，允许开发者编写更通用的函数，但也导致了类型错误的隐蔽性。例如，当函数期望一个整数，而传入一个字符串形式的数字时，PHP 会静默地将字符串转换为整数，而不会中断程序执行。
考虑以下场景：我们定义了一个计算面积的函数 calculateArea，它接受两个参数 $width 和 $height，并期望它们都是浮点数。如果在调用时传入了字符串 "5" 和整数 10，PHP 会在内部执行转换逻辑。
立即学习“PHP免费学习笔记（深入）”；
<?php
function calculateArea($width, $height) {
return $width * $height;
}
// 传入字符串和整数
$result = calculateArea("5", 10);
echo $result; // 输出 50
?>
在上述代码中，$width 被从字符串 "5" 转换为整数 5，然后与 $height（整数 10）相乘，结果为 50。整个过程没有产生任何警告或错误。这种行为在简单脚本中可能无伤大雅，但在复杂业务逻辑中，如果传入的是非数字字符串如 "abc"，转换结果将为 0，导致难以追踪的逻辑错误。理解这一机制有助于识别为何某些看似错误的输入并未触发异常。
启用严格类型声明以强制类型检查
要改变上述行为，使 PHP 在类型不匹配时直接抛出 TypeError 异常，必须使用 declare(strict_types=1); 指令。该指令必须位于 PHP 文件的开头，且在
<?php
declare(strict_types=1);
function calculateAreaStrict(float $width, float $height): float {
return $width * $height;
}
try {
// 传入字符串 "5"，期望 float
$result = calculateAreaStrict("5", 10);
} catch (TypeError $e) {
echo "Error: " . $e->getMessage();
}
?>
在启用严格模式后，调用 calculateAreaStrict("5", 10) 将触发 TypeError，因为字符串 "5" 无法自动转换为浮点数。错误消息通常类似于 "Argument #1 ($width) passed to function calculateAreaStrict() must be of type float, string given"。这种严格的检查机制能尽早发现数据源中的类型污染问题，提升代码的健壮性。需要注意的是，strict_types 仅影响当前文件，不会影响其他未启用该指令的文件，即使它们调用了当前文件中的函数。
返回值类型的严格检查与边界处理
除了参数类型，PHP 还支持对函数返回值进行类型声明。结合严格模式，可以确保函数不仅接收正确的输入，还返回预期的类型。这对于构建可预测的 API 至关重要。然而，当函数内部逻辑可能导致类型不一致时，仍需小心处理。例如，如果函数根据条件返回不同类型的数据，而未做统一转换，可能会在严格模式下失败。
<?php
declare(strict_types=1);
function processInput($input): int {
if (is_string($input)) {
return intval($input);
}
return $input;
}
// 测试
$val = processInput("123");
echo gettype($val); // 输出 integer
?
在此示例中，processInput 函数明确声明返回 int。无论输入是字符串还是整数，函数内部都通过 intval() 或原样返回来确保最终结果是整数。在严格模式下，如果忘记转换而直接返回字符串，将会抛出 TypeError。因此，开发者必须保证函数体内的所有返回路径都符合声明的返回类型。此外，对于可选参数或未指定类型的参数，严格模式同样适用，但需注意默认值的类型也必须匹配声明类型。
