Как получить первый ключ ассоциативного массива в PHP?

Использование функций reset() и key()

Самый надёжный и элегантный способ получить первый ключ массива в PHP — это комбинация функций reset() и key(). Функция reset() перемещает внутренний указатель массива на первый элемент и возвращает его значение. Функция key() возвращает ключ текущего элемента массива. Работает как для индексных, так и для ассоциативных массивов.

<?php
function getFirstKey(array $array) {
    if (empty($array)) {
        return null; // или выбросить исключение
    }
    reset($array);
    return key($array);
}

// Примеры использования:
$indexed = ["apple", "banana", "cherry"];
$assoc = ["name" => "John", "age" => 30, "city" => "New York"];

echo getFirstKey($indexed); // 0
echo getFirstKey($assoc);   // name
?>

Альтернативный способ с array_key_first() (PHP 7.3+)

Начиная с PHP 7.3 появилась специальная функция array_key_first(), которая делает именно то, что вам нужно — возвращает первый ключ массива без изменения внутреннего указателя. Это самый чистый и производительный вариант для новых проектов.

<?php
// Для PHP 7.3 и выше
$array = ["x" => 1, "y" => 2, "z" => 3];
$firstKey = array_key_first($array); // "x"

// Для пустого массива возвращает null
$empty = [];
$firstKey = array_key_first($empty); // null
?>

Подводные камни и важные замечания

• Пустой массив: Всегда проверяйте, не пуст ли массив, чтобы избежать ошибок. Функция key() на пустом массиве вернёт null, но это не всегда очевидно.
• Внутренний указатель: reset() изменяет внутренний указатель массива. Если вы используете циклы foreach или другие операции, зависящие от позиции указателя, это может вызвать проблемы. В таких случаях лучше использовать array_key_first().
• Производительность: Для больших массивов array_key_first() работает быстрее, так как не перемещает указатель и не копирует массив.
• Совместимость: Если ваш код должен работать на PHP 7.2 и ниже, используйте комбинацию reset() + key(). Для новых проектов выбирайте array_key_first().

Универсальная функция для всех версий PHP

Если вам нужна обратная совместимость, вот универсальное решение:

<?php
function getFirstKeySafe(array $array) {
    if (function_exists('array_key_first')) {
        return array_key_first($array);
    }
    
    if (empty($array)) {
        return null;
    }
    
    reset($array);
    return key($array);
}
?>

Вывод: Для современных проектов используйте array_key_first(). Если нужна совместимость со старыми версиями PHP — применяйте reset() + key() с проверкой на пустоту массива.

<?php
$array = ["a" => 1, "b" => 2, "c" => 3];

// PHP 8.0+ — эффективный способ
$firstKey = array_keys($array, null, true)[0] ?? null;

// Для всех версий PHP (менее эффективно)
$keys = array_keys($array);
$firstKey = $keys[0] ?? null;
?>