_wp_array_set() — описание функции WordPress на русском

Сигнатура

_wp_array_set( array $input_array, array $path, mixed $value = null )

Описание

Это PHP-эквивалент lodash.set() из JavaScript, и его воспроизведение может помочь другим компонентам сохранять некоторую симметрию между клиентской и серверной реализациями.
Пример использования:
$input_array = array();
_wp_array_set( $input_array, array( 'a', 'b', 'c', 1 ) );

$input_array становится:
array(
'a' => array(
'b' => array(
'c' => 1,
),
),
);

Оригинал (английский)

It is the PHP equivalent of JavaScript’s lodash.set() and mirroring it may help other components retain some symmetry between client and server implementations.

Example usage:

$input_array = array();
_wp_array_set( $input_array, array( 'a', 'b', 'c', 1 ) );

$input_array becomes:
array(
    'a' => array(
        'b' => array(
            'c' => 1,
        ),
    ),
);

Параметры

$input_array array обязательный

Массив, который нужно изменить, чтобы включить определённое значение по заданному пути.

$path array обязательный

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

$value mixed необязательный = null

Значение, которое будет установлено.

Исходный код

wp-includes/functions.php:5166

function _wp_array_set( &$input_array, $path, $value = null ) {
	// Confirm $input_array is valid.
	if ( ! is_array( $input_array ) ) {
		return;
	}

	// Confirm $path is valid.
	if ( ! is_array( $path ) ) {
		return;
	}

	$path_length = count( $path );

	if ( 0 === $path_length ) {
		return;
	}

	foreach ( $path as $path_element ) {
		if (
			! is_string( $path_element ) && ! is_integer( $path_element ) &&
			! is_null( $path_element )
		) {
			return;
		}
	}

	for ( $i = 0; $i < $path_length - 1; ++$i ) {
		$path_element = $path[ $i ];
		if (
			! array_key_exists( $path_element, $input_array ) ||
			! is_array( $input_array[ $path_element ] )
		) {
			$input_array[ $path_element ] = array();
		}
		$input_array = &$input_array[ $path_element ];
	}

	$input_array[ $path[ $i ] ] = $value;
}

История изменений

Версия	Описание
5.8.0	Introduced.