如何安全地解析可选的分号分隔 ISBN 参数（支持 1 或 2 个值）

本文介绍一种健壮、无报错的方式处理 laravel 中可选的 `isbns` get 参数，支持传入 0、1 或 2 个分号分隔的 isbn 值，并自动映射到 `isbn10` 和 `isbn13` 键，避免 `array_combine()` 因数组长度不匹配导致的崩溃。

在构建图书类 API 接口时，常需通过 isbns 查询参数接收一个或两个 ISBN（如 0307951529;9780307951526），并将其结构化为 ['isbn10' => '...', 'isbn13' => '...']。但直接使用 array_combine(['isbn10','isbn13'], explode(';', $isbn)) 存在严重隐患：当仅传入单个 ISBN（如 0307951529）时，$valuesArray 长度为 1，而 $keysArray 长度为 2，触发 array_combine(): Argument #1 and #2 must have the same number of elements 错误。

✅ 推荐解决方案：显式键值映射 + 安全截断

以下代码兼容 0、1 或 2 个分号分隔值，且逻辑清晰、无异常风险：

$isbn = $request->get('isbns', ''); // 默认空字符串，避免 null 引发 explode 警告
$valuesArray = array_slice(explode(';', trim($isbn)), 0, 2); // 最多取前 2 个，防多余参数

$keysArray = ['isbn10', 'isbn13'];
$queryArray = [];

foreach ($valuesArray as $index => $value) {
    if (isset($keysArray[$index]) && is_string($value) && trim($value) !== '') {
        $queryArray[$keysArray[$index]] = trim($value);
    }
}

// 此时 $queryArray 可能为 []、['isbn10' => '0307951529'] 或 ['isbn10' => '0307951529', 'isbn13' => '9780307951526']

? 关键优化点说明：

• 使用 array_slice(..., 0, 2) 严格限制最多处理 2 个值，忽略第 3 个及之后的输入（如 a;b;c → 仅取 a;b），提升健壮性；
• trim() 清除首尾空格，防止 '0307951529 ; 9780307951526' 解析出空字符串；
• 显式 isset($keysArray[$index]) 和非空校验，确保只写入合法键且值非空；
• $request->get('isbns', '') 提供默认值，避免 explode() 处理 null 报 Warning。

? 进阶建议（可选）：
若业务需明确区分 ISBN 类型（如自动识别 10/13 位），可结合正则或校验库（如 thephpleague/uri 或自定义 ISBN 校验函数）动态分配键名，而非依赖位置顺序。但对大多数场景，上述位置映射（首值→isbn10，次值→isbn13）已足够直观且符合约定。

✅ 最终整合到请求参数中：

$queryParams = [
    'api-key' => $apiKey,
    'author'  => $author,
    'title'   => $title,
    'isbns'   => [ (object) $queryArray ] // 保持原有结构
];

该方案彻底消除 array_combine() 的长度依赖风险，兼顾简洁性与鲁棒性，适用于生产环境。