简体中文
简体中文
在 PHP 开发过程中，array_slice 是我们常用的数组操作函数之一。它主要用于从数组中提取一段子数组。然而，当我们用它处理时，如果不注意参数和返回结果的细节，很容易引发意料之外的 bug。本文将通过实际示例来揭示这个“坑”，并教你如何正确避开它。
array_slice(array $array, int $offset, ?int $length = null, bool $preserve_keys = false): array
$array：要操作的原始数组
$offset：开始位置
$length：要截取的长度
$preserve_keys：是否保留原数组的键名（默认是 false，即重新索引）
来看一个例子：
$data = [
'apple' => 1,
'banana' => 2,
'cherry' => 3,
'date' => 4,
];
$result = array_slice($data, 1, 2);
print_r($result);
你以为会输出如下内容？
Array
(
[banana] => 2
[cherry] => 3
)
实际上，输出是这样的：
Array
(
[0] => 2
[1] => 3
)
为什么键名丢了？原因在于第四个参数 $preserve_keys 的默认值是 false，所以键名被重置成了从 0 开始的索引键。
只需要在调用 array_slice 时明确指定 true 给第四个参数：
$result = array_slice($data, 1, 2, true);
print_r($result);
输出就会如你所愿：
Array
(
[banana] => 2
[cherry] => 3
)
这一步很关键，尤其是在你依赖数组的键名（例如处理表单字段、配置文件等场景）时，忘记这个参数可能会导致逻辑完全错误。
比如你用切片结果来构造新的键值结构：
foreach (array_slice($data, 1, 2) as $key => $val) {
echo "$key => $val\n";
}
你期待输出的是：
banana => 2
cherry => 3
但实际输出是：
0 => 2
1 => 3
这可能会让你的某些键值依赖逻辑完全失败，特别是当你将 $key 作为某种标识符使用时。
在你使用 array_slice 之前，问自己：
是否在乎键名？（关联数组中键名一般都很重要）
是否将结果继续用于与原数组键相关的逻辑？
如果答案是“是”，务必设置 $preserve_keys = true。
封装一个更安全的版本，可以避免重复犯错：
function slice_assoc(array $array, int $offset, ?int $length = null): array {
return array_slice($array, $offset, $length, true);
}
然后使用：
$result = slice_assoc($data, 1, 2);
清晰、可靠、免出错。
在很多 CMS 和框架中，后台分页或配置数组处理中都会用到 array_slice。如果不保留键，可能会导致错乱，甚至引发权限校验漏洞。例如，在对某类配置项做分页截取时，如果键是 config_id 而被重置为整数索引，那么对应的配置将无法正常匹配。
更多 PHP 函数使用注意事项可以查看 https://gitbox.net/php-tips
