数组

## 简介

这些函数允许你通过不同的方式来使用和操作数组。数组是存储、管理和操作变量组的必不可少的工具。

PHP 支持简单数组和多维数组，数组可由用户自己创建也可以由其它函数创建。有很多特殊的数据库处理函数可以从数据库查询中返回数组以及一些返回数组的函数。

请参考手册中有关[数组](https://www.php.net/manual/zh/language.types.array.php "数组")的章节来详细了解 PHP 中数组是如何实现及使用的。也可以参考 [数组操作符](https://www.php.net/manual/zh/language.operators.array.php "数组操作符")来了解操作数组的一些其它方式。

## 安装/配置

### 需求
构建此扩展不需要其他扩展。

### 安装
使用这些函数不需要安装，它们是 PHP 核心的一部分。

### 运行时配置
此扩展没有在 `php.ini` 中定义配置指令。

### 资源类型
此扩展没有定义资源类型。

## 预定义常量
下列常量作为 PHP 核心的一部分总是可用的。

`CASE_LOWER (int)`
`CASE_LOWER` 用在 array_change_key_case() 中将数组的键名转换成小写字母。这也是 array_change_key_case() 的默认值。从 PHP 8.2.0 开始，只转换 ASCII 字符。

`CASE_UPPER (int)`
`CASE_UPPER` 用在 array_change_key_case() 中将数组的键名转换成大写字母。从 PHP 8.2.0 开始，只转换 ASCII 字符。

排序顺序标识：

`SORT_ASC (int)`
`SORT_ASC` 用在 array_multisort() 函数中，使其升序排列。

`SORT_DESC (int)`
`SORT_DESC` 用在 array_multisort() 函数中，使其降序排列。

排序类型标识：用于各种排序函数

`SORT_REGULAR (int)`
`SORT_REGULAR` 用于对对象进行通常比较。

`SORT_NUMERIC (int)`
`SORT_NUMERIC` 用于对对象进行数值比较。

`SORT_STRING (int)`
`SORT_STRING` 用于对对象进行字符串比较。

`SORT_LOCALE_STRING (int)`
SORT_LOCALE_STRING 基于当前区域来对对象进行字符串比较。

`SORT_NATURAL (int)`
`SORT_NATURAL` 用于对元素作为字符串使用“自然排序”（像是 natsort() ）比较。

`SORT_FLAG_CASE (int)`
`SORT_FLAG_CASE` 可以跟 `SORT_STRING` 或者 `SORT_NATURAL` 组合（按位或（OR））对字符串进行大小写不敏感排序。从 PHP 8.2.0 开始，只转换 ASCII 字符。

过滤器 flags:

`ARRAY_FILTER_USE_KEY (int)`
`ARRAY_FILTER_USE_KEY` 用于 array_filter() 将每个键作为第一个参数传递给指定回调函数。

`ARRAY_FILTER_USE_BOTH (int)`
`ARRAY_FILTER_USE_BOTH` 用于 array_filter() 将值和键传递给指定回调函数。

`COUNT_NORMAL (int)`

`COUNT_RECURSIVE (int)`

`EXTR_OVERWRITE (int)`

`EXTR_SKIP (int)`

`EXTR_PREFIX_SAME (int)`

`EXTR_PREFIX_ALL (int)`

`EXTR_PREFIX_INVALID (int)`

`EXTR_PREFIX_IF_EXISTS (int)`

`EXTR_IF_EXISTS (int)`

`EXTR_REFS (int)`

## 对数组进行排序
PHP 有一些用来排序数组的函数， 这个文档会把它们列出来。

主要区别有：

有些函数基于 [array](https://www.php.net/manual/zh/language.types.array.php "array") 的键来排序， 而其他的基于值来排序的：`$array['key'] = 'value'`;。
排序之后键和值之间的关联关系是否能够保持， 是指排序之后数组的键可能 会被重置为数字型的（0,1,2 ...）。
排序的顺序有：字母表顺序， 升序（由低到高）， 降序（由高到低），数字排序，自然排序，随机顺序或者用户自定义排序。
注意：下列的所有排序函数都是直接作用于数组本身， 而不是返回一个新的有序的数组。
以下函数对于数组中相等的元素，会保留原有的排序。 在 PHP 8.0.0 之前，它们排序后的顺序是未定义的（也即相等元素之间的顺序是不稳定的）。

| 函数名称              | 排序依据 | 数组索引键保持                | 排序的顺序        | 相关函数          |
|-------------------|------|------------------------|--------------|---------------|
| array_multisort() | 值    | string 键保持不变，int 键重新索引 | 第一个数组或者由选项指定 | array_walk()  |
| asort()           | 值    | 是                      | 升序           | arsort()      |
| arsort()          | 值    | 是                      | 降序           | asort()       |
| krsort()          | 键    | 是                      | 降序           | ksort()       |
| ksort()           | 键    | 是                      | 升序           | krsort()      |
| natcasesort()     | 值    | 是                      | 自然排序，大小写不敏感  | natsort()     |
| natsort()         | 值    | 是                      | 自然排序         | natcasesort() |
| rsort()           | 值    | 否                      | 降序           | sort()        |
| shuffle()         | 值    | 否                      | 随机           | array_rand()  |
| sort()            | 值    | 否                      | 升序           | rsort()       |
| uasort()          | 值    | 是                      | 由用户定义        | uksort()      |
| uksort()          | 键    | 是                      | 由用户定义        | uasort()      |
| usort()           | 值    | 否                      | 由用户定义        | uasort()      |