# ArrayObject::ksort

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

ArrayObject::ksort — Sort the entries by key

### 说明

public ArrayObject::ksort(int `$flags` = `SORT_REGULAR`): true

Sorts the entries by key, maintaining key to entry correlations. This is useful mainly for associative arrays.

> 注意:

> 如果两个成员完全相同，那么它们将保持原来的顺序。 在 PHP 8.0.0 之前，它们在排序数组中的相对顺序是未定义的。

### 参数

`flags`

  可选的第二个参数 `flags` 可以用以下值改变排序的行为：

  排序类型标记：

  - `SORT_REGULAR` - 正常比较单元 详细描述参见 比较运算符 章节
  - `SORT_NUMERIC` - 单元被作为数字来比较
  - `SORT_STRING` - 单元被作为字符串来比较
  - `SORT_LOCALE_STRING` - 根据当前的区域（locale）设置来把单元当作字符串比较，可以用 setlocale() 来改变。
  - `SORT_NATURAL` - 和 natsort() 类似对每个单元以“自然的顺序”对字符串进行排序。
  - `SORT_FLAG_CASE` - 能够与 `SORT_STRING` 或 `SORT_NATURAL` 合并（OR 位运算），不区分大小写排序字符串。

### 返回值

总是返回 `true`。

### 更新日志

版本 | 说明
--- | ---
8.2.0 | 现在返回类型为 `true`；之前是 bool。

### 示例

示例 #1 ArrayObject::ksort() example

`<?php
$fruits = array("d" => "lemon", "a" => "orange", "b" => "banana", "c" => "apple");
$fruitArrayObject = new ArrayObject($fruits);
$fruitArrayObject->ksort();
foreach ($fruitArrayObject as $key => $val) {
echo "$key = $val\n";
}
?>`

以上示例会输出：

    a = orange
    b = banana
    c = apple
    d = lemon

### 参见

- ArrayObject::asort() - Sort the entries by value
- ArrayObject::natsort() - Sort entries using a "natural order" algorithm
- ArrayObject::natcasesort() - Sort an array using a case insensitive "natural order" algorithm
- ArrayObject::uasort() - Sort the entries with a user-defined comparison function and maintain key association
- ArrayObject::uksort() - Sort the entries by keys using a user-defined comparison function
- ksort() - 对数组根据键名升序排序

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open