如何验证 PHP 函数参数的有效性？

如何验证 PHP 函数参数的有效性

在 PHP 中，函数参数的有效性验证是至关重要的，因为它有助于确保代码的健壮性和可靠性。可以通过多种方法实现参数验证，本文将探讨最常用的方法。

使用数据类型检查

通过使用 PHP 中的数据类型检查运算符，可以验证参数是否是预期的类型。例如：

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

上述函数接受两个整数参数，并返回一个整数。如果传递了非整数值，将引发 TypeError。

使用范围检查

可以使用 range() 函数来验证参数是否在指定的范围内。例如：

function checkAge(int $age): string
{
    if (in_array($age, range(18, 65))) {
        return "Eligible";
    } else {
        return "Not Eligible";
    }
}

此函数检查传入的年龄是否在 18 到 65 之间，并根据结果返回相应的消息。

使用正则表达式

正则表达式是一种强大的工具，可用于验证字符串参数的模式。例如：

function validateEmail(string $email): bool
{
    return preg_match("/^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,6}$/", $email);
}

此函数使用正则表达式来验证传入的电子邮件字符串是否正确格式化。

使用断言

断言是一种将布尔表达式作为参数的语法构造。在条件为 false 时抛出错误。例如：

function divideNums(int $num1, int $num2): float
{
    assert($num2 !== 0);

    return $num1 / $num2;
}

此函数使用 assert() 断言来确保第二个参数不为零，避免除数为零的错误。

实战案例

假设我们有一个函数，该函数计算三角形的周长和面积。我们可以对传入的参数进行验证以确保它们有效。

function calculateTriangle(float $base, float $height): array
{
    // 验证参数类型
    if (!is_float($base) || !is_float($height)) {
        throw new InvalidArgumentException("Invalid parameter types.");
    }

    // 验证参数范围
    if ($base <= 0 || $height <= 0) {
        throw new InvalidArgumentException("Invalid parameter values.");
    }

    // 计算结果
    $perimeter = 2 * $base + 2 * $height;
    $area = 0.5 * $base * $height;

    return ["perimeter" => $perimeter, "area" => $area];
}

在这个例子中，我们使用了数据类型检查和范围检查来验证函数参数。如果参数无效，将抛出异常并中止脚本的执行。