如何自定义 PHP 函数参数的类型验证？

在 PHP 中自定义函数参数类型验证可强制参数类型，确保其符合预期，从而提高代码健壮性。可通过以下方式实现：类型提示：声明函数参数的预期类型，不匹配类型将抛出异常。类型转换：使用 settype 函数或运算符将变量转换为指定类型。类型推断：PHP 自动推断变量类型，如赋值时。自定义验证：创建自定义验证函数以验证特定类型（如日期）。实战案例：通过姓名验证函数展示自定义验证的用法，确保名称长度和格式符合要求。

如何自定义 PHP 函数参数的类型验证

在 PHP 中，函数参数的类型验证允许你强制传入的参数类型，确保它们与预期相符。这有助于提高代码的健壮性和可靠性。

类型提示

PHP 7.0 引入了类型提示，允许你声明函数参数的预期类型。你可以使用内置类型或自建类。

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

如果传入的参数不匹配声明的类型，PHP 将抛出一个 TypeError 异常。

类型转换与类型推断

PHP 支持类型转换和类型推断：

• 类型转换：使用 settype 函数或强制类型转换运算符将变量转换为指定类型。
• 类型推断：在某些情况下，PHP 可以推断变量的类型，例如在赋值时。

// 类型转换
$int = (int) '10';

// 类型推断
$array = [1, 2, 3];

自定义类型验证

对于内置类型无法满足的需求，你可以创建自定义验证函数。

function validateDate(string $date): bool
{
    if (preg_match('/^[0-9]{4}-[0-1][0-9]-[0-3][0-9]$/', $date)) {
        return true;
    }

    return false;
}

function formatDate(string $date)
{
    if (!validateDate($date)) {
        throw new InvalidArgumentException('Invalid date format.');
    }

    //...
}

实战案例

以下是一个验证用户输入姓名的函数：

function validateName(string $name): void
{
    if (strlen($name) < 3 || strlen($name) > 25) {
        throw new InvalidArgumentException('Name must be between 3 and 25 characters long.');
    }

    if (!preg_match('/^[a-zA-Z ]+$/', $name)) {
        throw new InvalidArgumentException('Name must contain only letters and spaces.');
    }
}

这个函数使用自定义验证来确保传入的名字符合要求。

优点

自定义类型验证提供以下优点：

• 确保函数参数的有效性
• 提高代码的可读性和可维护性
• 通过强制类型减少错误
• 促进单元测试和测试驱动开发