array_slice 中 preserve_keys 参数对键名保留的影响

gitbox 2025-05-28

在 PHP 中，array_slice 函数是用来截取数组中指定部分的一个非常实用的工具。它的函数签名如下：

array_slice(array $array, int $offset, ?int $length = null, bool $preserve_keys = false): array

其中，参数 $preserve_keys 用于控制是否保留原数组的键名。这个参数的作用看似简单，但在实际使用中，很多人对它是否真的保留键名存在疑惑。本文将详细解释 $preserve_keys 参数的行为，并结合代码示例进行说明。

$preserve_keys 参数的作用

array_slice 会从数组 $array 中截取一段数据，默认情况下（即 $preserve_keys 为 false），返回的数组会重新索引，也就是说，键名会被重置为从0开始的数字索引。

当 $preserve_keys 设置为 true 时，函数将尝试保留原数组的键名。这在处理关联数组时非常重要，因为你希望保留键名对应的意义。

示例代码解析

下面我们用一段代码来说明：

<?php
$array = [
    'a' => 'apple',
    'b' => 'banana',
    'c' => 'cherry',
    5   => 'date',
    6   => 'elderberry',
];

// 默认行为 preserve_keys = false
$slice1 = array_slice($array, 1, 3);
print_r($slice1);

/*
输出：
Array
(
    [0] => banana
    [1] => cherry
    [2] => date
)
*/

// preserve_keys = true
$slice2 = array_slice($array, 1, 3, true);
print_r($slice2);

/*
输出：
Array
(
    [b] => banana
    [c] => cherry
    [5] => date
)
*/
?>

从上面的代码可以看出：

当 $preserve_keys 为 false 时，返回的数组键名被重置为数字索引（0、1、2）。
当 $preserve_keys 为 true 时，返回数组保留了原始的键名 'b', 'c' 和 5。

注意事项

如果数组是索引数组（数字键），且 $preserve_keys 为 false，则返回的数组键名会被重排。
如果是关联数组（字符串键），即使 $preserve_keys 为 false，键名也会被替换为数字索引，这会导致键名丢失。
当 $preserve_keys 为 true 时，返回的数组键名保持不变，但如果你用这个数组做后续操作，务必注意键名的完整性。

额外补充

官方手册中对 array_slice 的说明：https://gitbox.net/manual/en/function.array-slice.php

这里替换了域名为 gitbox.net，你可以访问了解更多详细信息。

array_slice