# key

(PHP 4, PHP 5, PHP 7)

key — 从关联数组中取得键名

### 说明

key ( array `$array` ) : mixed

key() 返回数组中当前单元的键名。

### 参数

`array`

  该数组。

### 返回值

key() 函数返回数组中内部指针指向的当前单元的键名。 但它不会移动指针。如果内部指针超过了元素列表尾部，或者数组是空的，key() 会返回 `NULL`。

### 更新日志

版本 | 说明
--- | ---
7.0.0 | `array` 现在总是会传值。 在此之前，它会尽可能传引用，否则就传值。

### 范例

Example #1 key() 例子

    <?php
    $array = array(
        'fruit1' => 'apple',
        'fruit2' => 'orange',
        'fruit3' => 'grape',
        'fruit4' => 'apple',
        'fruit5' => 'apple');

    // this cycle echoes all associative array
    // key where value equals "apple"
    while ($fruit_name = current($array)) {
        if ($fruit_name == 'apple') {
            echo key($array).'<br />';
        }
        next($array);
    }
    ?>

以上例程会输出：

    fruit1<br />
    fruit4<br />
    fruit5<br />

### 参见

- current() - 返回数组中的当前单元
- next() - 将数组中的内部指针向前移动一位
- foreach