PHP Splat 运算符

最后修改于 2025 年 5 月 21 日

在本文中，我们将探讨 PHP 的 splat 运算符 (...)，也称为展开运算符。该运算符于 PHP 5.6 中引入，主要提供两种功能：在函数中捕获可变长度参数列表（参数解包）和将数组解包为单个元素。

Splat 运算符简化了处理可变数量的参数并使数组操作更具表现力。它特别适用于创建灵活的 API 和组合数组。

PHP 的 splat 运算符的优点是

可变函数： 接受无限数量的参数，无需使用 func_get_args()
数组解包： 合并数组或将数组元素作为单独的参数传递
类型安全： 可以为可变参数指定类型提示
更简洁的代码： 比 array_merge 或参数计数更具可读性
灵活性： 适用于位置参数和命名参数 (PHP 8.0+)

通过使用 splat 运算符，开发人员可以编写更灵活、更具表现力的函数，同时保持简洁、可读的代码。

基本可变函数

Splat 运算符允许函数通过在参数前加上 ... 来接受可变数量的参数。然后，这些参数在函数内部作为数组提供。

basic_variadic.php

<?php

declare(strict_types=1);

// Simple variadic function
function sumAll(...$numbers): float {
    return array_sum($numbers);
}

echo sumAll(1, 2, 3) . "\n";
echo sumAll(1.5, 2.5, 3.5, 4.5) . "\n";

// With type hints (PHP 7.0+)
function concatenate(string ...$strings): string {
    return implode(' ', $strings);
}

echo concatenate('Hello', 'there', 'from', 'PHP') . "\n";

// Mixing regular and variadic parameters
function createPerson(string $name, int $age, ...$extraInfo): array {
    return [
        'name' => $name,
        'age' => $age,
        'extra' => $extraInfo
    ];
}

print_r(createPerson('Alice', 30, 'Developer', 'London', 'alice@example.com'));

// Comparison with old-style variadic functions
function oldSumAll() {
    $numbers = func_get_args();
    return array_sum($numbers);
}

echo oldSumAll(1, 2, 3) . "\n";

此示例展示了 splat 运算符在可变函数中的使用。 sumAll 函数接受任意数量的参数，而 concatenate 强制使用字符串类型。 createPerson 函数演示了混合使用常规参数和可变参数。

参数解包

在调用函数时，splat 运算符可以将数组解包为单个参数。当您有一个需要作为单独参数传递给函数的值数组时，这非常有用。

argument_unpacking.php

<?php

declare(strict_types=1);

// Function that takes three parameters
function formatDate(int $day, string $month, int $year): string {
    return "$day $month $year";
}

$dateParts = [15, 'June', 2025];
echo formatDate(...$dateParts) . "\n";

// With associative arrays (PHP 8.0+)
function createUser(string $name, string $email, int $age = 18): array {
    return compact('name', 'email', 'age');
}

$userData = ['name' => 'Alice', 'email' => 'alice@example.com', 'age' => 30];
print_r(createUser(...$userData));

// Unpacking multiple arrays
function mergeConfigs(array ...$configs): array {
    return array_merge(...$configs);
}

$defaults = ['timeout' => 30, 'debug' => false];
$custom = ['debug' => true, 'log_level' => 'error'];
$merged = mergeConfigs($defaults, $custom);
print_r($merged);

// With generators
function generateNumbers(int $start, int $end): Generator {
    for ($i = $start; $i <= $end; $i++) {
        yield $i;
    }
}

$numbers = [...generateNumbers(1, 5)];
print_r($numbers);

这演示了使用 splat 运算符的数组解包。 formatDate 示例显示了位置解包，而 createUser 演示了命名参数解包 (PHP 8.0+)。 mergeConfigs 函数显示了可变解包，并且生成器示例将产生的值转换为数组。

使用 splat 的数组操作

Splat 运算符通过提供一种简洁的方式来合并数组或一次将多个元素插入数组，从而简化了许多数组操作。

array_operations.php

<?php

declare(strict_types=1);

// Merging arrays
$front = ['a', 'b', 'c'];
$back = ['x', 'y', 'z'];
$combined = [...$front, ...$back];
print_r($combined);

// Inserting elements
$middle = ['d', 'e', 'f'];
$fullAlphabet = [...$front, ...$middle, ...$back];
print_r($fullAlphabet);

// With associative arrays (PHP 8.1+)
$defaults = ['color' => 'red', 'size' => 'medium'];
$overrides = ['color' => 'blue', 'price' => 10];
$result = [...$defaults, ...$overrides];
print_r($result);

// Creating new arrays with additional elements
$numbers = [1, 2, 3];
$moreNumbers = [0, ...$numbers, 4, 5];
print_r($moreNumbers);

// Combining with array_merge
$array1 = [1, 2, 3];
$array2 = [4, 5, 6];
$array3 = [7, 8, 9];

$merged = array_merge($array1, $array2, $array3);
$mergedWithSplat = [...$array1, ...$array2, ...$array3];
var_dump($merged === $mergedWithSplat); // true

这些示例展示了 splat 运算符如何简化数组操作。它提供了比 array_merge 更具可读性的替代方案，并且允许通过扩展来自多个数组的元素来进行灵活的数组构造。

Splat 运算符的实际用例

以下示例演示了 splat 运算符的五个实际应用，每个应用都附有代码和详细说明，以说明其在实际 PHP 开发中的强大功能和实用性。

practical_uses.php

<?php

declare(strict_types=1);

// 1. Flexible Logging with Contextual Data
function debugLog(string $message, ...$context): void {
    $timestamp = date('Y-m-d H:i:s');
    $contextJson = !empty($context) ? json_encode($context) : '';
    echo "[$timestamp] $message $contextJson\n";
}

