HOWTO · PHP
在 PHP 中檢查陣列是否包含某值
本教程演示如何使用 PHP 中的內建函式檢查陣列是否包含特定值。
本頁內容
當問題是某個值是否符合陣列元素時,請使用 in_array()。當問題是文字是否包含陣列中儲存的某個字串時,請使用 strpos()。兩種檢查回答的是不同問題:成員檢查不會搜尋元素內的內容,而找到子字串也不代表整段文字就是陣列中的值。
使用 in_array() 精確檢查陣列值
in_array($needle, $haystack) 會回傳布林值,表示陣列中是否有元素符合搜尋值。PHP 預設會以寬鬆比較方式比較值,因此不同型別的值也可能被視為相等。若必須同時符合值與型別,請將 true 傳入第三個引數 $strict。當陣列可能同時包含數字字串與整數時,這項設定特別實用。
執行以下範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$values = ["demo", 10];
var_dump(in_array("10", $values));
var_dump(in_array("10", $values, true));
var_dump(in_array(10, $values, true));
bool(true)
bool(false)
bool(true)
第一個呼叫使用預設的比較方式;第二個呼叫要求嚴格比較;第三個呼叫則以嚴格比較檢查整數元素。範例中程式碼與輸出文字依英文原文保留,因此畫面顯示的訊息仍是英文。請依資料模型預期的型別選擇比較方式,不要仰賴隱式轉換。
使用 strpos() 迴圈搜尋陣列值中的子字串
若要檢查文字是否包含任一候選字串,請逐一走訪候選值,並呼叫 strpos($text, $candidate)。有找到時,函式會回傳匹配位置;沒有找到則回傳 false。請使用 !== false 比較結果:匹配可能從位置 0 開始,這是有效的位置,但在寬鬆布林檢查中會被當成 false。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$candidates = ['John', 'Michelle', 'Shawn'];
$text = 'Shawn is here';
$found = false;
foreach ($candidates as $candidate) {
if (strpos($text, $candidate) !== false) {
$found = true;
break;
}
}
var_dump($found);
此迴圈找到第一個符合項目後就會停止。它回答的是文字中是否出現至少一個候選字串,而不是陣列中是否有完全相同的元素。若要忽略字母大小寫,請明確選擇不區分大小寫的搜尋方式,並留意文字編碼與比較規則。
為何 json_encode() 不適合用來可靠地搜尋陣列
json_encode() 會將 PHP 值轉換為 JSON 字串,而不是建立可供搜尋的 PHP 物件。使用 strpos() 搜尋這段序列化字串時,可能會在較長的元素中找到子字串:例如搜尋 John 會匹配 Johnson 這類元素,即使實際需求是找出完全相同的名稱 John。JSON 的標點符號與跳脫字元也描述的是編碼後的表示形式,而非原始值。
本節中的程式碼以及顯示的標籤或輸出仍為英文。
<?php
$names = ['Johnson', 'Michelle'];
$encoded = json_encode($names);
$hasExactName = in_array('John', $names, true);
$textHasNamePart = strpos($encoded, 'John') !== false;
var_dump($hasExactName);
var_dump($textHasNamePart);
若要檢查陣列成員,請使用 in_array() 檢查陣列,或逐一走訪其值並套用所需的比較方式。只有在序列化後的文字本身才是預期輸入時,才搜尋編碼後的 JSON;不要用它取代對原始資料的檢查。
選擇符合問題的檢查方式
若要確認完整的值是否存在於陣列元素中,請使用 in_array();若型別也必須相符,請啟用嚴格比較引數。若要確認較長文字中是否出現任一候選字串,包括從第一個字元開始的匹配,請使用 foreach 迴圈搭配 strpos() !== false。命名結果時也要清楚區分:一種是陣列成員檢查,另一種是子字串偵測。
不要搜尋 json_encode() 的輸出來判斷是否存在完全相同的陣列值。序列化會改變資料表示方式,也可能在較長的值中造成子字串匹配。請檢查原始陣列中的實際元素,再依預期型別選擇寬鬆或嚴格比較。這些做法能讓程式碼直接表達要回答的問題,也更容易維護。