wp_debug_backtrace_summary( string $ignore_class = null, int $skip_frames, bool $pretty = true ): string|array

Returns a comma-separated string or array of functions that have been called to get to the current point in code.

Description

See also

Parameters

$ignore_classstringoptional
A class to ignore all function calls within – useful when you want to just give info about the callee.

Default:null

$skip_framesintoptional
A number of stack frames to skip – useful for unwinding back to the source of the issue. Default 0.
$prettybooloptional
Whether you want a comma separated string instead of the raw array returned.

Default:true

Return

string|array Either a string containing a reversed comma separated trace or an array of individual calls.

Source

function wp_debug_backtrace_summary( $ignore_class = null, $skip_frames = 0, $pretty = true ) {	static $truncate_paths;	$trace = debug_backtrace( false );	$caller = array();	$check_class = ! is_null( $ignore_class );	++$skip_frames; // Skip this function.	if ( ! isset( $truncate_paths ) ) {	$truncate_paths = array(	wp_normalize_path( WP_CONTENT_DIR ),	wp_normalize_path( ABSPATH ),	);	}	foreach ( $trace as $call ) {	if ( $skip_frames > 0 ) {	--$skip_frames;	} elseif ( isset( $call['class'] ) ) {	if ( $check_class && $ignore_class === $call['class'] ) {	continue; // Filter out calls.	}	$caller[] = "{$call['class']}{$call['type']}{$call['function']}";	} else {	if ( in_array( $call['function'], array( 'do_action', 'apply_filters', 'do_action_ref_array', 'apply_filters_ref_array' ), true ) ) {	$caller[] = "{$call['function']}('{$call['args'][0]}')";	} elseif ( in_array( $call['function'], array( 'include', 'include_once', 'require', 'require_once' ), true ) ) {	$filename = isset( $call['args'][0] ) ? $call['args'][0] : '';	$caller[] = $call['function'] . "('" . str_replace( $truncate_paths, '', wp_normalize_path( $filename ) ) . "')";	} else {	$caller[] = $call['function'];	}	}	}	if ( $pretty ) {	return implode( ', ', array_reverse( $caller ) );	} else {	return $caller;	} } 

Changelog

VersionDescription
3.4.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.