key() 函数是什么？它在PHP数组遍历中起什么关键作用？

gitbox 2025-09-29

<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 这部分与文章内容无关</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"PHP 教程示例开始…\n"</span></span><span>;
</span><span><span class="hljs-variable">$array</span></span><span> = [</span><span><span class="hljs-number">1</span></span><span>, </span><span><span class="hljs-number">2</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>];
</span><span><span class="hljs-title function_ invoke__">print_r</span></span><span>(</span><span><span class="hljs-variable">$array</span></span><span>);
</span><span><span class="hljs-meta">?></span></span><span>

<hr>

</span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 文章正文开始</span></span><span>
</span><span><span class="hljs-meta">?></span></span><span>

<h1></span><span><span class="hljs-title function_ invoke__">key</span></span><span>() 函数是什么？它在PHP数组遍历中起什么关键作用？</h1>

<p>在 PHP 中，<code></span><span><span class="hljs-title function_ invoke__">key</span></span><span>()

如果数组内部指针指向有效元素，key() 返回当前元素的键名。
如果数组为空或者指针超出数组范围，key() 返回 NULL。

2. key() 在数组遍历中的关键作用

在 PHP 中遍历数组，通常使用 foreach 或 while 搭配 current()、next()、key() 等函数。key() 的作用是告诉我们当前指针指向的键，这在以下场景中非常重要：

同时访问键和值： 当你使用 while 循环遍历数组时，key() 可以获取当前元素的键，而 current() 获取值。
动态操作数组： 在某些算法中，你可能需要根据键名进行判断或删除特定元素，key() 提供了直接的访问方式。
避免额外变量： 如果你不使用 key()，可能需要额外维护一个计数器来表示索引，这在关联数组中尤其繁琐。

3. 示例代码

&lt;?php
</span><span><span class="hljs-variable">$fruits</span></span><span> = [
    </span><span><span class="hljs-string">"apple"</span></span><span> =&gt; </span><span><span class="hljs-number">5</span></span><span>,
    </span><span><span class="hljs-string">"banana"</span></span><span> =&gt; </span><span><span class="hljs-number">3</span></span><span>,
    </span><span><span class="hljs-string">"orange"</span></span><span> =&gt; </span><span><span class="hljs-number">7</span></span><span>
];

</span><span><span class="hljs-title function_ invoke__">reset</span></span><span>(</span><span><span class="hljs-variable">$fruits</span></span><span>); </span><span><span class="hljs-comment">// 将内部指针重置到数组开头</span></span><span>

</span><span><span class="hljs-keyword">while</span></span><span> (</span><span><span class="hljs-title function_ invoke__">key</span></span><span>(</span><span><span class="hljs-variable">$fruits</span></span><span>) !== </span><span><span class="hljs-literal">null</span></span><span>) {
    </span><span><span class="hljs-variable">$fruitName</span></span><span> = </span><span><span class="hljs-title function_ invoke__">key</span></span><span>(</span><span><span class="hljs-variable">$fruits</span></span><span>);     </span><span><span class="hljs-comment">// 获取当前元素的键名</span></span><span>
    </span><span><span class="hljs-variable">$fruitCount</span></span><span> = </span><span><span class="hljs-title function_ invoke__">current</span></span><span>(</span><span><span class="hljs-variable">$fruits</span></span><span>); </span><span><span class="hljs-comment">// 获取当前元素的值</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"水果: <span class="hljs-subst">$fruitName</span></span></span><span>, 数量: </span><span><span class="hljs-subst">$fruitCount</span></span><span>\n";
    </span><span><span class="hljs-title function_ invoke__">next</span></span><span>(</span><span><span class="hljs-variable">$fruits</span></span><span>); </span><span><span class="hljs-comment">// 将内部指针移动到下一个元素</span></span><span>
}
?&gt;

输出结果为：

水果: apple, 数量: </span><span><span>5</span></span><span>
水果: banana, 数量: </span><span><span>3</span></span><span>
水果: orange, 数量: </span><span><span>7</span></span><span>

在这个例子中，key() 让我们能够获取每个水果的名称，而 current() 提供数量信息，两者配合使用实现了完整的数组遍历。

4. 总结

key() 是 PHP 数组操作中一个轻量却关键的函数。它可以：

获取当前数组指针所指向的键名
方便在循环中同时访问键和值
在动态操作关联数组时提供必要信息

掌握 key() 与 current()、next() 等指针操作函数的组合使用，是 PHP 高级数组操作的基础。

<?php // 文章结束 ?>

相关标签:
key