php 5.6 引入的 ... 语法（splat operator）用于将函数调用时的参数数组展开为独立参数，或在函数定义中收集任意数量的位置参数。在函数定义中使用 function foo(...$args) 时，$args 是一个包含所有传入参数的数组；在函数调用中使用 foo(...$array) 时，会将数组元素解包并作为独立参数传递给目标函数。
定义阶段：收集可变参数
当在函数签名中使用 ... 前缀时，该参数会捕获所有剩余的位置参数。这是一个非常实用的模式，用于替代早期的 func_get_args()，因为它提供了类型提示和更清晰的变量作用域。需要注意的是，带有 ... 的参数必须是函数的最后一个参数，且不能与默认值冲突。
<?php
// 定义一个接受可变参数的函数
function sumAll(...$numbers) {
$total = 0;
foreach ($numbers as $num) {
// 确保只处理数字类型，防止非预期输入
if (is_numeric($num)) {
$total += $num;
}
}
return $total;
}
// 调用示例：传入任意数量的整数
$result = sumAll(1, 2, 3, 4, 5);
echo "Sum: " . $result; // 输出 Sum: 15
// 也可以传入空参数
$emptyResult = sumAll();
echo "Empty Sum: " . $emptyResult; // 输出 Empty Sum: 0
上述代码展示了如何安全地处理不定数量的输入。在实际工程中，这种结构常用于日志记录器、数据库查询构建器或配置合并工具。由于 $numbers 始终是一个数组，我们可以直接利用 PHP 丰富的数组函数进行处理，而不需要手动管理索引。
立即学习“PHP免费学习笔记（深入）”；
调用阶段：展开数组参数
在函数调用端，... 操作符的作用是将一个数组或可遍历对象解包，使其元素成为独立的实参。这在包装函数（Wrapper Function）或代理模式（Proxy Pattern）中极为常见，允许中间层透明地将参数传递给底层核心逻辑，而无需预先知道具体有哪些参数。
<?php
// 模拟一个需要多个参数的核心业务函数
function processOrder($orderId, $userId, $items, $options) {
return [
'order_id' => $orderId,
'user_id' => $userId,
'item_count' => count($items),
'has_options' => !empty($options)
];
}
// 创建一个包装函数，动态决定传递哪些参数
function createOrderProxy(array $config) {
// 从配置中提取必要数据
$orderId = $config['id'] ?? uniqid('ORD-');
$userId = $config['user'];
$items = $config['items'];
$options = $config['options'] ?? [];
// 使用 ... 展开数组，自动匹配位置参数
// 注意：这里假设位置参数顺序与 processOrder 定义一致
return processOrder(
$orderId,
$userId,
$items,
...$options // 如果 options 为空数组，则不传递额外参数
);
}
// 准备测试数据
$orderData = [
'id' => '1001',
'user' => 55,
'items' => ['apple', 'banana'],
'options' => ['gift_wrap' => true, 'express' => false]
];
// 执行并验证结果
$result = createOrderProxy($orderData);
print_r($result);
通过这种方式，我们避免了在包装函数中显式列出每一个参数名。如果底层 processOrder 增加了新参数，只要我们在调用处正确构建了展开的数组，包装函数通常无需修改。但必须警惕参数顺序的变化，因为展开操作严格依赖位置对应关系。对于命名参数较多的场景，建议结合关联数组与 func_get_args 或反射机制进行更复杂的适配。
