(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
array_key_exists — Проверяет, существует ли в массиве заданный ключ или индекс
Функция array_key_exists() возвращает true, если
заданный ключ (key) содержится в массиве.
В параметр key разрешено передавать значение,
которое допустимо в качестве индекса массива.
keyПроверяемое значение.
arrayМассив с проверяемыми ключами.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Замечание:
Функция array_key_exists() ищет ключи только на первом уровне массива. Внутренние ключи в многомерных массивах найдены не будут.
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр key теперь принимает в качестве аргументов значения
bool, float, int,
null, resource
и string.
|
Пример #1 Пример использования функции array_key_exists()
<?php
$search_array = array('first' => 1, 'second' => 4);
if (array_key_exists('first', $search_array)) {
echo "Массив содержит элемент «first».";
}
?>Пример #2 Пример использования функции array_key_exists() с языковой конструкцией isset()
Конструкция языка isset() не возвращает true для ключей массива,
которые ассоциированы со значением null,
а функция array_key_exists() — возвращает.
<?php
$search_array = array('first' => null, 'second' => 4);
// Возвращает false
isset($search_array['first']);
// Возвращает true
array_key_exists('first', $search_array);
?>Замечание:
По причинам обратной совместимости функция array_key_exists() возвращает
true, если ключ (key) — это свойство объекта (object), переданного в качестве параметраarray. Поведение устарело в PHP 7.4.0 и удалено в PHP 8.0.0.Проверить, содержит ли объект заданное свойство, можно функцией property_exists().
In PHP7+ to find if a value is set in a multidimensional array with a fixed number of dimensions, simply use the Null Coalescing Operator: ??So for a three dimensional array where you are not sure about any of the keys actually existing<?php// instead of:$exists = array_key_exists($key1, $arr) && array_key_exists($key2, $arr[$key1]) && array_key_exists($key3, $arr[$key1][$key2]) ;// use:$exists = array_key_exists($key3, $arr[$key1][$key2]??[]) ;?>When you want to check multiple array keys: <?php$array = [];$array['a'] = '';$array['b'] = '';$array['c'] = '';$array['d'] = '';$array['e'] = '';// all given keys a,b,c exists in the supplied arrayvar_dump(array_keys_exists(['a','b','c'], $array)); // bool(true)function array_keys_exists(array $keys, array $array): bool{ $diff = array_diff_key(array_flip($keys), $array); return count($diff) === 0;}<?php// Define an associative array$userProfile = [ 'name' => 'John Doe', 'email' => 'john.doe@example.com', 'age' => 30, 'country' => 'USA'];// Key to check$keyToCheck = 'email';// Use array_key_exists to check if the key exists in the arrayif (array_key_exists($keyToCheck, $userProfile)) { echo "The key '$keyToCheck' exists in the array with value: " . $userProfile[$keyToCheck];} else { echo "The key '$keyToCheck' does not exist in the array.";}?><?php// Define an associative array$userProfile = [ 'name' => 'John Doe', 'email' => 'john.doe@example.com', 'age' => 30, 'country' => 'USA'];// Key to check$keyToCheck = 'email';// Use array_key_exists to check if the key exists in the arrayif (array_key_exists($keyToCheck, $userProfile)) { echo "The key '$keyToCheck' exists in the array with value: " . $userProfile[$keyToCheck];} else { echo "The key '$keyToCheck' does not exist in the array.";}?>