php自定义函数限制传参类型

在PHP中，自定义函数时可以限制传入参数的类型以确保函数接收符合预期类型的参数。以下是限制传参类型的几种方法：

方法1：类型声明（PHP 7及以上）

从PHP 7开始，引入了严格的类型声明功能，可以直接在函数参数列表中指定参数的类型。这包括基本类型（如 int、string、float、bool、array、object、callable 等）以及类名、接口名、trait名（表示接受该类、接口或trait的实例）。如果传入的参数类型不符合声明，PHP会抛出一个错误。

function processNumber(int $num): string
{
    // 如果传入的不是一个整数，PHP 7+ 会抛出 TypeError
    return "Processing number: $num";
}

echo processNumber(123); // 正确：传入整数
echo processNumber("123"); // 错误：传入字符串，不符合类型声明

方法2：declare(strict_types=1)（PHP 7及以上）

在脚本或函数定义前使用 declare(strict_types=1)，可以启用严格类型模式。在此模式下，函数传参和返回值类型检查更为严格，仅允许精确匹配的类型。这对于函数内部的所有类型声明都有效。

declare(strict_types=1);

function addNumbers(int $num1, int $num2): int
{
    return $num1 + $num2;
}

$result = addNumbers(10, "20"); // 抛出 TypeError，因为第二个参数不是整数

方法3：类型检查与异常抛出（适用于所有PHP版本）

对于不支持类型声明的旧版本PHP或需要更灵活的类型检查，可以在函数内部进行手动类型检查，并在类型不符时抛出异常或返回错误信息。

function validateEmail(string $email): bool
{
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        throw new InvalidArgumentException("Invalid email address: $email");
    }
    return true;
}

try {
    validateEmail("invalid_email");
} catch (InvalidArgumentException $e) {
    echo $e->getMessage(); // 输出 "Invalid email address: invalid_email"
}

方法4：文档注释中的类型提示（非强制）

虽然这不是编译时或运行时的强制类型检查，但在函数文档注释中使用 @param 标签指定预期的参数类型是一种良好的编程实践，有助于代码阅读和IDE自动提示。这对任何版本的PHP都适用，但不会阻止错误类型的参数被传入函数。

/**
 * @param int $count 需要计数的整数值
 * @return int 计算后的结果
 */
function countToTen(int $count)
{
    // ...
}

综上所述，推荐在支持的PHP版本中使用类型声明来限制函数传参类型。对于旧版本或需要额外灵活性的情况，可以结合使用类型检查与异常抛出或使用文档注释提供类型提示。随着PHP的发展，越来越多的项目倾向于使用严格类型声明以提升代码质量和可维护性。