array_first() │ WP 6.9.0

Получает первый элемент массива. Полифил функции добавленной в PHP 8.5

Значение берётся из начала массива в том порядке, в котором элементы находятся в массиве. Ключ первого элемента не используется — функция получает только значение.

Если массив пустой, вернет null.

Полифилл для встроенной PHP-функции array_first().

Хуков нет.

Возвращает

Разное|null.

  • mixed — значение первого элемента массива.
  • null — если массив пустой.

Использование

array_first( $array );
$array(array) (обязательный)

Массив, из которого нужно получить первый элемент.

Параметр должен быть массивом. Если передать значение другого типа, PHP выбросит ошибку типа.

Примеры

#1 Получение первого значения из ассоциативного массива

$user_data = [
	'name'  => 'John',
	'email' => 'john@example.com',
	'role'  => 'editor',
];

$first_value = array_first( $user_data );

echo $first_value; // John

#2 Пустой массив

$items = [];

$first_item = array_first( $items );

if ( null === $first_item ) {
	echo 'Массив пустой.';
}

#3 Получение первого элемента обычного массива

$colors = [ 'red', 'green', 'blue' ];

$first_color = array_first( $colors );

echo $first_color; // red

Список изменений

С версии 6.9.0 Введена.

Код array_first() WP 7.0.4

wp-includes/compat.php 
function array_first( array $array ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.arrayFound
	if ( empty( $array ) ) {
		return null;
	}

	foreach ( $array as $value ) {
		return $value;
	}
}

Вспомогательные