You appear to be a bot. Output may be restricted

Description

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

Usage

$string|array = wp_debug_backtrace_summary( $ignore_class, $skip_frames, $pretty );

Parameters

$ignore_class

( string ) optional – Optional. A class to ignore all function calls within – useful when you want to just give info about the callee. Default null.

$skip_frames

( int ) optional – Optional. A number of stack frames to skip – useful for unwinding back to the source of the issue. Default 0.

$pretty

( bool ) optional default: 1 – Optional. Whether you want a comma separated string instead of the raw array returned. Default true.

Returns

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

Source

File name: wordpress/wp-includes/functions.php
Lines:

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;
  }
}
 

 View on GitHub View on Trac