使用PHP函數"array_search" 在數組中查找指定的值並返回其鍵名

M66 2025-06-05

PHP 中array_search 函數的作用

在PHP 開發中，數組是一種使用頻率極高的數據結構。要在數組中查找某個值對應的鍵名，可以使用array_search()函數，這是一個內置且高效的工具函數。

array_search() 的基本語法

mixed array_search( mixed $needle , array $haystack [, bool $strict = false ] )

這個函數接收三個參數：

$needle ：要查找的值。
$haystack ：要搜索的數組。
$strict ：可選參數，是否啟用嚴格比較（默認false）。若設置為true，則類型和值必須完全匹配。

基本使用示例

下面是一個使用array_search()查找字符串值的示例：

 $fruits = array("banana", "apple", "orange", "grape");
<p>$key = array_search("apple", $fruits);</p>
<p>echo "The key for 'apple' is: " . $key;

輸出結果為：

 The key for 'apple' is: 1

這個例子中，我們創建了一個水果數組，然後用array_search()查找"apple" 所在的鍵名，結果返回了索引值1。

嚴格模式下的使用

當你希望不僅比較值，還要比較類型時，可以將第三個參數$strict設置為true 。來看下面的示例：

 $fruits = array("banana", 1, "2", true);
<p>$key = array_search(1, $fruits, true);<br>
echo "The key for 1 is: " . $key . "\n";</p>
<p>$key = array_search("1", $fruits, true);<br>
echo "The key for '1' is: " . $key;

輸出結果為：

 The key for 1 is: 1
The key for '1' is:

由於使用了嚴格模式， 1 （整數）和"1" （字符串）被認為是不相等的，因此第二次查找返回了false（未匹配到鍵名）。

array_search 的注意事項

如果數組中存在多個匹配值， array_search()只返回第一個匹配項的鍵名。
返回的結果可能是整數索引或關聯數組的字符串鍵。
未找到匹配項時函數將返回false 。

結語

總的來說， array_search()是PHP 中一個非常實用的數組處理函數。它適用於需要查找值在數組中的位置並獲取其鍵名的場景。無論是順序數組還是關聯數組，都能快速定位目標元素，提升代碼效率。

array_search