如何在 PHP 单元测试（PHPUnit）中测试 array_change_key_case() 的行为？

M66 2025-04-25

array_change_key_case() 是 PHP 的一个常用函数，用于改变数组中所有键的大小写。当你需要确保数组键名的大小写一致性时，这个函数会非常有用。然而，在单元测试中，我们需要确保这个函数在不同情况下能够正确地执行。这篇文章将介绍如何使用 PHPUnit 对 array_change_key_case() 函数进行单元测试。

1. 简单介绍 array_change_key_case() 函数

array_change_key_case() 函数接受两个参数：

array：要处理的数组。
case（可选）：指定大小写的转换方式，默认值是 CASE_LOWER，表示转换成小写；可以传递 CASE_UPPER，表示转换成大写。

语法：

array_change_key_case(array $array, int $case = CASE_LOWER): array

示例：

$array = [
    "FirstName" => "John",
    "LastName"  => "Doe"
];

print_r(array_change_key_case($array, CASE_LOWER));

输出：

Array
(
    [firstname] => John
    [lastname] => Doe
)

2. 创建 PHPUnit 测试用例

接下来，我们来编写 PHPUnit 测试用例，以确保 array_change_key_case() 能正常工作。假设我们要测试的是将数组的所有键转化为小写或大写。

首先，确保你已经安装了 PHPUnit。如果还没有安装，你可以通过 Composer 安装它：

composer require --dev phpunit/phpunit ^9

在 PHPUnit 测试中，我们需要创建一个测试类，并在其中定义一些测试方法。下面是一个简单的示例：

<?php

use PHPUnit\Framework\TestCase;

class ArrayChangeKeyCaseTest extends TestCase
{
    // 测试将数组键名转换为小写
    public function testArrayChangeKeyCaseToLower()
    {
        $input = [
            "FirstName" => "John",
            "LastName"  => "Doe"
        ];

        $expected = [
            "firstname" => "John",
            "lastname"  => "Doe"
        ];

        $result = array_change_key_case($input, CASE_LOWER);

        $this->assertEquals($expected, $result);
    }

    // 测试将数组键名转换为大写
    public function testArrayChangeKeyCaseToUpper()
    {
        $input = [
            "firstName" => "John",
            "lastName"  => "Doe"
        ];

        $expected = [
            "FIRSTNAME" => "John",
            "LASTNAME"  => "Doe"
        ];

        $result = array_change_key_case($input, CASE_UPPER);

        $this->assertEquals($expected, $result);
    }

    // 测试空数组
    public function testArrayChangeKeyCaseWithEmptyArray()
    {
        $input = [];

        $result = array_change_key_case($input, CASE_UPPER);

        $this->assertEquals([], $result);
    }

    // 测试带有 URL 键的数组
    public function testArrayChangeKeyCaseWithURL()
    {
        $input = [
            "UserURL" => "http://m66.net/profile",
            "ApiURL"  => "https://m66.net/api"
        ];

        $expected = [
            "userurl" => "http://m66.net/profile",
            "apiurl"  => "https://m66.net/api"
        ];

        $result = array_change_key_case($input, CASE_LOWER);

        $this->assertEquals($expected, $result);
    }
}

3. 解释测试用例

testArrayChangeKeyCaseToLower()：测试将数组的键转换为小写。
testArrayChangeKeyCaseToUpper()：测试将数组的键转换为大写。
testArrayChangeKeyCaseWithEmptyArray()：测试对空数组的行为。
testArrayChangeKeyCaseWithURL()：测试带有 URL 键的数组，确保转换后的键名为小写，而 URL 的值保持不变。

4. 运行 PHPUnit 测试

将测试文件保存在 tests 目录下，并使用以下命令运行 PHPUnit 测试：

./vendor/bin/phpunit --bootstrap vendor/autoload.php tests/ArrayChangeKeyCaseTest

如果一切正常，你应该看到所有测试通过的输出。

5. 总结

通过使用 PHPUnit，我们能够确保 array_change_key_case() 函数在多种场景下都能够按预期工作。无论是简单的键名大小写转换，还是包含 URL 的复杂数组，正确的单元测试能够确保我们在不同情况下的需求都能够得到满足。通过测试不同类型的输入，我们可以更好地了解函数的行为，并确保代码的健壮性。

array_change_key_case