WooCommerce Code Reference

QueryInfoExtractor
in package

Extracts a unified query info tree from a GraphQL ResolveInfo.

The resulting array captures the full query structure: fields, arguments, sub-selections, inline fragments, and named fragment spreads.

Structure rules:

  • Leaf field (no args, no sub-selection) => true
  • Field with sub-selections => nested associative array
  • Field arguments => '__args' reserved key
  • Inline fragments => '...TypeName' prefix key
  • Named fragment spreads => expanded inline (merged into the parent as siblings of the other selections), matching how GraphQL evaluates them
  • Top-level query args included via '__args'

Table of Contents

extract_from_info()  : array<string|int, mixed>
Extract query info from a resolver's ResolveInfo and top-level args.
build_field_entry()  : array<string|int, mixed>|bool
Build the entry for a single field node.
merge_selections()  : array<string|int, mixed>
Recursively merge two selection trees produced by extract()/build_field_entry().
resolve_argument_value()  : mixed
Resolve the value of a single argument node, handling variables.

Methods

extract_from_info()

Extract query info from a resolver's ResolveInfo and top-level args.

public static extract_from_info(ResolveInfo $info, array<string|int, mixed> $args) : array<string|int, mixed>
Parameters
$info : ResolveInfo

The GraphQL resolve info.

$args : array<string|int, mixed>

The top-level query arguments.

Return values
array<string|int, mixed> — The unified query info tree.

build_field_entry()

Build the entry for a single field node.

private static build_field_entry(FieldNode $field, array<string|int, mixed> $variable_values, array<string, FragmentDefinitionNode> $fragments) : array<string|int, mixed>|bool
Parameters
$field : FieldNode

The field node.

$variable_values : array<string|int, mixed>

Variable values for resolving arguments.

$fragments : array<string, FragmentDefinitionNode>

Named fragment definitions from the document.

Return values
array<string|int, mixed>|bool — True for leaf fields, associative array otherwise.

merge_selections()

Recursively merge two selection trees produced by extract()/build_field_entry().

private static merge_selections(array<string|int, mixed> $a, array<string|int, mixed> $b) : array<string|int, mixed>

Used wherever selections from different sources are combined under the same key (notably: named fragment spreads expanded inline). Matches GraphQL's selection-set merge semantics — overlapping fields have their sub-selections unioned rather than one replacing the other, which a shallow array_merge would do.

Rules:

  • Key only in one side: kept verbatim.
  • Both sides arrays: recurse, unioning children.
  • One array, one true (leaf): keep the array — it carries the sub-selection detail, and its presence already implies the field was requested.
  • Both true: keep true.
  • __args collisions (same field with different argument values): the second operand wins. Conflicting field args are a GraphQL validation error upstream of us, so this path is defensive.
Parameters
$a : array<string|int, mixed>

First selection tree.

$b : array<string|int, mixed>

Second selection tree, merged into $a.

Return values
array<string|int, mixed> — The merged tree.

resolve_argument_value()

Resolve the value of a single argument node, handling variables.

private static resolve_argument_value(ArgumentNode $arg, array<string|int, mixed> $variable_values) : mixed
Parameters
$arg : ArgumentNode

The argument node.

$variable_values : array<string|int, mixed>

Variable values.

Return values
mixed — The resolved argument value.