初始化 API 请求参数的默认值数组

在开发 PHP 接口请求时，我们经常需要对传入参数进行处理，并为某些参数设置默认值。如果参数较多，手动初始化数组可能显得冗余而容易出错。此时，array_fill_keys() 就成为一个非常高效的工具。

本文将介绍如何使用 array_fill_keys() 来快速初始化 API 请求参数的默认值数组，提高代码的可维护性与清晰度。

什么是 array_fill_keys()？

array_fill_keys() 是 PHP 的一个内置函数，用于将一个数组的键与统一的值配对生成一个新数组。

语法：

array_fill_keys(array $keys, mixed $value): array

• $keys: 用作新数组键名的数组。

• $value: 所有键的默认值。

场景示例：API 请求参数初始化

设想你正在开发一个接口，用于查询文章数据，客户端可能传入以下参数：

• page: 当前页码

• limit: 每页数量

• sort: 排序字段

• order: 排序方向（asc 或 desc）

为了避免用户未传入这些参数导致系统出错，后台应设定一个默认参数数组。我们可以使用 array_fill_keys() 简化这个过程。

示例代码：

<?php

// 定义参数键名
$paramKeys = ['page', 'limit', 'sort', 'order'];

// 使用 array_fill_keys 初始化默认值
$defaultParams = array_fill_keys($paramKeys, null);

// 手动覆盖默认值（如果需要）
$defaultParams['page'] = 1;
$defaultParams['limit'] = 10;
$defaultParams['sort'] = 'created_at';
$defaultParams['order'] = 'desc';

// 模拟获取客户端传入参数
$userInput = [
    'page' => 2,
    'order' => 'asc'
];

// 合并用户输入与默认值（用户输入优先）
$requestParams = array_merge($defaultParams, $userInput);

// 输出最终参数数组
print_r($requestParams);

输出结果：

Array
(
    [page] => 2
    [limit] => 10
    [sort] => created_at
    [order] => asc
)

如你所见，array_fill_keys() 让我们只需列出需要的参数名，就能批量初始化一个干净的默认参数结构，大大减少了手动输入错误的可能性。

实际应用：请求远程 API

假设我们要通过 POST 请求将这些参数发送到远程接口 https://api.m66.net/articles/list，可以这样做：

<?php

$apiUrl = 'https://api.m66.net/articles/list';

$options = [
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/x-www-form-urlencoded\r\n",
        'content' => http_build_query($requestParams),
        'timeout' => 10
    ]
];

$context  = stream_context_create($options);
$result = file_get_contents($apiUrl, false, $context);

echo $result;

小结

使用 array_fill_keys() 来初始化 API 请求参数的默认值，不仅简洁，还能提高代码的可维护性。当你的接口参数列表变更时，只需更新参数键数组，而不必修改多个手动赋值的语句。

这是一种非常推荐的实践方式，尤其适合在大型项目中进行参数管理与结构统一。