debugLog('User logged in', ['user_id' => 123, 'ip' => '192.168.1.1']);

// 2. Modular Data Processing Pipeline
function processData(array $data, callable ...$processors): array {
    $result = $data;
    foreach ($processors as $processor) {
        $result = array_map($processor, $result);
    }
    return $result;
}

$numbers = [1, 2, 3, 4, 5];
$processed = processData(
    $numbers,
    fn($n) => $n * 2,
    fn($n) => $n + 1,
    fn($n) => $n ** 2
);
print_r($processed);

// 3. Configuration Merging with Safe Overrides
function createConfig(array $defaults, array ...$overrides): array {
    $config = $defaults;
    foreach ($overrides as $override) {
        $config = array_merge($config, $override);
    }
    return $config;
}

$appConfig = createConfig(
    ['debug' => false, 'timeout' => 30],
    ['debug' => true, 'environment' => 'production']
);
print_r($appConfig);

// 4. Flexible Data Transfer Objects (DTOs)
class ProductDTO {
    public string $name;
    public float $price;
    private array $extra;

    public function __construct(string $name, float $price, array $extra = []) {
        $this->name = $name;
        $this->price = $price;
        $this->extra = $extra;
    }

    public function getExtra(string $key): mixed {
        return $this->extra[$key] ?? null;
    }

    public function getAllExtra(): array {
        return $this->extra;
    }
}

$product = new ProductDTO('Laptop', 999.99, ['category' => 'Electronics', 'stock' => 5]);
print_r($product->getAllExtra());

// 5. Dynamic SQL Query Building
class QueryBuilder {
    private array $parts = [];

    public function select(string ...$columns): self {
        $this->parts['select'] = $columns ?: ['*'];
        return $this;
    }

    public function where(string ...$conditions): self {
        if (!empty($conditions)) {
            $this->parts['where'] = $conditions;
        }
        return $this;
    }

    public function getQuery(): string {
        $select = implode(', ', $this->parts['select'] ?? ['*']);
        $where = isset($this->parts['where']) ? ' WHERE ' . implode(' AND ', $this->parts['where']) : '';
        return "SELECT $select FROM products$where";
    }
}

$query = (new QueryBuilder())
    ->select('id', 'name', 'price')
    ->where('price > 100', 'stock > 0')
    ->getQuery();

echo $query . "\n";

debugLog 函数举例说明了 splat 运算符如何促进使用上下文数据的灵活日志记录。通过允许将任意数量的上下文数组作为参数传递，该函数可以将其序列化为 JSON，以包含在日志消息中。这对于调试用户操作或系统事件特别有用，因为它适应了各种数量的元数据（例如用户 ID 或 IP 地址），而无需预定义的参数。时间戳确保了日志的可追溯性，使这种方法成为在开发或生产环境中监视应用程序行为的理想选择。

processData 函数演示了 splat 运算符在创建模块化数据处理管道中的作用。它接受一个数据数组和可变数量的可调用函数，每个函数都按顺序应用以转换数据。在示例中，数字在一系列操作中被加倍、递增和平方。这种设计促进了可重用性，因为开发人员可以轻松地添加或修改处理器，而无需更改核心函数。它对于 ETL（提取、转换、加载）流程中的数据规范化或转换等任务特别有价值。

使用 createConfig 函数简化了配置管理，该函数使用 splat 运算符将多个覆盖数组合并到默认配置中。这确保了默认设置（例如调试模式或超时）得到保留，同时允许针对特定环境进行灵活的覆盖。使用带有可变参数的 array_merge 可防止意外覆盖，使其成为跨不同部署场景管理应用程序设置的强大解决方案。

ProductDTO 类展示了 splat 运算符如何支持灵活的数据传输对象。通过将附加属性存储在私有 extra 数组中，该类避免了动态属性创建，确保了与现代 PHP 的严格标准兼容。 getExtra 和 getAllExtra 方法提供了对这些属性的安全访问，允许开发人员处理可变数据（如产品类别或库存水平），同时保持类型安全性和封装性。

最后，QueryBuilder 类说明了 splat 运算符在构建动态 SQL 查询中的实用性。通过接受可变数量的列和条件，它创建了一个流畅的界面来构造查询。示例选择特定列并应用多个条件，生成干净的 SQL 语句。这种方法简化了数据库交互，使得构建复杂查询更容易，同时保持代码的可读性和可维护性，尤其是在具有动态数据需求的应用程序中。

PHP 的 splat 运算符 (...) 是一个用于处理可变长度参数列表和数组操作的多功能工具。需要记住的要点

可变函数： 使用 ...$param 接受任意数量的参数
参数解包： 使用 ...$array 将数组元素作为单独的参数传递
数组操作： 合并数组或使用展开的元素创建新数组
类型安全： 可变参数可以进行类型提示以进行参数验证
命名参数： 适用于 PHP 8.0+ 中的命名参数
性能： 通常效率很高，但请考虑使用非常大的数组的内存
可读性： 通常比 func_get_args 或 array_merge 更清晰

Splat 运算符在创建灵活的 API、处理可变长度数据或组合数组时特别有价值。它使 PHP 代码更具表现力，同时保持良好的性能特征。

作者

我叫 Jan Bodnar，是一位充满激情的程序员，拥有丰富的编程经验。我自 2007 年以来一直在撰写编程文章。迄今为止，我撰写了 1,400 多篇文章和 8 本电子书。我拥有十多年教授编程的经验。

列出所有 PHP 教程。