wp_parse_args() — объединение массива заданных параметров и массива параметров по умолчанию

Нужен для объединения массива с аргументами, переданными в функцию (под функцией в данном случае подразумевается не сам wp_parse_args(), а вообще какая-нибудь левая функция, используемая нами) и массивом аргументов, установленных по умолчанию. Массивы с параметрами могут быть также переданы в виде строки URL-вида, например orderby=rand&order=asc.

Функция wp_parse_args() сопоставляет оба массива и замещает все соответствующие элементы массива $defaults элементами массива $args. Если же соответствующего элемента в массиве $args не нашлось, то берется значение из $defaults.

Описание оказалось слишком грозным, а на деле все очень и очень просто, достаточно глянуть пример.

wp_parse_args( $args, $defaults = '' )
$args
(строка|массив) набор параметров, переданных в произвольную функцию
$defaults
(строка|массив) набор параметров по умолчанию

Пример

Для примера возьмем функцию, выводящую строку с текстом, предварительно добавляющую по краям ещё две строки (например открывающие и закрывающие HTML-теги).

/*
 * предположим, где-то в начале кода была задана функция true_my_function()
 */
function true_my_function( $args ) {
 
	// массив значений по умолчанию
	$defaults = array (
		'text' => 'это текст по умолчанию',
		'before' => "<em>",
		'after' => "</em>",
		'echo' => true
	);
 
	// используем wp_parse_args() для сопоставления массивов
	$args = wp_parse_args( $args, $defaults );
 
	$out = $args['before'] . $args['text'] . $args['after'];
 
	if (!$args['echo']) 
		return $out;
 
	echo $out;
}
 
/*
 * а чуть дальше в коде мы вызовем эту функцию, сделаем так, чтобы текст при выводе был не наклонным, а жирным
 */
$args = array(
	'before' => '<strong>',
	'after' => '</strong>'
);
true_my_function( $args ); // выведет: <strong>это текст по умолчанию</strong>

Как вариант, последние строчки в коде можно заменить на:

true_my_function( 'before=<strong>&after=</strong>' );

Миша

В последние годы я долго не знал, что мне делать с сайтом misha.blog, ведь он практически не приносит никакого профита, но недавно я осознал, что моя миссия – способствовать распространению WordPress. Ведь WordPress – это лучший движок для разработки сайтов – как для тех, кто готов использовать заложенную структуру этой CMS, так и для тех, кто предпочитает headless решения.

Сам же я впервые познакомился с WordPress в 2009 году. Организатор WordCamp. Преподаватель в школах Epic Skills и LoftSchool.

Если вам нужна помощь с вашим сайтом или может даже разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда сделаем вам всё на лучшем уровне.

Оставить комментарий

Если вы хотите добавить код, не забудьте обернуть его в <pre lang="php"></pre>, если же код – меньше одной строчки, то можно и в <code></code>.